org.hawkular.inventory.base

Class BaseRelationships.ReadWrite<BE>

java.lang.Object

org.hawkular.inventory.base.Traversal<BE,Relationship>

org.hawkular.inventory.base.BaseRelationships.ReadWrite<BE>

All Implemented Interfaces:

Relationships.ReadWrite

Enclosing class:

BaseRelationships

public static class BaseRelationships.ReadWrite<BE>
extends Traversal<BE,Relationship>
implements Relationships.ReadWrite

Field Summary

Fields inherited from class org.hawkular.inventory.base.Traversal

context

Constructor Summary

Constructors

Constructor and Description
ReadWrite(TraversalContext<BE,Relationship> context, Class<? extends Entity<?,?>> originEntityType)

Method Summary

Modifier and Type	Method and Description
void	delete(String id) Deletes an relationship with the provided id from the current position in the inventory traversal.
Relationships.Single	get(String id) Tries to find a single relationship in the current position in the inventory traversal.
Relationships.Multiple	getAll(RelationFilter... filters) Returns access interface to all relationships conforming to provided filters in the current position in the inventory traversal.
default Single	linkWith(Relationships.WellKnown name, CanonicalPath targetOrSource, Map<String,Object> properties)
Relationships.Single	linkWith(String name, CanonicalPath targetOrSource, Map<String,Object> properties) Creates a new relationship at the current position in the inventory traversal.
Relationships.Multiple	named(Relationships.WellKnown name)
Relationships.Multiple	named(String name)
void	update(String id, Relationship.Update update) Updates the provided relationship on the current position in the inventory traversal.

Methods inherited from class org.hawkular.inventory.base.Traversal

getSingle, isApplicable, mutating, readOnly

Methods inherited from class java.lang.Object

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

Constructor Detail

ReadWrite

public ReadWrite(TraversalContext<BE,Relationship> context,
                 Class<? extends Entity<?,?>> originEntityType)

Method Detail

named

public Relationships.Multiple named(String name)

Specified by:

named in interface Relationships.ReadWrite

named

public Relationships.Multiple named(Relationships.WellKnown name)

Specified by:

named in interface Relationships.ReadWrite

get

public Relationships.Single get(String id)
                         throws EntityNotFoundException,
                                RelationNotFoundException

Tries to find a single relationship in the current position in the inventory traversal.

Parameters:

id - the id of the relationship to find in the current traversal position

Returns:

access interface to the relationship

Throws:

EntityNotFoundException

RelationNotFoundException

getAll

public Relationships.Multiple getAll(RelationFilter... filters)

Returns access interface to all relationships conforming to provided filters in the current position in the inventory traversal.

Parameters:

filters - the (possibly empty) list of relationship filters to apply.

Returns:

the (read-only) access interface to the found relationships

linkWith

public Relationships.Single linkWith(String name,
                                     CanonicalPath targetOrSource,
                                     Map<String,Object> properties)
                              throws IllegalArgumentException

Creates a new relationship at the current position in the inventory traversal.

It is possible to have multiple relationships with the same name between 2 entities. These relationships will differ in their ids and can have different properties.

Note: please review the comments on the individual well-known relationships ( contains, defines, incorporates) for restrictions of usage, especially what restrictions the relationships impose when deleting entities.

Parameters:

name - the name of the relationship

targetOrSource - the the source/target entity (based on the chosen relationship direction) that the current entity (based on the position in the inventory traversal) will be in the relationship with

properties - the properties of the newly created relationship or null if none specified

Returns:

access interface to the freshly created relationship

Throws:

IllegalArgumentException - if any of the parameters is null

update

public void update(String id,
                   Relationship.Update update)
            throws RelationNotFoundException

Updates the provided relationship on the current position in the inventory traversal.

Parameters:

id - the id of the relationship to update

update - the update

Throws:

RelationNotFoundException - if the relationship is not found in the database

delete

public void delete(String id)
            throws RelationNotFoundException

Deletes an relationship with the provided id from the current position in the inventory traversal.

Parameters:

id - the id of the relationship to delete

Throws:

RelationNotFoundException - if the relation with given id doesn't exist on the current position in the inventory traversal

linkWith

public Single linkWith(Relationships.WellKnown name,
                       CanonicalPath targetOrSource,
                       Map<String,Object> properties)
                throws IllegalArgumentException

Throws:

IllegalArgumentException

See Also:

linkWith(String, CanonicalPath, Map)