Module org.refcodes.component
Package org.refcodes.component
package org.refcodes.component
-
ClassDescriptionAbstractComponentComposite<C extends Component>The
AbstractComponentCompositeis an implementation of theComponentComposite.TheAbstractComponentComposite.ExtendedCompositeComponentImplis an implementation of theComponentComposite.ExtendedComponentComposite.TheAbstractConnectableprovides base functionality required by connection related components.TheAbstractConnectableAutomatonimplements the very basicAbstractConnectableAutomatonfunctionality.TheAbstractDeviceAutomatonimplements the very basicAbstractDeviceAutomatonfunctionality.BidirectionalConnectionAccessor<INPUT,OUTPUT> Provides an accessor for a connection property for e.g. anInputStreamor anOutputStream.Provides a mutator for a connection property for e.g. anInputStreamor anOutputStream.Provides a connection property for e.g. anInputStreamor anOutputStream.BidirectionalConnectionComponent<INPUT,OUTPUT> A component implementing theBidirectionalConnectionComponentinterface supports a connection.A system implementing theBidirectionalConnectionComponent.BidirectionalConnectionAutomatoninterface supports managingBidirectionalConnectionComponentinstances and takes care that the open/close statuses are invoked in the correct order by throwing according exceptions in case the open/close-cycle is invoked in the wrong order.BidirectionalConnectionOpenable<INPUT,OUTPUT> This mixin might be implemented by a component in order to provide opening connection(s) facilities.TheBidirectionalConnectionOpenable.BidirectionalConnectionOpenAutomatoninterface defines those methods related to the opening of connection(s) life-cycle.BidirectionalConnectionOpenableHandle<H,INPUT, OUTPUT> TheBidirectionalConnectionOpenableHandleinterface defines those methods related to the handle based open/connect life-cycle.TheBidirectionalConnectionOpenableHandle.BidirectionalConnectionOpenAutomatonHandleinterface defines those methods related to the handle based open/connect life-cycle.This mixin might be implemented by a component in order to provide cease facilities.TheCeasable.CeaseAutomatoninterface defines those methods related to the cease life-cycle.Ceasable.CeaseBuilder<B extends Ceasable.CeaseBuilder<B>>To enable theCeasablefunctionality to be invoked in a builder chain.SeeCeasablewithout any checked exception being declared.TheCeasableHandleinterface defines those methods related to the handle based cease life-cycle.TheCeasableHandle.CeaseAutomatonHandleinterface defines those methods related to the handle based cease life-cycle.Thrown in case ceasing a component caused problems.Unchecked exception with the same semantics as theCeaseException.This mixin might be implemented by a component in order to provide closing connection(s) facilities.TheClosable.CloseAutomatoninterface defines those methods related to the closing of connection(s) life-cycle.Closable.CloseBuilder<B extends Closable.CloseBuilder<B>>To enable theClosablefunctionality to be invoked in a builder chain.TheClosableHandleinterface defines those methods related to the handle based close life-cycle.TheClosableHandle.CloseAutomatonHandleinterface defines those methods related to the handle based close life-cycle.Provides an accessor for a closed property.Provides a mutator for a closed property.Provides a closed property.Thrown in case closing a component caused problems.Unchecked exception with the same semantics as theCloseException.Per definition anyComponentat least must provide aDestroyable.destroy()method.Any composite implementation of the refcodes frameworks should implement thisComponentCompositeinterface so that any therein containedComponentinstances' state change methods are supported by theComponentCompositeas well and forwarded to theComponentcontained in theComponentCompositeinstance.TheComponentComposite.ExtendedComponentCompositeprovides extended functionality to theComponentComposite's functionality by including extendedOpenablefunctionality (ConnectionOpenable) and extendsInitializablefunctionality (Configurable).This exception is the base exception for the component package.ComponentHandleComposite<H,REF> Similar to theComponentComposite, theComponentHandleCompositeprovides all the defined handle based functionality, implementing classes provide the means to invoke those methods in case them are supported by the referenced components.This exception is the base runtime exception for the component package.This exception is the base exception for handle related runtime exceptions.The Class ComponentUtility.Configurable<CTX>This mixin might be implemented by a component in order to provide initialize facilities wit a configuration provided viaConfigurable.initialize(Object).TheConfigurable.ConfigureAutomatoninterface defines those methods related to the initialize life-cycle with a provided context.Configurable.ConfigureBuilder<CTX,B extends Configurable.ConfigureBuilder<CTX, B>> To enable theInitializablefunctionality to be invoked in a builder chain.AConfigurableComponentcan be configured invoking the methodConfigurable.initialize(Object).ConfigurableHandle<H,CTX> TheConfigurableHandleinterface defines those methods related to the handle based initialize/configure life-cycle.TheConfigurableHandle.ConfigureAutomatonHandleinterface defines those methods related to the handle based initialize/configure life-cycle.This class implements aConfigurableLifecycleComponent.ConfigurableLifecycleAutomaton.A component implementing theConfigurableLifecycleComponentinterface supports a life-cycle.A system implementing theConfigurableLifecycleComponent.ConfigurableLifecycleAutomatoninterface supports managingConfigurableLifecycleComponentinstances and takes care that the open/close statuses are invoked in the correct order by throwing according exceptions in case the open/close-cycle is invoked in the wrong order.TheConfigurableLifecycleComponentHandlemanages variousLifecycleStatusstates forConfigurableLifecycleComponentinstances each related to a handle.TheConfigurableLifecycleComponentHandle.ConfigurableLifecycleAutomatonHandleis an automaton managing variousLifecycleStatusstates forComponentinstances each related to a handle.Thrown in case initializing a component caused problems.Thrown in case initializing a component caused problems.AnyComponentwhich operates established connections may implement theConnectableComponentinterface providing a minimal set of functionality to work with connections; to test whether a connection is open and to close an open connection.TheConnectableComponent.ConnectableAutomatonextends theConnectableComponentwith automaton functionality to get detailed status information regarding connections.ConnectionAccessor<CON>Provides an accessor for a connection property for e.g. anInputStreamor anOutputStream.Provides a mutator for a connection property for e.g. anInputStreamor anOutputStream.Provides a connection property for e.g. anInputStreamor anOutputStream.This class implements aConnectionComponent.ConnectionAutomaton.ConnectionComponent<CON>A component implementing theConnectionComponentinterface supports a connection.A system implementing theConnectionComponent.ConnectionAutomatoninterface supports managingConnectionComponentinstances and takes care that the open/close statuses are invoked in the correct order by throwing according exceptions in case the open/close-cycle is invoked in the wrong order.ConnectionComponent.ConnectionComponentBuilder<CON,B extends ConnectionComponent.ConnectionComponentBuilder<CON, B>> Similar to theConnectionComponentwith additional according builder methods.ConnectionComponentHandle<H,CON> TheConnectionComponentHandlemanages variousConnectionStatusstates forConnectionComponentinstances each related to a handle.TheConnectionComponentHandle.ConnectionAutomatonHandleis an automaton managing variousConnectionStatusstates forConnectionComponentinstances each related to a handle.ConnectionOpenable<CON>This mixin might be implemented by a component in order to provide opening connection(s) facilities.TheConnectionOpenable.ConnectionOpenAutomatoninterface defines those methods related to the opening of connection(s) life-cycle.ConnectionOpenable.ConnectionOpenBuilder<CON,B extends ConnectionOpenable.ConnectionOpenBuilder<CON, B>> To enable theStartablefunctionality to be invoked in a builder chain.ConnectionOpenableHandle<H,CON> TheConnectionOpenableHandleinterface defines those methods related to the handle based open/connect life-cycle.TheConnectionOpenableHandle.ConnectionOpenAutomatonHandleinterface defines those methods related to the handle based open/connect life-cycle.An enumeration describing the connection requests.The Enum ConnectionStatus.Provides an accessor for aConnectionStatusproperty.Provides a mutator for aConnectionStatusproperty.Provides aConnectionStatusproperty.The Interface ConnectionStatusHandle.ContextAccessor<CTX>Provides an accessor for a context property for e.g. a service or a component.ContextAccessor.ContextBuilder<CTX,B extends ContextAccessor.ContextBuilder<CTX, B>> Provides a builder method for a context property returning the builder for applying multiple build operations.Provides a mutator for a context property for e.g. a service or a component.Provides a context property for e.g. a service or a component.This mixin might be implemented by a component in order to provide decomposition facilities.TheDecomposable.DecomposeAutomatoninterface defines those methods related to the decompose life-cycle.TheDecomposableHandleinterface defines those methods related to the handle based decompose life-cycle.TheDecomposableHandle.DecomposeAutomatonHandleinterface defines those methods related to the handle based decompose life-cycle.Thrown in case decomposing a component caused problems.Unchecked exception with the same semantics as theDecomposeException.This mixin might be implemented by aComponentin order to provide destroy facilities.TheDestroyable.DestroyAutomatoninterface defines those methods related to the destroy life-cycle.TheDestroyableHandleinterface defines those methods related to the handle based destroy life-cycle.TheDestroyableHandle.DestroyAutomatonHandleinterface defines those methods related to the handle based destroy life-cycle.Thrown in case destroying a component caused problems.Unchecked exception with the same semantics as theDestroyException.Digester<J>ADigesterprovides the functionality to consume a job (which is pushed from the outside) for further processing.Thrown in case digesting (processing) a job by aDigester.digest(Object)caused problems; the aCause is usually wrapped by thisException.Thrown in case digesting (processing) a job by aDigester.digest(Object)caused problems; the aCause is usually wrapped by thisException.Thrown in case disposing a component caused problems.Unchecked exception with the same semantics as theDisposeException.This mixin might be implemented by a component in order to provide flush facilities.Flushable.FlushBuilder<B extends Flushable.FlushBuilder<B>>The Interface FlushBuilder.FlushHandle<H>TheFlushHandleinterface defines those methods related to the handle based flush operation.Provides an accessor for a handle property for e.g. key / handle pair.Provides a mutator for a handle property for e.g. key / handle pair.Provides a handle property for e.g. key / handle pair.HandleDirectory<H,REF> The handle directory enables listing of all known data managed by the implementing component.Generates handles of the generic type.Plain straight forwardStringinstances generatingHandleGeneratorbasically being a plain good oldUniqueIdGenerator.HandleLookup<H,REF> Any system in this framework being able to work with handles provides an implementation of the handle lookup interface.This exception is thrown in case a handle was provided which was unknown to the invoked component.This exception is thrown in case a handle was provided whose reference does not support a given operation.This mixin might be implemented by a component in order to provide initializing facilities.TheInitializable.InitializeAutomatoninterface defines those methods related to the initialize life-cycle.To enable theInitializablefunctionality to be invoked in a builder chain.SeeInitializablewithout any checked exception being declared.AInitializableComponentcan be initialized invoking the methodInitializable.initialize().TheInitializableHandleinterface defines those methods related to the handle based initialize life-cycle.TheInitializableHandle.InitializeAutomatonHandleinterface defines those methods related to the handle based initialize life-cycle.Provides an accessor for a initialized property.Provides a mutator for a initialized property.Provides a initialized property.Provides access to the initialized handle reference.Thrown in case initializing a component caused problems.Unchecked exception with the same semantics as theIOException.A component implementing theLifecycleComponentinterface supports a life-cycle.A system implementing theLifecycleComponent.LifecycleAutomatoninterface supports managingLifecycleComponentinstances and takes care that the life-cycle stages are invoked in the correct order by throwing according exceptions in case the life-cycle is invoked in the wrong order.Same as theLifecycleComponentthough without the need to try-catch any exceptions on the various life-cycle stages.TheLifecycleComponentHandlemanages variousLifecycleStatusstates forLifecycleComponentinstances each related to a handle.TheLifecycleComponentHandle.LifecycleAutomatonHandleis an automaton managing variousLifecycleStatusstates forComponentinstances each related to a handle.This exception is the base lifecycle exception .This exception is the base lifecycle exception .TheLifecycleMachineimplements aLifecycleComponent.LifecycleAutomaton.Opens the otherwise protectedLifecycleMachine.ManualLifecycleMachine.setLifecycleStatus(LifecycleStatus)to be public in order to force any lifecycle status to be set.An enumeration describing the lifecycle requests regarding a component..Provides an accessor for aLifecycleRequestproperty.Provides a mutator for aLifecycleRequestproperty.Provides aLifecycleRequestproperty.The Enum LifecycleStatus.Provides an accessor for aLifecycleStatusproperty.LifecycleStatusAccessor.LifecycleStatusBuilder<B extends LifecycleStatusAccessor.LifecycleStatusBuilder<B>>Provides a builder method for aLifecycleStatusproperty returning the builder for applying multiple build operations.Provides a mutator for aLifecycleStatusproperty.Provides aLifecycleStatusproperty.The Interface LifecycleStatusHandle.This class implements aLifecycleComponent.LifecycleAutomaton.A component implementing theLinkComponentinterface supports establishing a connection (not necessarily a network connection).A system implementing theLinkComponent.LinkAutomatoninterface supports managingLinkComponentinstances and takes care that the open/close statuses are invoked in the correct order by throwing according exceptions in case the open/close-cycle is invoked in the wrong order.Similar to theLinkComponentwith additional according builder methods.TheLinkComponentHandlemanages variousConnectionStatusstates forLinkComponentinstances each related to a handle.TheLinkComponentHandle.LinkAutomatonHandleis an automaton managing variousConnectionStatusstates forComponentinstances each related to a handle.This mixin might be implemented by a component in order to provide opening connection(s) facilities.TheOpenable.OpenAutomatoninterface defines those methods related to the opening of connection(s) life-cycle.Openable.OpenBuilder<B extends Openable.OpenBuilder<B>>To enable theStartablefunctionality to be invoked in a builder chain.TheOpenableHandleinterface defines those methods related to the handle based open/connect life-cycle.TheOpenableHandle.OpenAutomatonHandleinterface defines those methods related to the handle based open/connect life-cycle.Provides an accessor for a opened property.Provides a mutator for a opened property.Provides a opened property.OpenedHandle<H>Provides access to the opened (connected) handle reference.This mixin might be implemented by a component in order to provide pause facilities.ThePausable.PauseAutomatoninterface defines those methods related to the pause life-cycle.Pausable.PauseBuilder<B extends Pausable.PauseBuilder<B>>To enable thePausablefunctionality to be invoked in a builder chain.SeePausablewithout any checked exception being declared.ThePausableHandleinterface defines those methods related to the handle based pause life-cycle.ThePausableHandle.PauseAutomatonHandleinterface defines those methods related to the handle based pause life-cycle.Thrown in case pausing a component caused problems.Unchecked exception with the same semantics as thePauseException.Provides an accessor for a progress property.Provides a mutator for a progress property.Provides a progress property.Whenever a handle is associated with a progress, then a component providing such handles should implement this interface.This mixin might be implemented by a component in order to provide reload facilities.Reloadable.ReloadBuilder<B extends Reloadable.ReloadBuilder<B>>The Interface ReloadBuilder.ReloadHandle<H>TheReloadHandleinterface defines those methods related to the handle based reload operation.Thrown in case resetting a component caused problems.Unchecked exception with the same semantics as theResetException.ResetHandle<H>TheResetHandleinterface defines those methods related to the handle based reset operation.This mixin might be implemented by a component in order to provide resume facilities.TheResumable.ResumeAutomatoninterface defines those methods related to the resume life-cycle.Resumable.ResumeBuilder<B extends Resumable.ResumeBuilder<B>>To enable theResumablefunctionality to be invoked in a builder chain.SeeResumablewithout any checked exception being declared.TheResumableHandleinterface defines those methods related to the handle based resume life-cycle.TheResumableHandle.ResumeAutomatonHandleinterface defines those methods related to the handle based resume life-cycle.Thrown in case resuming a component caused problems.Unchecked exception with the same semantics as theResumeException.Provides an accessor for a running property.Provides a mutator for a running property.Provides a running property.Provides access to the running handle reference.This mixin might be implemented by a component in order to provide start facilities.TheStartable.StartAutomatoninterface defines those methods related to the start life-cycle.Startable.StartBuilder<B extends Startable.StartBuilder<B>>To enable theStartablefunctionality to be invoked in a builder chain.SeeStartablewithout any checked exception being declared.TheStartableHandleinterface defines those methods related to the handle based start life-cycle.TheStartableHandle.StartAutomatonHandleinterface defines those methods related to the handle based start life-cycle.Thrown in case starting a component caused problems.Unchecked exception with the same semantics as theStartException.Thrown in case stopping a component caused problems.Unchecked exception with the same semantics as theStopException.This mixin might be implemented by a component in order to provide stop facilities.TheStoppable.StopAutomatoninterface defines those methods related to the stop life-cycle.Stoppable.StopBuilder<B extends Stoppable.StopBuilder<B>>To enable theStoppablefunctionality to be invoked in a builder chain.SeeStoppablewithout any checked exception being declared.TheStoppableHandleinterface defines those methods related to the handle based stop life-cycle.TheStoppableHandle.StopAutomatonHandleinterface defines those methods related to the handle based stop life-cycle.This exception is thrown in case a handle was provided which was unknown to the invoked component.This exception is thrown in case a handle was provided whose reference does not support a given operation.