com.highqsoft.avalon

Class ApplElemAccess

java.lang.Object

org.omg.PortableServer.Servant

org.asam.ods.ApplElemAccessPOA

com.highqsoft.avalon.ApplElemAccess

All Implemented Interfaces:

java.io.Serializable, ApplElemAccess, ApplElemAccessOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity, org.omg.CORBA.portable.InvokeHandler

public class ApplElemAccess
extends ApplElemAccessPOA
implements ApplElemAccess

The ApplElemAccess implementation.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected AoSession	aosObj The session where the object belongs to
protected long	cObjPtr Object pointer used in C (for native use only).
protected static java.util.HashMap<java.lang.Long,org.omg.CORBA.Object>	refCache HashMap for the reference cache that ensures identical objects.

Constructor Summary

Constructors

Constructor and Description
ApplElemAccess()
ApplElemAccess(long cObjPtr) The constructor with the ATHOS address pointer.

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	deleteInstances(T_LONGLONG aid, T_LONGLONG[] instIds) Delete instances from an application element.
protected void	finalize()
ACL[]	getAttributeRights(T_LONGLONG aid, java.lang.String attrName) Retrieve access control list information for the given application attribute 'aid'/'attr_name'.
InitialRight[]	getElementInitialRights(T_LONGLONG aid) Retrieve access control list information of the initial rights for the requested applciation element 'aid'.
ACL[]	getElementRights(T_LONGLONG aid) Retrieve access control list information for the requested applciation element 'aid'.
java.lang.String[]	getInitialRightReference(T_LONGLONG aid) Get all attribute names (references) which are used to retrieve the Initial Rights from.
static org.omg.CORBA.Object	getInstance(long cObjPtr, AoSession aosObj) This method is only called from native code.
InitialRight[]	getInstanceInitialRights(T_LONGLONG aid, T_LONGLONG instId) Retrieve access control list information of the initial rights for the requested instance 'aid'/'iid'.
ACL[]	getInstanceRights(T_LONGLONG aid, T_LONGLONG instId) Retrieve access control list information for the requested instance 'aid'/'iid'.
ElemResultSet[]	getInstances(QueryStructure aoq, int how_many) Perform the Query.
ResultSetExt[]	getInstancesExt(QueryStructureExt aoq, int how_many) Perform the Query.
ODSFile	getODSFile(ElemId elem) (24022) Get the ODSFile interface for an instance of an application element derived from AoFile.
T_LONGLONG[]	getRelInst(ElemId elem, java.lang.String relName) Get related instances (Id).
ValueMatrix	getValueMatrix(ElemId elem) Get the value matrix of a measurement or a submatrix.
ValueMatrix	getValueMatrixInMode(ElemId elem, ValueMatrixMode vmMode) Get the value matrix of a measurement or a submatrix.
ElemId[]	insertInstances(AIDNameValueSeqUnitId[] val) Insert instances into application element.
void	setAttributeRights(T_LONGLONG aid, java.lang.String attrName, T_LONGLONG usergroupId, int rights, RightsSet set) Set the ACL information on some application element-attribute defined by 'aid' and 'attr_name'.
void	setElementInitialRights(T_LONGLONG aid, T_LONGLONG usergroupId, int rights, T_LONGLONG refAid, RightsSet set) Set the access control list information for the initial rights on some application element defined by 'aid'.
void	setElementRights(T_LONGLONG aid, T_LONGLONG usergroupId, int rights, RightsSet set) Set the ACL information on some application element defined by 'aid'.
void	setInitialRightReference(T_LONGLONG aid, java.lang.String refName, RightsSet set) Set the flag 'set' in svcattr, if this reference will be used (or not) to retrieve the Initial Rights.
void	setInstanceInitialRights(T_LONGLONG aid, T_LONGLONG[] instIds, T_LONGLONG usergroupId, int rights, T_LONGLONG refAid, RightsSet set) Set the access control list information for the initial rights on some instance defined by the application element id 'aid' and a sequence of instance defined by the id 'iid'.
void	setInstanceRights(T_LONGLONG aid, T_LONGLONG[] instIds, T_LONGLONG usergroupId, int rights, RightsSet set) Set the ACL information on some instance defined by the application element id 'aid' and a sequence of instance defined by the id 'iid'.
void	setRelInst(ElemId elem, java.lang.String relName, T_LONGLONG[] instIds, SetType type) Set the instance reference.
void	updateInstances(AIDNameValueSeqUnitId[] val) Update instances in an application element.

Methods inherited from class org.asam.ods.ApplElemAccessPOA

_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

cObjPtr

protected long cObjPtr

Object pointer used in C (for native use only).

refCache

protected static java.util.HashMap<java.lang.Long,org.omg.CORBA.Object> refCache

HashMap for the reference cache that ensures identical objects.

aosObj

protected AoSession aosObj

The session where the object belongs to

Constructor Detail

ApplElemAccess

public ApplElemAccess()

ApplElemAccess

public ApplElemAccess(long cObjPtr)

The constructor with the ATHOS address pointer.

Parameters:

cObjPtr - the ATHOS address pointer,

Method Detail

getInstance

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

This method is only called from native code. Never call it from Java!

Parameters:

cObjPtr - the ATHOS address pointer

aosObj - the Avalon session where the object belongs to.

getInstances

public ElemResultSet[] getInstances(QueryStructure aoq,
                           int how_many)
                             throws AoException

Perform the Query. The number of different application elements which are requested are exactly defined by the definition of the query given in the anuSeq. The number of attributes for each application element is also given in the definition. The number of matching instances (their attributes) is not defined by the query and can be a large amount. Therefor only one iterator for the attribute values are defined.

Specified by:

getInstances in interface ApplElemAccessOperations

Parameters:

aoq - The query definition.

how_many - Number of values in each result set.

Returns:

The result set with the requested 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 AO_TRANSACTION_NOT_ACTIVE

getRelInst

public T_LONGLONG[] getRelInst(ElemId elem,
                      java.lang.String relName)
                        throws AoException

Get related instances (Id). This method returns a sequence of related instances. The relation name specifies the relation given in the ApplStructValue. The aid of the ElemId and the relName defines the unique relation and the elem2 is the target application element.

Specified by:

getRelInst in interface ApplElemAccessOperations

Parameters:

elem - Original instance. At the protocol level 3 this information was stored in the field elemId of the structure GetInstRefReq and the request AOP_GetInstRef.

relName - The relation name. At the protocol level 3 this information was stored in the field refName of the structure GetInstRefReq and the request AOP_GetInstRef.

Returns:

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

setRelInst

public void setRelInst(ElemId elem,
              java.lang.String relName,
              T_LONGLONG[] instIds,
              SetType type)
                throws AoException

Set the instance reference.

Specified by:

setRelInst in interface ApplElemAccessOperations

Parameters:

elem - The instance to add the related instances. At the protocol level 3 this information was stored in the field elemId1 of the structure SetInstRefReq and the request AOP_SetInstRef.

relName - The name of relation. At the protocol level 3 this information was stored in the field refName of the structure SetInstRefReq and the request AOP_SetInstRef.

instIds - Sequence of instance id's. At the protocol level 3 this information was stored in the field elemId2 of the structure SetInstRefReq and the request AOP_SetInstRef. It was not possiable to set more then one relation.

type - The type of the modification, insert, update or remove. At the protocol level 3 this information was stored in the field onoff of the structure SetInstRefReq and the request AOP_SetInstRef.

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

insertInstances

public ElemId[] insertInstances(AIDNameValueSeqUnitId[] val)
                         throws AoException

Insert instances into application element. This method returns a sequence of Id's, the order is related to the order of instance specified in the input. In case of inheritance, the method supports only instances of same subtype per call. The returned Id's are the Id's of the related supertype instances.

Specified by:

insertInstances in interface ApplElemAccessOperations

Parameters:

val - The sequence of attributes and their values. At the protocol level 3 this information was stored in the fields elemId and nvSeq of the structure PutValReq and the request AOP_PutValReq.

Returns:

List with the Id's of 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

Since:

ASAM ODS 5.0

updateInstances

public void updateInstances(AIDNameValueSeqUnitId[] val)
                     throws AoException

Update instances in an application element. It's necessary that the input structure includes also the Id attribute. In case of inherited application elements the supertype Id has to be included.

Specified by:

updateInstances in interface ApplElemAccessOperations

Parameters:

val - The sequence of attributes and their values. At least one of the attribute values sequence must be a sequence with the Id. At the protocol level 3 this information was stored in the fields elemId and nvSeq of the structure PutValReq and the request AOP_PutValReq.

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

deleteInstances

public void deleteInstances(T_LONGLONG aid,
                   T_LONGLONG[] instIds)
                     throws AoException

Delete instances from an application element. In case of inherited application elements the Id of the supertype has to be specified.

Specified by:

deleteInstances in interface ApplElemAccessOperations

Parameters:

aid - The application element Id.

instIds - The sequence of instance Id's. At the protocol level 3 this information was stored in the fields elemId and nvSeq of the structure PutValReq and the request AOP_PutValReq.

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

getValueMatrix

public ValueMatrix getValueMatrix(ElemId elem)
                           throws AoException

Get the value matrix of a measurement or a submatrix. If the value matrix will be built up with special submatrix link, use the interface Measument.

Specified by:

getValueMatrix in interface ApplElemAccessOperations

Parameters:

elem - The element id. The aid has to be the appliction element Id of the measurment or submatrix.

Returns:

The value matrix

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_BASETYPE

setAttributeRights

public void setAttributeRights(T_LONGLONG aid,
                      java.lang.String attrName,
                      T_LONGLONG usergroupId,
                      int rights,
                      RightsSet set)
                        throws AoException

Set the ACL information on some application element-attribute defined by 'aid' and 'attr_name'. The 'usergroup_id' defines the usergroup the rights should be set for. 'rights' defines the rights to set or clear. f the parameter 'set' is set to value 'set', the rights in 'rights' are set all other are cleared. If the parameter 'set' is set to value 'add', the rights in 'rights' are add to the existing rights. If the parameter 'set' is set to 'remove', the rights in 'rights' are removed from the existing rights. Restriction for the model: only one application element of the type AoUserGroup is allowed.

Specified by:

setAttributeRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

attrName - The name of the attribute.

usergroupId - The usergroup to set the rights for.

rights - The new right for the usergroup.

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

setElementRights

public void setElementRights(T_LONGLONG aid,
                    T_LONGLONG usergroupId,
                    int rights,
                    RightsSet set)
                      throws AoException

Set the ACL information on some application element defined by 'aid'. The 'usergroup_id' defines the usergroup the rights should be set for. 'rights' defines the rights to set or clear. If the parameter 'set' is set to value 'set', the rights in 'rights' are set all other are cleared. If the parameter 'set' is set to 'add', the rights in 'rights' are add to the existing rights. If the parameter 'set' is set to 'remove', the rights in 'rights' are removed from the existing rights. Restriction for the model: only one application element of the type AoUserGroup is allowed.

Specified by:

setElementRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

usergroupId - The usergroup to set the rights for.

rights - The new 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.

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

setInstanceRights

public void setInstanceRights(T_LONGLONG aid,
                     T_LONGLONG[] instIds,
                     T_LONGLONG usergroupId,
                     int rights,
                     RightsSet set)
                       throws AoException

Set the ACL information on some instance defined by the application element id 'aid' and a sequence of instance defined by the id 'iid'. The 'usergroup_id' defines the usergroup the rights should be set for. 'rights' defines the rights to set or clear. If the parameter 'set' is set to 'set', the rights in 'rights' are set all other are cleared. If the parameter 'set' is set to 'add', the rights in 'rights' are add to the existing rights. If the parameter 'set' is set to 'remove', the rights in 'rights' are removed from the existing rights. Restriction for the model: only one application element of the type AoUserGroup is allowed.

Specified by:

setInstanceRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

instIds - The sequence of instance Id's.

usergroupId - The usergroup to set the rights for.

rights - The new right for the usergroup.

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

getAttributeRights

public ACL[] getAttributeRights(T_LONGLONG aid,
                       java.lang.String attrName)
                         throws AoException

Retrieve access control list information for the given application attribute 'aid'/'attr_name'.

Specified by:

getAttributeRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

attrName - The name of the attribute.

Returns:

The access control list entries of the give 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 AO_TRANSACTION_NOT_ACTIVE

getElementRights

public ACL[] getElementRights(T_LONGLONG aid)
                       throws AoException

Retrieve access control list information for the requested applciation element 'aid'.

Specified by:

getElementRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

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

getInstanceRights

public ACL[] getInstanceRights(T_LONGLONG aid,
                      T_LONGLONG instId)
                        throws AoException

Retrieve access control list information for the requested instance 'aid'/'iid'.

Specified by:

getInstanceRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

instId - The Id of the instance.

Returns:

The access control list entries of the given 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 AO_TRANSACTION_NOT_ACTIVE

Since:

ASAM ODS 5.0

setElementInitialRights

public void setElementInitialRights(T_LONGLONG aid,
                           T_LONGLONG usergroupId,
                           int rights,
                           T_LONGLONG refAid,
                           RightsSet set)
                             throws AoException

Set the access control list information for the initial rights on some application element defined by 'aid'. The 'usergroup_id' defines the usergroup the rights should be set for. 'rights' defines the rights to set or clear. If the parameter 'set' is set to 'set', the rights in 'rights' are set all other are cleared. If the parameter 'set' is set to 'add', the rights in 'rights' are add to the existing rights. If the parameter 'set' is set to 'remove', the rights in 'rights' are removed from the existing rights. Restriction for the model: only one application element of the type AoUserGroup is allowed.

Specified by:

setElementInitialRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

usergroupId - The usergroup to set the initial rights for.

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

setInstanceInitialRights

public void setInstanceInitialRights(T_LONGLONG aid,
                            T_LONGLONG[] instIds,
                            T_LONGLONG usergroupId,
                            int rights,
                            T_LONGLONG refAid,
                            RightsSet set)
                              throws AoException

Set the access control list information for the initial rights on some instance defined by the application element id 'aid' and a sequence of instance defined by the id 'iid'. The 'usergroup_id' defines the usergroup the rights should be set for. 'rights' defines the rights to set or clear. If the parameter 'set' is set to 'set', the rights in 'rights' are set all other are cleared. If the parameter 'set' is set to 'add', the rights in 'rights' are add to the existing rights. If the parameter 'set' is set to 'remove', the rights in 'rights' are removed from the existing rights. Restriction for the model: only one application element of the type AoUserGroup is allowed.

Specified by:

setInstanceInitialRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

instIds - The sequence of instance Id's.

usergroupId - The usergroup to set the initial rights for.

rights - The new initial right for the usergroup.

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

setInitialRightReference

public void setInitialRightReference(T_LONGLONG aid,
                            java.lang.String refName,
                            RightsSet set)
                              throws AoException

Set the flag 'set' in svcattr, if this reference will be used (or not) to retrieve the Initial Rights. If more than one reference is set to true, the union (or-function) of all rights are used.

Specified by:

setInitialRightReference in interface ApplElemAccessOperations

Parameters:

aid - The application element Id.

refName - The name of the reference.

set - What to do with the given reference.

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

getInitialRightReference

public java.lang.String[] getInitialRightReference(T_LONGLONG aid)
                                            throws AoException

Get all attribute names (references) which are used to retrieve the Initial Rights from.

Specified by:

getInitialRightReference in interface ApplElemAccessOperations

Parameters:

aid - The application element Id.

Returns:

The names of the references which will be used for the initial rights determination.

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

getElementInitialRights

public InitialRight[] getElementInitialRights(T_LONGLONG aid)
                                       throws AoException

Retrieve access control list information of the initial rights for the requested applciation element 'aid'.

Specified by:

getElementInitialRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

Returns:

The access control list entries of the given application element for the 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

getInstanceInitialRights

public InitialRight[] getInstanceInitialRights(T_LONGLONG aid,
                                      T_LONGLONG instId)
                                        throws AoException

Retrieve access control list information of the initial rights for the requested instance 'aid'/'iid'.

Specified by:

getInstanceInitialRights in interface ApplElemAccessOperations

Parameters:

aid - The Id of the application element.

instId - The Id of the instance.

Returns:

The access control list entries of the given instance for the 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

Since:

ASAM ODS 5.0

getInstancesExt

public ResultSetExt[] getInstancesExt(QueryStructureExt aoq,
                             int how_many)
                               throws AoException

Perform the Query. This method can be used for a more powerfull query compared to the method getInstances of this interface, with join definitions and aggregate functions. The number of different application elements which are requested are exactly defined by the definition of the query given in the field anuSeq of the QueryStructureExt. The number of attributes for each application element is also given in the definition. The number of matching instances (their attributes) is not defined by the query and can be a large amount. Therefore only one iterator for the attribute values are defined.

Specified by:

getInstancesExt in interface ApplElemAccessOperations

Parameters:

aoq - The query definition.

how_many - Maximum number of values in each result set. Valid arguments are: how_many = 0 : report all found values, how_many > 0 : report a maximum number of values.

Returns:

The result set with the requested 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

Since:

ASAM ODS 5.0

getValueMatrixInMode

public ValueMatrix getValueMatrixInMode(ElemId elem,
                               ValueMatrixMode vmMode)
                                 throws AoException

Get the value matrix of a measurement or a submatrix. If the value matrix will be built up with special submatrix link, use the interface Measurement. For more information see the methods getValueMatrixInMode of the instances SubMatrix and Measurement.

Specified by:

getValueMatrixInMode in interface ApplElemAccessOperations

Parameters:

elem - The element id. The aid has to be the application element Id of the measurement or sub matrix.

vmMode - The requested mode of the value matrix.

Returns:

The value matrix.

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_INVALID_BASETYPE AO_INVALID_VALUEMATRIX_STRUCTURE

getODSFile

public ODSFile getODSFile(ElemId elem)
                   throws AoException

(24022) Get the ODSFile interface for an instance of an application element derived from AoFile. This method returns an ODSFile interface. One parameter controls the behavior of this method: The value of the parameter 'elem' (with its components 'aid' and 'iid') uniquely identifies an instance within the ODS storage. If no such instance exists, or if the instance is not an instance of an application element derived from AoFile, the exception AO_INVALID_BASETYPE is thrown. Note that an ODS server may be set up to support the ODS security concepts and that in such case access to a file is only allowed if the access rights of the accessing user are sufficient. If the user does not have at least READ rights for the instance specified by 'elem' an exception AO_ACCESS_DENIED will be thrown.

Specified by:

getODSFile in interface ApplElemAccessOperations

Parameters:

elem - The instance to which the file belongs, whose access is intended.

Returns:

The ODSFile interface to access the desired file.

Throws:

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

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