Создание аренды BLOB-объектов и управление ими с помощью Java
В этой статье показано, как создавать аренды BLOB-объектов и управлять ими с помощью клиентской библиотеки служба хранилища Azure для Java. Клиентская библиотека может использовать для получения, продления, выпуска и прерывания аренды BLOB-объектов.
Необходимые компоненты
- В этой статье предполагается, что у вас уже есть проект, настроенный для работы с клиентской библиотекой Хранилище BLOB-объектов Azure для Java. Сведения о настройке проекта, включая установку пакетов, добавление
importдиректив и создание авторизованного клиентского объекта, см. в статье "Начало работы с служба хранилища Azure и Java". - Механизм авторизации должен иметь разрешения на работу с арендой BLOB-объектов. Дополнительные сведения см. в руководстве по авторизации для следующей операции REST API:
- Lease Blob (Аренда BLOB-объекта)
Сведения об аренде BLOB-объектов
Аренда создает и управляет блокировкой большого двоичного объекта для операций записи и удаления. Длительность блокировки может составлять 15–60 секунд либо быть бесконечной. Аренда большого двоичного объекта обеспечивает монопольный доступ на запись и удаление большого двоичного объекта. Чтобы записать в большой двоичный объект с активной арендой, клиент должен включить активный идентификатор аренды с запросом на запись.
Дополнительные сведения о состояниях аренды и о том, когда можно выполнить данное действие по аренде, см. в разделе "Состояния аренды" и действия.
Все операции контейнера разрешены в контейнере, включающее большие двоичные объекты с активной арендой, включая удаление контейнера. Поэтому контейнер может быть удален даже в том случае, если в нем есть активные аренды больших двоичных объектов. Используйте операцию "Контейнер аренды" для управления правами на удаление контейнера.
Операции аренды обрабатываются классом BlobLeaseClient , который предоставляет клиенту все операции аренды для больших двоичных объектов и контейнеров. Дополнительные сведения об аренде контейнеров с помощью клиентской библиотеки см. в статье "Создание аренды контейнеров и управление ими с помощью Java".
Получение аренды
При получении аренды BLOB-объектов вы получите идентификатор аренды, который код может использовать для работы с большим двоичным объектом. Если большой двоичный объект уже имеет активную аренду, можно запросить только новую аренду с помощью активного идентификатора аренды. Однако можно указать новую длительность аренды.
Чтобы получить аренду, создайте экземпляр класса BlobLeaseClient , а затем используйте следующий метод:
Следующий пример получает 30-секундную аренду для большого двоичного объекта:
public BlobLeaseClient acquireBlobLease(BlobClient blob) {
// Create the lease client
BlobLeaseClient leaseClient = new BlobLeaseClientBuilder()
.blobClient(blob)
.buildClient();
// Acquire the lease - specify duration between 15 and 60 seconds, or -1 for
// infinite duration
String leaseID = leaseClient.acquireLease(30);
System.out.printf("Acquired lease ID: %s%n", leaseID);
return leaseClient;
}
Продление аренды
Вы можете продлить аренду BLOB-объектов, если идентификатор аренды, указанный в запросе, соответствует идентификатору аренды, связанному с большим двоичным объектом. Аренда может быть продлена даже в том случае, если срок его действия истек, если большой двоичный объект не был изменен или арендован еще раз после истечения срока действия этой аренды. При продлении аренды длительность сброса аренды.
Чтобы продлить существующую аренду, используйте следующий метод:
В следующем примере возобновляется аренда большого двоичного объекта:
public void renewBlobLease(BlobLeaseClient leaseClient) {
leaseClient.renewLease();
}
Освобождение аренды
Вы можете освободить аренду BLOB-объектов, если идентификатор аренды, указанный в запросе, соответствует идентификатору аренды, связанному с большим двоичным объектом. Освобождение аренды позволяет другому клиенту получить аренду большого двоичного объекта сразу после завершения выпуска.
Вы можете освободить аренду с помощью следующего метода:
В следующем примере освобождается аренда большого двоичного объекта:
public void releaseBlobLease(BlobLeaseClient leaseClient) {
leaseClient.releaseLease();
System.out.println("Release lease operation completed");
}
Прерывание аренды
Вы можете нарушить аренду BLOB-объектов, если большой двоичный объект имеет активную аренду. Любой авторизованный запрос может нарушить аренду; Запрос не требуется для указания соответствующего идентификатора аренды. Аренда не может быть продлена после того, как она нарушена, и разрыв аренды предотвращает получение новой аренды в течение определенного периода времени, пока исходная аренда не истекает или не будет освобождена.
Вы можете разорвать аренду с помощью следующего метода:
В следующем примере прерывается аренда большого двоичного объекта:
public void breakBlobLease(BlobLeaseClient leaseClient) {
leaseClient.breakLease();
}
Состояния аренды и действия
На следующей схеме показаны пять состояний аренды, а также команды или события, вызывающие изменение состояния аренды.
В следующей таблице перечислены пять состояний аренды, краткое описание каждого из них и список действий аренды, разрешенных в заданном состоянии. Эти действия аренды вызывают переходы состояния, как показано на схеме.
| Состояние аренды | Description | Разрешенные действия аренды |
|---|---|---|
| Доступно | Аренда разблокирована и может быть приобретена. | acquire |
| Аренду | Аренда заблокирована. | acquire (один и тот же идентификатор аренды), renew, change, releaseи break |
| Срок действия истек | Срок аренды истек. | acquire, renew, release и break |
| Нарушение | Аренда была нарушена, но аренда будет по-прежнему заблокирована до истечения периода перерыва. | release и break. |
| Неисправно | Аренда была нарушена, и срок перерыва истек. | acquire, release и break |
По истечении срока аренды идентификатор аренды сохраняется службой BLOB-объектов до тех пор, пока большой двоичный объект не будет изменен или арендован снова. Клиент может попытаться продлить или освободить аренду с помощью идентификатора аренды с истекшим сроком действия. Если эта операция выполнена успешно, клиент знает, что большой двоичный объект не был изменен с момента последнего действия идентификатора аренды. Если запрос завершается ошибкой, клиент знает, что большой двоичный объект был изменен, или большой двоичный объект был арендован снова после последней активности аренды. Затем клиент должен получить новую аренду большого двоичного объекта.
Если срок действия аренды истекает, а не освобождается явным образом, клиенту может потребоваться подождать до одной минуты, прежде чем будет получена новая аренда для большого двоичного объекта. Однако клиент может продлить аренду с идентификатором аренды немедленно, если большой двоичный объект не был изменен.
Аренда не может быть предоставлена для моментального снимка BLOB-объектов, так как моментальные снимки доступны только для чтения. Запрос аренды для моментального снимка приводит к коду 400 (Bad Request)состояния.
Ресурсы
Дополнительные сведения об управлении арендой BLOB-объектов с помощью клиентской библиотеки Хранилище BLOB-объектов Azure для Java см. в следующих ресурсах.
Операции REST API
Пакет SDK Azure для Java содержит библиотеки, которые создаются на основе REST API Azure, что позволяет взаимодействовать с операциями REST API через знакомые парадигмы Java. Методы клиентской библиотеки для управления арендами BLOB-объектов используют следующую операцию REST API:
- Lease Blob (Аренда BLOB-объекта)
Примеры кода
Ресурсы клиентской библиотеки
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по