org.fabric3.spi.model.instance

Class LogicalWire

java.lang.Object

org.fabric3.spi.model.instance.LogicalScaArtifact<LogicalComponent<?>>

org.fabric3.spi.model.instance.LogicalWire

All Implemented Interfaces:

java.io.Serializable

public class LogicalWire
extends LogicalScaArtifact<LogicalComponent<?>>

A wire from a reference to a service in the domain. A wire always targets a service in the domain (as opposed to a service hosted externally) and hence is expressed using the SCA URI of the target service. A wire is expressed by using the target attribute of a reference element or using the wire element. Furthermore, a wire may be unbound or explicitly configured with a binding. If the wire is unbound and crosses process boundaries, it will be bound by the runtime using the SCA binding. During deployment, wires are created and resolved incrementally. A wire is created for When a wire is instantiated, its source reference and target service URI are resolved against the domain.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
LogicalWire(LogicalComponent<?> parent, LogicalReference source, LogicalService target, java.net.URI contributionUri) Instantiates a logical wire.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Tests for quality whether the source and target URIs are the same.
LogicalReference	getSource() Gets the source of the wire.
LogicalBinding	getSourceBinding()
LogicalState	getState() Returns the wire state.
LogicalService	getTarget() Gets the target service of the wire.
LogicalBinding	getTargetBinding()
java.net.URI	getTargetContribution() Returns the contribution URI of the target for this wire.
int	hashCode() Hash code based on the source and target URIs.
void	setSourceBinding(LogicalBinding sourceBinding)
void	setState(LogicalState state) Sets the wire state.
void	setTargetBinding(LogicalBinding targetBinding)

Methods inherited from class org.fabric3.spi.model.instance.LogicalScaArtifact

addMetadata, getMetadata, getParent

Methods inherited from class java.lang.Object

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

Constructor Detail

LogicalWire

public LogicalWire(LogicalComponent<?> parent,
                   LogicalReference source,
                   LogicalService target,
                   java.net.URI contributionUri)

Instantiates a logical wire.

Parameters:

parent - component within which the wire is defined.

source - the source reference of the wire

target - the target service

contributionUri - the target service contribution

Method Detail

getSource

public LogicalReference getSource()

Gets the source of the wire.

Returns:

source of the wire.

getTarget

public LogicalService getTarget()

Gets the target service of the wire.

Returns:

target service of the wire.

getState

public LogicalState getState()

Returns the wire state.

Returns:

the wire state

setState

public void setState(LogicalState state)

Sets the wire state.

Parameters:

state - the wire state

getTargetContribution

public java.net.URI getTargetContribution()

Returns the contribution URI of the target for this wire. A source of a wire may be deployed via a different contribution than its target. This value is used to track the target contribution so the wire may be undeployed along wih the target even if the source is not.

Returns:

the deployable that provisioned the wire.

getSourceBinding

public LogicalBinding getSourceBinding()

setSourceBinding

public void setSourceBinding(LogicalBinding sourceBinding)

getTargetBinding

public LogicalBinding getTargetBinding()

setTargetBinding

public void setTargetBinding(LogicalBinding targetBinding)

equals

public boolean equals(java.lang.Object obj)

Tests for quality whether the source and target URIs are the same.

Overrides:

equals in class java.lang.Object

Parameters:

obj - Object to be tested against.

hashCode

public int hashCode()

Hash code based on the source and target URIs.

Overrides:

hashCode in class java.lang.Object

Returns:

Hash code based on the source and target URIs.