C++ Based OPC UA Client/Server/PubSub SDK  1.7.6.537
OpcUa::RoleType Class Reference

Class implementing the UaObject interface for the RoleType. More...

#include <opcua_roletype.h>

Inherits OpcUa::RoleTypeBase.

Public Member Functions

 RoleType (const UaNodeId &nodeId, UaObject *pInstanceDeclarationObject, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Construction of the class RoleType. More...
 
 RoleType (const UaNodeId &nodeId, const UaString &name, OpcUa_UInt16 browseNameNameSpaceIndex, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Construction of the class RoleType. More...
 
 RoleType (UaBase::Object *pBaseNode, XmlUaNodeFactoryManager *pFactory, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Constructs an instance of the class RoleType with all components. More...
 
virtual UaStatus AddApplication (const ServiceContext &serviceContext, const UaString &ApplicationUri)
 
virtual UaStatus AddEndpoint (const ServiceContext &serviceContext, const UaEndpointType &Endpoint)
 
virtual UaStatus AddIdentity (const ServiceContext &serviceContext, const UaIdentityMappingRuleType &Rule)
 
virtual UaStatus RemoveApplication (const ServiceContext &serviceContext, const UaString &ApplicationUri)
 
virtual UaStatus RemoveEndpoint (const ServiceContext &serviceContext, const UaEndpointType &Endpoint)
 
virtual UaStatus RemoveIdentity (const ServiceContext &serviceContext, const UaIdentityMappingRuleType &Rule)
 
- Public Member Functions inherited from OpcUa::RoleTypeBase
 RoleTypeBase (const UaNodeId &nodeId, UaObject *pInstanceDeclarationObject, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Constructs an RoleType object using an instance declaration node as base.
 
 RoleTypeBase (const UaNodeId &nodeId, const UaString &name, OpcUa_UInt16 browseNameNameSpaceIndex, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Constructs an RoleType object.
 
 RoleTypeBase (UaBase::Object *pBaseNode, XmlUaNodeFactoryManager *pFactory, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Constructs an instance of the class RoleTypeBase with all components. More...
 
virtual UaNodeId typeDefinitionId () const
 Returns the type definition NodeId for the RoleType.
 
virtual UaStatus beginCall (MethodManagerCallback *pCallback, const ServiceContext &serviceContext, OpcUa_UInt32 callbackHandle, MethodHandle *pMethodHandle, const UaVariantArray &inputArguments)
 Call method of an UA object. More...
 
virtual UaStatus call (const ServiceContext &serviceContext, MethodHandle *pMethodHandle, const UaVariantArray &inputArguments, UaVariantArray &outputArguments, UaStatusCodeArray &inputArgumentResults, UaDiagnosticInfos &inputArgumentDiag)
 Synchronous version of the MethodManager method call executed in a worker thread.
 
virtual void setApplications (const UaStringArray &Applications)
 Sets the Applications.
 
virtual void getApplications (UaStringArray &Applications) const
 Gets the Applications.
 
virtual void setApplicationsExclude (OpcUa_Boolean ApplicationsExclude)
 Sets the ApplicationsExclude value. More...
 
virtual OpcUa_Boolean getApplicationsExclude () const
 Returns the value of ApplicationsExclude. More...
 
virtual void setEndpoints (const UaEndpointTypes &Endpoints)
 Sets the Endpoints.
 
virtual void getEndpoints (UaEndpointTypes &Endpoints) const
 Gets the Endpoints.
 
virtual void setEndpointsExclude (OpcUa_Boolean EndpointsExclude)
 Sets the EndpointsExclude value. More...
 
virtual OpcUa_Boolean getEndpointsExclude () const
 Returns the value of EndpointsExclude. More...
 
virtual void setIdentities (const UaIdentityMappingRuleTypes &Identities)
 Sets the Identities.
 
virtual void getIdentities (UaIdentityMappingRuleTypes &Identities) const
 Gets the Identities.
 
virtual OpcUa::PropertyTypegetApplicationsNode ()
 Returns the Applications node. More...
 
virtual const OpcUa::PropertyTypegetApplicationsNode () const
 Returns the Applications node. More...
 
virtual OpcUa::PropertyTypegetApplicationsExcludeNode ()
 Returns the ApplicationsExclude node. More...
 
virtual const OpcUa::PropertyTypegetApplicationsExcludeNode () const
 Returns the ApplicationsExclude node. More...
 
virtual OpcUa::PropertyTypegetEndpointsNode ()
 Returns the Endpoints node. More...
 
virtual const OpcUa::PropertyTypegetEndpointsNode () const
 Returns the Endpoints node. More...
 
virtual OpcUa::PropertyTypegetEndpointsExcludeNode ()
 Returns the EndpointsExclude node. More...
 
virtual const OpcUa::PropertyTypegetEndpointsExcludeNode () const
 Returns the EndpointsExclude node. More...
 
virtual OpcUa::PropertyTypegetIdentitiesNode ()
 Returns the Identities node.
 
virtual const OpcUa::PropertyTypegetIdentitiesNode () const
 Returns the Identities node.
 
virtual OpcUa::BaseMethodgetAddApplication ()
 Returns the AddApplication node. More...
 
virtual const OpcUa::BaseMethodgetAddApplication () const
 Returns the AddApplication node. More...
 
virtual OpcUa::BaseMethodgetAddEndpoint ()
 Returns the AddEndpoint node. More...
 
virtual const OpcUa::BaseMethodgetAddEndpoint () const
 Returns the AddEndpoint node. More...
 
virtual OpcUa::BaseMethodgetAddIdentity ()
 Returns the AddIdentity node. More...
 
virtual const OpcUa::BaseMethodgetAddIdentity () const
 Returns the AddIdentity node. More...
 
virtual OpcUa::BaseMethodgetRemoveApplication ()
 Returns the RemoveApplication node. More...
 
virtual const OpcUa::BaseMethodgetRemoveApplication () const
 Returns the RemoveApplication node. More...
 
virtual OpcUa::BaseMethodgetRemoveEndpoint ()
 Returns the RemoveEndpoint node. More...
 
virtual const OpcUa::BaseMethodgetRemoveEndpoint () const
 Returns the RemoveEndpoint node. More...
 
virtual OpcUa::BaseMethodgetRemoveIdentity ()
 Returns the RemoveIdentity node. More...
 
virtual const OpcUa::BaseMethodgetRemoveIdentity () const
 Returns the RemoveIdentity node. More...
 
virtual void useAccessInfoFromType ()
 Applies the NodeAccessInfo set at the RoleTypeBase and its children. More...
 
void useAccessInfoFromInstance (RoleTypeBase *pInstance)
 Uses the NodeAccessInfo of pOther and its children. More...
 
- Public Member Functions inherited from OpcUa::BaseObjectType
 BaseObjectType (const UaNodeId &nodeId, UaObject *pInstanceDeclarationObject, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Construction of the class BaseObjectType. More...
 
 BaseObjectType (const UaNodeId &nodeId, const UaString &name, OpcUa_UInt16 browseNameNameSpaceIndex, NodeManagerConfig *pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
 Construction of the class BaseObjectType. More...
 
UaReferenceListsgetUaReferenceLists () const
 Get the UaReferenceLists interface for the node. More...
 
virtual UaStatus browse (const ServiceContext &serviceContext, BrowseContext &browseContext, UaReferenceDescriptions &References)
 Discover the references of a specified node of a view. More...
 
UaNodeId nodeId () const
 Get the NodeId of the current Node. More...
 
virtual UaQualifiedName browseName () const
 Get the browseName of the current Node. More...
 
virtual UaLocalizedText displayName (Session *pSession) const
 Get the displayName as LocalizedText of the current Node. More...
 
virtual OpcUa_Boolean isDescriptionSupported () const
 Check if Node is DescriptionSupported. More...
 
virtual UaLocalizedText description (Session *pSession) const
 Get the description as LocalizedText of the current Node. More...
 
virtual OpcUa_Boolean isWriteMaskSupported () const
 Check if Node is WriteMaskSupported. More...
 
virtual OpcUa_UInt32 writeMask () const
 Get the writeMask of the current Node. More...
 
virtual OpcUa_Boolean isUserWriteMaskSupported () const
 Check if Node is UserWriteMaskSupported. More...
 
virtual OpcUa_UInt32 userWriteMask (Session *pSession) const
 Check if Node has a userWriteMask. More...
 
UaNodegetUaNode () const
 Get the UaNode interface pointer of this node. More...
 
virtual OpcUa_Byte eventNotifier () const
 Returns the EventNotifier for the BaseObjectType. More...
 
virtual MethodManagergetMethodManager (UaMethod *pMethod) const
 Returns the method manager interface for the BaseObjectType instance. More...
 
virtual void setUserData (UserDataBase *pUserData)
 Method to set user data stored in this class. More...
 
virtual UserDataBasegetUserData () const
 Method to get the user data stored in this class. More...
 
virtual void setBrowseName (const UaQualifiedName &browseName)
 Sets the browse name attribute value. More...
 
virtual void setDisplayName (const UaLocalizedText &displayName)
 Sets the display name attribute value. More...
 
virtual void setDescription (const UaLocalizedText &description)
 Sets the description attribute value. More...
 
virtual void setWriteMask (OpcUa_UInt32 writeMask)
 Sets the write mask attribute value. More...
 
virtual void setEventNotifier (OpcUa_Byte eventNotifier)
 Sets the eventNotifier attribute value. More...
 
virtual void setModellingRuleId (const UaNodeId &modellingRuleId)
 Set NodeId of the modeling rule for this node. More...
 
virtual UaNodeId modellingRuleId () const
 Get NodeId of the modeling rule for this node. More...
 
void setMethodManager (MethodManager *pMethodManager)
 Allows a class aggregating the object to implement the MethodManager for this object. More...
 
virtual UaStatus setAttributeValue (Session *pSession, OpcUa_Int32 attributeId, const UaDataValue &dataValue, NodeAccessInfo *pDefaultPermissions, OpcUa_Boolean checkWriteMask)
 Sets the value of an attribute of the Node. More...
 
- Public Member Functions inherited from MethodManager
 MethodManager ()
 construction
 
virtual ~MethodManager ()
 destruction
 
- Public Member Functions inherited from UaObject
 UaObject (UaMutexRefCounted *pSharedMutex=NULL)
 Construction of the UaObject. More...
 
OpcUa_NodeClass nodeClass () const
 Get the node class of the Node. More...
 
virtual void getAttributeValue (Session *pSession, OpcUa_Int32 attributeId, NodeAccessInfo *pDefaultPermissions, UaDataValue &uaDataValue)
 Gets the value of an attribute of the Node. More...
 
- Public Member Functions inherited from UaNode
 UaNode (UaMutexRefCounted *pSharedMutex=NULL)
 Construction of the UaNode. More...
 
virtual UaNodeId getKey () const
 Get the key of the node used for the hash table. More...
 
virtual NodeAccessInfogetAccessInfo () const
 Returns the access info for this node. More...
 
virtual bool hasAccessInfo () const
 Check if this UaNode has a NodeAccessInfo assigned. More...
 
virtual void useAccessInfoFrom (const UaNode *pOther)
 Set the NodeAccessInfo from another node to this node. More...
 
virtual void setAccessInfo (NodeAccessInfo *pAccessInfo)
 Set the NodeAccessInfo for this node. More...
 
virtual void attachAccessInfo (NodeAccessInfo *pAccessInfo)
 Set the NodeAccessInfo for this node. More...
 
- Public Member Functions inherited from ChainEntry
 ChainEntry ()
 construction
 
ChainEntryfind (const UaNodeId &key, ChainEntry **ppPrevious)
 finds the right entry in the chain. More...
 
void add (ChainEntry *pNewEntry)
 adds a new entry to the list. More...
 
void prepend (ChainEntry *pNewEntry)
 prepends a new entry to the list. More...
 
ChainEntryremove (const UaNodeId &key, ChainEntry **ppNext)
 removes an entry from the list. More...
 
ChainEntrygetNext () const
 Check if there is a chain. More...
 
virtual void setInvalid ()
 Set the entry to invalid. More...
 
void clearChain ()
 Clear the chain when the hashtable is cleared.
 
- Public Member Functions inherited from ReferenceCounter
 ReferenceCounter ()
 construction
 
virtual ~ReferenceCounter ()
 destruction
 
- Public Member Functions inherited from UaReferenceLists
 UaReferenceLists ()
 Constructs the reference lists object.
 
virtual ~UaReferenceLists ()
 Destroys the reference lists object.
 
virtual UaStatus browseReferences (const ServiceContext &serviceContext, BrowseContext &browseContext, UaReferenceDescriptions &References)
 Discover the references of a specified node of a view. More...
 
virtual UaStatus translateBrowsePathToNodeId (const ServiceContext &serviceContext, const UaNodeId &startingNode, UaRelativePath &relativePath, UaBrowsePathTargets &browsePathTargets)
 Find a node based on an element of an relative path. More...
 
virtual const UaReferencepTargetNodes () const
 Returns the list of references to target nodes. More...
 
virtual const UaReferencepSourceNodes () const
 Returns the list of references to source nodes. More...
 
virtual UaNodegetTargetNodeByBrowseName (const UaQualifiedName &browseName) const
 Searches a target node with the passed browse name and returns the UaNode interface if found. More...
 
virtual void addTargetNode (UaReference *pReference)
 Add a reference to a target node where this node is the source node. More...
 
virtual void addSourceNode (UaReference *pReference)
 Adds a reference to a source node where this node is the target node. More...
 
virtual UaStatus removeSourceNode (UaReference *pReferenceToRemove)
 Remove a reference to a source node where this node is the target node. More...
 
virtual bool removeSourceReference (UaReference *pReferenceToRemove)
 Remove the passed reference to a source node. More...
 
virtual UaStatus removeTargetNode (UaNode *pTargetNode, const UaNodeId &referenceTypeId, OpcUa_Boolean deleteBidirectional)
 Remove a reference to a target node where this node is the source node. More...
 
virtual UaStatus removeTargetNode (const UaNodeId &targetNodeId, const UaNodeId &referenceTypeId, OpcUa_Boolean deleteBidirectional)
 Remove a reference to a target node where this node is the source node. More...
 
virtual bool removeTargetReference (UaReference *pReferenceToRemove)
 Remove the passed reference to a target node. More...
 
virtual UaStatus removeCrossNodeManagerRef (NodeManager *pNodeManager)
 Remove references to another NodeManager. More...
 
virtual UaStatus invalidateSourceReferences (OpcUa_Boolean deleteSourceReferences)
 Set all references from SourceNodes to this Node invalid. More...
 
virtual UaStatus invalidateTargetReferences (OpcUa_Boolean deleteTargetReferences)
 Set all references to TargetNode of this node invalid. More...
 
virtual UaStatus deleteAllChildren (NodeManagerConfig *pNodeManagerConfig)
 Deletes all child nodes. More...
 

Static Public Member Functions

static void createTypes ()
 Create the type related static members of the class.
 
static void clearStaticMembers ()
 Clear the static members of the class.
 
- Static Public Member Functions inherited from OpcUa::RoleTypeBase
static void createTypes ()
 Create the related type nodes.
 
static void clearStaticMembers ()
 Clear the static members of the class.
 
- Static Public Member Functions inherited from OpcUa::BaseObjectType
static void clearStaticMembers ()
 Clear the static members of the class.
 

Protected Member Functions

virtual ~RoleType ()
 Destruction.
 
- Protected Member Functions inherited from OpcUa::RoleTypeBase
virtual ~RoleTypeBase ()
 Destruction.
 
- Protected Member Functions inherited from OpcUa::BaseObjectType
virtual ~BaseObjectType ()
 Destruction of the BaseObjectType. More...
 
- Protected Member Functions inherited from UaObject
virtual ~UaObject ()
 Destruction of the UaObject. More...
 
- Protected Member Functions inherited from UaNode
virtual ~UaNode ()
 Destruction of the UaNode. More...
 
- Protected Member Functions inherited from ChainEntry
virtual ~ChainEntry ()
 destruction
 
- Protected Member Functions inherited from UaReferenceLists
virtual UaStatus collectAllChildrenRecursive (NodeManagerConfig *pNodeManagerConfig, NodesToDeleteCollection &nodesToDeleteCollection, int recursionCounter=0)
 Collect a list of all child nodes. More...
 

Additional Inherited Members

- Protected Attributes inherited from UaReferenceLists
UaReferencem_pTargetNodes
 List of references to target nodes where this node is the source node. More...
 
UaReferencem_pLastTargetNode
 Last references in the list of references to the target nodes. More...
 
UaReferencem_pSourceNodes
 List of references to source nodes where this node is the target node. More...
 

Detailed Description

Class implementing the UaObject interface for the RoleType.

OPC UA Objects are used to represent systems, system components, real-world objects and software objects. They have the NodeClass Object. The detailed description of Objects and their attributes can be found in the general description of the Object node class.

Variable members of the RoleType:

Browse Name DataType TypeDefinition Modelling Rule See Also
Applications String PropertyType Optional getApplications, setApplications
ApplicationsExclude Boolean PropertyType Optional getApplicationsExclude, setApplicationsExclude
Endpoints EndpointType PropertyType Optional getEndpoints, setEndpoints
EndpointsExclude Boolean PropertyType Optional getEndpointsExclude, setEndpointsExclude
Identities IdentityMappingRuleType PropertyType Mandatory getIdentities, setIdentities

Method members of the RoleType:

Browse Name Modelling Rule
AddApplication Optional
AddEndpoint Optional
AddIdentity Optional
RemoveApplication Optional
RemoveEndpoint Optional
RemoveIdentity Optional

https://reference.opcfoundation.org/v104/Core/docs/Part5/F.3.1

Constructor & Destructor Documentation

OpcUa::RoleType::RoleType ( const UaNodeId nodeId,
UaObject pInstanceDeclarationObject,
NodeManagerConfig pNodeConfig,
UaMutexRefCounted pSharedMutex = NULL 
)

Construction of the class RoleType.

This constructor is used if the object is created based on an instance declaration of an object type. Since the only difference between the instance declaration object and the instance object are the node id, the pointer to the instance declaration node is used to get the attribute values other than NodeId from the instance declaration node.

The object is reference counted and can not be deleted directly. The reference counter is set to one after the object is created. If the object was successfully added to a NodeManager using the methods NodeManagerConfig::addUaNode or NodeManagerConfig::addNodeAndReference the NodeManager will release this reference during shut down. If the object was not added to a NodeManager, it must be deleted using the releaseReference method. If the interface pointer is used in other places, the availability of the object must be ensured by incrementing the reference counter with addReference when the pointer is stored somewhere and decremented with releaseReference if the interface pointer is not longer needed.

Parameters
[in]nodeIdNodeId of the new object
[in]pInstanceDeclarationObjectUaObject interface of the instance declaration node used to provide attribute values other than NodeId
[in]pNodeConfigInterface pointer to the NodeManagerConfig interface used to add and delete node and references in the address space
[in]pSharedMutexShared mutex object used to synchronize access to the object. Can be NULL if no shared mutex is provided
OpcUa::RoleType::RoleType ( const UaNodeId nodeId,
const UaString name,
OpcUa_UInt16  browseNameNameSpaceIndex,
NodeManagerConfig pNodeConfig,
UaMutexRefCounted pSharedMutex = NULL 
)

Construction of the class RoleType.

This constructor is used if the object is not created based on an instance declaration. It defines the name and node id of the object. Additional language specific names and other attribute values can be set with set methods provided by the class.

The object is reference counted and can not be deleted directly. The reference counter is set to one after the object is created. If the object was successfully added to a NodeManager using the methods NodeManagerConfig::addUaNode or NodeManagerConfig::addNodeAndReference the NodeManager will release this reference during shut down. If the object was not added to a NodeManager, it must be deleted using the releaseReference method. If the interface pointer is used in other places, the availability of the object must be ensured by incrementing the reference counter with addReference when the pointer is stored somewhere and decremented with releaseReference if the interface pointer is not longer needed.

Parameters
[in]nodeIdNodeId of the new object
[in]nameName of the new object. Used as browse name and also as display name if no additional language specific names are set.
[in]browseNameNameSpaceIndexNamespace index used for the browse name
[in]pNodeConfigInterface pointer to the NodeManagerConfig interface used to add and delete node and references in the address space
[in]pSharedMutexShared mutex object used to synchronize access to the object. Can be NULL if no shared mutex is provided
OpcUa::RoleType::RoleType ( UaBase::Object pBaseNode,
XmlUaNodeFactoryManager pFactory,
NodeManagerConfig pNodeConfig,
UaMutexRefCounted pSharedMutex = NULL 
)

Constructs an instance of the class RoleType with all components.

Parameters
[in]pBaseNodeThe "tree" of nodes that specifies the attributes of the instance and its children
[in]pFactoryThe factory to create the children
[in]pNodeConfigInterface pointer to the NodeManagerConfig interface used to add and delete node and references in the address space
[in]pSharedMutexShared mutex object used to synchronize access to the variable. Can be NULL if no shared mutex is provided

Member Function Documentation

UaStatus OpcUa::RoleType::AddApplication ( const ServiceContext serviceContext,
const UaString ApplicationUri 
)
virtual
Parameters
serviceContextGeneral context for the service calls containing information like the session object, return diagnostic mask and timeout hint.

Implements OpcUa::RoleTypeBase.

UaStatus OpcUa::RoleType::AddEndpoint ( const ServiceContext serviceContext,
const UaEndpointType Endpoint 
)
virtual
Parameters
serviceContextGeneral context for the service calls containing information like the session object, return diagnostic mask and timeout hint.

Implements OpcUa::RoleTypeBase.

UaStatus OpcUa::RoleType::AddIdentity ( const ServiceContext serviceContext,
const UaIdentityMappingRuleType Rule 
)
virtual
Parameters
serviceContextGeneral context for the service calls containing information like the session object, return diagnostic mask and timeout hint.

Implements OpcUa::RoleTypeBase.

UaStatus OpcUa::RoleType::RemoveApplication ( const ServiceContext serviceContext,
const UaString ApplicationUri 
)
virtual
Parameters
serviceContextGeneral context for the service calls containing information like the session object, return diagnostic mask and timeout hint.

Implements OpcUa::RoleTypeBase.

UaStatus OpcUa::RoleType::RemoveEndpoint ( const ServiceContext serviceContext,
const UaEndpointType Endpoint 
)
virtual
Parameters
serviceContextGeneral context for the service calls containing information like the session object, return diagnostic mask and timeout hint.

Implements OpcUa::RoleTypeBase.

UaStatus OpcUa::RoleType::RemoveIdentity ( const ServiceContext serviceContext,
const UaIdentityMappingRuleType Rule 
)
virtual
Parameters
serviceContextGeneral context for the service calls containing information like the session object, return diagnostic mask and timeout hint.

Implements OpcUa::RoleTypeBase.


The documentation for this class was generated from the following files: