net.sf.okapi.common

Class UnicodeBOMWriter

java.lang.Object

java.io.Writer

net.sf.okapi.common.UnicodeBOMWriter

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable

public class UnicodeBOMWriter
extends Writer

Writes Unicode text to an output stream. If the specified encoding is a Unicode, then the text is preceeded by the proper Unicode BOM. If it is any other encoding, this class behaves just like OutputStreamWriter. This class is here because Java's OutputStreamWriter apparently doesn't believe in writing BOMs.

For optimum performance, it is recommended that you wrap all instances of UnicodeWriter with a java.io.BufferedWriter.

Version:

0.7

Author:

Robert Futrell

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROPERTY_WRITE_UTF8_BOM If this system property evaluates to "false", ignoring case, files written out as UTF-8 will not have a BOM written for them.

Fields inherited from class java.io.Writer

lock

Constructor Summary

Constructors

Constructor and Description
UnicodeBOMWriter(File file, String encoding) This is a utility constructor since the vast majority of the time, this class will be used to write Unicode files.
UnicodeBOMWriter(OutputStream out, String encoding) Creates a new writer.
UnicodeBOMWriter(String fileName, String encoding) This is a utility constructor since the vast majority of the time, this class will be used to write Unicode files.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this writer.
void	flush() Flushes the stream.
String	getEncoding() Returns the encoding being used to write this output stream (i.e., the encoding of the file).
void	write(char[] cbuf, int off, int len) Writes a portion of an array of characters.
void	write(int c) Writes a single character.
void	write(String str, int off, int len) Writes a portion of a string.

Methods inherited from class java.io.Writer

append, append, append, write, write

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY_WRITE_UTF8_BOM

public static final String PROPERTY_WRITE_UTF8_BOM

If this system property evaluates to "false", ignoring case, files written out as UTF-8 will not have a BOM written for them. Otherwise (even if the property is not set), UTF-8 files will have a BOM written.

See Also:

Constant Field Values

Constructor Detail

UnicodeBOMWriter

public UnicodeBOMWriter(String fileName,
                        String encoding)
                 throws UnsupportedEncodingException,
                        IOException

This is a utility constructor since the vast majority of the time, this class will be used to write Unicode files.

Parameters:

fileName - The file to which to write the Unicode output.

encoding - The encoding to use.

Throws:

UnsupportedEncodingException - If the specified encoding is not supported.

IOException - If an IO exception occurs.

UnicodeBOMWriter

public UnicodeBOMWriter(File file,
                        String encoding)
                 throws UnsupportedEncodingException,
                        IOException

This is a utility constructor since the vast majority of the time, this class will be used to write Unicode files.

Parameters:

file - The file to which to write the Unicode output.

encoding - The encoding to use.

Throws:

UnsupportedEncodingException - If the specified encoding is not supported.

IOException - If an IO exception occurs.

UnicodeBOMWriter

public UnicodeBOMWriter(OutputStream out,
                        String encoding)
                 throws UnsupportedEncodingException,
                        IOException

Creates a new writer.

Parameters:

out - The output stream to write.

encoding - The encoding to use.

Throws:

UnsupportedEncodingException - If the specified encoding is not supported.

IOException - If an IO exception occurs.

Method Detail

close

public void close()
           throws IOException

Closes this writer.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in class Writer

Throws:

IOException - If an IO exception occurs.

flush

public void flush()
           throws IOException

Flushes the stream.

Specified by:

flush in interface Flushable

Specified by:

flush in class Writer

Throws:

IOException - If an IO exception occurs.

getEncoding

public String getEncoding()

Returns the encoding being used to write this output stream (i.e., the encoding of the file).

Returns:

The encoding of the stream.

write

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

Writes a portion of an array of characters.

Specified by:

write in class Writer

Parameters:

cbuf - The buffer of characters.

off - The offset from which to start writing characters.

len - The number of characters to write.

Throws:

IOException - If an I/O error occurs.

write

public void write(int c)
           throws IOException

Writes a single character.

Overrides:

write in class Writer

Parameters:

c - An integer specifying the character to write.

Throws:

IOException - If an IO error occurs.

write

public void write(String str,
                  int off,
                  int len)
           throws IOException

Writes a portion of a string.

Overrides:

write in class Writer

Parameters:

str - The string from which to write.

off - The offset from which to start writing characters.

len - The number of characters to write.

Throws:

IOException - If an IO error occurs.