Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Logger extends Object
Объекты регистратора могут быть получены запросами к одному из getLogger методов фабрики. Они или создадут новый Регистратор или возвратят подходящий существующий Регистратор. Важно отметить что Регистратор, возвращенный одним из getLogger
методы фабрики могут быть собраны "мусор" в любое время, если ссылка strong на Регистратор не сохраняется.
Журналирование сообщений будет передано зарегистрированным Объектам-обработчикам, которые могут передать сообщения ко множеству мест назначения, включая консоли, файлы, журналы ОС, и т.д.
Каждый Регистратор отслеживает "родительский" Регистратор, который является его самым близким существующим предком в пространстве имен Регистратора.
Каждому Регистратору связали "Уровень" с этим. Это отражает минимальный уровень, о котором заботится этот регистратор. Если уровень Регистратора устанавливается в null, то его эффективный уровень наследован от его родителя, который может поочередно получить это рекурсивно из его родителя, и так далее дерево.
Уровень журнала может быть сконфигурирован основанный на свойствах от конфигурационного файла журналирования, как описано в описании LogManager class. Однако это может также быть динамически изменено запросами к методу Logger.setLevel. Если уровень регистратора изменяется, изменение может также влиять на дочерние регистраторы, так как любой дочерний регистратор, у которого есть null как его уровень, наследует свой эффективный уровень от его родителя.
На каждом вызове журналирования Регистратор первоначально выполняет дешевую проверку уровня запроса (например, СЕРЬЕЗНЫЙ или ПРЕКРАСНЫЙ) против эффективного уровня журнала регистратора. Если уровень запроса ниже чем уровень журнала, вызов журналирования сразу возвращается.
После передачи этого начального (дешевого) теста Регистратор выделит LogRecord, чтобы описать сообщение журналирования. Это тогда вызовет Фильтр (если есть), чтобы сделать, более подробное начинает работу, должна ли запись быть опубликована. Если это передаст это, то тогда опубликует LogRecord к его выходным Обработчикам. По умолчанию регистраторы также публикуют к Обработчикам их родителя, рекурсивно дерево.
Каждый Регистратор может сделать, чтобы ResourceBundle назвал связанным с этим. Именованный пакет будет использоваться для того, чтобы локализовать сообщения журналирования. Если Регистратор не сделает, чтобы его собственный ResourceBundle назвал, то он наследует имя ResourceBundle от своего родителя, рекурсивно дерево.
Большинство выходных методов регистратора берет параметр "сообщения". Этим параметром сообщения может быть или необработанное значение или ключ локализации. Во время форматирования, если регистратор имеет (или наследовался), ResourceBundle локализации и если у ResourceBundle есть отображение для строки сообщения, то строка сообщения заменяется локализованным значением. Иначе исходная строка сообщения используется. Как правило, средства форматирования используют java.text. Форматирование стиля MessageFormat, чтобы отформатировать параметры, таким образом, например строка формата" {0} {1}" отформатировала бы два параметра как строки.
Ряд методов альтернативно берет "msgSupplier" вместо параметра "сообщения". Эти методы берут a Supplier
<String>
функция, которая вызывается, чтобы создать требуемое сообщение журнала только, когда сообщение фактически должно быть зарегистрировано основанное на эффективном уровне журнала, таким образом устраняющем ненужную конструкцию сообщения. Например, если бы разработчик хочет зарегистрировать системное состояние здоровья для диагноза с Принимающей строку версией, код был бы похож:
class DiagnosisMessages {
static String systemHealthStatus() {
// collect system health information
...
}
}
...
logger.log(Level.FINER, DiagnosisMessages.systemHealthStatus());
С вышеупомянутым кодом состояние здоровья собирается излишне, даже когда БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала отключается. С Принимающей поставщика версией как ниже, будет только собрано состояние, когда БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала будет включен.
logger.log(Level.FINER, DiagnosisMessages::systemHealthStatus);
Отображая имена ResourceBundle к ResourceBundles, Регистратор сначала попытается использовать ContextClassLoader Потока. Если это будет нулем, то он попробует системный ClassLoder вместо этого.
Форматирование (включая локализацию) является ответственностью выходного Обработчика, который будет обычно вызывать Средство форматирования.
Отметьте, что форматирование не должно произойти синхронно. Это может быть задержано, пока LogRecord фактически не пишется внешнему приемнику.
Методы журналирования группируются в пяти основных категориях:
Есть ряд методов "журнала", которые берут уровень журнала, строку сообщения, и дополнительно некоторые параметры к строке сообщения.
Есть ряд "logp" методы (для "журнала, точного"), которые походят на методы "журнала", но также и берут явный источник имя class и имя метода.
Есть ряд "logrb" метод (для "журнала с пакетом ресурса"), которые походят на "logp" метод, но также и берут явное имя пакета ресурса для использования в локализации сообщения журнала.
Есть методы удобства для того, чтобы проследить записи метода ("входящие" методы), возвраты метода ("выходящие" методы) и выдать исключения (методы "броска").
Наконец, есть ряд методов удобства для использования в очень самых простых случаях, когда разработчик просто хочет зарегистрировать простую строку на данном уровне журнала. Эти методы называют в честь имен стандартного уровня ("серьезными", "предупреждение", "информация", и т.д.) и берут единственный параметр, строку сообщения.
Для методов, которые не берут явное исходное имя и имя метода, платформа Журналирования сделает "максимальные усилия", чтобы определить который class и метод, вызванный в метод журналирования. Однако, важно понять, что эта автоматически выведенная информация может только быть приблизительной (или может даже быть вполне неправильным!). Виртуальным машинам позволяют сделать обширную оптимизацию, когда JITing и может полностью удалить стековые фреймы, лишая возможности достоверно определять местоположение вызова class и метод.
Все методы на Регистраторе мультиориентированы на многопотоковое исполнение.
Разделение на подклассы информации: Отметьте, что LogManager class может обеспечить свою собственную реализацию именованных Регистраторов для любой точки в пространстве имен. Поэтому, любые подклассы Регистратора (если они не реализуются в соединении с новым LogManager class) должны заботиться, чтобы получить экземпляр Регистратора из LogManager class и должны делегировать операции, такие как "isLoggable" и "журнал (Запись журнала)" к тому экземпляру. Отметьте, что, чтобы прервать весь вывод журналирования, подклассы должны только переопределить журнал (Запись журнала) метод. Все другие методы журналирования реализуются как запросы к этому журналу (Запись журнала) метод.
Модификатор и Тип | Поле и Описание |
---|---|
static Logger |
глобальная переменная
Осуждаемый.
Инициализация этого поля является склонной к мертвым блокировкам. Поле должно быть инициализировано Регистратором инициализация class, которая может вызвать мертвые блокировки с LogManager инициализация class. В таких случаях две инициализации class ожидают друг друга, чтобы завершиться. Привилегированный способ получить глобальный объект регистратора через вызов
Logger.getGlobal() . Для совместимости со старыми версиями JDK, где Logger.getGlobal() не доступное использование вызов Logger.getLogger(Logger.GLOBAL_LOGGER_NAME) или Logger.getLogger("global") . |
static String |
GLOBAL_LOGGER_NAME
GLOBAL_LOGGER_NAME является именем для глобального регистратора.
|
Модификатор | Конструктор и Описание |
---|---|
protected |
Logger(String name, String resourceBundleName)
Защищенный метод, чтобы создать регистратор для именованной подсистемы.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
addHandler(Handler handler)
Добавьте Обработчик журнала, чтобы получить сообщения журналирования.
|
void |
config(String msg)
Зарегистрируйте сообщение КОНФИГУРАЦИИ.
|
void |
config(Supplier<String> msgSupplier)
Зарегистрируйте сообщение КОНФИГУРАЦИИ, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
void |
entering(String sourceClass, String sourceMethod)
Зарегистрируйте запись метода.
|
void |
entering(String sourceClass, String sourceMethod, Object param1)
Зарегистрируйте запись метода с одним параметром.
|
void |
entering(String sourceClass, String sourceMethod, Object[] params)
Зарегистрируйте запись метода с массивом параметров.
|
void |
exiting(String sourceClass, String sourceMethod)
Зарегистрируйте возврат метода.
|
void |
exiting(String sourceClass, String sourceMethod, Object result)
Зарегистрируйте возврат метода с объектом результата.
|
void |
fine(String msg)
Зарегистрируйте ПРЕКРАСНОЕ сообщение.
|
void |
fine(Supplier<String> msgSupplier)
Зарегистрируйте ПРЕКРАСНОЕ сообщение, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
void |
finer(String msg)
Зарегистрируйте БОЛЕЕ ПРЕКРАСНОЕ сообщение.
|
void |
finer(Supplier<String> msgSupplier)
Зарегистрируйте БОЛЕЕ ПРЕКРАСНОЕ сообщение, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
void |
finest(String msg)
Зарегистрируйте САМОЕ ПРЕКРАСНОЕ сообщение.
|
void |
finest(Supplier<String> msgSupplier)
Зарегистрируйте САМОЕ ПРЕКРАСНОЕ сообщение, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
static Logger |
getAnonymousLogger()
Создайте анонимный Регистратор.
|
static Logger |
getAnonymousLogger(String resourceBundleName)
Создайте анонимный Регистратор.
|
Фильтр |
getFilter()
Получите текущий фильтр для этого Регистратора.
|
static Logger |
getGlobal()
Возвратите глобальный объект регистратора с Регистратором имени. GLOBAL_LOGGER_NAME.
|
Обработчик[] |
getHandlers()
Свяжите Обработчики с этим регистратором.
|
Уровень |
getLevel()
Получите Уровень журнала, который был определен для этого Регистратора.
|
static Logger |
getLogger(String name)
Найдите или создайте регистратор для именованной подсистемы.
|
static Logger |
getLogger(String name, String resourceBundleName)
Найдите или создайте регистратор для именованной подсистемы.
|
Строка |
getName()
Завоюйте репутацию для этого регистратора.
|
Регистратор |
getParent()
Возвратите родителя для этого Регистратора.
|
ResourceBundle |
getResourceBundle()
Получите пакет ресурса локализации для этого регистратора для текущей локали значения по умолчанию.
|
Строка |
getResourceBundleName()
Получите имя пакета ресурса локализации для этого регистратора.
|
boolean |
getUseParentHandlers()
Обнаружьте, отправляет ли этот регистратор свой вывод его родительскому регистратору.
|
void |
info(String msg)
Зарегистрируйте сообщение ИНФОРМАЦИИ.
|
void |
info(Supplier<String> msgSupplier)
Зарегистрируйте сообщение ИНФОРМАЦИИ, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
boolean |
isLoggable(Level level)
Проверьте, было ли сообщение данного уровня бы фактически зарегистрировано этим регистратором.
|
void |
log(Level level, String msg)
Зарегистрируйте сообщение без параметров.
|
void |
log(Level level, String msg, Object param1)
Зарегистрируйте сообщение с одним объектным параметром.
|
void |
log(Level level, String msg, Object[] params)
Зарегистрируйте сообщение с массивом объектных параметров.
|
void |
log(Level level, String msg, Throwable thrown)
Зарегистрируйте сообщение со связанной информацией о Throwable.
|
void |
log(Level level, Supplier<String> msgSupplier)
Зарегистрируйте сообщение, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
void |
log(Level level, Throwable thrown, Supplier<String> msgSupplier)
Зарегистрируйте лениво созданное сообщение со связанной информацией о Throwable.
|
void |
log(LogRecord record)
Зарегистрируйте LogRecord.
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg)
Зарегистрируйте сообщение, определяя источник class и метод, без параметров.
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)
Зарегистрируйте сообщение, определяя источник class и метод, с единственным объектным параметром к сообщению журнала.
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)
Зарегистрируйте сообщение, определяя источник class и метод, с массивом объектных параметров.
|
void |
logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)
Зарегистрируйте сообщение, определяя источник class и метод, со связанной информацией о Throwable.
|
void |
logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier)
Зарегистрируйте лениво созданное сообщение, определяя источник class и метод, без параметров.
|
void |
logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier)
Зарегистрируйте лениво созданное сообщение, определяя источник class и метод, со связанной информацией о Throwable.
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)
Зарегистрируйте сообщение, определяя источник class, метод, и имя пакета ресурса без параметров.
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)
Зарегистрируйте сообщение, определяя источник class, метод, и имя пакета ресурса, с единственным объектным параметром к сообщению журнала.
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)
Зарегистрируйте сообщение, определяя источник class, метод, и имя пакета ресурса, с массивом объектных параметров.
|
void |
logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)
Зарегистрируйте сообщение, определяя источник class, метод, и имя пакета ресурса, со связанной информацией о Throwable.
|
void |
removeHandler(Handler handler)
Удалите Обработчик журнала.
|
void |
setFilter(Filter newFilter)
Установите фильтр, чтобы управлять выводом на этом Регистраторе.
|
void |
setLevel(Level newLevel)
Установите уровень журнала, определяющий, какие уровни сообщения будут зарегистрированы этим регистратором.
|
void |
setParent(Logger parent)
Установите родителя для этого Регистратора.
|
void |
setUseParentHandlers(boolean useParentHandlers)
Определите, должен ли этот регистратор отправить свой вывод его родительскому Регистратору.
|
void |
severe(String msg)
Зарегистрируйте СЕРЬЕЗНОЕ сообщение.
|
void |
severe(Supplier<String> msgSupplier)
Зарегистрируйте СЕРЬЕЗНОЕ сообщение, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
void |
throwing(String sourceClass, String sourceMethod, Throwable thrown)
Журнал, выдающий исключение.
|
void |
warning(String msg)
Зарегистрируйте Предупреждающее сообщение.
|
void |
warning(Supplier<String> msgSupplier)
Зарегистрируйте Предупреждающее сообщение, которое является только, чтобы быть созданным, если уровень журналирования будет так, что сообщением, то будет фактически зарегистрирован.
|
public static final String GLOBAL_LOGGER_NAME
@Deprecated public static final Logger global
Logger.getGlobal()
. Для совместимости со старыми версиями JDK, где Logger.getGlobal()
не доступное использование вызов Logger.getLogger(Logger.GLOBAL_LOGGER_NAME)
или Logger.getLogger("global")
.protected Logger(String name, String resourceBundleName)
Регистратор будет первоначально сконфигурирован с нулевым Уровнем и с набором useParentHandlers к истине.
name
- Имя для регистратора. Это должно быть разделенным от точки именем и должно обычно быть основано на имени пакета или имени class подсистемы, такой как java.net или javax.swing. Это может быть нуль для анонимных Регистраторов.resourceBundleName
- имя ResourceBundle, который будет использоваться для того, чтобы локализовать сообщения для этого регистратора. Может быть нуль, если ни одно из сообщений не требует локализации.MissingResourceException
- если resourceBundleName является ненулем, и никакой соответствующий ресурс не может быть найден.public static final Logger getGlobal()
public static Logger getLogger(String name)
Если новый регистратор будет создаваться, то его уровень журнала будет сконфигурирован основанный на конфигурации LogManager, и это будет сконфигурированный, чтобы также отправить вывод журналирования Обработчикам его родителя. Это будет зарегистрировано в глобальном пространстве имен LogManager.
Отметьте: LogManager может только сохранить слабую ссылку на недавно создаваемый Регистратор. Важно понять, что ранее создаваемый Регистратор с именем может быть собран "мусор" в любое время, если нет никакой ссылки strong на Регистратор. В частности это означает что два компенсационных вызова как getLogger("MyLogger").log(...)
может использовать различные объекты Регистратора по имени "MyLogger", если нет никакой ссылки strong на Регистратор по имени "MyLogger" в другом месте в программе.
name
- Имя для регистратора. Это должно быть разделенным от точки именем и должно обычно быть основано на имени пакета или имени class подсистемы, такой как java.net или javax.swingNullPointerException
- если имя является нулем.public static Logger getLogger(String name, String resourceBundleName)
Если новый регистратор будет создаваться, то его уровень журнала будет сконфигурирован основанный на LogManager, и это будет сконфигурированный, чтобы также отправить вывод журналирования Обработчикам его родителя. Это будет зарегистрировано в глобальном пространстве имен LogManager.
Отметьте: LogManager может только сохранить слабую ссылку на недавно создаваемый Регистратор. Важно понять, что ранее создаваемый Регистратор с именем может быть собран "мусор" в любое время, если нет никакой ссылки strong на Регистратор. В частности это означает что два компенсационных вызова как getLogger("MyLogger", ...).log(...)
может использовать различные объекты Регистратора по имени "MyLogger", если нет никакой ссылки strong на Регистратор по имени "MyLogger" в другом месте в программе.
Если именованный Регистратор уже существует и еще не имеет пакета ресурса локализации тогда, данное имя пакета ресурса используется. Если именованный Регистратор уже существует и имеет различное имя пакета ресурса тогда, IllegalArgumentException бросается.
name
- Имя для регистратора. Это должно быть разделенным от точки именем и должно обычно быть основано на имени пакета или имени class подсистемы, такой как java.net или javax.swingresourceBundleName
- имя ResourceBundle, который будет использоваться для того, чтобы локализовать сообщения для этого регистратора. Может быть null
если ни одно из сообщений не требует локализации.MissingResourceException
- если resourceBundleName является ненулем, и никакой соответствующий ресурс не может быть найден.IllegalArgumentException
- если Регистратор уже существует и использует различное имя пакета ресурса.NullPointerException
- если имя является нулем.public static Logger getAnonymousLogger()
Этот метод фабрики прежде всего предназначается для использования от апплетов. Поскольку получающийся Регистратор является анонимным, это может быть сохранено частным созданием class. Это устраняет потребность для нормальных проверок безопасности, которая поочередно позволяет недоверяемому коду апплета обновлять состояние управления Регистратора. Например апплет может сделать setLevel или addHandler на анонимном Регистраторе.
Даже если новый регистратор является анонимным, он конфигурируется, чтобы иметь корневой регистратор ("") как его родитель. Это означает, что по умолчанию наследовало свой эффективный уровень и обработчики от корневого регистратора.
public static Logger getAnonymousLogger(String resourceBundleName)
Этот метод фабрики прежде всего предназначается для использования от апплетов. Поскольку получающийся Регистратор является анонимным, это может быть сохранено частным созданием class. Это устраняет потребность для нормальных проверок безопасности, которая поочередно позволяет недоверяемому коду апплета обновлять состояние управления Регистратора. Например апплет может сделать setLevel или addHandler на анонимном Регистраторе.
Даже если новый регистратор является анонимным, он конфигурируется, чтобы иметь корневой регистратор ("") как его родитель. Это означает, что по умолчанию наследовало свой эффективный уровень и обработчики от корневого регистратора.
resourceBundleName
- имя ResourceBundle, который будет использоваться для того, чтобы локализовать сообщения для этого регистратора. Может быть нуль, если ни одно из сообщений не требует локализации.MissingResourceException
- если resourceBundleName является ненулем, и никакой соответствующий ресурс не может быть найден.public ResourceBundle getResourceBundle()
public String getResourceBundleName()
public void setFilter(Filter newFilter) throws SecurityException
После передачи начальной проверки "уровня" Регистратор вызовет этот Фильтр, чтобы проверить, должна ли запись журнала действительно быть опубликована.
newFilter
- объект фильтра (может быть нуль),SecurityException
- если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.public Filter getFilter()
public void log(LogRecord record)
Все другие методы журналирования в этом class вызывают через этот метод, чтобы фактически выполнить любое журналирование. Подклассы могут переопределить этот единственный метод, чтобы получить все действие журнала.
record
- LogRecord, который будет опубликованpublic void log(Level level, String msg)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙmsg
- Строковое сообщение (или ключ в каталоге сообщений)public void log(Level level, Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙmsgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void log(Level level, String msg, Object param1)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙmsg
- Строковое сообщение (или ключ в каталоге сообщений)param1
- параметр к сообщениюpublic void log(Level level, String msg, Object[] params)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙmsg
- Строковое сообщение (или ключ в каталоге сообщений)params
- массив параметров к сообщениюpublic void log(Level level, String msg, Throwable thrown)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам.
Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом это обрабатывается особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙmsg
- Строковое сообщение (или ключ в каталоге сообщений)thrown
- Throwable связался с сообщением журнала.public void log(Level level, Throwable thrown, Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика. Сообщение и данный Throwable
тогда сохранены в a LogRecord
который передается всем зарегистрированным выходным обработчикам.
Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом это обрабатывается особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙthrown
- Throwable связался с сообщением журнала.msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void logp(Level level, String sourceClass, String sourceMethod, String msg)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияmsg
- Строковое сообщение (или ключ в каталоге сообщений)public void logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияmsgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияmsg
- Строковое сообщение (или ключ в каталоге сообщений)param1
- Параметр к сообщению журнала.public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияmsg
- Строковое сообщение (или ключ в каталоге сообщений)params
- Массив параметров к сообщениюpublic void logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам.
Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом это обрабатывается особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияmsg
- Строковое сообщение (или ключ в каталоге сообщений)thrown
- Throwable связался с сообщением журнала.public void logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика. Сообщение и данный Throwable
тогда сохранены в a LogRecord
который передается всем зарегистрированным выходным обработчикам.
Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом это обрабатывается особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияthrown
- Throwable связался с сообщением журнала.msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияbundleName
- имя пакета ресурса, чтобы локализовать сообщение, может быть нульmsg
- Строковое сообщение (или ключ в каталоге сообщений)public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияbundleName
- имя пакета ресурса, чтобы локализовать сообщение, может быть нульmsg
- Строковое сообщение (или ключ в каталоге сообщений)param1
- Параметр к сообщению журнала.public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияbundleName
- имя пакета ресурса, чтобы локализовать сообщение, может быть нуль.msg
- Строковое сообщение (или ключ в каталоге сообщений)params
- Массив параметров к сообщениюpublic void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам.
Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом это обрабатывается особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
level
- Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙsourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который выпустил запрос журналированияbundleName
- имя пакета ресурса, чтобы локализовать сообщение, может быть нульmsg
- Строковое сообщение (или ключ в каталоге сообщений)thrown
- Throwable связался с сообщением журнала.public void entering(String sourceClass, String sourceMethod)
Это - метод удобства, который может использоваться, чтобы зарегистрировать запись в метод. LogRecord с сообщением "ЗАПИСЬ", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod и sourceClass регистрируется.
sourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который вводитсяpublic void entering(String sourceClass, String sourceMethod, Object param1)
Это - метод удобства, который может использоваться, чтобы зарегистрировать запись в метод. LogRecord с сообщением "ЗАПИСЬ {0}", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod, sourceClass, и параметр регистрируется.
sourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который вводитсяparam1
- параметр к вводимому методуpublic void entering(String sourceClass, String sourceMethod, Object[] params)
Это - метод удобства, который может использоваться, чтобы зарегистрировать запись в метод. Регистрируется LogRecord с сообщением "ЗАПИСЬ" (сопровождаемый индикатором формата {N} для каждой записи в массиве параметра), БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod, sourceClass, и параметры.
sourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода, который вводитсяparams
- массив параметров к вводимому методуpublic void exiting(String sourceClass, String sourceMethod)
Это - метод удобства, который может использоваться, чтобы зарегистрировать возврат из метода. LogRecord с сообщением "ВОЗВРАТ", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod и sourceClass регистрируется.
sourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя методаpublic void exiting(String sourceClass, String sourceMethod, Object result)
Это - метод удобства, который может использоваться, чтобы зарегистрировать возврат из метода. LogRecord с сообщением "ВОЗВРАТ {0}", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и давание sourceMethod, sourceClass, и объект результата регистрируется.
sourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя методаresult
- Объект, который возвращаетсяpublic void throwing(String sourceClass, String sourceMethod, Throwable thrown)
Это - метод удобства, чтобы зарегистрировать это, метод завершается, выдавая исключение. Журналирование делается, используя БОЛЕЕ ПРЕКРАСНЫЙ уровень.
Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам. Сообщение LogRecord устанавливается "БРОСИТЬ".
Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом это обрабатывается особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
sourceClass
- имя class, который выпустил запрос журналированияsourceMethod
- имя метода.thrown
- Throwable, который бросается.public void severe(String msg)
Если регистратор в настоящий момент включается для СЕРЬЕЗНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void warning(String msg)
Если регистратор в настоящий момент включается для уровня Предупреждающего сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void info(String msg)
Если регистратор в настоящий момент включается для уровня сообщения ИНФОРМАЦИИ тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void config(String msg)
Если регистратор в настоящий момент включается для уровня сообщения КОНФИГУРАЦИИ тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void fine(String msg)
Если регистратор в настоящий момент включается для ПРЕКРАСНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void finer(String msg)
Если регистратор в настоящий момент включается для БОЛЕЕ ПРЕКРАСНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void finest(String msg)
Если регистратор в настоящий момент включается для САМОГО ПРЕКРАСНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
msg
- Строковое сообщение (или ключ в каталоге сообщений)public void severe(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для СЕРЬЕЗНОГО уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void warning(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для уровня Предупреждающего сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void info(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для уровня сообщения ИНФОРМАЦИИ тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void config(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для уровня сообщения КОНФИГУРАЦИИ тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void fine(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для ПРЕКРАСНОГО уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void finer(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для БОЛЕЕ ПРЕКРАСНОГО уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void finest(Supplier<String> msgSupplier)
Если регистратор в настоящий момент включается для САМОГО ПРЕКРАСНОГО уровня сообщения тогда, сообщение создается, вызывая обеспеченную функцию поставщика и передается ко всем зарегистрированным выходным Объектам-обработчикам.
msgSupplier
- Функция, который когда вызвано, производит требуемое сообщение журналаpublic void setLevel(Level newLevel) throws SecurityException
Если новый уровень является нулем, это означает, что этот узел должен наследовать свой уровень от его самого близкого предка с определенным (ненулевым) значением уровня.
newLevel
- новое значение для уровня журнала (может быть нуль),SecurityException
- если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.public Level getLevel()
public boolean isLoggable(Level level)
level
- сообщение, регистрирующее уровеньpublic String getName()
public void addHandler(Handler handler) throws SecurityException
По умолчанию Регистраторы также отправляют свой вывод их родительскому регистратору. Обычно корневой Регистратор конфигурируется с рядом Обработчиков, которые по существу действуют как обработчики значения по умолчанию для всех регистраторов.
handler
- Обработчик журналированияSecurityException
- если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.public void removeHandler(Handler handler) throws SecurityException
Возвраты тихо, если данный Обработчик не находится или является нулем
handler
- Обработчик журналированияSecurityException
- если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.public Handler[] getHandlers()
public void setUseParentHandlers(boolean useParentHandlers)
useParentHandlers
- истина, если вывод должен быть отправлен родителю регистратора.SecurityException
- если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.public boolean getUseParentHandlers()
public Logger getParent()
Этот метод возвращает самого близкого существующего родителя в пространстве имен. Таким образом, если Регистратор вызовут "a.b.c.d", и Регистратор, названный "a.b", был создан, но никакой регистратор "a.b.c" существует, то вызов getParent на Регистраторе "a.b.c.d" возвратит Регистратор "a.b".
Результатом будет нуль, если это вызовут на корневом Регистраторе в пространстве имен.
public void setParent(Logger parent)
Это нельзя вызвать от кода программы.
parent
- новый родительский регистраторSecurityException
- если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92