file.encoding.
* The only encodings that are guaranteed to be available are "8859_1"
* (the Latin-1 character set) and "UTF8". Unfortunately, Java does not
* provide a mechanism for listing the encodings that are supported in
* a given implementation.
* * Here is a list of standard encoding names that may be available: *
*
OutputStreamWriter
* to write to the specified stream using a caller supplied character
* encoding scheme. Note that due to a deficiency in the Java language
* design, there is no way to determine which encodings are supported.
*
* @param out The OutputStream to write to
* @param encoding_scheme The name of the encoding scheme to use for
* character to byte translation
*
* @throws UnsupportedEncodingException If the named encoding is
* not available.
*/
public OutputStreamWriter(OutputStream out, String encoding_scheme)
throws UnsupportedEncodingException
{
this.out = out;
if (encoding_scheme != "ISO8859_1" && encoding_scheme != "US_ASCII")
throw new UnsupportedEncodingException();
}
/**
* This method initializes a new instance of OutputStreamWriter
* to write to the specified stream using the default encoding.
*
* @param out The OutputStream to write to
*/
public OutputStreamWriter(OutputStream out)
{
this.out = out;
}
/**
* This method writes a single character to the output stream.
*
* @param ch The char to write, passed as an int.
*
* @throws IOException If an error occurs
*/
public void write(int ch) throws IOException
{
write(new char[] { (char) ch }, 0, 1);
}
/**
* This method writes count characters from the specified
* array to the output stream starting at position offset
* into the array.
*
* @param buf The array of character to write from
* @param offset The offset into the array to start writing chars from
* @param count The number of chars to write.
*
* @throws IOException If an error occurs
*/
public void write(char[] buf, int offset, int count) throws IOException
{
if (buf == null)
throw new IOException();
byte[] b = new byte[count];
for (int i = 0; i < count; i++)
b[i] = (byte) ((buf[offset + i] <= 0xFF) ? buf[offset + i] : '?');
out.write(b);
}
/**
* This method writes count bytes from the specified
* String starting at position offset into the
* String.
*
* @param str The String to write chars from
* @param offset The position in the String to start
* writing chars from
* @param count The number of chars to write
*
* @throws IOException If an error occurs
*/
public void write(String str, int offset, int count) throws IOException
{
if (str == null)
throw new IOException();
write(str.toCharArray(), offset, count);
}
/**
* This method flushes any buffered bytes to the underlying output sink.
*
* @throws IOException If an error occurs
*/
public void flush() throws IOException
{
if (out != null)
{
out.flush();
}
}
/**
* This method closes this stream, and the underlying
* OutputStream
*
* @throws IOException If an error occurs
*/
public void close() throws IOException
{
synchronized (lock)
{
if (out == null)
return;
flush();
out.close();
out = null;
}
}
} // class OutputStreamWriter