systems.dmx.core.impl

Class AssociationImpl

Show UML class diagram

java.lang.Object

systems.dmx.core.impl.DMXObjectImpl

systems.dmx.core.impl.AssociationImpl

All Implemented Interfaces:

Association, DMXObject, Identifiable, JSONEnabled

Direct Known Subclasses:

AssociationDefinitionImpl, RelatedAssociationImpl

class AssociationImpl
extends DMXObjectImpl
implements Association

An association model that is attached to the DB.

Field Summary

Fields

Modifier and Type	Field and Description
private Logger	logger

Fields inherited from class systems.dmx.core.impl.DMXObjectImpl

mf, model, pl

Constructor Summary

Constructors

Constructor and Description
AssociationImpl(AssociationModelImpl model, PersistenceLayer pl)

Method Summary

Modifier and Type	Method and Description
void	delete() Deletes the DMX object in its entirety, that is - the object itself (the parent) - all child topics associated via "dmx.core.composition", recusively - all the remaining direct associations, e.g.
private TopicRole	filterRole(Role role, TopicRoleModel roleModel)
Association	getAssociation(String assocTypeUri, String myRoleTypeUri, String othersRoleTypeUri, long othersTopicId)
List<Association>	getAssociations() Fetches all associations this object is a player in.
AssociationModelImpl	getModel()
long	getOtherPlayerId(long id)
RelatedObject	getPlayer(String roleTypeUri)
DMXObject	getPlayer1()
DMXObject	getPlayer2()
RelatedAssociation	getRelatedAssociation(String assocTypeUri, String myRoleTypeUri, String othersRoleTypeUri, String othersAssocTypeUri)
List<RelatedAssociation>	getRelatedAssociations(String assocTypeUri, String myRoleTypeUri, String othersRoleTypeUri, String othersAssocTypeUri)
List<RelatedTopic>	getRelatedTopics(List assocTypeUris, String myRoleTypeUri, String othersRoleTypeUri, String othersTopicTypeUri)
Role	getRole(RoleModel roleModel) ### TODO: rethink this method Returns this association's role which refers to the same object as the given role model.
Role	getRole(String roleTypeUri)
Role	getRole1()
Role	getRole2()
Topic	getTopicByType(String topicTypeUri) ### TODO: make it work for assoc players as well or drop it
boolean	hasSameRoleTypeUris()
boolean	isPlayer(TopicRoleModel roleModel) ### TODO: drop it
Association	loadChildTopics()
Association	loadChildTopics(String assocDefUri)
boolean	matches(String roleTypeUri1, long playerId1, String roleTypeUri2, long playerId2) Checks if the given players match this association.
void	update(AssociationModel updateModel)

Methods inherited from class systems.dmx.core.impl.DMXObjectImpl

className, equals, getChildTopics, getDatabaseVendorObject, getId, getProperty, getRelatedTopic, getRelatedTopics, getRelatedTopics, getSimpleValue, getType, getTypeUri, getUri, hashCode, hasProperty, removeProperty, setChildTopics, setProperty, setSimpleValue, setSimpleValue, setSimpleValue, setSimpleValue, setSimpleValue, setTypeUri, setUri, toJSON, toString, updateChildTopics

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface systems.dmx.core.DMXObject

getChildTopics, getDatabaseVendorObject, getId, getProperty, getRelatedTopic, getRelatedTopics, getRelatedTopics, getSimpleValue, getType, getTypeUri, getUri, hasProperty, removeProperty, setChildTopics, setProperty, setSimpleValue, setSimpleValue, setSimpleValue, setSimpleValue, setSimpleValue, setTypeUri, setUri, updateChildTopics

Methods inherited from interface systems.dmx.core.JSONEnabled

toJSON

Field Detail

logger

private final Logger logger

Constructor Detail

AssociationImpl

AssociationImpl(AssociationModelImpl model,
                PersistenceLayer pl)

Method Detail

getRole1

public final Role getRole1()

Specified by:

getRole1 in interface Association

getRole2

public final Role getRole2()

Specified by:

getRole2 in interface Association

getPlayer1

public final DMXObject getPlayer1()

Specified by:

getPlayer1 in interface Association

getPlayer2

public final DMXObject getPlayer2()

Specified by:

getPlayer2 in interface Association

getRole

public final Role getRole(String roleTypeUri)

Specified by:

getRole in interface Association

Returns:

this association's role that matches the given role type. If no role matches, null is returned. If both roles are matching an exception is thrown.

hasSameRoleTypeUris

public final boolean hasSameRoleTypeUris()

Specified by:

hasSameRoleTypeUris in interface Association

matches

public final boolean matches(String roleTypeUri1,
                             long playerId1,
                             String roleTypeUri2,
                             long playerId2)

Description copied from interface: Association

Checks if the given players match this association. The given role type URIs must be different. The player position ("1" vs. "2") is not relevant.

Specified by:

matches in interface Association

Returns:

true if the given players match this association.

getOtherPlayerId

public final long getOtherPlayerId(long id)

Specified by:

getOtherPlayerId in interface Association

getPlayer

public final RelatedObject getPlayer(String roleTypeUri)

Specified by:

getPlayer in interface Association

Returns:

this association's player which plays the given role. If there is no such player, null is returned.

If there are 2 such players an exception is thrown.

getTopicByType

public final Topic getTopicByType(String topicTypeUri)

Description copied from interface: Association

### TODO: make it work for assoc players as well or drop it

Specified by:

getTopicByType in interface Association

Returns:

this association's topic which has the given type. If there is no such topic, null is returned.

If there are 2 such topics an exception is thrown.

getRole

public final Role getRole(RoleModel roleModel)

Description copied from interface: Association

### TODO: rethink this method Returns this association's role which refers to the same object as the given role model. The role returned is found by comparing topic IDs, topic URIs, or association IDs. The role types are not compared.

If the object refered by the given role model is not a player in this association an exception is thrown.

Specified by:

getRole in interface Association

isPlayer

public final boolean isPlayer(TopicRoleModel roleModel)

Description copied from interface: Association

### TODO: drop it

Specified by:

isPlayer in interface Association

update

public final void update(AssociationModel updateModel)

Specified by:

update in interface Association

delete

public final void delete()

Description copied from interface: DMXObject

Deletes the DMX object in its entirety, that is - the object itself (the parent) - all child topics associated via "dmx.core.composition", recusively - all the remaining direct associations, e.g. "dmx.core.instantiation"

Specified by:

delete in interface DMXObject

loadChildTopics

public final Association loadChildTopics()

Specified by:

loadChildTopics in interface Association

Specified by:

loadChildTopics in interface DMXObject

Overrides:

loadChildTopics in class DMXObjectImpl

loadChildTopics

public final Association loadChildTopics(String assocDefUri)

Specified by:

loadChildTopics in interface Association

Specified by:

loadChildTopics in interface DMXObject

Overrides:

loadChildTopics in class DMXObjectImpl

getModel

public AssociationModelImpl getModel()

Specified by:

getModel in interface Association

Specified by:

getModel in interface DMXObject

Overrides:

getModel in class DMXObjectImpl

getRelatedTopics

public final List<RelatedTopic> getRelatedTopics(List assocTypeUris,
                                                 String myRoleTypeUri,
                                                 String othersRoleTypeUri,
                                                 String othersTopicTypeUri)

Specified by:

getRelatedTopics in interface DMXObject

Parameters:

assocTypeUris - may *not* be null

myRoleTypeUri - may be null

othersRoleTypeUri - may be null

othersTopicTypeUri - may be null

getRelatedAssociation

public final RelatedAssociation getRelatedAssociation(String assocTypeUri,
                                                      String myRoleTypeUri,
                                                      String othersRoleTypeUri,
                                                      String othersAssocTypeUri)

Specified by:

getRelatedAssociation in interface DMXObject

Parameters:

assocTypeUri - may be null

myRoleTypeUri - may be null

othersRoleTypeUri - may be null

othersAssocTypeUri - may be null

getRelatedAssociations

public final List<RelatedAssociation> getRelatedAssociations(String assocTypeUri,
                                                             String myRoleTypeUri,
                                                             String othersRoleTypeUri,
                                                             String othersAssocTypeUri)

Specified by:

getRelatedAssociations in interface DMXObject

Parameters:

assocTypeUri - may be null

myRoleTypeUri - may be null

othersRoleTypeUri - may be null

othersAssocTypeUri - may be null

getAssociation

public final Association getAssociation(String assocTypeUri,
                                        String myRoleTypeUri,
                                        String othersRoleTypeUri,
                                        long othersTopicId)

Specified by:

getAssociation in interface DMXObject

getAssociations

public final List<Association> getAssociations()

Description copied from interface: DMXObject

Fetches all associations this object is a player in.

Specified by:

getAssociations in interface DMXObject

filterRole

private final TopicRole filterRole(Role role,
                                   TopicRoleModel roleModel)