org.fabric3.spi.domain.generator

Interface ComponentGenerator<C extends LogicalComponent<? extends org.fabric3.api.model.type.component.Implementation<?>>>

public interface ComponentGenerator<C extends LogicalComponent<? extends org.fabric3.api.model.type.component.Implementation<?>>>

Generates metadata used to provision components and physical wires to a runtime.

Method Summary

Modifier and Type	Method and Description
PhysicalComponent	generate(C component) Generates an PhysicalComponent based on a LogicalComponent.
PhysicalWireSource	generateCallbackSource(LogicalService service) Generates a PhysicalWireSource used to attach a physical wire for a callback service to a source component.
PhysicalConnectionSource	generateConnectionSource(LogicalProducer producer) Generates a PhysicalConnectionSource used to attach an event connection to its source producer.
PhysicalConnectionTarget	generateConnectionTarget(LogicalConsumer consumer) Generates a PhysicalConnectionTarget used to attach an event connection to its target consumer.
PhysicalWireSource	generateResourceSource(LogicalResourceReference<?> resourceReference) Generates a PhysicalWireSource used to attach a physical resource to a source component.
PhysicalWireSource	generateSource(LogicalReference reference) Generates a PhysicalWireSource used to attach a physical wire to a source component.
PhysicalWireTarget	generateTarget(LogicalService service) Generates a PhysicalWireTarget used to attach a physical wire to a target component.

Method Detail

generate

PhysicalComponent generate(C component)
                    throws org.fabric3.api.host.Fabric3Exception

Generates an PhysicalComponent based on a LogicalComponent.

Parameters:

component - the logical component to evaluate

Returns:

the physical component definition

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process

generateSource

PhysicalWireSource generateSource(LogicalReference reference)
                           throws org.fabric3.api.host.Fabric3Exception

Generates a PhysicalWireSource used to attach a physical wire to a source component. Metadata contained in the source is specific to the component implementation type and used when the wire is attached to its source.

Parameters:

reference - the source logical reference

Returns:

the metadata used to attach the wire to its source

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process

generateTarget

PhysicalWireTarget generateTarget(LogicalService service)
                           throws org.fabric3.api.host.Fabric3Exception

Generates a PhysicalWireTarget used to attach a physical wire to a target component. Metadata contained in the source is specific to the component implementation type and used when the wire is attached to its target.

Parameters:

service - the target logical service

Returns:

the metadata used to attach the wire to its target on the service node

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process

generateCallbackSource

PhysicalWireSource generateCallbackSource(LogicalService service)
                                   throws org.fabric3.api.host.Fabric3Exception

Generates a PhysicalWireSource used to attach a physical wire for a callback service to a source component. Metadata contained in the source is specific to the component implementation type and used when the wire is attached to its source.

Parameters:

service - the forward service the callback is being generated for

Returns:

the metadata used to attach the wire to its source on the service node

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process

generateConnectionSource

PhysicalConnectionSource generateConnectionSource(LogicalProducer producer)
                                           throws org.fabric3.api.host.Fabric3Exception

Generates a PhysicalConnectionSource used to attach an event connection to its source producer.

Parameters:

producer - the producer

Returns:

the connection metadata

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process

generateConnectionTarget

PhysicalConnectionTarget generateConnectionTarget(LogicalConsumer consumer)
                                           throws org.fabric3.api.host.Fabric3Exception

Generates a PhysicalConnectionTarget used to attach an event connection to its target consumer.

Parameters:

consumer - the consumer

Returns:

the connection metadata

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process

generateResourceSource

PhysicalWireSource generateResourceSource(LogicalResourceReference<?> resourceReference)
                                   throws org.fabric3.api.host.Fabric3Exception

Generates a PhysicalWireSource used to attach a physical resource to a source component. Metadata contained in the source is specific to the component implementation type and used when the wire is attached to its source.

Parameters:

resourceReference - the source logical resource

Returns:

the metadata used to attach the wire to its source on the service node

Throws:

org.fabric3.api.host.Fabric3Exception - if an error occurs during the generation process