org.hawkular.inventory.api

Interface WriteInterface<Update,Blueprint extends Entity.Blueprint,Single>

Type Parameters:

Update - type of entity update class

Blueprint - the blueprint type that supplies data necessary to create a new entity

Single - the access interface to a single entity

All Known Subinterfaces:

Environments.ReadWrite, Feeds.ReadWrite, Metrics.ReadWrite, MetricTypes.ReadWrite, org.hawkular.inventory.api.ReadWriteInterface<Update,Blueprint,Single,Multiple>, Resources.ReadWrite, ResourceTypes.ReadWrite, Tenants.ReadWrite

All Known Implementing Classes:

EmptyInventory.EnvironmentReadWrite, EmptyInventory.FeedsReadWrite, EmptyInventory.MetricsReadWrite, EmptyInventory.MetricTypesReadWrite, EmptyInventory.ResourcesReadWrite, EmptyInventory.ResourceTypesReadWrite, EmptyInventory.TenantsReadWrite

public interface WriteInterface<Update,Blueprint extends Entity.Blueprint,Single>

Generic methods to write access to entities.

Since:

1.0

Author:

Lukas Krejci

Method Summary

Modifier and Type	Method and Description
Single	create(Blueprint blueprint) Creates a new entity at the current position in the inventory traversal.
void	delete(String id) Deletes an entity with the provided id from the current position in the inventory traversal.
void	update(String id, Update update) Persists the provided entity on the current position in the inventory traversal.

Method Detail

create

Single create(Blueprint blueprint)
       throws EntityAlreadyExistsException

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

Parameters:

blueprint - the blueprint to be used to create the new entity

Returns:

access interface to the freshly created entity

Throws:

EntityAlreadyExistsException - if the entity already exists

IllegalArgumentException - if the blueprint or context in which the entity is being create is somehow invalid

update

void update(String id,
            Update update)
     throws EntityNotFoundException

Persists the provided entity on the current position in the inventory traversal.

Parameters:

id - the id of the entity to update

update - the updates to the entity

Throws:

EntityNotFoundException - if the entity is not found in the database

IllegalArgumentException - if the supplied entity could not be updated for some reason

delete

void delete(String id)
     throws EntityNotFoundException

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

Parameters:

id - the id of the entity to delete

Throws:

EntityNotFoundException - if an entity with given ID doesn't exist on the current postion in the inventory traversal

IllegalArgumentException - if the supplied entity could not be deleted for some reason