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 języka java.util.logging do aplikacji korzystających z zestawu Azure SDK dla języka Java. Struktura java.util.logging jest częścią zestawu JDK. Jak wspomniano w Konfigurowanie rejestrowania w zestawie Azure SDK dla języka Java, wszystkie biblioteki klienckie platformy Azure rejestrują się przez SLF4J, więc można używać frameworków logujących, takich jak java.util.logging.

Aby włączyć funkcję java.util.logging, należy wykonać dwie czynności:

1. Dołącz adapter SLF4J dla 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 dotyczących konfigurowania rejestratora, zobacz Konfigurowanie danych wyjściowych rejestrowania w dokumentacji Oracle.

Dodaj zależność Maven

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 java.util.logging, utwórz plik o nazwie logging.properties w ./src/main/resources katalogu projektu lub gdziekolwiek indziej. Ten plik będzie zawierać konfiguracje rejestrowania, aby dostosować je do swoich potrzeb. Podaj ścieżkę do pliku, ustawiając właściwość systemu java.util.logging.config.file. Przed utworzeniem wystąpienia rejestratora należy ustawić tę właściwość. 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 utworzy plik o nazwie myapplication.log w katalogu głównym (%h). Ten rejestrator nie obsługuje automatycznego obracania plików po pewnym okresie. Jeśli ta funkcja jest wymagana, musisz napisać harmonogram w celu 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.

Po opanowaniu logowania, rozważ przyjrzenie się integracjom, które platforma Azure oferuje w ramach takich jak Spring i MicroProfile.