com.highqsoft.avalon

Class ODSFile

java.lang.Object

org.omg.PortableServer.Servant

org.asam.ods.ODSFilePOA

com.highqsoft.avalon.ODSFile

All Implemented Interfaces:

AvalonDestroyable, java.io.Serializable, InstanceElement, InstanceElementOperations, ODSFile, ODSFileOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity, org.omg.CORBA.portable.InvokeHandler

public class ODSFile
extends ODSFilePOA
implements ODSFile, AvalonDestroyable

\page variables \addindex KEEP_ORIGINAL_FILE_LOCATION \par Variable KEEP_ORIGINAL_FILE_LOCATION The variable KEEP_ORIGINAL_FILE_LOCATION in athos, read from or written to the INI-File. In case of writing the new value into the INI-File, a backup of the former INI-file is created. (date/time indicated in the filename). \par Access to the variable KEEP_ORIGINAL_FILE_LOCATION Read and write operations are possible. \par Output of the variable KEEP_ORIGINAL_FILE_LOCATION If the variable is set to 'YES', has the following effects: - Function: void takeUnderControl(String sourceUrl) The passed filename (sourceUrl) will be taken under control of ODS server, the file is not moved to ODS server location. - Function: void removeFromControl(String targetUrl) The file will be removed from ODS server control, but the location of the file in the filesystem will not be changed.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ODSFile.ODSFileRef

Field Summary

Fields

Modifier and Type	Field and Description
protected AoSession	aosObj
protected long	cObjPtr
protected static java.util.Vector<java.lang.String>	deletedFiles
protected static java.util.HashMap<java.lang.Long,ODSFile.ODSFileRef>	refCache

Constructor Summary

Constructors

Constructor and Description
ODSFile()
ODSFile(long cObjPtr)

Method Summary

Methods

Modifier and Type	Method and Description
org.omg.CORBA.Request	_create_request(org.omg.CORBA.Context ctx, java.lang.String operation, org.omg.CORBA.NVList arg_list, org.omg.CORBA.NamedValue result)
org.omg.CORBA.Request	_create_request(org.omg.CORBA.Context ctx, java.lang.String operation, org.omg.CORBA.NVList arg_list, org.omg.CORBA.NamedValue result, org.omg.CORBA.ExceptionList exclist, org.omg.CORBA.ContextList ctxlist)
org.omg.CORBA.Object	_duplicate()
org.omg.CORBA.DomainManager[]	_get_domain_managers()
org.omg.CORBA.Policy	_get_policy(int policy_type)
int	_hash(int maximum)
boolean	_is_equivalent(org.omg.CORBA.Object other)
void	_release()
org.omg.CORBA.Request	_request(java.lang.String operation)
org.omg.CORBA.Object	_set_policy_override(org.omg.CORBA.Policy[] policies, org.omg.CORBA.SetOverrideType set_add)
void	addInstanceAttribute(NameValueUnit instAttr) Add an instance attribute to the instance.
ODSWriteTransfer	append() (30000) Get the ODSWriteTransfer interface for the file, to allow appending further bytes to the file.
boolean	canRead() (30001) Check whether the file may be opened for reading.
boolean	canWrite() (30002) Check whether the file may be opened for writing.
void	closeWriteTransfer(long size) Close the write transfer of the file
T_LONGLONG	compare(InstanceElement ieObj) Compare two instance elements.
T_LONGLONG	compare(InstanceElement instanceElement) Compare two instance elements.
ODSWriteTransfer	create() (30003) Create a new file at the ODS server and get the ODSWriteTransfer interface for that file, to allow storing bytes to the file.
InstanceElement[]	createRelatedInstances(ApplicationRelation applicationRelation, NameValueSeqUnit[] nameValueSeqUnit, ApplicationRelationInstanceElementSeq[] applicationRelationInstanceElementSeq) Create a list with instances which are related to the actual instance element.
void	createRelation(ApplicationRelation relation, InstanceElement instElem) Create a relation between the current and the given instance.
InstanceElement	deepCopy(java.lang.String newName, java.lang.String newVersion) Provides an easy-to-use and effective copy mechanismn for instance element hierarchies inside the server (e.g. copy a project with all tests or copy a test with all measurements).
void	destroy() Destroy the object on the server.
boolean	exists() (30004) Check whether the file physically exists at the ODS server.
protected void	finalize()
ApplicationElement	getApplicationElement() Get the application element of the instance element.
java.lang.String	getAsamPath() Get the ASAM-Path of the instance element.
java.lang.String	getDate() (30005) Get the date of the file.
T_LONGLONG	getId() Get the Id of the instance element.
InitialRight[]	getInitialRights() Retrieve access control list information for the initial rights of the given object.
static org.omg.CORBA.Object	getInstance(long cObjPtr, AoSession aosObj)
java.lang.String	getName() Get the name of the instance element.
InstanceElementIterator	getRelatedInstances(ApplicationRelation applRel, java.lang.String iePattern) Get the related instances.
InstanceElementIterator	getRelatedInstancesByRelationship(Relationship ieRelationship, java.lang.String iePattern) Get the list of related instances.
ACL[]	getRights() Retrieve access control list information of the given object.
T_LONGLONG	getSize() (30006) Get the size of the file.
NameValueUnit	getValue(java.lang.String attrName) Get the attribute value (name, value and unit) of the given attribute of the instance element.
NameValueUnit	getValueByBaseName(java.lang.String baseAttrName) Get the attribute value (value and unit) of the attribute inherited from the given base attribute of the instance element.
NameValueUnit	getValueInUnit(NameUnit attr) Get the attribute value (name, value and unit) of the given attribute of the instance element.
NameValueUnit[]	getValueSeq(java.lang.String[] attrNames) Get the sequence of the values of the application or instance attributes, specified by their names.
long	lastAccessTime() Returns the time stamp of the last access in milliseconds.
java.lang.String[]	listAttributes(java.lang.String iaPattern, AttrType aType) Get the attribute names from the instance element.
NameIterator	listRelatedInstances(ApplicationRelation ieRelation, java.lang.String iePattern) Get the names of the related instances.
NameIterator	listRelatedInstancesByRelationship(Relationship ieRelationship, java.lang.String iePattern) Get the names of the related instances.
protected void	nativeDestroy(AoSession aosObj)
ODSReadTransfer	read() (30008) Get the ODSReadTransfer interface for the file.
void	remove() (30007) Remove a file from the ODS server.
void	removeFromControl(java.lang.String targetUrl) (30010) Remove a file that is currently under control of the ODS server out of control of the server and move it to a specified location in the server namespace.
void	removeInstanceAttribute(java.lang.String attrName) Remove an instance attribute.
void	removeRelation(ApplicationRelation applRel, InstanceElement instElem_nm) Remove the relation between the current instance and the given instance.
void	renameInstanceAttribute(java.lang.String oldName, java.lang.String newName) Rename the instance attribute.
void	setInitialRights(InstanceElement usergroup, int rights, T_LONGLONG refAid, RightsSet set) The given usergroup the initial rights should be set for.
void	setName(java.lang.String iaName) Set the name of an instance element.
void	setRights(InstanceElement usergroup, int rights, RightsSet set) The given usergroup the rights should be set for.
void	setValue(NameValueUnit value) Set the value of an application or instance attribute.
void	setValueSeq(NameValueUnit[] values) Set a sequences of values of an application or instance attributes.
InstanceElement	shallowCopy(java.lang.String newName, java.lang.String newVersion) Provides an easy-to-use and effective copy mechanismn for instance elements inside the server.
void	takeUnderControl(java.lang.String sourceUrl) (30009) Put a file that is already residing in the ODS server under control of the ODS server.
void	touch() Touches this instance and reset the last access time telling to any other that this instance is still active, although no method was called.
Measurement	upcastMeasurement() Cast an instance element to a measurement.
ODSFile	upcastODSFile() (14033) Upcast the InstanceElement object to the corresponding ODSFile interface for an instance.
SubMatrix	upcastSubMatrix() Cast an instance element to a submatrix.

Methods inherited from class org.asam.ods.ODSFilePOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.omg.CORBA.Object

_get_interface_def, _is_a, _non_existent

Field Detail

refCache

protected static java.util.HashMap<java.lang.Long,ODSFile.ODSFileRef> refCache

deletedFiles

protected static java.util.Vector<java.lang.String> deletedFiles

cObjPtr

protected long cObjPtr

aosObj

protected AoSession aosObj

Constructor Detail

ODSFile

public ODSFile()

ODSFile

public ODSFile(long cObjPtr)

Method Detail

getInstance

public static org.omg.CORBA.Object getInstance(long cObjPtr,
                               AoSession aosObj)

addInstanceAttribute

public void addInstanceAttribute(NameValueUnit instAttr)
                          throws AoException

Add an instance attribute to the instance. The instance attribute is build as a Name/Value/Unit tuple on the client. This method has to copy the data from the client to the server. The name of the attribute must be unique. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

addInstanceAttribute in interface InstanceElementOperations

Parameters:

instAttr - The instance attribute to be added.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

createRelation

public void createRelation(ApplicationRelation relation,
                  InstanceElement instElem)
                    throws AoException

Create a relation between the current and the given instance. Check if the application elements of the relation matches the application elements of the instances. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

createRelation in interface InstanceElementOperations

Parameters:

relation - The application relation.

instElem - The instance element.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_INVALID_RELATION AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getApplicationElement

public ApplicationElement getApplicationElement()
                                         throws AoException

Get the application element of the instance element.

Specified by:

getApplicationElement in interface InstanceElementOperations

Returns:

The application element from which the instance element is derived.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getAsamPath

public java.lang.String getAsamPath()
                             throws AoException

Get the ASAM-Path of the instance element.

Specified by:

getAsamPath in interface InstanceElementOperations

Returns:

The ASAM path to the instance element.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getId

public T_LONGLONG getId()
                 throws AoException

Get the Id of the instance element.

Specified by:

getId in interface InstanceElementOperations

Returns:

The Id of the instance element.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

compare

public T_LONGLONG compare(InstanceElement ieObj)
                   throws AoException

Compare two instance elements. The Id's of the application elements and the Id's of the instance elements are compared. The Id's of the application elements will be compare first.

Returns:

The difference of the Id's. Meaning: diff < 0 ElemId of instance is smaller then instance to compare with. diff == 0 ElemId is identical. diff > 0 ElemId of instance is greater then instance to compare with.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_BAD_PARAMETER

getName

public java.lang.String getName()
                         throws AoException

Get the name of the instance element.

Specified by:

getName in interface InstanceElementOperations

Returns:

The name of the instance element.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getRelatedInstances

public InstanceElementIterator getRelatedInstances(ApplicationRelation applRel,
                                          java.lang.String iePattern)
                                            throws AoException

Get the related instances. The application relation and the name of the related instances specify the listed instances. The pattern is case sensitive and may contain wildcard characters.

Specified by:

getRelatedInstances in interface InstanceElementOperations

Parameters:

applRel - The application relation.

iePattern - The name or the search pattern for the related instance names.

Returns:

The related instances.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_INVALID_RELATION AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getRelatedInstancesByRelationship

public InstanceElementIterator getRelatedInstancesByRelationship(Relationship ieRelationship,
                                                        java.lang.String iePattern)
                                                          throws AoException

Get the list of related instances. The relationship and the name of the related instances specify the listed instances. The pattern is case sensitive and may contain wildcard characters.

Specified by:

getRelatedInstancesByRelationship in interface InstanceElementOperations

Parameters:

ieRelationship - The requested relationship.

iePattern - The name or the search pattern for the related instance names.

Returns:

The related instances.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_INVALID_RELATIONSHIP AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getValue

public NameValueUnit getValue(java.lang.String attrName)
                       throws AoException

Get the attribute value (name, value and unit) of the given attribute of the instance element. This method will not return the value of relation attributes, use the method getRelatedInstances.

Specified by:

getValue in interface InstanceElementOperations

Parameters:

attrName - The name of the requested attribute.

Returns:

The attribute value.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getValueByBaseName

public NameValueUnit getValueByBaseName(java.lang.String baseAttrName)
                                 throws AoException

Get the attribute value (value and unit) of the attribute inherited from the given base attribute of the instance element. The base name is case insensitive and may not contain wildcard characters.

Specified by:

getValueByBaseName in interface InstanceElementOperations

Parameters:

baseAttrName - The base name of the requested attribute.

Returns:

The attribute value.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

listAttributes

public java.lang.String[] listAttributes(java.lang.String iaPattern,
                                AttrType aType)
                                  throws AoException

Get the attribute names from the instance element. The attributes reserved for a relation are not listed.

Specified by:

listAttributes in interface InstanceElementOperations

Parameters:

iaPattern - The name or the search pattern for the attribute names.

aType - The requested attribute type.

Returns:

The names of the attributes.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_INVALID_ATTRIBUTE_TYPE AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

listRelatedInstances

public NameIterator listRelatedInstances(ApplicationRelation ieRelation,
                                java.lang.String iePattern)
                                  throws AoException

Get the names of the related instances. The application relation and the name of the related instances specifies the listed names. The pattern is case sensitive and may contain wildcard characters.

Specified by:

listRelatedInstances in interface InstanceElementOperations

Parameters:

ieRelation - The application relation.

iePattern - The name or the search pattern for the related instance names.

Returns:

The names of the related instances.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

listRelatedInstancesByRelationship

public NameIterator listRelatedInstancesByRelationship(Relationship ieRelationship,
                                              java.lang.String iePattern)
                                                throws AoException

Get the names of the related instances. The relationship and the name of the related instances specify the listed names. The pattern is case sensitive and may contain wildcard characters.

Specified by:

listRelatedInstancesByRelationship in interface InstanceElementOperations

Parameters:

ieRelationship - The requested relationship.

iePattern - The name or the search pattern for the related instance names.

Returns:

The names of the related instances.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_INVALID_RELATIONSHIP AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

removeInstanceAttribute

public void removeInstanceAttribute(java.lang.String attrName)
                             throws AoException

Remove an instance attribute. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The application attributes can't be removed.

Specified by:

removeInstanceAttribute in interface InstanceElementOperations

Parameters:

attrName - The name of the attribute to be removed.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_FOUND AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

removeRelation

public void removeRelation(ApplicationRelation applRel,
                  InstanceElement instElem_nm)
                    throws AoException

Remove the relation between the current instance and the given instance. It is necessary to specify the instance element in case of n:m relations if not all relations shall be deleted. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

removeRelation in interface InstanceElementOperations

Parameters:

applRel - The relation to be removed.

instElem_nm - The instance element for specific delete from n:m relations.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_INVALID_RELATION AO_NOT_FOUND AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

renameInstanceAttribute

public void renameInstanceAttribute(java.lang.String oldName,
                           java.lang.String newName)
                             throws AoException

Rename the instance attribute. The application attributes can't be renamed. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

renameInstanceAttribute in interface InstanceElementOperations

Parameters:

oldName - The old instance attribute name.

newName - The new instance attribute name.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_DUPLICATE_NAME AO_IMPLEMENTATION_PROBLEM AO_NOT_FOUND AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

setName

public void setName(java.lang.String iaName)
             throws AoException

Set the name of an instance element. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

setName in interface InstanceElementOperations

Parameters:

iaName - The instance attribute name.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

setValue

public void setValue(NameValueUnit value)
              throws AoException

Set the value of an application or instance attribute. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The name of the attribute is specified by the name of the NameValueUnit tuple. If the application attribute flag unique is set, the uniqueness of the new value is checked. This method can not be used to set the valueof a relation attribute, use the method createRelation.

Specified by:

setValue in interface InstanceElementOperations

Parameters:

value - The value to be set in the instance element.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_DUPLICATE_VALUE AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

upcastMeasurement

public Measurement upcastMeasurement()
                              throws AoException

Cast an instance element to a measurement. There are some object oriented languages which do not allow this cast.

Specified by:

upcastMeasurement in interface InstanceElementOperations

Returns:

The instance of type measurement.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

upcastSubMatrix

public SubMatrix upcastSubMatrix()
                          throws AoException

Cast an instance element to a submatrix. There are some object oriented languages which do not allow this cast.

Specified by:

upcastSubMatrix in interface InstanceElementOperations

Returns:

The instance of type submatrix.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getValueInUnit

public NameValueUnit getValueInUnit(NameUnit attr)
                             throws AoException

Get the attribute value (name, value and unit) of the given attribute of the instance element.

Specified by:

getValueInUnit in interface InstanceElementOperations

Parameters:

attr - The name of the requested attribute and the unit of the attribute value.

Returns:

The attribute value, value converted to the requested unit.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_INCOMPATIBLE_UNITS AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getValueSeq

public NameValueUnit[] getValueSeq(java.lang.String[] attrNames)
                            throws AoException

Get the sequence of the values of the application or instance attributes, specified by their names. The name sequence can use a pattern (*) for all attributes of the instance element. This means that application as well as instance attributes will be delivered.

Specified by:

getValueSeq in interface InstanceElementOperations

Parameters:

attrNames - The names of the attributes to be reported.

Returns:

The sequence of the attribute values.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

setValueSeq

public void setValueSeq(NameValueUnit[] values)
                 throws AoException

Set a sequences of values of an application or instance attributes. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The name of the attribute is specified by the name of the NameValueUnit tuple. If the application attribute flag unique is set, the uniqueness of the new value is checked.

Specified by:

setValueSeq in interface InstanceElementOperations

Parameters:

values - The sequence of the values to be set at the instance element.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_DUPLICATE_VALUE AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

setRights

public void setRights(InstanceElement usergroup,
             int rights,
             RightsSet set)
               throws AoException

The given usergroup the rights should be set for. defines the rights to set or clear. If the parameter is set to 'set', the rights in are set all other are cleared. If the parameter is set to 'add', the rights in are add to the existing rights. If the parameter is set to 'remove', the rights in are removed from the existing rights.

Specified by:

setRights in interface InstanceElementOperations

Parameters:

usergroup - The usergroup for which the rights will be modified.

rights - The new right for the usergroup. The rights constants are defined in the interface SecurityRights. The interface definition language IDL does not allow to set the values of enumerations thus the constant definitions had to be done in an interface.

set - What to do with the new right.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

getRights

public ACL[] getRights()
                throws AoException

Retrieve access control list information of the given object.

Specified by:

getRights in interface InstanceElementOperations

Returns:

The access control list entries of the given application element.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

getInitialRights

public InitialRight[] getInitialRights()
                                throws AoException

Retrieve access control list information for the initial rights of the given object.

Specified by:

getInitialRights in interface InstanceElementOperations

Returns:

The access control list entries with the initial rights of the given application element.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

setInitialRights

public void setInitialRights(InstanceElement usergroup,
                    int rights,
                    T_LONGLONG refAid,
                    RightsSet set)
                      throws AoException

The given usergroup the initial rights should be set for. defines the rights to set or clear. If the parameter is set to 'set', the rights in are set all other are cleared. If the parameter is set to 'add', the rights in are add to the existing rights. If the parameter is set to 'remove', the rights in are removed from the existing rights.

Specified by:

setInitialRights in interface InstanceElementOperations

Parameters:

usergroup - The usergroup for which the initial rights will be modified.

rights - The new initial rights for the usergroup. The rights constants are defined in the interface SecurityRights. The interface definition language IDL does not allow to set the values of enumerations thus the constant definitions had to be done in an interface.

refAid - The Id of referencing application element for which the initial rights will be used. If no refAid is set the initial rights will be used for each new instance element independent of the application element.

set - What to do with the new initial rights.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

shallowCopy

public InstanceElement shallowCopy(java.lang.String newName,
                          java.lang.String newVersion)
                            throws AoException

Provides an easy-to-use and effective copy mechanismn for instance elements inside the server. The new instance elements gets a copy of all attribute values and informational relations that are available in the original instance element. The new instance element has the same parent as the original instance element but it does not have references to any children of the original instance element.

Specified by:

shallowCopy in interface InstanceElementOperations

Parameters:

newName - The name of the new instance element. If a new version shall be created this parameter may be NULL to use the same name for the copy. In this case a new version must be provided.

newVersion - The version of the new instance element. This parameter may be NULL if a new name is provided.

Returns:

The reference to the copied instance element.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

deepCopy

public InstanceElement deepCopy(java.lang.String newName,
                       java.lang.String newVersion)
                         throws AoException

Provides an easy-to-use and effective copy mechanismn for instance element hierarchies inside the server (e.g. copy a project with all tests or copy a test with all measurements). The deep copy follows only the child references but not the informational references. Example: Copying elements of type AoMeasurement does not include copying the referenced elements of type AoMeasurementQuantity. The copied instance elements of type AoMeasurement will reference the same measurement quantities as the original. An application that wants to copy the measurement quantity also must do this (including setting the proper references) by itself e.g. with another call to shallowCopy; deepCopy is not necessary in this case because AoMeasurementQuantity has no children.

Specified by:

deepCopy in interface InstanceElementOperations

Parameters:

newName - The name of the new instance element. If a new version shall be created this parameter may be NULL to use the same name for the copy. In this case a new version must be provided.

newVersion - The version of the new instance element. This parameter may be NULL if a new name is provided.

Returns:

The reference to the copied instance element hierarchy.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

destroy

public void destroy()
             throws AoException

Destroy the object on the server. The destructor of the client so the server knows this object is not used anymore by the client. Access to this object after the destroy method will lead to an exception.

Specified by:

destroy in interface AvalonDestroyable

Specified by:

destroy in interface InstanceElementOperations

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

nativeDestroy

protected void nativeDestroy(AoSession aosObj)
                      throws AoException

Throws:

AoException

compare

public T_LONGLONG compare(InstanceElement instanceElement)
                   throws AoException

Compare two instance elements. The Id's of the application elements and the Id's of the instance elements are compared. The Id's of the application element will be compare first.

Specified by:

compare in interface InstanceElementOperations

Parameters:

compIeObj - The instance element to compare with.

Returns:

The difference of the Id's. Meaning: diff < 0 ElemId of instance is smaller then instance to compare with. diff == 0 ElemId is identical. diff > 0 ElemId of instance is greater then instance to compare with.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE

createRelatedInstances

public InstanceElement[] createRelatedInstances(ApplicationRelation applicationRelation,
                                       NameValueSeqUnit[] nameValueSeqUnit,
                                       ApplicationRelationInstanceElementSeq[] applicationRelationInstanceElementSeq)
                                         throws AoException

Create a list with instances which are related to the actual instance element. The attribute are given with the name of the sequence. The values of the attributes are given in the value sequence. The index in the different value sequences match for one instance element. The index in the instance element sequence of the related instances match for the instance with the same index in the value sequence.

Specified by:

createRelatedInstances in interface InstanceElementOperations

Parameters:

applRel - The application relation for wich the related instances will be created.

attributes - The attributes of the new created instances.

relatedInstances - The list with related instances for different application relations.

Returns:

The list with the new created instances.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_TRANSACTION_NOT_ACTIVE AO_INVALID_REQUEST

Since:

ASAM ODS 5.0

upcastODSFile

public ODSFile upcastODSFile()
                      throws AoException

(14033) Upcast the InstanceElement object to the corresponding ODSFile interface for an instance. This method may only be invoked for instances of an application element derived from the base element AoFile and returns an ODSFile interface. An exception with the error code AO_INVALID_BASETYPE is thrown when the instance is not an instance of an application element derived from the base element AoFile.

Specified by:

upcastODSFile in interface InstanceElementOperations

Returns:

The ODSFile interface to access the desired file.

Throws:

AoException - with the following possible error codes: AO_INVALID_BASETYPE AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

append

public ODSWriteTransfer append()
                        throws AoException

(30000) Get the ODSWriteTransfer interface for the file, to allow appending further bytes to the file. This method returns the ODSWriteTransfer interface for the file represented by this ODSFile object. That interface allows to write sequentially to the file, beginning at the end of the currently existing file. Before returning the interface ODSWriteTransfer, the physical file will be opened for subsequent write operations. In case the current user has no UPDATE right for the instance (resp. for all of its attributes in case of attribute security) from which this ODSFile object was created, the exception AO_ACCESS_DENIED will be thrown. In case the physical file referenced by this ODSFile object cannot be found, the exception AO_BAD_OPERATION will be thrown. In case the physical file referenced by this ODSFile object is currently opened by an ODSReadTransfer or an ODSWriteTransfer object, the exception AO_FILE_LOCKED will be thrown. In case the physical file referenced by this ODSFile object cannot be found, the exception AO_SYSTEM_PROBLEM will be thrown. In case the file cannot be opened for writing the exception AO_SYSTEM_PROBLEM will be thrown.

Specified by:

append in interface ODSFileOperations

Returns:

The ODSWriteTransfer interface to append to the file.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_FILE_LOCKED AO_ACCESS_DENIED AO_BAD_OPERATION AO_SYSTEM_PROBLEM

closeWriteTransfer

public void closeWriteTransfer(long size)

Close the write transfer of the file

Parameters:

size - the new size of the file

canRead

public boolean canRead()
                throws AoException

(30001) Check whether the file may be opened for reading. This method checks whether the file represented by this ODSFile object may be opened by the ODS server for reading access. The method returns a boolean TRUE in case the file may be opened for reading, and a boolean FALSE in case it cannot be opened for reading or it is already opened for write access (i.e. an ODSWriteTransfer object for this file exists). In case the physical file referenced by this ODSFile object cannot be found, false will be returned.

Specified by:

canRead in interface ODSFileOperations

Returns:

Information about whether the file can be opened for reading

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

canWrite

public boolean canWrite()
                 throws AoException

(30002) Check whether the file may be opened for writing. This method checks whether the file represented by this ODSFile object may be opened by the ODS server for writing access. The method returns a boolean TRUE in case the user has appropriate rights and the file can be opened for writing, and a boolean FALSE in case it is already opened for write access (i.e. an ODSWriteTransfer object for this file exists) or for read access (i.e. one or more ODSReadTransfer objects for this file exist). In case ao_location is defined and the current user has no UPDATE right for the instance from which this ODSFile object was created, a boolean FALSE will be returned. In case ao_location is undefined and the current user has no INSERT right for the instance from which this ODSFile object was created, a boolean FALSE will be returned.

Specified by:

canWrite in interface ODSFileOperations

Returns:

Information about whether the file can be opened for writing

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

create

public ODSWriteTransfer create()
                        throws AoException

(30003) Create a new file at the ODS server and get the ODSWriteTransfer interface for that file, to allow storing bytes to the file. This method returns the ODSWriteTransfer interface for the file represented by this ODSFile object. That interface allows to write sequentially to the (initially empty) file. Before returning the interface ODSWriteTransfer, the physical file will be created at the ODS server and opened for subsequent write operations. The file name will be decided by the ODS server and set as value of the attribute derived from the base attribute 'ao_location' of the instance from which this ODSFile object was created. In case the current user has no INSERT right for the instance from which this ODSFile object was created, the exception AO_ACCESS_DENIED will be thrown. If the attribute derived from 'ao_location' of the instance from which this ODSFile object was created already has a value, the instance potentially already references a file which was not yet removed, and the server will check whether that former file still exists in the server namespace. If so the exception AO_BAD_OPERATION will be thrown and no new file will be created. In case the file cannot be opened for writing the exception AO_SYSTEM_PROBLEM will be thrown.

Specified by:

create in interface ODSFileOperations

Returns:

The ODSWriteTransfer interface to a new file.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_ACCESS_DENIED AO_BAD_OPERATION AO_SYSTEM_PROBLEM

exists

public boolean exists()
               throws AoException

(30004) Check whether the file physically exists at the ODS server. This method checks whether the file represented by this ODSFile object truly exists at the expected location (e.g. on a specific drive/directory) in the ODS server namespace. The method returns a boolean TRUE in case the file exists, and a boolean FALSE in case it does not exist.

Specified by:

exists in interface ODSFileOperations

Returns:

Information about whether the file exists.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE

getDate

public java.lang.String getDate()
                         throws AoException

(30005) Get the date of the file. This method returns the date of the file represented by this ODSFile object. The returned string follows the rules for ODS date and time specification strings. The date returned shall specify the timestamp of the latest change of the file. It is the information the operating system of the ODS server provides; if there is no date available from the operating system with exactly this meaning, the ODS server shall return the closest information available. In case the physical file referenced by this ODSFile object cannot be found, the exception AO_SYSTEM_PROBLEM will be thrown. In case the physical file referenced by this ODSFile object is currently opened by an ODSWriteTransfer object of another session, the exception AO_FILE_LOCKED will be thrown. In case there is no file defined by the attribute derived from 'ao_location', the exception AO_BAD_OPERATION will be thrown.

Specified by:

getDate in interface ODSFileOperations

Returns:

The date of last change of the file represented by this ODSFile object.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_BAD_OPERATION AO_SYSTEM_PROBLEM AO_FILE_LOCKED

getSize

public T_LONGLONG getSize()
                   throws AoException

(30006) Get the size of the file. This method returns the size of the file represented by this ODSFile object. The returned value shall specify the exact file size in bytes. It is the information the operating system of the ODS server provides. In case the physical file referenced by this ODSFile object cannot be found, the exception AO_SYSTEM_PROBLEM will be thrown. In case there is no file defined by the attribute derived from 'ao_location', the exception AO_BAD_OPERATION will be thrown. In case the physical file referenced by this ODSFile object is currently opened by an ODSWriteTransfer object of another session, the exception AO_FILE_LOCKED will be thrown.

Specified by:

getSize in interface ODSFileOperations

Returns:

The size in bytes of the file represented by this ODSFile object.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_FILE_LOCKED AO_BAD_OPERATION AO_SYSTEM_PROBLEM

remove

public void remove()
            throws AoException

(30007) Remove a file from the ODS server. This method removes the file represented by this ODSFile object from the ODS server namespace if the user has appropriate rights. The attribute derived from the base attribute 'ao_location' of the instance from which this ODSFile object was created will become undefined and ao_size will be set to 0. In case the current user has no DELETE right for the instance from which this ODSFile object was created, the exception AO_ACCESS_DENIED will be thrown. In case the file is currently opened for write access (i.e. an ODSWriteTransfer object for this file exists) or for read access (i.e. one or more ODSReadTransfer objects for this file exist) an exception AO_FILE_LOCKED will be thrown. In case the physical file referenced by this ODSFile object does not exist, the method will return without any further file action; it will set the attribute derived from the base attribute 'ao_location' to undefined and 'ao_size' to 0; it will not throw an exception to signal the non-existence of the file. In case the file cannot be physically deleted from its location, the exception AO_SYSTEM_PROBLEM will be thrown.

Specified by:

remove in interface ODSFileOperations

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_FILE_LOCKED AO_ACCESS_DENIED AO_SYSTEM_PROBLEM

read

public ODSReadTransfer read()
                     throws AoException

(30008) Get the ODSReadTransfer interface for the file. This method returns the ODSReadTransfer interface for the file represented by this ODSFile object. That interface allows to read sequentially from the file, either starting at the very beginning or at a user-specified byte location within the file. Before returning the interface ODSReadTransfer, the physical file will be opened for reading. In case the physical file referenced by this ODSFile object is currently opened by an ODSWriteTransfer object, the exception AO_FILE_LOCKED will be thrown. In case there is no file defined by the attribute derived from 'ao_location', the exception AO_BAD_OPERATION will be thrown. In case the attribute derived from 'ao_location' is defined but the physical file referenced by this ODSFile object cannot be found or cannot be opened for reading, the exception AO_SYSTEM_PROBLEM will be thrown.

Specified by:

read in interface ODSFileOperations

Returns:

The ODSReadTransfer interface to read from the file.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_FILE_LOCKED AO_BAD_OPERATION AO_SYSTEM_PROBLEM

takeUnderControl

public void takeUnderControl(java.lang.String sourceUrl)
                      throws AoException

(30009) Put a file that is already residing in the ODS server under control of the ODS server. This method allows to put files under control of the ODS server (make them a 'managed file') without the need to stream their bytes through the ODSWriteTransfer interface. The parameter 'sourceUrl' specifies the location of the file that shall become a managed file. This location must reference a file which is accessible by the server. The server will move the file to a location where managed files reside and give it a name of its own choice; the file will no longer exist at its previous location. The server will store file name and location in the attribute derived from 'ao_location' and store the size of the file in the attribute derived from 'ao_size'. The string value of 'sourceUrl' must comply to the URL specification given in RFC 2396 with the restriction that ASAM ODS only supports absolute URLs with the access scheme "file:", otherwise the exception AO_BAD_PARAMETER will be thrown. In case there is no file defined by the attribute derived from 'ao_location', the exception AO_BAD_OPERATION will be thrown. In case the file cannot be physically moved from its original location to a server-location where managed files reside, the exception AO_SYSTEM_PROBLEM will be thrown (e.g. if the file specified by 'sourceUrl' does not exist, or if it cannot be physically moved, etc.).

Specified by:

takeUnderControl in interface ODSFileOperations

Parameters:

sourceUrl - Filename URL of the file to take under control as a managed file.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_BAD_PARAMETER AO_BAD_OPERATION AO_SYSTEM_PROBLEM

removeFromControl

public void removeFromControl(java.lang.String targetUrl)
                       throws AoException

(30010) Remove a file that is currently under control of the ODS server out of control of the server and move it to a specified location in the server namespace. This method allows to take files out of control of the ODS server and place them at a specified location, without the need to stream their bytes through the ODSReadTransfer interface. The parameter 'targetUrl' specifies the location to which the currently managed file shall be moved. This location must be accessible by the server. The server will move the file from the location where managed files reside to the location given by 'targetUrl'; the file will no longer exist at its previous location. The server will set the value of the attribute derived from 'ao_location' to undefined and of the attribute derived from 'ao_size' to 0. The string value of 'targetUrl' must comply to the URL specification given in RFC 2396 with the restriction that ASAM ODS only supports absolute URLs with the access scheme "file:"; otherwise the exception AO_BAD_PARAMETER will be thrown. In case the file specified by 'targetUrl' already exists the exception AO_BAD_PARAMETER will be thrown and no action will be performed by this method. In case the file specified by 'targetUrl' cannot be physically moved to the intended location, the exception AO_SYSTEM_PROBLEM will be thrown and no action will be performed by this method. In case the file referenced by this ODSFile object is currently opened for write access (i.e. an ODSWriteTransfer object for this file exists) or for read access (i.e. one or more ODSReadTransfer objects for this file exist) an exception AO_FILE_LOCKED will be thrown and no action will be performed by this method. In case there is no file defined by the attribute derived from 'ao_location', the exception AO_BAD_OPERATION will be thrown.

Specified by:

removeFromControl in interface ODSFileOperations

Parameters:

targetUrl - Filename URL of the file where to move the managed file.

Throws:

AoException - with the following possible error codes: AO_CONNECTION_LOST AO_IMPLEMENTATION_PROBLEM AO_NOT_IMPLEMENTED AO_NO_MEMORY AO_SESSION_NOT_ACTIVE AO_BAD_PARAMETER AO_FILE_LOCKED AO_SYSTEM_PROBLEM AO_BAD_OPERATION AO_BAD_PARAMETER

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

_create_request

public org.omg.CORBA.Request _create_request(org.omg.CORBA.Context ctx,
                                    java.lang.String operation,
                                    org.omg.CORBA.NVList arg_list,
                                    org.omg.CORBA.NamedValue result)

Specified by:

_create_request in interface org.omg.CORBA.Object

_create_request

public org.omg.CORBA.Request _create_request(org.omg.CORBA.Context ctx,
                                    java.lang.String operation,
                                    org.omg.CORBA.NVList arg_list,
                                    org.omg.CORBA.NamedValue result,
                                    org.omg.CORBA.ExceptionList exclist,
                                    org.omg.CORBA.ContextList ctxlist)

Specified by:

_create_request in interface org.omg.CORBA.Object

_duplicate

public org.omg.CORBA.Object _duplicate()

Specified by:

_duplicate in interface org.omg.CORBA.Object

_get_domain_managers

public org.omg.CORBA.DomainManager[] _get_domain_managers()

Specified by:

_get_domain_managers in interface org.omg.CORBA.Object

_get_policy

public org.omg.CORBA.Policy _get_policy(int policy_type)

Specified by:

_get_policy in interface org.omg.CORBA.Object

_hash

public int _hash(int maximum)

Specified by:

_hash in interface org.omg.CORBA.Object

_is_equivalent

public boolean _is_equivalent(org.omg.CORBA.Object other)

Specified by:

_is_equivalent in interface org.omg.CORBA.Object

_release

public void _release()

Specified by:

_release in interface org.omg.CORBA.Object

_request

public org.omg.CORBA.Request _request(java.lang.String operation)

Specified by:

_request in interface org.omg.CORBA.Object

_set_policy_override

public org.omg.CORBA.Object _set_policy_override(org.omg.CORBA.Policy[] policies,
                                        org.omg.CORBA.SetOverrideType set_add)

Specified by:

_set_policy_override in interface org.omg.CORBA.Object

lastAccessTime

public long lastAccessTime()

Description copied from interface: AvalonDestroyable

Returns the time stamp of the last access in milliseconds.

Specified by:

lastAccessTime in interface AvalonDestroyable

Returns:

the milliseconds representing the last access time.

touch

public void touch()
           throws AoException

Description copied from interface: AvalonDestroyable

Touches this instance and reset the last access time telling to any other that this instance is still active, although no method was called.

Specified by:

touch in interface AvalonDestroyable

Throws:

AoException - if touch fails