Rejestrowanie przy użyciu zestawu Azure SDK dla języka Java i 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 artykule Konfigurowanie rejestrowania w zestawie Azure SDK dla języka Java, wszystkie biblioteki klienckie platformy Azure logują się za pośrednictwem protokołu SLF4J, dzięki czemu można używać struktur rejestrowania, takich jak java.util.logging.
Aby włączyć funkcję java.util.logging, należy wykonać dwie czynności:
- Dołącz adapter SLF4J dla pliku java.util.logging jako zależność,
- 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.
Dodawanie zależności narzędzia 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 widocznym 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>
Dodawanie pliku 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 będzie zawierać konfiguracje rejestrowania, aby dostosować potrzeby rejestrowania. Podaj ścieżkę do pliku, ustawiając właściwość systemowa java.util.logging.config.file . Przed utworzeniem wystąpienia rejestratora należy ustawić tę właściwość. Aby uzyskać więcej informacji, zobacz Rejestrowanie języka Java: konfiguracja.
Rejestrowanie 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 rejestruje w konsoli, która nie jest zwykle preferowaną lokalizacją 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 macierzysty (%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 i 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 rejestrowania rozważ przyjrzenie się integracji, które oferuje platforma Azure w strukturach, takich jak Spring i MicroProfile.