Examples of org.apache.avalon.framework.component.Component

Package org.apache.avalon.framework.component

Examples of org.apache.avalon.framework.component.Component

org.apache.avalon.framework.component.Component
This interface identifies classes that can be used as Components by a Composable.
The contract surrounding the Component is that it is used, but not a user. When a class implements this interface, it is stating that other entities may use that class.

A Component is the basic building block of the Avalon Framework. When a class implements this interface, it allows itself to be managed by a ComponentManager and used by an outside element called a Composable. The Composable must know what type of Component it is accessing, so it will re-cast the Component into the type it needs.

In order for a Component to be useful you must either extend this interface, or implement this interface in conjunction with one that actually has methods. The new interface is the contract with the Composable that this is a particular type of component, and as such it can perform those functions on that type of component.

For example, we want a component that performs a logging function so we extend the Component to be a LoggingComponent.
```
 interface LoggingComponent extends Component { log(String message); } 
```
Now all Composables that want to use this type of component, will re-cast the Component into a LoggingComponent and the Composable will be able to use the log method.

Deprecated: Deprecated without replacement. Should only be used while migrating away from a system based on Composable/ComponentManager. A generic java.lang.Object can be used as a replacement.
@author Avalon Development Team @version CVS $Revision: 1.16 $ $Date: 2004/02/11 14:34:24 $

        throws Exception
    {
        Integer testInt = new Integer( 7 );
        ComponentProxyGenerator proxyGen = new ComponentProxyGenerator();


        final Component component =
            proxyGen.getProxy( "java.lang.Comparable", testInt );
        assertTrue( component != null );
        assertTrue( component instanceof Comparable );


        Comparable comp = (Comparable)component;

View Full Code Here

        m_manager.addComponent( Dad.ROLE, dadClass, emptyConfig );
        m_manager.addComponent( Kid.ROLE, kidClass, emptyConfig );


        m_manager.initialize();


        Component mom = m_manager.lookup( Mom.ROLE );
        Component dad = m_manager.lookup( Dad.ROLE );


        m_manager.release( mom );
        m_manager.release( dad );


        m_manager.dispose();

View Full Code Here

     * is <code>ThreadSafe</code>, and return it if true.
     * <p>
     * Note : this method must be called <i>after</i> <code>setSelector()</code>.
     */
    protected Component getThreadSafeComponent(String name) throws ComponentException {
        Component component = this.selector.select(name);
        if (component instanceof ThreadSafe) {
            return component;
        } else {
            this.selector.release(component);
            return null;

View Full Code Here

            this.parentSelector = newSelector;
        }
    }


    public Component select(Object hint) throws ComponentException {
        Component component = null;


        try {
            component = super.select(hint);
        } catch (ComponentException ce) {
            if (this.parentSelector != null) {

View Full Code Here

     * @exception ComponentException if a bundle is not found
     */
    public Component select(String name, Locale loc, boolean cacheAtStartup)
        throws ComponentException
    {
        Component bundle = _select(name, loc, cacheAtStartup);
        if (bundle == null)
            throw new ComponentException("Unable to locate resource: " + name);
        return bundle;
    }

View Full Code Here

     * @exception ComponentException if a bundle is not found
     */
    public Component selectFromFilename(String fileName, boolean cacheAtStartup)
        throws ComponentException
    {
        Component bundle = _select(fileName, null, cacheAtStartup);
        if (bundle == null)
            throw new ComponentException("Unable to locate resource: " + fileName);
        return bundle;
    }

View Full Code Here

     * @param fileName          file name of the bundle
     * @return                  the cached bundle; null, if not found
     */
    protected Component selectCached(String fileName)
    {
        Component bundle = null;
        try
        {
            bundle = super.select(fileName);
            if (logger.isDebugEnabled()) logger.debug("Returning from cache: " + fileName);
        }

View Full Code Here

            try {
                return super.select(hint);


            } catch(ComponentException ce) {
                // Doesn't exist here : try in parent selector
                Component component = this.parentSelector.select(hint);
                this.parentComponents.add(component);
                return component;
            }
        }
    }

View Full Code Here

                getLogger().debug( message + " for role: " + role );
            }
            throw new ComponentException( role, message );
        }


        Component component = null;


        try
        {
            component = handler.get();
        }

View Full Code Here

        //  with the ECM.  We need to remember to unwrap this when the component is
        //  decommissioned.
    //
    // note that ComponentHandler depends on this specific
    // component instanceof Component check to be made
        Component returnableComponent;
        if( !( component instanceof Component ) )
        {
            returnableComponent = m_proxyGenerator.getCompatibleProxy( component );
            m_componentProxies.put( returnableComponent, component );
        }

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of org.apache.avalon.framework.component.Component

org.apache.avalon.excalibur.component.ComponentHandler

org.apache.avalon.excalibur.component.DefaultComponentFactory

org.apache.avalon.excalibur.component.ExcaliburComponentManager

org.apache.avalon.excalibur.component.ExcaliburComponentSelector

org.apache.avalon.excalibur.component.test.ComponentProxyGeneratorTestCase

org.apache.avalon.excalibur.component.test.ExcaliburComponentManagerTestCase

org.apache.cocoon.acting.ModularDatabaseAction

org.apache.cocoon.Cocoon

org.apache.cocoon.components.CocoonComponentManager

org.apache.cocoon.components.EnvironmentDescription

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.