Rejestrowanie za pomocą Azure SDK dla języka Java oraz biblioteki java.util.logging

Ten artykuł zawiera omówienie sposobu dodawania rejestrowania przy użyciu polecenia java.util.logging do aplikacji korzystających z Azure SDK dla Java. Struktura java.util.logging jest częścią zestawu JDK. Jak wspomniano w artykule Konfigurowanie rejestrowania w zestawie Azure SDK dla języka Java, wszystkie biblioteki klienckie platformy Azure logują się za pośrednictwem prostej fasady rejestrowania dla języka Java (SLF4J), aby można było używać struktur rejestrowania, takich jak java.util.logging.

Aby włączyć java.util.logging, wykonaj następujące kroki:

1. Dołącz adapter SLF4J dla elementu java.util.logging jako zależność.
2. Utwórz plik o nazwie logging.properties w katalogu projektu /src/main/resources .

Aby uzyskać więcej informacji na temat konfigurowania rejestratora, zobacz Konfigurowanie danych wyjściowych rejestrowania w dokumentacji oracle.

Dodawanie zależności narzędzia Maven dla pliku java.util.logging

Aby dodać zależność narzędzia Maven, dołącz następujący kod XML do pliku pom.xml projektu. Zastąp numer wersji 1.7.30 najnowszym numerem wersji wyświetlonym na stronie powiązania SLF4J JDK14.

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jdk14</artifactId>
    <version>1.7.30</version> <!-- replace this version with the latest available version on Maven central -->
</dependency>

Dodaj plik logging.properties do projektu

Aby zalogować się przy użyciu polecenia java.util.logging, utwórz plik o nazwie logging.properties w katalogu ./src/main/resources projektu lub gdziekolwiek indziej. Ten plik zawiera konfiguracje rejestrowania w celu dostosowania potrzeb rejestrowania. Podaj ścieżkę do pliku, ustawiając właściwość systemowa java.util.logging.config.file . Ustaw tę właściwość przed utworzeniem wystąpienia rejestratora. Aby uzyskać więcej informacji, zobacz Java Logging: Configuration.

Logowanie konsoli

Konfigurację można utworzyć, aby zalogować się do konsoli, jak pokazano w poniższym przykładzie. Ten przykład jest skonfigurowany do rejestrowania wszystkich zdarzeń rejestrowania, które są na poziomie INFO lub wyższym, niezależnie od tego, skąd pochodzą.

handlers = java.util.logging.ConsoleHandler
.level = INFO

java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.SimpleFormatter.format=[%1$tF %1$tH:%1$tM:%1$tS.%1$tL] [%4$s] %3$s %5$s %n

Logowanie do pliku

Poprzedni przykład loguje do konsoli, która zazwyczaj nie jest preferowaną lokalizacją dla dzienników. Aby skonfigurować rejestrowanie w pliku, użyj następującej konfiguracji:

handlers = java.util.logging.FileHandler
.level = INFO

java.util.logging.FileHandler.pattern = %h/myapplication.log
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
java.util.logging.FileHandler.level = INFO

Ten kod tworzy plik o nazwie myapplication.log w katalogu głównym (%h). Ten rejestrator nie obsługuje automatycznego obracania plików po pewnym okresie. Jeśli potrzebujesz tej funkcji, musisz napisać harmonogram zarządzania rotacją plików dziennika.

Następne kroki

W tym artykule opisano konfigurację java.util.logging oraz sposób używania zestawu Azure SDK dla języka Java do rejestrowania. Ponieważ zestaw Azure SDK dla języka Java współpracuje ze wszystkimi strukturami rejestrowania SLF4J, rozważ przejrzenie podręcznika użytkownika SLF4J, aby uzyskać więcej szczegółów.

Gdy opanujesz rejestrowanie, rozważ zapoznanie się z integracjami, które Azure oferuje dla frameworków takich jak Spring.