org.picocontainer.gems.containers
Class CommonsLoggingTracingContainerDecorator

java.lang.Object
  extended by org.picocontainer.gems.containers.CommonsLoggingTracingContainerDecorator
All Implemented Interfaces:
Disposable, MutablePicoContainer, PicoContainer, Startable

public class CommonsLoggingTracingContainerDecorator
extends Object
implements MutablePicoContainer

Author:
Michael Rimov

Constructor Summary
CommonsLoggingTracingContainerDecorator(MutablePicoContainer delegate)
          Default typical wrapper that wraps another MutablePicoContainer.
CommonsLoggingTracingContainerDecorator(MutablePicoContainer delegate, String loggingCategory)
          Alternate constructor that allows specification of the Logger to use.
 
Method Summary
 void accept(PicoVisitor visitor)
          
 boolean addChildContainer(PicoContainer child)
          
 void dispose()
          
 ComponentAdapter getComponentAdapter(Object componentKey)
          
 ComponentAdapter getComponentAdapterOfType(Class componentType)
          
 Collection getComponentAdapters()
          
 List getComponentAdaptersOfType(Class componentType)
          
 Object getComponentInstance(Object componentKey)
          
 Object getComponentInstanceOfType(Class componentType)
          
 List getComponentInstances()
          
 List getComponentInstancesOfType(Class componentType)
          
 Log getLoggerUsed()
          Retrieves the log instance used by this decorator.
 PicoContainer getParent()
          
 MutablePicoContainer makeChildContainer()
          
protected  void onKeyDoesntExistInContainer(Object componentKey, Log target)
          Standard message handling for cases when a null object is returned for a given key.
 ComponentAdapter registerComponent(ComponentAdapter componentAdapter)
          
 ComponentAdapter registerComponentImplementation(Class componentImplementation)
          
 ComponentAdapter registerComponentImplementation(Object componentKey, Class componentImplementation)
          
 ComponentAdapter registerComponentImplementation(Object componentKey, Class componentImplementation, Parameter[] parameters)
          
 ComponentAdapter registerComponentInstance(Object componentInstance)
          
 ComponentAdapter registerComponentInstance(Object componentKey, Object componentInstance)
          
 boolean removeChildContainer(PicoContainer child)
          
 void start()
          
 void stop()
          
 ComponentAdapter unregisterComponent(Object componentKey)
          
 ComponentAdapter unregisterComponentByInstance(Object componentInstance)
          
 void verify()
          Deprecated.  
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CommonsLoggingTracingContainerDecorator

public CommonsLoggingTracingContainerDecorator(MutablePicoContainer delegate)
Default typical wrapper that wraps another MutablePicoContainer.

Parameters:
delegate - Container to be decorated.
Throws:
NullPointerException - if delegate is null.

CommonsLoggingTracingContainerDecorator

public CommonsLoggingTracingContainerDecorator(MutablePicoContainer delegate,
                                               String loggingCategory)
Alternate constructor that allows specification of the Logger to use.

Parameters:
delegate - Container to be decorated.
log - specific Log4j Logger to use.
Throws:
NullPointerException - if delegate or log is null.
Method Detail

onKeyDoesntExistInContainer

protected void onKeyDoesntExistInContainer(Object componentKey,
                                           Log target)
Standard message handling for cases when a null object is returned for a given key.

Parameters:
componentKey -
target -

accept

public void accept(PicoVisitor visitor)

Specified by:
accept in interface PicoContainer
Parameters:
visitor -
See Also:
PicoContainer.accept(org.picocontainer.PicoVisitor)

addChildContainer

public boolean addChildContainer(PicoContainer child)

Specified by:
addChildContainer in interface MutablePicoContainer
Parameters:
child -
Returns:
See Also:
MutablePicoContainer.addChildContainer(org.picocontainer.PicoContainer)

dispose

public void dispose()

Specified by:
dispose in interface Disposable
See Also:
Disposable.dispose()

getComponentAdapter

public ComponentAdapter getComponentAdapter(Object componentKey)

Specified by:
getComponentAdapter in interface PicoContainer
Parameters:
componentKey -
Returns:
See Also:
PicoContainer.getComponentAdapter(java.lang.Object)

getComponentAdapterOfType

public ComponentAdapter getComponentAdapterOfType(Class componentType)

Specified by:
getComponentAdapterOfType in interface PicoContainer
Parameters:
componentType -
Returns:
ComponentAdapter or null.
See Also:
PicoContainer.getComponentAdapterOfType(java.lang.Class)

getComponentAdapters

public Collection getComponentAdapters()

Specified by:
getComponentAdapters in interface PicoContainer
Returns:
Collection or null.
See Also:
PicoContainer.getComponentAdapters()

getComponentAdaptersOfType

public List getComponentAdaptersOfType(Class componentType)

Specified by:
getComponentAdaptersOfType in interface PicoContainer
Parameters:
componentType -
Returns:
List of ComponentAdapters
See Also:
PicoContainer.getComponentAdaptersOfType(java.lang.Class)

getComponentInstance

public Object getComponentInstance(Object componentKey)

Specified by:
getComponentInstance in interface PicoContainer
Parameters:
componentKey -
Returns:
See Also:
PicoContainer.getComponentInstance(java.lang.Object)

getComponentInstanceOfType

public Object getComponentInstanceOfType(Class componentType)

Specified by:
getComponentInstanceOfType in interface PicoContainer
Parameters:
componentType -
Returns:
See Also:
PicoContainer.getComponentInstanceOfType(java.lang.Class)

getComponentInstances

public List getComponentInstances()

Specified by:
getComponentInstances in interface PicoContainer
Returns:
See Also:
PicoContainer.getComponentInstances()

getComponentInstancesOfType

public List getComponentInstancesOfType(Class componentType)

Specified by:
getComponentInstancesOfType in interface PicoContainer
Parameters:
componentType -
Returns:
See Also:
PicoContainer.getComponentInstancesOfType(java.lang.Class)

getParent

public PicoContainer getParent()

Specified by:
getParent in interface PicoContainer
Returns:
See Also:
PicoContainer.getParent()

makeChildContainer

public MutablePicoContainer makeChildContainer()

Specified by:
makeChildContainer in interface MutablePicoContainer
Returns:
See Also:
MutablePicoContainer.makeChildContainer()

registerComponent

public ComponentAdapter registerComponent(ComponentAdapter componentAdapter)

Specified by:
registerComponent in interface MutablePicoContainer
Parameters:
componentAdapter -
Returns:
See Also:
MutablePicoContainer.registerComponent(org.picocontainer.ComponentAdapter)

registerComponentImplementation

public ComponentAdapter registerComponentImplementation(Class componentImplementation)

Specified by:
registerComponentImplementation in interface MutablePicoContainer
Parameters:
componentImplementation -
Returns:
See Also:
MutablePicoContainer.registerComponentImplementation(java.lang.Class)

registerComponentImplementation

public ComponentAdapter registerComponentImplementation(Object componentKey,
                                                        Class componentImplementation,
                                                        Parameter[] parameters)

Specified by:
registerComponentImplementation in interface MutablePicoContainer
Parameters:
componentKey -
componentImplementation -
parameters -
Returns:
See Also:
MutablePicoContainer.registerComponentImplementation(java.lang.Object, java.lang.Class, org.picocontainer.Parameter[])

registerComponentImplementation

public ComponentAdapter registerComponentImplementation(Object componentKey,
                                                        Class componentImplementation)

Specified by:
registerComponentImplementation in interface MutablePicoContainer
Parameters:
componentKey -
componentImplementation -
Returns:
See Also:
MutablePicoContainer.registerComponentImplementation(java.lang.Object, java.lang.Class)

registerComponentInstance

public ComponentAdapter registerComponentInstance(Object componentKey,
                                                  Object componentInstance)

Specified by:
registerComponentInstance in interface MutablePicoContainer
Parameters:
componentKey -
componentInstance -
Returns:
See Also:
MutablePicoContainer.registerComponentInstance(java.lang.Object, java.lang.Object)

registerComponentInstance

public ComponentAdapter registerComponentInstance(Object componentInstance)

Specified by:
registerComponentInstance in interface MutablePicoContainer
Parameters:
componentInstance -
Returns:
See Also:
MutablePicoContainer.registerComponentInstance(java.lang.Object)

removeChildContainer

public boolean removeChildContainer(PicoContainer child)

Specified by:
removeChildContainer in interface MutablePicoContainer
Parameters:
child -
Returns:
See Also:
MutablePicoContainer.removeChildContainer(org.picocontainer.PicoContainer)

start

public void start()

Specified by:
start in interface Startable
See Also:
Startable.start()

stop

public void stop()

Specified by:
stop in interface Startable
See Also:
Startable.stop()

unregisterComponent

public ComponentAdapter unregisterComponent(Object componentKey)

Specified by:
unregisterComponent in interface MutablePicoContainer
Parameters:
componentKey -
Returns:
See Also:
MutablePicoContainer.unregisterComponent(java.lang.Object)

unregisterComponentByInstance

public ComponentAdapter unregisterComponentByInstance(Object componentInstance)

Specified by:
unregisterComponentByInstance in interface MutablePicoContainer
Parameters:
componentInstance -
Returns:
See Also:
MutablePicoContainer.unregisterComponentByInstance(java.lang.Object)

verify

public void verify()
            throws PicoVerificationException
Deprecated. 

Specified by:
verify in interface PicoContainer
Throws:
PicoVerificationException
See Also:
PicoContainer.verify()

getLoggerUsed

public Log getLoggerUsed()
Retrieves the log instance used by this decorator.

Returns:
Logger instance.


Copyright © 2003-2010 Codehaus. All Rights Reserved.