|
Oracle® Multimedia Java API Reference 11g Release 2 (11.2) E10779-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
java.io.OutputStream
oracle.ord.media.jai.io.SeekableOutputStream
oracle.ord.media.jai.io.FileSeekableOutputStream
public class FileSeekableOutputStream
A SeekableOutputStream class that writes to a file whose original contents will be overwritten.
Constructor Summary | |
---|---|
FileSeekableOutputStream(java.io.File file) Creates a FileSeekableOutputStream object that writes to a file. |
|
FileSeekableOutputStream(java.lang.String name) Creates a FileSeekableOutputStream object that writes to a named file. |
Method Summary | |
---|---|
void |
close() Closes the output stream and releases any resources associated with this stream. |
void |
flush() Flushes the output stream and forces any buffered output bytes to be written to the file. |
long |
getFilePointer() Returns the offset in the stream. |
long |
length() Returns the current length of the stream. |
void |
seek(long pos) Sets the file-pointer offset, measured from the beginning of this stream, at which the next write operation will occur. |
void |
truncate(long len) Truncates the stream to the specified length. |
void |
write(byte[] b) Writes all bytes in the specified byte array to the file. |
void |
write(byte[] b, int off, int len) Writes the specified number of bytes from the specified byte array to the file. |
void |
write(int b) Writes the specified byte to the file. |
Methods inherited from class oracle.ord.media.jai.io.SeekableOutputStream |
---|
wrapOutputStream |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public FileSeekableOutputStream(java.io.File file) throws java.io.IOException, java.io.FileNotFoundException
file
- the file to which the data will be written.java.io.FileNotFoundException
- if the file does not exist.java.io.IOException
- if an IO error occurs or if the value of the file parameter is null
.public FileSeekableOutputStream(java.lang.String name) throws java.io.IOException, java.io.FileNotFoundException
name
- the name of the system-dependent file.java.io.FileNotFoundException
- if the file does not exist.java.io.IOException
- if an IO error occurs or if the value of the name parameter is null
.Method Detail |
---|
public long length() throws java.io.IOException
length
in class SeekableOutputStream
java.io.IOException
- if an IO error occurs.public long getFilePointer() throws java.io.IOException
getFilePointer
in class SeekableOutputStream
java.io.IOException
- if an IO error occurs.public void seek(long pos) throws java.io.IOException
The offset may be set beyond the end of the stream. Setting the offset beyond the end of the stream does not change the stream length; the stream length will change only by writing after the offset has been set beyond the end of the stream.
seek
in class SeekableOutputStream
pos
- the offset position, measured in bytes from the beginning of the stream, at which to set the file pointer.java.io.IOException
- if the value of the pos parameter is less than zero or if an IO error occurs.public void truncate(long len) throws java.io.IOException
truncate
in class SeekableOutputStream
len
- the length of the stream, in bytes.java.io.IOException
- if the value of the len parameter is less than zero or larger than the stream length, or if an IO error occurs.public void write(int b) throws java.io.IOException
write
in class java.io.OutputStream
b
- the byte to be written to the file. Only the low-order byte is written; the upper 24 bits are ignored.java.io.IOException
- if an IO error occurs.public void write(byte[] b) throws java.io.IOException
write
in class java.io.OutputStream
b
- an array of bytes to be written to the file.java.io.IOException
- if an IO error occurs.public void write(byte[] b, int off, int len) throws java.io.IOException
write
in class java.io.OutputStream
b
- the buffer containing the data to be written to the file.off
- the starting position for the offset in the buffer.len
- the number of bytes to write to the file.java.io.IOException
- if an IO error occurs.public void flush() throws java.io.IOException
There is little need to call this method until all the data has been written because the close method includes a call to the flush method.
flush
in interface java.io.Flushable
flush
in class java.io.OutputStream
java.io.IOException
- if an IO error occurs.public void close() throws java.io.IOException
flush()
method to write any buffered bytes to the stream.close
in interface java.io.Closeable
close
in class java.io.OutputStream
java.io.IOException
- if an IO error occurs.
|
Oracle® Multimedia Java API Reference 11g Release 2 (11.2) E10779-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |