org.openhubframework.openhub.common.log

Class LazyFileOutputStream

java.lang.Object

java.io.OutputStream

org.openhubframework.openhub.common.log.LazyFileOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class LazyFileOutputStream
extends OutputStream

Represents an output stream of bytes with LAZY strategy of stream initialization.

Since:

2.0

Author:

Tomas Hanus

Constructor Summary

Constructors

Constructor and Description
LazyFileOutputStream(File f) Create lazy file-based OutputStream.
LazyFileOutputStream(File f, boolean append) Create lazy file-based OutputStream where is possible to specify append flag.
LazyFileOutputStream(String pathName) Create lazy file-based OutputStream by converting the given pathname string into an abstract pathname.
LazyFileOutputStream(String pathName, boolean append) Create lazy file-based OutputStream by converting the given pathname string into an abstract pathname where is possible to specify append flag.

Method Summary

Modifier and Type	Method and Description
void	close()
void	flush()
protected FileOutputStream	outputStream() This method is the key component of the class, it gets the wrapped FileOutputStream object if already initialized or if not it generates it in a thread safe way.
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LazyFileOutputStream

public LazyFileOutputStream(File f)

Create lazy file-based OutputStream.

Parameters:

f - as file used for flushing log events

See Also:

LazyFileOutputStream(File, boolean)

LazyFileOutputStream

public LazyFileOutputStream(File f,
                            boolean append)

Create lazy file-based OutputStream where is possible to specify append flag.

Parameters:

f - as file used for flushing log events

append - true if the file is opened for append

See Also:

FileOutputStream.append, LazyFileOutputStream(File)

LazyFileOutputStream

public LazyFileOutputStream(String pathName)

Create lazy file-based OutputStream by converting the given pathname string into an abstract pathname.

Parameters:

pathName - a pathname string

See Also:

File.File(String), LazyFileOutputStream(String, boolean)

LazyFileOutputStream

public LazyFileOutputStream(String pathName,
                            boolean append)

Create lazy file-based OutputStream by converting the given pathname string into an abstract pathname where is possible to specify append flag.

Parameters:

pathName - a pathname string

append - true if the file is opened for append

See Also:

File.File(String), LazyFileOutputStream(String)

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class OutputStream

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException

write

public void write(int b)
           throws IOException

Specified by:

write in class OutputStream

Throws:

IOException

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Overrides:

write in class OutputStream

Throws:

IOException

write

public void write(byte[] b)
           throws IOException

Overrides:

write in class OutputStream

Throws:

IOException

outputStream

protected FileOutputStream outputStream()
                                 throws FileNotFoundException

This method is the key component of the class, it gets the wrapped FileOutputStream object if already initialized or if not it generates it in a thread safe way. This kind of implementation allows to call the initialization of the underlying FileOutputStream object only when needed.

Returns:

the wrapped FileOutputStream object

Throws:

FileNotFoundException - if the file can't be created