Package org.openmuc.jeebus.spine.impl

Class EntityBuilder

java.lang.Object

org.openmuc.jeebus.spine.impl.EntityBuilder

public class EntityBuilder
extends java.lang.Object

Constructor Summary

Constructors

Constructor	Description
EntityBuilder()

Method Summary

Modifier and Type	Method	Description
EntityBuilder	addEntity()	Creates a new EntityBuilder instance.
FeatureBuilder	addFeature()	Creates a new FeatureBuilder instance.
void	addFeature(Feature feature)
void	addFeature(AddableFeature feature)
EntityBuilder	addUseCase(UseCase useCase)
org.openmuc.jeebus.spine.xsd.v1.EntityAddressType	applyAndGetStaticAddress()	Convenience method for calling applyToDevice() and getting the address of the new Entity.
DeviceBuilder	applyToDevice()	Builds this entity and adds it to the parent device.
EntityBuilder	applyToEntity()	Builds this entity and adds it to the parent entity.
Entity	build()	Builds the SPINE entity.
long	getLastAddedFeatureId()
EntityBuilder	setDescription(java.lang.String description)
EntityBuilder	setLabel(java.lang.String label)
EntityBuilder	setType(org.openmuc.jeebus.spine.xsd.v1.EntityTypeEnumType entityType)	This method must be called before calling applyToDevice(), applyToEntity() or build()!

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityBuilder

public EntityBuilder()

Method Detail

setType

public EntityBuilder setType(org.openmuc.jeebus.spine.xsd.v1.EntityTypeEnumType entityType)

This method must be called before calling applyToDevice(), applyToEntity() or build()!

Parameters:

entityType - the type of the SPINE entity

Returns:

the updated EntityBuilder

addEntity

public EntityBuilder addEntity()

Creates a new EntityBuilder instance. The sub-entity can then be fluently added to this entity with applyToEntity()

Returns:

a new EntityBuilder instance

addFeature

public FeatureBuilder addFeature()

Creates a new FeatureBuilder instance. The feature can then be fluently added to this entity with FeatureBuilder.apply().

Returns:

a new FeatureBuilder instance

addFeature

public void addFeature(AddableFeature feature)

addFeature

public void addFeature(Feature feature)

setDescription

public EntityBuilder setDescription(java.lang.String description)

Parameters:

description - a string describing the new SPINE entity

Returns:

the updated EntityBuilder

setLabel

public EntityBuilder setLabel(java.lang.String label)

Parameters:

label - a human-readable alias of the new SPINE entity

Returns:

the updated EntityBuilder

applyToEntity

public EntityBuilder applyToEntity()

Builds this entity and adds it to the parent entity.
If this EntityBuilder was not created from another EntityBuilder this throws UnsupportedOperationException.
If mandatory information was not set (setType(EntityTypeEnumType)) this operation throws an IncompleteBuildException.

Returns:

the updated parent EntityBuilder

applyAndGetStaticAddress

public org.openmuc.jeebus.spine.xsd.v1.EntityAddressType applyAndGetStaticAddress()

Convenience method for calling applyToDevice() and getting the address of the new Entity.

Returns:

the complete static {link EntityAddressType} of the new Entity

applyToDevice

public DeviceBuilder applyToDevice()

Builds this entity and adds it to the parent device.
If this EntityBuilder was not created from a DeviceBuilder this throws UnsupportedOperationException.
If mandatory information was not set (setType(EntityTypeEnumType)) this operation throws an IncompleteBuildException.

Returns:

the updated parent DeviceBuilder

addUseCase

public EntityBuilder addUseCase(UseCase useCase)

getLastAddedFeatureId

public long getLastAddedFeatureId()

build

public Entity build()
             throws IncompleteBuildException

Builds the SPINE entity. The new entity can then be added to a SPINE device or entity at runtime with EntityParent.addEntity(Entity) or EntityParent.addEntity(Entity)
If mandatory information was not set (setType(EntityTypeEnumType)) this operation throws and IncompleteBuildException.

Returns:

the built SPINE entity

Throws:

IncompleteBuildException - when the entity type was not set