com.ibm.as400.resource
Class RIFSFile

java.lang.Object
  com.ibm.as400.resource.Resource
      com.ibm.as400.resource.ChangeableResource
          com.ibm.as400.resource.RIFSFile

All Implemented Interfaces:

Serializable

Deprecated. Use IFSFile instead, as this package may be removed in the future.

public class RIFSFile
extends ChangeableResource

The RIFSFile class represents a file or directory in the integrated file system on the system. This class provides function similar to IFSFile and IFSJavaFile except that it is a subclass of Resource. As a result, it can be used directly in conjunction with components written for Resource objects.

The following attribute IDs are supported:

• ABSOLUTE_PATH
• CANONICAL_PATH
• CAN_READ
• CAN_WRITE
• CCSID
• CREATED
• EXISTS
• IS_ABSOLUTE
• IS_DIRECTORY
• IS_FILE
• IS_HIDDEN
• IS_READ_ONLY
• LAST_ACCESSED
• LAST_MODIFIED
• LENGTH
• NAME
• PARENT
• PATH
• TYPE

Use any of these attribute IDs with getAttributeValue() and setAttributeValue() to access the attribute values for an RIFSFile.

// Create an RIFSFile object to refer to a specific file.
AS400 system = new AS400("MYSYSTEM", "MYUSERID", "MYPASSWORD");
RIFSFile file = new RIFSFile(system, "/home/myuserid/config.txt");


// Determine if the file is read only.
boolean readOnly = ((Boolean)file.getAttributeValue(RIFSFile.IS_READ_ONLY)).booleanValue();


// Set the last modified date to now.
file.setAttributeValue(RIFSFile.LAST_MODIFIED, new Date());


// Commit the attribute change.
file.commitAttributeChanges();

See Also:

RIFSFileList, Serialized Form

Field Summary

Modifier and Type	Field and Description
static String	ABSOLUTE_PATH Deprecated. Attribute ID for absolute path.
static String	CAN_READ Deprecated. Attribute ID for can read.
static String	CAN_WRITE Deprecated. Attribute ID for can write.
static String	CANONICAL_PATH Deprecated. Attribute ID for canonical path.
static String	CCSID Deprecated. Attribute ID for CCSID.
static String	CREATED Deprecated. Attribute ID for created.
static String	EXISTS Deprecated. Attribute ID for exists.
static String	IS_ABSOLUTE Deprecated. Attribute ID for is absolute.
static String	IS_DIRECTORY Deprecated. Attribute ID for is directory.
static String	IS_FILE Deprecated. Attribute ID for is file.
static String	IS_HIDDEN Deprecated. Attribute ID for is hidden.
static String	IS_READ_ONLY Deprecated. Attribute ID for is read only.
static String	LAST_ACCESSED Deprecated. Attribute ID for last accessed.
static String	LAST_MODIFIED Deprecated. Attribute ID for last modified.
static String	LENGTH Deprecated. Attribute ID for length.
static String	NAME Deprecated. Attribute ID for name.
static String	OWNERID Deprecated. Attribute ID for owner ID.
static String	PARENT Deprecated. Attribute ID for parent.
static String	PATH Deprecated. Attribute ID for path.
static String	TYPE Deprecated. Attribute ID for type.
static String	TYPE_DIRECTORY Deprecated. Attribute value indicating that this is a directory.
static String	TYPE_FILE Deprecated. Attribute value indicating that this is a file.
static String	TYPE_UNKNOWN Deprecated. Attribute value indicating that the tyype is unknown.

Constructor and Description

RIFSFile()
Deprecated. Constructs an RIFSFile object.

RIFSFile(AS400 system, String path)
Deprecated. Constructs an RIFSFile object.

Method Summary

Modifier and Type	Method and Description
protected void	commitAttributeChanges(Object[] attributeIDs, Object[] values) Deprecated. Commits the specified attribute changes.
void	delete() Deprecated. Deletes this file or directory.
protected void	establishConnection() Deprecated. Establishes the connection to the system.
protected void	freezeProperties() Deprecated. Freezes any property changes.
Object	getAttributeUnchangedValue(Object attributeID) Deprecated. Returns the unchanged value of an attribute.
String	getPath() Deprecated. Returns the file path name.
void	refreshAttributeValues() Deprecated. Refreshes the values for all attributes.
void	setPath(String path) Deprecated. Sets the file path name.
void	setSystem(AS400 system) Deprecated. Sets the system.

Methods inherited from class com.ibm.as400.resource.ChangeableResource

cancelAttributeChanges, commitAttributeChanges, commitAttributeChanges, fireAttributeChangesCanceled, fireAttributeChangesCommitted, fireAttributeValueChanged, fireResourceCreated, fireResourceDeleted, getAttributeUnchangedValue, getAttributeValue, getAttributeValue, hasUncommittedAttributeChanges, initializeAttributeValue, setAttributeValue, setAttributeValue

Methods inherited from class com.ibm.as400.resource.Resource

addActiveStatusListener, addPropertyChangeListener, addResourceListener, addVetoableChangeListener, arePropertiesFrozen, equals, fireAttributeValuesRefreshed, fireBusy, fireIdle, firePropertyChange, fireVetoableChange, getAttributeMetaData, getAttributeMetaData, getPresentation, getResourceKey, getSystem, isBidiEnabled, isConnectionEstablished, removeActiveStatusListener, removePropertyChangeListener, removeResourceListener, removeVetoableChangeListener, setPresentation, setResourceKey, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ABSOLUTE_PATH

public static final String ABSOLUTE_PATH

Deprecated.

Attribute ID for absolute path. This identifies a read-only String attribute, which represents the absolute path name.

See Also:

Constant Field Values

CANONICAL_PATH

public static final String CANONICAL_PATH

Deprecated.

Attribute ID for canonical path. This identifies a read-only String attribute, which represents the canonical path name.

See Also:

Constant Field Values

CAN_READ

public static final String CAN_READ

Deprecated.

Attribute ID for can read. This identifies a read-only Boolean attribute, which indicates whether this file can be read.

See Also:

Constant Field Values

CAN_WRITE

public static final String CAN_WRITE

Deprecated.

Attribute ID for can write. This identifies a read-only Boolean attribute, which indicates whether this file can be written.

See Also:

Constant Field Values

CCSID

public static final String CCSID

Deprecated.

Attribute ID for CCSID. This identifies a read-only Integer attribute, which represents the coded character set identifier for the file.

See Also:

Constant Field Values

CREATED

public static final String CREATED

Deprecated.

Attribute ID for created. This identifies a read-only Date attribute, which represents the date and time that the file was created.

See Also:

Constant Field Values

EXISTS

public static final String EXISTS

Deprecated.

Attribute ID for exists. This identifies a read-only Boolean attribute, which indicates whether the file exists.

See Also:

Constant Field Values

IS_ABSOLUTE

public static final String IS_ABSOLUTE

Deprecated.

Attribute ID for is absolute. This identifies a read-only Boolean attribute, which indicates whether the path name is absolute.

See Also:

Constant Field Values

IS_DIRECTORY

public static final String IS_DIRECTORY

Deprecated.

Attribute ID for is directory. This identifies a read-only Boolean attribute, which indicates whether this is a directory.

See Also:

Constant Field Values

IS_FILE

public static final String IS_FILE

Deprecated.

Attribute ID for is file. This identifies a read-only Boolean attribute, which indicates whether this is a file.

See Also:

Constant Field Values

IS_HIDDEN

public static final String IS_HIDDEN

Deprecated.

Attribute ID for is hidden. This identifies a Boolean attribute, which indicates whether this file is hidden.

See Also:

Constant Field Values

IS_READ_ONLY

public static final String IS_READ_ONLY

Deprecated.

Attribute ID for is read only. This identifies a Boolean attribute, which indicates whether this file is read only.

See Also:

Constant Field Values

LAST_ACCESSED

public static final String LAST_ACCESSED

Deprecated.

Attribute ID for last accessed. This identifies a read-only Date attribute, which represents the date and time the file was last accessed.

See Also:

Constant Field Values

LAST_MODIFIED

public static final String LAST_MODIFIED

Deprecated.

Attribute ID for last modified. This identifies a Date attribute, which represents the date and time the file was last modified. Setting this to 0 will leave the last modified date unchanged.

See Also:

Constant Field Values

LENGTH

public static final String LENGTH

Deprecated.

Attribute ID for length. This identifies a read-only Long attribute, which represents the length of the file in bytes.

See Also:

Constant Field Values

NAME

public static final String NAME

Deprecated.

Attribute ID for name. This identifies a read-only String attribute, which represents the name of the file.

See Also:

Constant Field Values

OWNERID

public static final String OWNERID

Deprecated.

Attribute ID for owner ID. This identifies a read-only Integer attribute, which represents the owner ID number of the file.

See Also:

Constant Field Values

PARENT

public static final String PARENT

Deprecated.

Attribute ID for parent. This identifies a read-only String attribute, which represents the name of the parent directory.

See Also:

Constant Field Values

PATH

public static final String PATH

Deprecated.

Attribute ID for path. This identifies a read-only String attribute, which represents the path name of the file.

See Also:

Constant Field Values

TYPE

public static final String TYPE

Deprecated.

Attribute ID for type. This identifies a read-only String attribute, which indicates whether this is a directory or a file. Possible values are:

• TYPE_DIRECTORY - This is a directory.
• TYPE_FILE - This is a file.
• TYPE_UNKNOWN - The type is unknown.

See Also:

Constant Field Values

TYPE_DIRECTORY

public static final String TYPE_DIRECTORY

Deprecated.

Attribute value indicating that this is a directory.

See Also:

TYPE, Constant Field Values

TYPE_FILE

public static final String TYPE_FILE

Deprecated.

Attribute value indicating that this is a file.

See Also:

TYPE, Constant Field Values

TYPE_UNKNOWN

public static final String TYPE_UNKNOWN

Deprecated.

Attribute value indicating that the tyype is unknown.

See Also:

TYPE, Constant Field Values

Constructor Detail

RIFSFile

public RIFSFile()

Deprecated.

Constructs an RIFSFile object.

RIFSFile

public RIFSFile(AS400 system,
                String path)

Deprecated.

Constructs an RIFSFile object.

Parameters:

system - The system.

path - The file path name.

Method Detail

commitAttributeChanges

protected void commitAttributeChanges(Object[] attributeIDs,
                                      Object[] values)
                               throws ResourceException

Deprecated.

Commits the specified attribute changes.

Overrides:

commitAttributeChanges in class ChangeableResource

Parameters:

attributeIDs - The attribute IDs for the specified attribute changes.

values - The specified attribute changes

Throws:

ResourceException - If an error occurs.

See Also:

Subclass notes

delete

public void delete()
            throws ResourceException

Deprecated.

Deletes this file or directory.

Throws:

ResourceException - If an error occurs.

establishConnection

protected void establishConnection()
                            throws ResourceException

Deprecated.

Establishes the connection to the system.

The method is called by the resource framework automatically when the connection needs to be established.

Overrides:

establishConnection in class Resource

Throws:

ResourceException - If an error occurs.

freezeProperties

protected void freezeProperties()
                         throws ResourceException

Deprecated.

Freezes any property changes. After this is called, property changes should not be made. Properties are not the same thing as attributes. Properties are basic pieces of information which must be set to make the object usable, such as the system and the name.

The method is called by the resource framework automatically when the properties need to be frozen.

Overrides:

freezeProperties in class Resource

Throws:

ResourceException - If an error occurs.

getAttributeUnchangedValue

public Object getAttributeUnchangedValue(Object attributeID)
                                  throws ResourceException

Deprecated.

Returns the unchanged value of an attribute. If the attribute value has an uncommitted change, this returns the unchanged value. If the attribute value does not have an uncommitted change, this returns the same value as getAttributeValue().

Overrides:

getAttributeUnchangedValue in class ChangeableResource

Parameters:

attributeID - Identifies the attribute.

Returns:

The attribute value, or null if the attribute value is not available.

Throws:

ResourceException - If an error occurs.

See Also:

Subclass notes

getPath

public String getPath()

Deprecated.

Returns the file path name.

Returns:

The file path name.

refreshAttributeValues

public void refreshAttributeValues()
                            throws ResourceException

Deprecated.

Refreshes the values for all attributes. This does not cancel uncommitted changes. This method fires an attributeValuesRefreshed() ResourceEvent.

Overrides:

refreshAttributeValues in class ChangeableResource

Throws:

ResourceException - If an error occurs.

setPath

public void setPath(String path)

Deprecated.

Sets the file path name. This does not change the file on the system. Instead, it changes the file to which this object references. This cannot be changed if the object has established a connection to the system.

Parameters:

path - The file path name.

setSystem

public void setSystem(AS400 system)
               throws PropertyVetoException

Deprecated.

Sets the system. This does not change the job on the system. Instead, it changes the system to which this object references. This cannot be changed if the object has established a connection to the system.

Overrides:

setSystem in class Resource

Parameters:

system - The system.

Throws:

PropertyVetoException - If the property change is vetoed.