com.highqsoft.ods.athos

Class ApplicationElement

java.lang.Object

com.highqsoft.ods.athos.ApplicationElement

All Implemented Interfaces:

java.io.Serializable, ApplicationElement, ApplicationElementOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity

public class ApplicationElement
extends java.lang.Object
implements ApplicationElement

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected long	cObjPtr

Constructor Summary

Constructors

Constructor and Description
ApplicationElement()
ApplicationElement(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.Object	_get_interface_def()
org.omg.CORBA.Policy	_get_policy(int policy_type)
int	_hash(int maximum)
boolean	_is_a(java.lang.String repositoryIdentifier)
boolean	_is_equivalent(org.omg.CORBA.Object other)
boolean	_non_existent()
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)
ApplicationAttribute	createAttribute() Create a new application attribute on the server.
InstanceElement	createInstance(java.lang.String ieName) Create an instance of the application element.
InstanceElement[]	createInstances(NameValueSeqUnit[] attributes, ApplicationRelationInstanceElementSeq[] relatedInstances) Create a list with instances.
boolean	equals(java.lang.Object obj)
protected void	finalize()
ApplicationElement[]	getAllRelatedElements() Get a list of all related application elements connected to this application element.
ApplicationRelation[]	getAllRelations() Get a list of all application relations connected to this application element.
ApplicationStructure	getApplicationStructure() Get the application structure to which the application element belongs.
ApplicationAttribute	getAttributeByBaseName(java.lang.String baName) Get the application attribute of an application element which is inherited from the base attribute with the given name.
ApplicationAttribute	getAttributeByName(java.lang.String aaName) Get the application attribute of an application element which has the given name.
ApplicationAttribute[]	getAttributes(java.lang.String aaPattern) Get a list of the application attributes of an application element.
BaseElement	getBaseElement() Get the base element of an application element.
T_LONGLONG	getId() Get the Id of an application element.
ApplicationRelation[]	getInitialRightRelations() Get all relations which are used to retrieve the instances to create the initial rights of the new created instance element.
InitialRight[]	getInitialRights() Retrieve access control list information for the initial rights of the given object.
InstanceElement	getInstanceById(T_LONGLONG ieId) Get the instance element specified by the given Id.
InstanceElement	getInstanceByName(java.lang.String ieName) Get the instance element specified by the given name.
InstanceElementIterator	getInstances(java.lang.String iePattern) Get the instances whose names match the pattern.
java.lang.String	getName() Get the name of an application element.
ApplicationElement[]	getRelatedElementsByRelationship(Relationship aeRelationship) Get related application elements connected via the specified relationship.
ApplicationRelation[]	getRelationsByBaseName(java.lang.String brName) Return the basic application relations derived from the base relation with the givewn name.
ApplicationRelation[]	getRelationsByType(RelationType aeRelationType) Get application relations of the requested type connected from this application element.
ACL[]	getRights() Retrieve access control list information of the given object.
int	getSecurityLevel() Get the security level of the application element.
java.lang.String[]	listAllRelatedElements() Get the names of all related application elements.
java.lang.String[]	listAttributes(java.lang.String aaPattern) Get the application attribute names of the application element.
NameIterator	listInstances(java.lang.String aaPattern) Get the names of the instances whose names match the pattern.
java.lang.String[]	listRelatedElementsByRelationship(Relationship aeRelationship) Get the names of related application elements connected via the specified relationship.
void	removeAttribute(ApplicationAttribute applAttr) Remove an application attribute from an application element.
void	removeInstance(T_LONGLONG ieId, boolean recursive) Remove an instance from the application element.
void	setBaseElement(BaseElement baseElem) Set the base element of the application element.
void	setInitialRightRelation(ApplicationRelation applRel, boolean set) Set for the given application element, which relation will be used to determine the initial rights for the new created instances.
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 aeName) Set the name of the application element.
void	setRights(InstanceElement usergroup, int rights, RightsSet set) The given usergroup the rights should be set for.
void	setSecurityLevel(int secLevel, RightsSet set) Set the security level for the given application element.

Methods inherited from class java.lang.Object

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

Field Detail

cObjPtr

protected long cObjPtr

Constructor Detail

ApplicationElement

public ApplicationElement()

ApplicationElement

public ApplicationElement(long cObjPtr)

Method Detail

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

createAttribute

public ApplicationAttribute createAttribute()
                                     throws AoException

Create a new application attribute on the server. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The properties of the new application attribute may be changed via the set-methods of the ApplicationAttribute interface. For performance reasons it is recommended to set all required properties of an application attribute before it is commited the first time. This avoids database cross-checks for each attribute. The default properties of a new application attribute are: BaseAttribute NULL DataType DT_UNKNOWN IsObligatory 0 IsUnique 0 Length 0 Name "AUTOGEN" Unit NULL If there are already instances of the application element the values of the existing instances of the new attribute are set to undefined (flag AO_VF_DEFINED is set to zero). The exception AO_DUPLICATE_NAME name occurs if there is already another application attribute with the name "AUTOGEN".

Specified by:

createAttribute in interface ApplicationElementOperations

Returns:

The new application attribute.

Throws:

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

createInstance

public InstanceElement createInstance(java.lang.String ieName)
                               throws AoException

Create an instance of the application element. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The instance gets permanent when the transaction is committed. All attributes connected to the application element are automatically created and connected to the instance. The values of the attributes can be set by the method setValue of the interface InstanceElement.

Specified by:

createInstance in interface ApplicationElementOperations

Parameters:

ieName - The instance name.

Returns:

The new instance.

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

getAllRelatedElements

public ApplicationElement[] getAllRelatedElements()
                                           throws AoException

Get a list of all related application elements connected to this application element.

Specified by:

getAllRelatedElements in interface ApplicationElementOperations

Returns:

The related application elements.

Throws:

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

getAllRelations

public ApplicationRelation[] getAllRelations()
                                      throws AoException

Get a list of all application relations connected to this application element. The inverse relation of relations connected to other application elements pointing to the given application elements are not returned.

Specified by:

getAllRelations in interface ApplicationElementOperations

Returns:

The application relations of the application 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

getAttributeByBaseName

public ApplicationAttribute getAttributeByBaseName(java.lang.String baName)
                                            throws AoException

Get the application attribute of an application element which is inherited from the base attribute with the given name. The base name is case insensitive and may not contain wildcard characters.

Specified by:

getAttributeByBaseName in interface ApplicationElementOperations

Parameters:

baName - The base attribute name.

Returns:

The application attribute.

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

getAttributeByName

public ApplicationAttribute getAttributeByName(java.lang.String aaName)
                                        throws AoException

Get the application attribute of an application element which has the given name. The name is case sensitive and may not contain wildcard characters.

Specified by:

getAttributeByName in interface ApplicationElementOperations

Parameters:

aaName - The application attribute name.

Returns:

The application attribute.

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

getRelationsByBaseName

public ApplicationRelation[] getRelationsByBaseName(java.lang.String brName)
                                             throws AoException

Return the basic application relations derived from the base relation with the givewn name.

Specified by:

getRelationsByBaseName in interface ApplicationElementOperations

Parameters:

brName - The base relation name.

Returns:

The list with application relations.

Throws:

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

getAttributes

public ApplicationAttribute[] getAttributes(java.lang.String aaPattern)
                                     throws AoException

Get a list of the application attributes of an application element. There are no attributes returned in the result list that contain a reference to another application element.

Specified by:

getAttributes in interface ApplicationElementOperations

Parameters:

aaPattern - The name or the search pattern for the application attribute name.

Returns:

The application attributes.

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

getBaseElement

public BaseElement getBaseElement()
                           throws AoException

Get the base element of an application element.

Specified by:

getBaseElement in interface ApplicationElementOperations

Returns:

The base 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 an application element.

Specified by:

getId in interface ApplicationElementOperations

Returns:

The Id of the application 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

getInstanceById

public InstanceElement getInstanceById(T_LONGLONG ieId)
                                throws AoException

Get the instance element specified by the given Id. If the Id of the instance is not unique an exception is thrown.

Specified by:

getInstanceById in interface ApplicationElementOperations

Parameters:

ieId - The instance element Id.

Returns:

The 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

getInstanceByName

public InstanceElement getInstanceByName(java.lang.String ieName)
                                  throws AoException

Get the instance element specified by the given name. If the name of the instance is not unique an exception is thrown. This is a convienience method for instance elements with unique names. If there are duplicate names for instance use the method getInstances instead and specify the requested name as pattern parameter.

Specified by:

getInstanceByName in interface ApplicationElementOperations

Parameters:

ieName - The instance element name.

Returns:

The instance element.

Throws:

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

getInstances

public InstanceElementIterator getInstances(java.lang.String iePattern)
                                     throws AoException

Get the instances whose names match the pattern. The pattern is case sensitive and may contain wildcard characters.

Specified by:

getInstances in interface ApplicationElementOperations

Parameters:

iePattern - The name or the search pattern for the instance element name.

Returns:

The instance elements.

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

getName

public java.lang.String getName()
                         throws AoException

Get the name of an application element.

Specified by:

getName in interface ApplicationElementOperations

Returns:

The name of the application 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

getRelatedElementsByRelationship

public ApplicationElement[] getRelatedElementsByRelationship(Relationship aeRelationship)
                                                      throws AoException

Get related application elements connected via the specified relationship.

Specified by:

getRelatedElementsByRelationship in interface ApplicationElementOperations

Parameters:

aeRelationship - The requested relationship.

Returns:

The related application elements.

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

getRelationsByType

public ApplicationRelation[] getRelationsByType(RelationType aeRelationType)
                                         throws AoException

Get application relations of the requested type connected from this application element. The inverse relations are not returned.

Specified by:

getRelationsByType in interface ApplicationElementOperations

Parameters:

aeRelationType - The requested relation type.

Returns:

The application relations.

Throws:

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

listAllRelatedElements

public java.lang.String[] listAllRelatedElements()
                                          throws AoException

Get the names of all related application elements.

Specified by:

listAllRelatedElements in interface ApplicationElementOperations

Returns:

The names of the related application elements.

Throws:

AoException - with the following possible error codes: 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 aaPattern)
                                  throws AoException

Get the application attribute names of the application element. There are no attribute names returned in the result list that contain a reference to another application element.

Specified by:

listAttributes in interface ApplicationElementOperations

Parameters:

aaPattern - The name or the search pattern for the application attribute name.

Returns:

The names of the application attributes.

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

listInstances

public NameIterator listInstances(java.lang.String aaPattern)
                           throws AoException

Get the names of the instances whose names match the pattern. The pattern is case sensitive and may contain wildcard characters.

Specified by:

listInstances in interface ApplicationElementOperations

Parameters:

aaPattern - The name or the search pattern for the application attribute name.

Returns:

The names of the 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

listRelatedElementsByRelationship

public java.lang.String[] listRelatedElementsByRelationship(Relationship aeRelationship)
                                                     throws AoException

Get the names of related application elements connected via the specified relationship.

Specified by:

listRelatedElementsByRelationship in interface ApplicationElementOperations

Parameters:

aeRelationship - The requested relationship.

Returns:

The names of the related application elements.

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

removeAttribute

public void removeAttribute(ApplicationAttribute applAttr)
                     throws AoException

Remove an application attribute from an application element. If there are instances of the application element the attribute of the existing instances change from application to instance attributes. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction.

Specified by:

removeAttribute in interface ApplicationElementOperations

Parameters:

applAttr - The application attribute to remove.

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

removeInstance

public void removeInstance(T_LONGLONG ieId,
                  boolean recursive)
                    throws AoException

Remove an instance from the application element. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The instance is removed from the server when the transaction is commited. If the recursive flag is set all children of the instance are also deleted. Removing instances is allowed only if there are no references(relations) to this instance. If the recursive flag is set a reference to one of the children is not allowed and will cause an exception.

Specified by:

removeInstance in interface ApplicationElementOperations

Parameters:

ieId - The instance Id.

recursive - The recursive flag.

Throws:

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

setBaseElement

public void setBaseElement(BaseElement baseElem)
                    throws AoException

Set the base element of the application element. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The assignment to the current base element is overwritten. If there are instances of the application element or references to the application element an exception is thrown.

Specified by:

setBaseElement in interface ApplicationElementOperations

Parameters:

baseElem - The base element.

Throws:

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

setName

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

Set the name of the application element. It is allowed to modify the object outside a transaction but it is recommended to activate a transaction. The name of the application element must be unique.

Specified by:

setName in interface ApplicationElementOperations

Parameters:

aeName - The application element name.

Throws:

AoException - with the following possible error codes: AO_BAD_PARAMETER AO_CONNECTION_LOST AO_DUPLICATE_NAME 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 ApplicationElementOperations

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 ApplicationElementOperations

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 ApplicationElementOperations

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 ApplicationElementOperations

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

setInitialRightRelation

public void setInitialRightRelation(ApplicationRelation applRel,
                           boolean set)
                             throws AoException

Set for the given application element, which relation will be used to determine the initial rights for the new created instances.

Specified by:

setInitialRightRelation in interface ApplicationElementOperations

Parameters:

applRel - The application relation which will be used to determine the initial rights. The relation range of the application relation must be [1:1] otherwise the server can will not found an unique instance element to retrieve the initial rights.

set - Set or remove the relation for the initial rights. If this parameter is true the relation will be set otherwise removed.

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

getInitialRightRelations

public ApplicationRelation[] getInitialRightRelations()
                                               throws AoException

Get all relations which are used to retrieve the instances to create the initial rights of the new created instance element. If there are more then one application relation the initial rights of each related instance are 'ored' to the list of the initial rights.

Specified by:

getInitialRightRelations in interface ApplicationElementOperations

Returns:

The sequence with the application relations which will be used to create the initial rights of the new created 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

getSecurityLevel

public int getSecurityLevel()
                     throws AoException

Get the security level of the application element. The security level tells if there is a security check for both application element and instanc elements or only for the application attributes, the instance elements or none at all.

Specified by:

getSecurityLevel in interface ApplicationElementOperations

Returns:

The current security level. The security level constants are defined in the interface SecurityLevel. 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.

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

setSecurityLevel

public void setSecurityLevel(int secLevel,
                    RightsSet set)
                      throws AoException

Set the security level for the given application element. If the security level is added the client is responsable for the access control list entries of the existing objects.

Specified by:

setSecurityLevel in interface ApplicationElementOperations

Parameters:

secLevel - The new security level.The security level constants are defined in the interface SecurityLevel. 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 security level.

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

getApplicationStructure

public ApplicationStructure getApplicationStructure()
                                             throws AoException

Get the application structure to which the application element belongs.

Specified by:

getApplicationStructure in interface ApplicationElementOperations

Returns:

The application structure to which the application element belongs.

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

createInstances

public InstanceElement[] createInstances(NameValueSeqUnit[] attributes,
                                ApplicationRelationInstanceElementSeq[] relatedInstances)
                                  throws AoException

Create a list with instances. 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:

createInstances in interface ApplicationElementOperations

Parameters:

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

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_interface_def

public org.omg.CORBA.Object _get_interface_def()

Specified by:

_get_interface_def 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_a

public boolean _is_a(java.lang.String repositoryIdentifier)

Specified by:

_is_a 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

_non_existent

public boolean _non_existent()

Specified by:

_non_existent 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