com.highqsoft.avalon

Class InstanceElement

java.lang.Object

org.omg.PortableServer.Servant

org.asam.ods.InstanceElementPOA

com.highqsoft.avalon.InstanceElement

All Implemented Interfaces:

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

public class InstanceElement
extends InstanceElementPOA
implements InstanceElement, AvalonDestroyable

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	InstanceElement.InstanceElementRef

Field Summary

Fields

Modifier and Type	Field and Description
protected AoSession	aosObj
protected long	cObjPtr
protected static java.util.HashMap<java.lang.Long,InstanceElement.InstanceElementRef>	refCache

Constructor Summary

Constructors

Constructor and Description
InstanceElement()
InstanceElement(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.
T_LONGLONG	compare(InstanceElement ieObj) Compare two instance elements.
T_LONGLONG	compare(InstanceElement instanceElement) Compare two instance elements.
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.
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.
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.
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.
void	nativeDestroy(AoSession aosObj)
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	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.InstanceElementPOA

_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,InstanceElement.InstanceElementRef> refCache

cObjPtr

protected long cObjPtr

aosObj

protected AoSession aosObj

Constructor Detail

InstanceElement

public InstanceElement()

InstanceElement

public InstanceElement(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

public 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

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