org.osid.transport

Interface DataOutputStream

public interface DataOutputStream

The data output stream provides a means in which data can be written to a stream.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Flushes the output, closes this stream and frees up any allocated resources.
void	write(byte[] buf, long n) Writes n bytes to this stream.
void	writeStream(DataInputStream stream) Writes a stream to this stream.

Method Detail

write

void write(byte[] buf,
         long n)
           throws OperationFailedException

Writes n bytes to this stream.

Parameters:

buf - the buffer containing the data to write

n - the number of bytes to write

Throws:

IllegalStateException - this stream has been closed

InvalidArgumentException - buf does not contain n bytes

NullArgumentException - buf is null

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

writeStream

void writeStream(DataInputStream stream)
                 throws OperationFailedException

Writes a stream to this stream.

Parameters:

stream - an input stream

Throws:

IllegalStateException - this stream has been closed

NullArgumentException - stream is null

OperationFailedException - unable to complete request

Compliance:

mandatory - This method must be implemented.

close

void close()

Flushes the output, closes this stream and frees up any allocated resources. Methods in this object may not be invoked after this method is called.

Throws:

IllegalStateException - this stream has been closed

Compliance:

mandatory - This method must be implemented.