org.hawkular.inventory.api

Class EmptyInventory.RelationshipsReadWrite

java.lang.Object

org.hawkular.inventory.api.EmptyInventory.RelationshipsReadWrite

All Implemented Interfaces:

Relationships.ReadWrite

Enclosing class:

EmptyInventory

public static class EmptyInventory.RelationshipsReadWrite
extends Object
implements Relationships.ReadWrite

Constructor Summary

Constructors

Constructor and Description
RelationshipsReadWrite()

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.
Relationships.Single	linkWith(Relationships.WellKnown name, Entity targetOrSource, Map<String,String> properties) Creates a new relationship at the current position in the inventory traversal.
Relationships.Single	linkWith(String name, Entity targetOrSource, Map<String,String> 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) Persists the provided relationship on the current position in the inventory traversal.

Methods inherited from class java.lang.Object

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

Constructor Detail

RelationshipsReadWrite

public RelationshipsReadWrite()

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,
                                     Entity targetOrSource,
                                     Map<String,String> properties)
                              throws IllegalArgumentException

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

Note that there are limitations when working with well-known relationships. See linkWith(Relationships.WellKnown, Entity, Map) for details.

Parameters:

name - the name of the relationship (label)

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 (but properties) is null

See Also:

linkWith(Relationships.WellKnown, Entity, Map)

linkWith

public Relationships.Single linkWith(Relationships.WellKnown name,
                                     Entity targetOrSource,
                                     Map<String,String> 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, owns) for restrictions of usage, especially what restrictions the relationships impose when deleting entities.

Parameters:

name - the well known name (Relationships.WellKnown) 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

Persists 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