Closeable, Flushable, Serializable, AutoCloseableIFSTextFileOutputStreampublic class IFSFileOutputStream extends OutputStream implements Serializable
// Work with /Dir/File on the system eniac.
AS400 as400 = new AS400("eniac");
IFSFileOutputStream file = new IFSFileOutputStream(as400, "/Dir/File");
// Lock the first 8 bytes of the file.
IFSKey key = file.lock(8);
// Write 8 bytes to the file.
byte[] data = { 0, 1, 2, 3, 4, 5, 6, 7 };
file.write(data, 0, 8);
// Unlock the first 8 bytes.
file.unlock(key);
// Close the file.
file.close();
| Modifier and Type | Field | Description |
|---|---|---|
protected PropertyChangeSupport |
changes_ |
|
protected IFSFileDescriptor |
fd_ |
|
static int |
SHARE_ALL |
Share option that allows read and write access by other users.
|
static int |
SHARE_NONE |
Share option that does not allow read or write access by other users.
|
static int |
SHARE_READERS |
Share option that allows only read access by other users.
|
static int |
SHARE_WRITERS |
Share option that allows only write access by other users.
|
protected VetoableChangeSupport |
vetos_ |
| Constructor | Description |
|---|---|
IFSFileOutputStream() |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(AS400 system,
IFSFile file,
int shareOption,
boolean append) |
Deprecated.
Use IFSFileOutputStream(IFSFile, int, boolean) instead.
|
IFSFileOutputStream(AS400 system,
IFSFile file,
int shareOption,
boolean append,
int ccsid) |
Deprecated.
Use IFSFileOutputStream(IFSFile, int, boolean, int) instead.
|
IFSFileOutputStream(AS400 system,
IFSJavaFile file,
int shareOption,
boolean append) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(AS400 system,
IFSJavaFile file,
int shareOption,
boolean append,
int ccsid) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(AS400 system,
String name) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(AS400 system,
String name,
int ccsid) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(AS400 system,
String name,
int shareOption,
boolean append) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(AS400 system,
String name,
int shareOption,
boolean append,
int ccsid) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(IFSFile file) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(IFSFileDescriptor fd) |
Creates a file output stream to write to file descriptor fd.
|
IFSFileOutputStream(IFSFile file,
int shareOption,
boolean append) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(IFSFile file,
int shareOption,
boolean append,
int ccsid) |
Constructs an IFSFileOutputStream object.
|
IFSFileOutputStream(IFSJavaFile file) |
Constructs an IFSFileOutputStream object.
|
| Modifier and Type | Method | Description |
|---|---|---|
void |
addFileListener(FileListener listener) |
Adds a file listener to receive file events from this IFSFileOutputStream.
|
void |
addPropertyChangeListener(PropertyChangeListener listener) |
Adds a property change listener.
|
void |
addVetoableChangeListener(VetoableChangeListener listener) |
Adds a vetoable change listener.
|
void |
close() |
Closes this file output stream and releases any system resources associated
with this stream.
|
protected void |
finalize() |
Ensures that the file output stream is closed when there are no more
references to it.
|
void |
flush() |
Forces any buffered output bytes to be written.
|
IFSFileDescriptor |
getFD() |
Returns the file descriptor associated with this stream.
|
String |
getPath() |
Returns the integrated file system path name of the object represented by
this IFSFileOutputStream object.
|
int |
getShareOption() |
Returns the share option for this object.
|
AS400 |
getSystem() |
Returns the AS400 system object for this stream.
|
IFSKey |
lock(int length) |
Deprecated.
Replaced by
lock(long) |
IFSKey |
lock(long length) |
Places a lock on the file at the current position for the specified number
of bytes.
|
protected void |
open(int fileDataCCSID) |
Opens the specified file.
|
void |
removeFileListener(FileListener listener) |
Removes a file listener so that it no longer receives file events from
this IFSFileOutputStream.
|
void |
removePropertyChangeListener(PropertyChangeListener listener) |
Removes a property change listener.
|
void |
removeVetoableChangeListener(VetoableChangeListener listener) |
Removes a vetoable change listener.
|
void |
setAppend(boolean append) |
Sets the append option.
|
void |
setFD(IFSFileDescriptor fd) |
Sets the file descriptor.
|
void |
setPath(String path) |
Sets the integrated file system path name.
|
void |
setShareOption(int shareOption) |
Sets the share option.
|
void |
setSystem(AS400 system) |
Sets the system.
|
void |
unlock(IFSKey key) |
Undoes a lock on this file.
|
void |
write(byte[] data) |
Writes data.length bytes of data from the byte array data
to this file output stream.
|
void |
write(byte[] data,
int dataOffset,
int length) |
Writes length bytes of data from the byte array data, starting
at offset, to this file output stream.
|
void |
write(int b) |
Writes the specified byte to this file output stream.
|
nullOutputStreampublic static final int SHARE_ALL
public static final int SHARE_NONE
public static final int SHARE_READERS
public static final int SHARE_WRITERS
protected transient PropertyChangeSupport changes_
protected transient VetoableChangeSupport vetos_
protected IFSFileDescriptor fd_
public IFSFileOutputStream()
public IFSFileOutputStream(AS400 system, String name) throws AS400SecurityException, IOException
system - The system that contains the file.name - The file to be opened for writing.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, String name, int ccsid) throws AS400SecurityException, IOException
system - The system that contains the file.name - The file to be opened for writing.ccsid - The CCSID with which to tag the data in the file.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, String name, int shareOption, boolean append) throws AS400SecurityException, IOException
system - The system that contains the file.name - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, String name, int shareOption, boolean append, int ccsid) throws AS400SecurityException, IOException
system - The system that contains the file.name - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.ccsid - The CCSID with which to tag the data in the file.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(IFSFile file) throws AS400SecurityException, IOException
file - The file to be opened for writing.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, IFSFile file, int shareOption, boolean append) throws AS400SecurityException, IOException
system - The system that contains the file.file - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(IFSFile file, int shareOption, boolean append) throws AS400SecurityException, IOException
file - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, IFSFile file, int shareOption, boolean append, int ccsid) throws AS400SecurityException, IOException
system - The system that contains the file.file - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.ccsid - The CCSID with which to tag the data in the file.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(IFSFile file, int shareOption, boolean append, int ccsid) throws AS400SecurityException, IOException
file - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.ccsid - The CCSID with which to tag the data in the file.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(IFSFileDescriptor fd)
fd - The file descriptor to be opened for writing.public IFSFileOutputStream(IFSJavaFile file) throws AS400SecurityException, IOException
file - The file to be opened for writing.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, IFSJavaFile file, int shareOption, boolean append) throws AS400SecurityException, IOException
system - The system that contains the file.file - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public IFSFileOutputStream(AS400 system, IFSJavaFile file, int shareOption, boolean append, int ccsid) throws AS400SecurityException, IOException
system - The system that contains the file.file - The file to be opened for writing.shareOption - Indicates how users can access the file. append - Controls the behavior of the file.
If true, output is appended to the file;
otherwise, the current contents of the file are erased,
and output replaces the file contents.ccsid - The CCSID with which to tag the data in the file.AS400SecurityException - If a security or authority error occurs.IOException - If an error occurs while communicating with the system.public void addFileListener(FileListener listener)
listener - The file listener.public void addPropertyChangeListener(PropertyChangeListener listener)
listener - The property change listener to add.public void addVetoableChangeListener(VetoableChangeListener listener)
listener - The vetoable change listener to add.public void close()
throws IOException
close in interface AutoCloseableclose in interface Closeableclose in class OutputStreamIOException - If an error occurs while communicating with the system.protected void finalize()
throws IOException
finalize in class ObjectIOException - If an error occurs while communicating with the system.public void flush()
throws IOException
flush in interface Flushableflush in class OutputStreamIOException - If an error occurs while communicating with the system.public final IFSFileDescriptor getFD() throws IOException
IOException - If an error occurs while communicating with the system.public String getPath()
public int getShareOption()
public AS400 getSystem()
public IFSKey lock(int length) throws IOException
lock(long)length - The number of bytes to lock.ExtendedIOException - If the specified bytes are already locked by another process.IOException - If an error occurs while communicating with the system.unlock(com.ibm.as400.access.IFSKey)public IFSKey lock(long length) throws IOException
length - The number of bytes to lock.IOException - If an error occurs while communicating with the system.unlock(com.ibm.as400.access.IFSKey)protected void open(int fileDataCCSID)
throws IOException
fileDataCCSID - The CCSID with which to tag the data in the file.IOException - If an error occurs while communicating with the system.public void removeFileListener(FileListener listener)
listener - The file listener.public void removePropertyChangeListener(PropertyChangeListener listener)
listener - The property change listener to remove.public void removeVetoableChangeListener(VetoableChangeListener listener)
listener - The vetoable change listener to remove.public void setAppend(boolean append)
throws PropertyVetoException
append - If true, data is appended to an existing file;
otherwise, output replaces the file contents.PropertyVetoException - If the change is vetoed.public void setFD(IFSFileDescriptor fd) throws PropertyVetoException
fd - The file descriptor.PropertyVetoException - If the change is vetoed.public void setPath(String path) throws PropertyVetoException
path - The absolute integrated file system path name.PropertyVetoException - If the change is vetoed.public void setShareOption(int shareOption)
throws PropertyVetoException
shareOption - Indicates how users can access the file. PropertyVetoException - If the change is vetoed.public void setSystem(AS400 system) throws PropertyVetoException
system - The system object.PropertyVetoException - If the change is vetoed.public void unlock(IFSKey key) throws IOException
key - The key for the lock.IOException - If an error occurs while communicating with the system.IFSKey,
lock(long)public void write(int b)
throws IOException
write in class OutputStreamb - The byte to be written.IOException - If an error occurs while communicating with the system.public void write(byte[] data)
throws IOException
write in class OutputStreamdata - The data to be written.IOException - If an error occurs while communicating with the system.public void write(byte[] data,
int dataOffset,
int length)
throws IOException
write in class OutputStreamdata - The data to be written.dataOffset - The start offset in the data.length - The number of bytes to write.IOException - If an error occurs while communicating with the system.Copyright © 2024. All rights reserved.