org.vishia.util

Class FileWriter

java.lang.Object

java.io.Writer

org.vishia.util.FileWriter

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.Appendable, java.lang.AutoCloseable

public class FileWriter
extends java.io.Writer

This class is a alternative to java.io.FileWriter. It based on java.util.OutputStreamWriter, adequate to java.io.FileWriter. But in opposite to that,

• The instance of this class will be preserved also if the file is closed, respectively the instance can be created static, without opened file. It is because usage in fast realtime systems in C via Java2C-translator. The implementation in C is written without any dynamically memory.
• On open() no exceptions are thrown, a boolean return value is used.

Field Summary

Fields

Modifier and Type	Field and Description
static int	kFileNotFound
static int	kFileOpenError
java.lang.String	sError
protected java.io.OutputStreamWriter	writer The OutputStreamWriter can't be used as superclass, because the file is able to open only with calling constructor.

Fields inherited from class java.io.Writer

lock

Constructor Summary

Constructors

Constructor and Description
FileWriter()

Method Summary

Modifier and Type	Method and Description
void	close()
void	finalize()
void	flush()
boolean	isOpen()
int	open(java.lang.String fileName, boolean append) opens a file to write.
void	write(char[] cbuf, int off, int len)
void	write(java.lang.String text)

Methods inherited from class java.io.Writer

append, append, append, write, write, write

Methods inherited from class java.lang.Object

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

Field Detail

writer

protected java.io.OutputStreamWriter writer

The OutputStreamWriter can't be used as superclass, because the file is able to open only with calling constructor. Thats why all methods of OutputStreamWriter have to be wrapped here.

kFileNotFound

public static final int kFileNotFound

See Also:

Constant Field Values

kFileOpenError

public static final int kFileOpenError

See Also:

Constant Field Values

sError

public java.lang.String sError

Constructor Detail

FileWriter

public FileWriter()

Method Detail

open

public int open(java.lang.String fileName,
                boolean append)

opens a file to write.

Parameters:

fileName - Path to the file. To separate folder, a slash '/' should be used. But a backslash is also accepted. An absolute path should be start either with slash or with a one-char drive specifier, following by ':/'.

append - If the file exists, the content written than is appended.

Returns:

0 if the file is opened, -1 if the file is not found, -2 on other conditions.

isOpen

public boolean isOpen()

close

public void close()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class java.io.Writer

write

public void write(java.lang.String text)
           throws java.io.IOException

Overrides:

write in class java.io.Writer

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Specified by:

flush in interface java.io.Flushable

Specified by:

flush in class java.io.Writer

Throws:

java.io.IOException

finalize

public void finalize()

Overrides:

finalize in class java.lang.Object

write

public void write(char[] cbuf,
                  int off,
                  int len)
           throws java.io.IOException

Specified by:

write in class java.io.Writer

Throws:

java.io.IOException