Ведение журнала на стороне клиента с помощью клиентской библиотеки службы хранилища Azure для Java

  • Статья

Инструкции по установке двоичных файлов для клиентских библиотек службы хранилища Azure в проекте Java см. в файле сведений для проекта на сайте GitHub https://github.com/Azure/azure-storage-java: . В этом файле указаны все дополнительные зависимости, которые следует установить.

Необходимо установить дополнительную зависимость SLF4J, если планируется использовать ведение журнала на стороне клиента. SLF4J — это фасад ведения журнала, который позволяет легко использовать многие распространенные платформы ведения журнала Java из клиентского приложения. Дополнительные сведения о SLF4J см. в руководстве пользователя SLF4J. Чтобы просто проверить, как использовать SLF4J с пакетом SDK для хранилища, поместите JAR-файлы slf4j-api и slf4j-simple в путь сборки для проекта клиента хранилища. Все сообщения журнала хранилища затем направляются в консоль.

Следующий пример кода Java по умолчанию отключает ведение журнала хранилища посредством вызова статического метода setLoggingEnabledByDefault, и затем с помощью объекта OperationContext выполняется включение ведения журнала для определенного запроса:

// Set logging off by default.  
OperationContext.setLoggingEnabledByDefault(false);  
OperationContext ctx = new OperationContext();  
ctx.setLoggingEnabled(true);  
  
// Create an operation to add a new customer to the people table.  
TableOperation insertCustomer1 = TableOperation.insertOrReplace(customer1);  
  
// Submit the operation to the table service.  
table.execute(insertCustomer1, null, ctx);

В следующем примере показаны сообщения журнала, которые slf4j-simple записывает в консоль:

[main] INFO ROOT - {ceba5ec6...}: {Starting operation.}  
[main] INFO ROOT - {ceba5ec6...}: {Starting operation with location 'PRIMARY' per location mode 'PRIMARY_ONLY'.}  
[main] INFO ROOT - {ceba5ec6...}: {Starting request to 'http://storageaccountname2.table.core.windows.net/people(PartitionKey='Harp',RowKey='Walter')' at 'Tue, 08 Jul 2014 15:07:43 GMT'.}  
[main] INFO ROOT - {ceba5ec6...}: {Writing request data.}  
[main] INFO ROOT - {ceba5ec6...}: {Request data was written successfully.}  
[main] INFO ROOT - {ceba5ec6...}: {Waiting for response.}  
[main] INFO ROOT - {ceba5ec6...}: {Response received. Status code = '204', Request ID = '8f6ce566-3760-4733-a8da-a090e642286a', Content-MD5 = 'null', ETag = 'W/"datetime'2014-07-08T15%3A07%3A41.1177234Z'"'.}  
[main] INFO ROOT - {ceba5ec6...}: {Processing response headers.}  
[main] INFO ROOT - {ceba5ec6...}: {Response headers were processed successfully.}  
[main] INFO ROOT - {ceba5ec6...}: {Processing response body.}  
[main] INFO ROOT - {ceba5ec6...}: {Response body was parsed successfully.}  
[main] INFO ROOT - {ceba5ec6...}: {Operation completed.}

GUID (ceba5ec6... в примере) — это идентификатор запроса клиента, назначенный операции хранения клиентской библиотекой хранилища.