J2ME in a Nutshell

Name

OutputStream

Synopsis

OutputStream is an abstract class that defines methods used to write a stream of bytes to an output source. The write() methods write either a single byte or an array of bytes to the output stream. Any error encountered when writing the data results in an IOException. Note that some subclasses may buffer data internally instead of writing directly to the underlying storage mechanism. Application code may use the flush() to force any buffered data to be written out. Buffered data is automatically flushed when the stream is closed by the close() method.

Like InputStream, OutputStream is byte-oriented and not character-oriented and cannot safely be used to write character data by storing the bottom 8 bits of each character in a byte and writing out the resulting byte array. Character data should be handled using the writeUTF() or writeChars() methods of DataOutputStream or by using an OutputStreamWriter with the appropriate encoding for the data being written.

public abstract class OutputStream {  
// Public Constructors
   public OutputStream();    
// Public Instance Methods
   public void close() throws IOException;                       // empty
   public void flush() throws IOException;                       // empty
   public abstract void write( int b) throws IOException;  
   public void write( byte[] b) throws IOException;  
   public void write(byte[] b, int off, 
        int len) throws IOException;  
}

Subclasses

ByteArrayOutputStream, DataOutputStream, PrintStream

Passed To

DataOutputStream.DataOutputStream(), OutputStreamWriter.OutputStreamWriter(), ...