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 $

                getLogger().debug( message );
            }
            throw new ComponentException( hint.toString(), message );
        }


        Component component = null;


        try
        {
            component = handler.get();
        }

View Full Code Here

     * @return a <code>Component</code>
     * @exception Exception if an error occurs
     */
    public Component get() throws Exception
    {
        Component component = doGet();


        synchronized( m_referenceSemaphore )
        {
            m_references++;
        }

View Full Code Here

        ContainerUtil.dispose(startupManager);
        startupManager = null;


        // add the logger manager to the component locator
        final ComponentProxyGenerator proxyGenerator = new ComponentProxyGenerator();
        final Component loggerManagerProxy = proxyGenerator.getProxy(LoggerManager.class.getName(),loggerManager);
        componentManager.addComponentInstance(LoggerManager.ROLE,loggerManagerProxy);


        ContainerUtil.initialize(this.componentManager);


        // Get the Processor and keep it if it's ThreadSafe

View Full Code Here

        if (handler == null) {
            throw new ComponentException(ROLE, "Could not find component for hint: " + hint);
        }


        try {
            Component component = (Component) handler.get();
            componentMapping.put(component, handler);
            return component;
        } catch (Exception ce) {
            if (getLogger().isDebugEnabled())
                getLogger().debug("Could not access component for hint: " + hint, ce);

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

    void release() {
        if ( this.requestLifecycleComponents != null ) {
            final Iterator iter = this.requestLifecycleComponents.values().iterator();
            while (iter.hasNext()) {
                final Object[] o = (Object[])iter.next();
                final Component component = (Component)o[0];
                ((CocoonComponentManager)o[1]).releaseRLComponent( component );
            }
            this.requestLifecycleComponents.clear();
        }
        
        for(int i = 0; i < autoreleaseComponents.size(); i++) {
            final Object[] o = (Object[])autoreleaseComponents.get(i);
            final Component component = (Component)o[0];
            if (o[1] instanceof ComponentManager) {
                ((ComponentManager)o[1]).release( component );
            } else {
                ((ComponentSelector)o[1]).release( component );
                if (o[2] != null) {

View Full Code Here

        for (Iterator it = lookupComponents.iterator(); it.hasNext();)
        {
            String component = (String) it.next();
            try
            {
                Component c = manager.lookup(component);
                log.info("Lookup for Component " + component + " successful");
                manager.release(c);
            }
            catch (Exception e)
            {

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

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.