|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.logging.Handler
org.jboss.logging.jdk.handlers.HandlerSkeleton
org.jboss.logging.jdk.handlers.WriterHandler
org.jboss.logging.jdk.handlers.FileHandler
public class FileHandler
FileAppender appends log events to a file.
Field Summary | |
---|---|
protected boolean |
fileAppend
Controls file truncatation. |
protected String |
fileName
The name of the log file. |
Fields inherited from class org.jboss.logging.jdk.handlers.WriterHandler |
---|
bufferedIO, bufferSize, immediateFlush |
Fields inherited from class org.jboss.logging.jdk.handlers.HandlerSkeleton |
---|
name |
Constructor Summary | |
---|---|
FileHandler()
The default constructor does not do anything. |
|
FileHandler(Formatter layout,
String filename)
Instantiate a FileHandler and open the file designated by filename . |
|
FileHandler(Formatter layout,
String filename,
boolean append)
Instantiate a FileHandler and open the file designated by filename . |
|
FileHandler(Formatter layout,
String filename,
boolean append,
boolean bufferedIO,
int bufferSize)
Instantiate a FileHandler and open the file
designated by filename . |
Method Summary | |
---|---|
void |
activateOptions()
If the value of File is not null , then setFile(java.lang.String) is called with the values of File and
Append properties. |
boolean |
getAppend()
Returns the value of the Append option. |
String |
getFile()
Returns the value of the File option. |
void |
setAppend(boolean flag)
The Append option takes a boolean value. |
void |
setFile(String file)
The File property takes a string value which should be the name of the file to append to. |
void |
setFile(String fileName,
boolean append,
boolean bufferedIO,
int bufferSize)
Sets and opens the file where the log output will go. |
Methods inherited from class org.jboss.logging.jdk.handlers.WriterHandler |
---|
checkEntryConditions, close, flush, getBufferSize, getImmediateFlush, isBufferedIO, publish, setBufferedIO, setBufferSize, setEncoding, setImmediateFlush, setOutputStream, subPublish |
Methods inherited from class org.jboss.logging.jdk.handlers.HandlerSkeleton |
---|
debug, getName, setName |
Methods inherited from class java.util.logging.Handler |
---|
getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, reportError, setErrorManager, setFilter, setFormatter, setLevel |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected boolean fileAppend
true
, meaning that by default a
FileAppender
will append to an existing file and not
truncate it.
This option is meaningful only if the FileAppender opens the file.
protected String fileName
Constructor Detail |
---|
public FileHandler()
public FileHandler(Formatter layout, String filename, boolean append, boolean bufferedIO, int bufferSize) throws IOException
FileHandler
and open the file
designated by filename
. The opened filename will
become the output destination for this appender.
If the append
parameter is true, the file will be
appended to. Otherwise, the file designated by
filename
will be truncated before being opened.
If the bufferedIO
parameter is true
,
then buffered IO will be used to write to the output file.
IOException
public FileHandler(Formatter layout, String filename, boolean append) throws IOException
filename
. The opened filename will become the output
destination for this appender.
If the append
parameter is true, the file will be
appended to. Otherwise, the file designated by
filename
will be truncated before being opened.
IOException
public FileHandler(Formatter layout, String filename) throws IOException
filename
. The opened filename will become the output
destination for this appender.
The file will be appended to.
IOException
Method Detail |
---|
public void setFile(String file)
Note: Actual opening of the file is made when activateOptions()
is called, not when the options are set.
public boolean getAppend()
public String getFile()
public void activateOptions()
null
, then setFile(java.lang.String)
is called with the values of File and
Append properties.
activateOptions
in class HandlerSkeleton
public void setAppend(boolean flag)
true
by default. If true, then File
will be opened in append mode by setFile
(see
above). Otherwise, setFile
will open
File
in truncate mode.
Note: Actual opening of the file is made when activateOptions()
is called, not when the options are set.
public void setFile(String fileName, boolean append, boolean bufferedIO, int bufferSize) throws IOException
Sets and opens the file where the log output will go. The specified file must be writable.
If there was already an opened file, then the previous file is closed first.
Do not use this method directly. To configure a FileHandler or one of its subclasses, set its properties one by one and then call activateOptions.
fileName
- The path to the log file.append
- If true will append to fileName. Otherwise will
truncate fileName.
IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |