Medical Imaging Interaction Toolkit  2024.06.00
Medical Imaging Interaction Toolkit
mitk::GenericIDRelationRule Class Reference

#include <mitkGenericIDRelationRule.h>

Inheritance diagram for mitk::GenericIDRelationRule:
Collaboration diagram for mitk::GenericIDRelationRule:

Public Types

typedef GenericIDRelationRule Self
 
typedef PropertyRelationRuleBase Superclass
 
typedef itk::SmartPointer< SelfPointer
 
typedef itk::SmartPointer< const SelfConstPointer
 
using RuleIDType = PropertyRelationRuleBase::RuleIDType
 
using RelationUIDType = PropertyRelationRuleBase::RelationUIDType
 
using RelationUIDVectorType = PropertyRelationRuleBase::RelationUIDVectorType
 
- Public Types inherited from mitk::PropertyRelationRuleBase
enum  RelationType { RelationType::None, RelationType::Data, RelationType::ID, RelationType::Complete }
 
typedef PropertyRelationRuleBase Self
 
typedef itk::Object Superclass
 
typedef itk::SmartPointer< SelfPointer
 
typedef itk::SmartPointer< const SelfConstPointer
 
using RuleIDType = std::string
 
using RelationUIDType = Identifiable::UIDType
 
using RelationUIDVectorType = std::vector< RelationUIDType >
 
using RelationVectorType = std::vector< RelationType >
 
using InstanceIDType = std::string
 

Public Member Functions

virtual std::vector< std::string > GetClassHierarchy () const override
 
virtual const char * GetClassName () const
 
Pointer Clone () const
 
RuleIDType GetRuleID () const override
 
bool IsAbstract () const override
 
std::string GetDisplayName () const override
 
std::string GetSourceRoleName () const override
 
std::string GetDestinationRoleName () const override
 
RelationUIDType Connect (IPropertyOwner *source, const IPropertyProvider *destination) const
 
- Public Member Functions inherited from mitk::PropertyRelationRuleBase
Pointer Clone () const
 
 itkCreateAnotherMacro (Self)
 
virtual bool IsSourceCandidate (const IPropertyProvider *owner) const
 
virtual bool IsDestinationCandidate (const IPropertyProvider *owner) const
 
bool IsSource (const IPropertyProvider *owner) const
 
RelationVectorType GetRelationTypes (const IPropertyProvider *source, const IPropertyProvider *destination) const
 
bool HasRelation (const IPropertyProvider *source, const IPropertyProvider *destination, RelationType requiredRelation=RelationType::None) const
 
RelationUIDVectorType GetExistingRelations (const IPropertyProvider *source, RelationType layer=RelationType::None) const
 
RelationUIDVectorType GetRelationUIDs (const IPropertyProvider *source, const IPropertyProvider *destination) const
 
RelationUIDType GetRelationUID (const IPropertyProvider *source, const IPropertyProvider *destination) const
 
NodePredicateBase::ConstPointer GetSourceCandidateIndicator () const
 
NodePredicateBase::ConstPointer GetDestinationCandidateIndicator () const
 
NodePredicateBase::ConstPointer GetConnectedSourcesDetector () const
 
NodePredicateBase::ConstPointer GetSourcesDetector (const IPropertyProvider *destination, RelationType exclusiveRelation=RelationType::None) const
 
NodePredicateBase::ConstPointer GetDestinationsDetector (const IPropertyProvider *source, RelationType exclusiveRelation=RelationType::None) const
 
NodePredicateBase::ConstPointer GetDestinationDetector (const IPropertyProvider *source, RelationUIDType relationUID) const
 
void Disconnect (IPropertyOwner *source, const IPropertyProvider *destination, RelationType layer=RelationType::Complete) const
 
void Disconnect (IPropertyOwner *source, RelationUIDType relationUID, RelationType layer=RelationType::Complete) const
 
std::vector< PropertyKeyPathGetRelationPropertyPaths (const IPropertyProvider *source, RelationUIDType relationUID, RelationType layer=RelationType::Data) const
 

Static Public Member Functions

static const char * GetStaticNameOfClass ()
 
static Pointer New (const RuleIDType &_arg)
 
static Pointer New (const RuleIDType &_arga, const std::string &_argb)
 
static Pointer New (const RuleIDType &_arga, const std::string &_argb, const std::string &_argc, const std::string &_argd)
 
- Static Public Member Functions inherited from mitk::PropertyRelationRuleBase
static const char * GetStaticNameOfClass ()
 
static PropertyKeyPath GetRootKeyPath ()
 
static PropertyKeyPath GetRIIPropertyKeyPath (const std::string propName, const InstanceIDType &instanceID)
 
static PropertyKeyPath GetRIIRelationUIDPropertyKeyPath (const InstanceIDType &instanceID="")
 
static PropertyKeyPath GetRIIRuleIDPropertyKeyPath (const InstanceIDType &instanceID="")
 
static PropertyKeyPath GetRIIDestinationUIDPropertyKeyPath (const InstanceIDType &instanceID="")
 

Protected Types

using InstanceIDType = PropertyRelationRuleBase::InstanceIDType
 
using InstanceIDVectorType = PropertyRelationRuleBase::InstanceIDVectorType
 
using DataRelationUIDVectorType = PropertyRelationRuleBase::DataRelationUIDVectorType
 
- Protected Types inherited from mitk::PropertyRelationRuleBase
using InstanceIDVectorType = std::vector< InstanceIDType >
 
using DataRelationUIDVectorType = std::vector< std::pair< RelationUIDType, RuleIDType > >
 

Protected Member Functions

 GenericIDRelationRule (const RuleIDType &ruleIDTag)
 
 GenericIDRelationRule (const RuleIDType &ruleIDTag, const std::string &displayName)
 
 GenericIDRelationRule (const RuleIDType &ruleIDTag, const std::string &displayName, const std::string &sourceRole, const std::string &destinationRole)
 
 ~GenericIDRelationRule () override=default
 
DataRelationUIDVectorType GetRelationUIDs_DataLayer (const IPropertyProvider *source, const IPropertyProvider *destination, const InstanceIDVectorType &instances_IDLayer) const override
 
void Connect_datalayer (IPropertyOwner *source, const IPropertyProvider *destination, const InstanceIDType &instanceID) const override
 
void Disconnect_datalayer (IPropertyOwner *source, const RelationUIDType &relationUID) const override
 
bool IsSupportedRuleID (const RuleIDType &ruleID) const override
 
itk::LightObject::Pointer InternalClone () const override
 
- Protected Member Functions inherited from mitk::PropertyRelationRuleBase
 PropertyRelationRuleBase ()=default
 
 ~PropertyRelationRuleBase () override=default
 
InstanceIDVectorType GetInstanceID_IDLayer (const IPropertyProvider *source, const IPropertyProvider *destination) const
 
RelationUIDType GetRelationUIDByInstanceID (const IPropertyProvider *source, const InstanceIDType &instanceID) const
 
InstanceIDType GetInstanceIDByRelationUID (const IPropertyProvider *source, const RelationUIDType &relationUID) const
 
RelationUIDType Connect (IPropertyOwner *source, const IPropertyProvider *destination) const
 
std::string GetRIIPropertyRegEx (const std::string propName="", const InstanceIDType &instanceID="") const
 
RuleIDType GetRuleIDByInstanceID (const IPropertyProvider *source, const InstanceIDType &instanceID) const
 
std::string GetDestinationUIDByInstanceID (const IPropertyProvider *source, const InstanceIDType &instanceID) const
 
itk::LightObject::Pointer InternalClone () const override
 
const IdentifiableCastProviderAsIdentifiable (const mitk::IPropertyProvider *provider) const
 

Additional Inherited Members

- Static Protected Member Functions inherited from mitk::PropertyRelationRuleBase
static InstanceIDType NULL_INSTANCE_ID ()
 
static InstanceIDType GetInstanceIDByPropertyName (const std::string propName)
 
static std::vector< std::string > GetPropertyKeys (const IPropertyProvider *owner)
 

Detailed Description

This rule class can be used for relations that are only defined on the ID-layer and where no connection on the Data-layer can be defined or deduced. So it can be used for all ID based relations between PropertyProviders that also implement the interface identifiable. In order to be able to use this class for different relation types based on ID, the ruleIDTag is used. It must be specified when creating a rule instance. The ruleIDTag will be used as suffix for the rule ID of the instance and therefore allows to create specific and distinguishable rules instances based on this class. One may also specify the display name and the role names of the instance. If not specified, the default values are used (display name: "<ruleIDTag> relation", source role name: "source of <ruleIDTag> relation", destination role name: "destination <ruleIDTag> of relation")

Definition at line 32 of file mitkGenericIDRelationRule.h.

Member Typedef Documentation

◆ ConstPointer

◆ DataRelationUIDVectorType

◆ InstanceIDType

◆ InstanceIDVectorType

◆ Pointer

◆ RelationUIDType

◆ RelationUIDVectorType

◆ RuleIDType

◆ Self

◆ Superclass

Constructor & Destructor Documentation

◆ GenericIDRelationRule() [1/3]

mitk::GenericIDRelationRule::GenericIDRelationRule ( const RuleIDType ruleIDTag)
protected

◆ GenericIDRelationRule() [2/3]

mitk::GenericIDRelationRule::GenericIDRelationRule ( const RuleIDType ruleIDTag,
const std::string &  displayName 
)
protected

◆ GenericIDRelationRule() [3/3]

mitk::GenericIDRelationRule::GenericIDRelationRule ( const RuleIDType ruleIDTag,
const std::string &  displayName,
const std::string &  sourceRole,
const std::string &  destinationRole 
)
protected

◆ ~GenericIDRelationRule()

mitk::GenericIDRelationRule::~GenericIDRelationRule ( )
overrideprotecteddefault

Member Function Documentation

◆ Clone()

Pointer mitk::GenericIDRelationRule::Clone ( ) const

◆ Connect()

RelationUIDType mitk::GenericIDRelationRule::Connect ( IPropertyOwner source,
const IPropertyProvider destination 
) const

Pass through to base implementation of PropertyRelationRuleBase. See PropertyRelationRuleBase::connect documentation for more information.

◆ Connect_datalayer()

void mitk::GenericIDRelationRule::Connect_datalayer ( IPropertyOwner source,
const IPropertyProvider destination,
const InstanceIDType instanceID 
) const
overrideprotectedvirtual

Is called by Connect() to ensure that source has correctly set properties to resemble the relation on the data layer. This means that the method should set the properties that describe and encode the relation on the data layer (data-layer-specific relation properties). If the passed instance are already connected, the old settings should be overwritten. Connect() will ensure that source and destination are valid pointers.

Parameters
source
destination
instanceIDis the ID for the relation instance that should be connected. Existence of the relation instance is ensured.
Precondition
source must be a valid instance.
destination must be a valid instance.

Implements mitk::PropertyRelationRuleBase.

◆ Disconnect_datalayer()

void mitk::GenericIDRelationRule::Disconnect_datalayer ( IPropertyOwner source,
const RelationUIDType relationUID 
) const
overrideprotectedvirtual

This method is called by Disconnect() to remove all properties of the relation from the source that are set by Connect_datalayer().

Remarks
This method should remove all properties that are set for a specific relation by Connect_datalayer(...). If the relationUID is not part of the source, nothing will be changed. Disconnect() ensures that source is a valid pointer if called.
Disconnect() ensures that source is valid and only invokes if instance exists.

Implements mitk::PropertyRelationRuleBase.

◆ GetClassHierarchy()

virtual std::vector<std::string> mitk::GenericIDRelationRule::GetClassHierarchy ( ) const
inlineoverridevirtual

Reimplemented from mitk::PropertyRelationRuleBase.

Definition at line 35 of file mitkGenericIDRelationRule.h.

◆ GetClassName()

virtual const char* mitk::GenericIDRelationRule::GetClassName ( ) const
virtual

Reimplemented from mitk::PropertyRelationRuleBase.

◆ GetDestinationRoleName()

std::string mitk::GenericIDRelationRule::GetDestinationRoleName ( ) const
overridevirtual

Returns a human readable string that can be used to describe the role of a destination in context of the rule instance.

Implements mitk::PropertyRelationRuleBase.

◆ GetDisplayName()

std::string mitk::GenericIDRelationRule::GetDisplayName ( ) const
overridevirtual

Returns a human readable string that can be used to describe the rule. Does not need to be unique.

Implements mitk::PropertyRelationRuleBase.

◆ GetRelationUIDs_DataLayer()

DataRelationUIDVectorType mitk::GenericIDRelationRule::GetRelationUIDs_DataLayer ( const IPropertyProvider source,
const IPropertyProvider destination,
const InstanceIDVectorType instances_IDLayer 
) const
overrideprotectedvirtual

Returns the RelationUIDs of all relations that are defined by the data layer of source for this rule instance and, if defined, destination. If the passed source (and destination) instance has no relation on the data layer, an empty vector will be returned.

Remarks
Per definition for property relation rules only 0 or 1 instance should be found for one provider pair and concrete rule. But there might be more then one instance because either 1) the rule is abstract and supports multiple rule IDs or 2) the data layer may be ambiguous (e.g. because the destination was not specified) and therefore multiple relation instances of the rule instance could match. The implementation of this function should report all relation instances. The calling function will take care.
Parameters
source
destinationDestination the find relations should point to. If destination is NULL any relation on the data layer for this rule and source are wanted.
instances_IDLayerList of relation instances that are already defined by the ID layer. The implementation of this function should only cover relations that are not already resembled in the passed relarions_IDLayer.
Precondition
source must be a pointer to a valid IPropertyProvider instance.

Implements mitk::PropertyRelationRuleBase.

◆ GetRuleID()

RuleIDType mitk::GenericIDRelationRule::GetRuleID ( ) const
overridevirtual

Returns an ID string that identifies the rule class

Implements mitk::PropertyRelationRuleBase.

◆ GetSourceRoleName()

std::string mitk::GenericIDRelationRule::GetSourceRoleName ( ) const
overridevirtual

Returns a human readable string that can be used to describe the role of a source in context of the rule instance.

Implements mitk::PropertyRelationRuleBase.

◆ GetStaticNameOfClass()

static const char* mitk::GenericIDRelationRule::GetStaticNameOfClass ( )
inlinestatic

Definition at line 35 of file mitkGenericIDRelationRule.h.

◆ InternalClone()

itk::LightObject::Pointer mitk::GenericIDRelationRule::InternalClone ( ) const
overrideprotected

◆ IsAbstract()

bool mitk::GenericIDRelationRule::IsAbstract ( ) const
overridevirtual

Returns if the instance is a abstract rule (true). Default implementation is true. Overwrite and reimplement if another behavior is needed.

Reimplemented from mitk::PropertyRelationRuleBase.

◆ IsSupportedRuleID()

bool mitk::GenericIDRelationRule::IsSupportedRuleID ( const RuleIDType ruleID) const
overrideprotectedvirtual

Returns if the passed rule ID is supported/relevant for the rule. Either because it is the very ID of the rule (default implementation) or because it is an abstract rule which also supports the rule ID.

Returns
true: If the rule ID can handle the rule ID. false: the rule does not support the rule ID.

Reimplemented from mitk::PropertyRelationRuleBase.

◆ New() [1/3]

static Pointer mitk::GenericIDRelationRule::New ( const RuleIDType _arg)
inlinestatic

Definition at line 37 of file mitkGenericIDRelationRule.h.

◆ New() [2/3]

static Pointer mitk::GenericIDRelationRule::New ( const RuleIDType _arga,
const std::string &  _argb 
)
inlinestatic

Definition at line 38 of file mitkGenericIDRelationRule.h.

◆ New() [3/3]

static Pointer mitk::GenericIDRelationRule::New ( const RuleIDType _arga,
const std::string &  _argb,
const std::string &  _argc,
const std::string &  _argd 
)
inlinestatic

Definition at line 39 of file mitkGenericIDRelationRule.h.


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