Spec-Zone .ru
спецификации, руководства, описания, API
|
public class LogRecord extends Object implements Serializable
Когда LogRecord передают в платформу журналирования, это логически принадлежит платформе и больше не должно использоваться или обновлено клиентским приложением.
Отметьте что, если клиентское приложение не определило явное исходное имя метода и источник имя class, то LogRecord class выведет их автоматически, когда к ним сначала получат доступ (из-за запроса getSourceMethodName или getSourceClassName), анализируя стек вызовов. Поэтому, если Обработчик журналирования хочет выдать LogRecord к другому потоку, или передать его по RMI, и если он хочет впоследствии получить имя метода или информацию об имени class, он должен вызвать один из getSourceClassName или getSourceMethodName, чтобы вынудить значения быть заполненными в.
Примечания сериализации:
Конструктор и Описание |
---|
LogRecord(Level level, String msg)
Создайте LogRecord с данным уровнем и значениями сообщения.
|
Модификатор и Тип | Метод и Описание |
---|---|
Уровень |
getLevel()
Получите уровень сообщения журналирования, например Уровень. СЕРЬЕЗНЫЙ.
|
Строка |
getLoggerName()
Получите исходное имя Регистратора.
|
Строка |
getMessage()
Получите "необработанное" сообщение журнала перед локализацией или форматированием.
|
long |
getMillis()
Получите время события в миллисекундах с 1970.
|
Объект[] |
getParameters()
Получите параметры к сообщению журнала.
|
ResourceBundle |
getResourceBundle()
Получите пакет ресурса локализации
|
Строка |
getResourceBundleName()
Получите имя пакета ресурса локализации
|
long |
getSequenceNumber()
Получите порядковый номер.
|
Строка |
getSourceClassName()
Получите имя class, который (предположительно) выпустил запрос журналирования.
|
Строка |
getSourceMethodName()
Получите имя метода, который (предположительно) выпустил запрос журналирования.
|
int |
getThreadID()
Получите идентификатор для потока где порожденное сообщение.
|
Throwable |
getThrown()
Получите любой throwable, связанный с записью журнала.
|
void |
setLevel(Level level)
Установите уровень сообщения журналирования, например Уровень. СЕРЬЕЗНЫЙ.
|
void |
setLoggerName(String name)
Определите исходное имя Регистратора.
|
void |
setMessage(String message)
Установите "необработанное" сообщение журнала перед локализацией или форматированием.
|
void |
setMillis(long millis)
Время события набора.
|
void |
setParameters(Object[] parameters)
Установите параметры к сообщению журнала.
|
void |
setResourceBundle(ResourceBundle bundle)
Установите пакет ресурса локализации.
|
void |
setResourceBundleName(String name)
Определите имя пакета ресурса локализации.
|
void |
setSequenceNumber(long seq)
Установите порядковый номер.
|
void |
setSourceClassName(String sourceClassName)
Определите имя class, который (предположительно) выпустил запрос журналирования.
|
void |
setSourceMethodName(String sourceMethodName)
Определите имя метода, который (предположительно) выпустил запрос журналирования.
|
void |
setThreadID(int threadID)
Установите идентификатор для потока где порожденное сообщение.
|
void |
setThrown(Throwable thrown)
Установите throwable, связанный с событием журнала.
|
public LogRecord(Level level, String msg)
Свойство последовательности будет инициализировано с новым уникальным значением. Эти значения последовательности выделяются в увеличивающемся порядке в пределах VM.
millis свойство будет инициализировано к текущему времени.
Свойство ID потока будет инициализировано с уникальным ID для текущего потока.
Все другие свойства будут инициализированы к "нулю".
level
- значение уровня журналированияmsg
- сырые данные, нелокализованные, регистрируя сообщение (может быть нуль),public String getLoggerName()
public void setLoggerName(String name)
name
- исходное имя регистратора (может быть нуль),public ResourceBundle getResourceBundle()
Это - ResourceBundle, который должен использоваться, чтобы локализовать строку сообщения прежде, чем отформатировать это. Результатом может быть нуль, если сообщение не локализуемо, или если никакой подходящий ResourceBundle не доступен.
public void setResourceBundle(ResourceBundle bundle)
bundle
- пакет локализации (может быть нуль),public String getResourceBundleName()
Это - имя для ResourceBundle, который должен использоваться, чтобы локализовать строку сообщения прежде, чем отформатировать его. Результатом может быть нуль, если сообщение не локализуемо.
public void setResourceBundleName(String name)
name
- имя пакета локализации (может быть нуль),public Level getLevel()
public void setLevel(Level level)
level
- уровень сообщения журналированияpublic long getSequenceNumber()
Порядковые номера обычно присваиваются в конструкторе LogRecord, который присваивает уникальные порядковые номера каждому новому LogRecord в увеличивающемся порядке.
public void setSequenceNumber(long seq)
Порядковые номера обычно присваиваются в конструкторе LogRecord, таким образом, не должно обычно быть необходимо использовать этот метод.
public String getSourceClassName()
Отметьте, что этот sourceClassName не проверяется и может имитироваться. Эта информация, возможно, или была предоставлена как часть вызова журналирования, или это, возможно, было выведено автоматически платформой журналирования. В последнем случае информация может только быть приблизительной и может фактически описать более ранний запрос к стековому фрейму.
Может быть нуль, если никакая информация не могла бы быть получена.
public void setSourceClassName(String sourceClassName)
sourceClassName
- исходное имя class (может быть нуль),public String getSourceMethodName()
Отметьте, что этот sourceMethodName не проверяется и может имитироваться. Эта информация, возможно, или была предоставлена как часть вызова журналирования, или это, возможно, было выведено автоматически платформой журналирования. В последнем случае информация может только быть приблизительной и может фактически описать более ранний запрос к стековому фрейму.
Может быть нуль, если никакая информация не могла бы быть получена.
public void setSourceMethodName(String sourceMethodName)
sourceMethodName
- исходное имя метода (может быть нуль),public String getMessage()
Может быть нуль, который эквивалентен пустой строке "".
Это сообщение может быть или заключительным текстом или ключом локализации.
Во время форматирования, если у исходного регистратора есть локализация ResourceBundle и если, что у ResourceBundle есть запись для этой строки сообщения, тогда строка сообщения заменяется локализованным значением.
public void setMessage(String message)
message
- необработанная строка сообщения (может быть нуль),public Object[] getParameters()
public void setParameters(Object[] parameters)
parameters
- параметры сообщения журнала. (может быть нуль),public int getThreadID()
Это - идентификатор потока в пределах Java VM, и можете, или, возможно, не отображается ни на какой ID операционной системы.
public void setThreadID(int threadID)
threadID
- ID потокаpublic long getMillis()
public void setMillis(long millis)
millis
- время события в millis с 1970public Throwable getThrown()
Если событие, включенное исключение, это будет объектом исключения. Иначе нуль.
public void setThrown(Throwable thrown)
thrown
- throwable (может быть нуль),
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92