Journalisation côté client avec la bibliothèque cliente Stockage Azure pour Java

  • Article

Pour obtenir des instructions sur l’installation des fichiers binaires pour les bibliothèques clientes stockage Azure dans votre projet Java, consultez le fichier lisez-moi du projet sur GitHub : https://github.com/Azure/azure-storage-java. Ce fichier répertorie les dépendances supplémentaires que vous devez installer.

Vous devez installer la dépendance SLF4J facultative si vous prévoyez d'utiliser la journalisation côté client. SLF4J est une façade de journalisation qui vous permet d’utiliser facilement de nombreuses infrastructures de journalisation Java courantes à partir d’une application cliente : pour plus d’informations sur SLF4J, consultez le manuel de l’utilisateur SLF4J. Pour un test simple de l’utilisation de SLF4J avec le Kit de développement logiciel (SDK) de stockage, placez les fichiers JAR slf4j-api et slf4j-simple dans le chemin de build de votre projet client de stockage. Tous les messages du journal de stockage sont ensuite dirigés vers la console.

L'exemple de code Java suivant montre comment désactiver la journalisation du client de stockage par défaut en appelant la méthode statique setLoggingEnabledByDefault, puis en utilisant un objet OperationContext afin d'activer la journalisation pour une demande spécifique :

// 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);

L’exemple suivant montre les messages de journal que slf4j-simple écrit dans la console :

[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.}

Le GUID (ceba5ec6... dans l’exemple) est l’ID de demande client attribué à l’opération de stockage par la bibliothèque de stockage côté client.