org.fabric3.spi.container.component

Interface ScopedComponent

All Superinterfaces:

AtomicComponent, Component, org.fabric3.api.host.monitor.Monitorable

public interface ScopedComponent
extends AtomicComponent

A component whose implementation instances are managed by a ScopeContainer. This interface defines callbacks used by the scope container to change the state of an implementation.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	createInstance() Create a new implementation instance, fully injected with all property and reference values.
boolean	isEagerInit() Returns true if component instances should be eagerly initialized.
void	reinject(java.lang.Object instance) Reinjects the instance with updated references.
void	startInstance(java.lang.Object instance) Starts a component instance.
void	stopInstance(java.lang.Object instance) Stops a component instance.

Methods inherited from interface org.fabric3.spi.container.component.AtomicComponent

createSupplier, getInstance, releaseInstance

Methods inherited from interface org.fabric3.spi.container.component.Component

endUpdate, getContributionUri, getUri, start, startUpdate, stop

Methods inherited from interface org.fabric3.api.host.monitor.Monitorable

getLevel, getName, setLevel

Method Detail

isEagerInit

boolean isEagerInit()

Returns true if component instances should be eagerly initialized.

Returns:

true if component instances should be eagerly initialized

createInstance

java.lang.Object createInstance()
                         throws org.fabric3.api.host.Fabric3Exception

Create a new implementation instance, fully injected with all property and reference values. The instance's lifecycle callbacks must not have been called.

Returns:

a wrapper for a new implementation instance

Throws:

org.fabric3.api.host.Fabric3Exception - if there was a problem instantiating the implementation

startInstance

void startInstance(java.lang.Object instance)
            throws org.fabric3.api.host.Fabric3Exception

Starts a component instance. If configured on the implementation, an initialization callback will be performed.

Parameters:

instance - the instance to start

Throws:

org.fabric3.api.host.Fabric3Exception - if there is an error initializing the instance

stopInstance

void stopInstance(java.lang.Object instance)
           throws org.fabric3.api.host.Fabric3Exception

Stops a component instance. If configured on the implementation, a destruction callback will be performed.

Parameters:

instance - the instance to start

Throws:

org.fabric3.api.host.Fabric3Exception - if there is an error stopping the instance

reinject

void reinject(java.lang.Object instance)
       throws org.fabric3.api.host.Fabric3Exception

Reinjects the instance with updated references.

Parameters:

instance - the instance

Throws:

org.fabric3.api.host.Fabric3Exception - if there is an error reinjecting the instance