|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object
|
+--java.util.logging.Handler
|
+--java.util.logging.StreamHandler
|
+--java.util.logging.FileHandler
단순 파일의 로깅 Handler 입니다.
FileHandler 에서는 지정된 파일, 또는 파일의 로테이션 세트의 어느 쪽인가에 기입할 수가 있습니다.
파일의 로테이션 세트의 경우, 각 파일이 지정된 사이즈의 한도에 도달하면(자), 그 파일이 닫혀져 교환해 새로운 파일이 열립니다. 다음에, 0, 1, 2 등을 기본 파일명에 추가해, 구파일에 이름을 붙입니다.
디폴트로, 버퍼링은 입출력 프로그램 라이브러리로 사용 가능합니다만, 각 로그 레코드는 완료시에 플래시 됩니다.
디폴트로,XMLFormatter 클래스는 포맷 처리에 사용됩니다.
구성: 디폴트로, 각 FileHandler 는 다음에 나타내는 LogManager 구성 프로퍼티를 사용해 초기화됩니다. 프로퍼티가 미정도리의 경우 (또는 무효인 값을 가지는 경우), 지정된 디폴트의 값이 사용됩니다.
패턴은 실행시로 옮겨지는 다음의 특수 컴퍼넌트를 포함한 캐릭터 라인으로부터 구성됩니다.
이와 같이, 예를 들어 카운트 2 를 가지는 패턴 "%t/java%g.log# 에서는 통상 로그 파일을 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 (String pattern,
int limit,
int count)
파일세트에 기입한다. |
|
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")) 를 가지지 않는 경우
public FileHandler(String pattern)
throws IOException ,
SecurityException
지정된 패턴의 인수가 파일명의 패턴으로서 사용되어 파일의 제한이 제한없이 설정되어 파일 카운트가 1 으로 설정되어 있는 경우 이외는 FileHandler 는 LogManager 프로퍼티 (또는 그 디폴트 값)에 근거해 구성됩니다.
기입해지는 데이터의 총량에 제한이 없기 때문에, 주의해 사용해 주세요.
pattern - 출력 파일의 이름
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")) 를 가지지 않는 경우
public FileHandler(String pattern,
boolean append)
throws IOException ,
SecurityException
지정된 패턴의 인수가 파일명의 패턴으로서 사용되어 파일의 제한이 제한없이 설정되어 파일 카운트가 1 으로 설정되어 추가 모드의 지정된 append 인수로 설정되어 있는 경우 이외는 FileHandler 는 LogManager 프로퍼티 (또는 그 디폴트 값)에 근거해 구성됩니다.
기입해지는 데이터의 총량에 제한이 없기 때문에, 주의해 사용해 주세요.
pattern - 출력 파일의 이름append - 추가 모드를 지정한다
IOException - 파일을 열 때 입출력의 문제가 발생했을 경우
SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")) 를 가지지 않는 경우
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 의 경우
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 의 경우| 메소드의 상세 |
public void publish(LogRecord record)
StreamHandler 내의 publish record - 로그 이벤트의 설명
public void close()
throws SecurityException
StreamHandler 내의 close SecurityException - 시큐러티 매니저가 존재해, 호출원이 LoggingPermission("control")) 를 가지지 않는 경우
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.