java.util.logging.Handler
java.util.logging.StreamHandler
java.util.logging.FileHandler
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public class FileHandler
단순 파일의 로깅 Handler 입니다.
FileHandler에 서는 지정된 파일, 또는 파일의 로테이션 세트의 어느 쪽인가에 출력할 수 있습니다 .
파일의 로테이션 세트의 경우, 각 파일이 지정된 사이즈의 한도에 도달하면, 그 파일이 닫혀져 교환해 새로운 파일이 열립니다. 다음에 0, 1, 2 등을 기본 파일명에 추가해, 구파일에 이름을 붙입니다.
디폴트로 버퍼링은 입출력 라이브러리에서 사용 가능하지만, 각 로그 레코드는 완료시에 플래시 됩니다.
디폴트로XMLFormatter 클래스는 포맷 처리에 사용됩니다.
구성: 디폴트로 각 FileHandler는 다음에 나타내는 LogManager 구성 프로퍼티를 사용해 초기화됩니다. 프로퍼티가 미정도리의 경우 (또는 무효인 값을 가지는 경우), 지정된 디폴트의 값이 사용됩니다.
패턴은 실행시로 옮겨지는 다음의 특수 컴퍼넌트를 포함한 캐릭터 라인으로부터 구성됩니다.
이와 같이, 예를 들어 카운트 2를 가지는 패턴? t/java%g.log운? 고견? A로그 파일을 Solaris인 경우는 /var/tmp/java0.log와 /var/tmp/java1.log 에 Windows 95인 경우는 C:\TEMP\java0.log와 C:\TEMP\java1.log에 각각 출력합니다.
생성 번호는 0, 1, 2와 같은 연속 번호가 됩니다.
보통, 일의의 필드 "%u"는 0 으로 설정됩니다. 다만, FileHandler가 파일명을 열려고 해, 파일이 현재 다른 프로세스에 의해 사용중인 것을 알 수 있었을 경우, 일의의 번호 필드를 증가해 한번 더 시행합니다. 이것은 FileHandler가 현재 사용되어 있지 않은 파일명을 검출할 때까지 반복해집니다. 충돌이 있어,"%u" 필드가 지정되지 않는 경우, 파일명의 말미의 닷의 뒤로 추가됩니다. 이것은 자동적으로 추가되는 생성 번호의 뒤가 됩니다.
이 때문에 3개의 프로세스의 모든 것이 fred%u. %g.txt에 로그를 기록하려고 하는 경우, 프로세스의 로테이션의 차례에 따라서, 최초의 파일로서 fred0. 0. txt, fred1. 0. txt, fred2. 0. txt를 사용하게 됩니다.
충돌을 회피하는 목적으로 일의의 ID를 사용해도, 로컬 디스크의 파일 시스템이 확실히 동작하는 것이 보증되는 것만으로 있기로 주의해 주세요.
| 생성자 개요 | |
|---|---|
FileHandler ()
디폴트의 FileHandler를 구축합니다. |
|
FileHandler (String pattern)
지정된 파일명을 출력한다. |
|
FileHandler (String pattern,
boolean append)
FileHandler를 초기화해, 옵션의 추가 모드로 지정된 파일명에 출력합니다. |
|
FileHandler (String pattern,
int limit,
int count)
파일세트에 출력하는 FileHandler를 초기화합니다. |
|
FileHandler (String pattern,
int limit,
int count,
boolean append)
옵션의 추가 모드로 파일세트에 출력합니다. |
|
| 메서드 개요 | |
|---|---|
void |
close ()
모든 파일을 닫습니다. |
void |
publish (LogRecord record)
LogRecord를 포맷의해 발행합니다. |
| 클래스 java.util.logging. StreamHandler 로부터 상속된 메서드 |
|---|
flush,
isLoggable,
setEncoding,
setOutputStream |
| 클래스 java.util.logging. Handler 로부터 상속된 메서드 |
|---|
getEncoding,
getErrorManager,
getFilter,
getFormatter,
getLevel,
reportError,
setErrorManager,
setFilter,
setFormatter,
setLevel |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| 생성자 상세 |
|---|
public FileHandler()
throws IOException,
SecurityException
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")를 가지지 않는 경우
NullPointerException - 패턴의 프로퍼티가 비어있는 캐릭터 라인의 경우
public FileHandler(String pattern)
throws IOException,
SecurityException
지정된 패턴의 인수가 파일명의 패턴으로서 사용되어 파일의 제한이 제한없이 설정되어 파일 카운트가 1 으로 설정되어 있는 경우 이외는 FileHandler는 LogManager 프로퍼티 (또는 그 기본값)에 근거해 구성됩니다.
출력해지는 데이터의 총량에 제한이 없기 때문에 주의해 사용해 주세요.
pattern - 출력 파일의 이름
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")를 가지지 않는 경우
IllegalArgumentException - 패턴이 비어있는 캐릭터 라인의 경우
public FileHandler(String pattern,
boolean append)
throws IOException,
SecurityException
지정된 패턴의 인수가 파일명의 패턴으로서 사용되어 파일의 제한이 제한없이 설정되어 파일 카운트가 1 으로 설정되어 추가 모드의 지정된 append 인수로 설정되어 있는 경우 이외는 FileHandler는 LogManager 프로퍼티 (또는 그 기본값)에 근거해 구성됩니다.
출력해지는 데이터의 총량에 제한이 없기 때문에 주의해 사용해 주세요.
pattern - 출력 파일의 이름append - 추가 모드를 지정한다
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")를 가지지 않는 경우
IllegalArgumentException - 패턴이 비어있는 캐릭터 라인의 경우
public FileHandler(String pattern,
int limit,
int count)
throws IOException,
SecurityException
지정된 패턴의 인수가 파일명의 패턴으로서 사용되어 파일의 제한이 제한 인수로 설정되어 파일 카운트가 지정된 count 인수로 설정되어 있는 경우 이외는 FileHandler는 LogManager 프로퍼티 (또는 그 기본값)에 근거해 구성됩니다.
카운트는 적어도 1 이 아니면 안됩니다.
pattern - 출력 파일의 이름부의 패턴limit - 임의의 1개의 파일에 출력하는 최대 바이트수count - 사용하는 파일수
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")를 가지지 않는 경우
IllegalArgumentException - limit < 0, 또는 count < 1인 경우
IllegalArgumentException - 패턴이 비어있는 캐릭터 라인의 경우
public FileHandler(String pattern,
int limit,
int count,
boolean append)
throws IOException,
SecurityException
지정된 패턴의 인수가 파일명의 패턴으로서 사용되어 파일의 제한이 제한 인수로 설정되어 파일 카운트가 지정된 count 인수로 설정되어 추가 모드가 지정된 append 인수로 설정되어 있는 경우 이외는 FileHandler는 LogManager 프로퍼티 (또는 그 기본값)에 근거해 구성됩니다.
카운트는 적어도 1 이 아니면 안됩니다.
pattern - 출력 파일의 이름부의 패턴limit - 임의의 1개의 파일에 출력하는 최대 바이트수count - 사용하는 파일수append - 추가 모드를 지정한다
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")를 가지지 않는 경우
IllegalArgumentException - limit < 0, 또는 count < 1인 경우
IllegalArgumentException - 패턴이 비어있는 캐릭터 라인의 경우| 메서드의 상세 |
|---|
public void publish(LogRecord record)
StreamHandler 내의 publish record - 로그 이벤트의 설명. null 레코드는 단지 무시되는 것만으로 통지는 행해지지 않는다
public void close()
throws SecurityException
StreamHandler 내의 close SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")를 가지지 않는 경우
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.