plexus-component-api-1.0.0~alpha22/ 0000755 0001750 0001750 00000000000 11225420770 017105 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/ 0000755 0001750 0001750 00000000000 11225420767 017702 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/test/ 0000755 0001750 0001750 00000000000 11225420767 020661 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/test/java/ 0000755 0001750 0001750 00000000000 11225420767 021602 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/test/java/org/ 0000755 0001750 0001750 00000000000 11225420767 022371 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/test/java/org/codehaus/ 0000755 0001750 0001750 00000000000 11225420767 024164 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/test/java/org/codehaus/plexus/ 0000755 0001750 0001750 00000000000 11225420767 025504 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/ 0000755 0001750 0001750 00000000000 11225420770 020620 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/ 0000755 0001750 0001750 00000000000 11225420770 022227 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/ 0000755 0001750 0001750 00000000000 11225420770 023016 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/ 0000755 0001750 0001750 00000000000 11225420770 024611 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/ 0000755 0001750 0001750 00000000000 11225420770 026131 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/package.html 0000644 0001750 0001750 00000000234 10554073705 030417 0 ustar twerner twerner
Provides the API that bootstraps the Plexus Component managment. This is the entry point for all Plexus
component access.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/logging/ 0000755 0001750 0001750 00000000000 11225420770 027557 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/logging/package.html 0000644 0001750 0001750 00000000155 10554073705 032047 0 ustar twerner twerner
Provides the classes and interfaces for the core Plexus logging facilities.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/configuration/ 0000755 0001750 0001750 00000000000 11225420770 031000 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/configuration/package.html 0000644 0001750 0001750 00000000227 10554073705 033270 0 ustar twerner twerner
Configurations in Plexus are the classes that define how a component is described, for example, as a plexus.xml file.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/ 0000755 0001750 0001750 00000000000 11225420770 030133 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/reloading/ 0000755 0001750 0001750 00000000000 11225420770 032077 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000151 00000000000 011562 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/reloading/package.html plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/reloading/package.0000644 0001750 0001750 00000000157 10554073705 033504 0 ustar twerner twerner
Provides tools for defining what Plexus should do when reloading a component.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/ 0000755 0001750 0001750 00000000000 11225420770 032352 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000152 00000000000 011563 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/package.html plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/package0000644 0001750 0001750 00000000227 10554073705 033677 0 ustar twerner twerner
Provides classes for defining/describing components and dependencies as they are contained in a component repository.
././@LongLink 0000000 0000000 0000000 00000000150 00000000000 011561 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/exception/ plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/excepti0000755 0001750 0001750 00000000000 11225420770 033734 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000164 00000000000 011566 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/exception/package.html plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/repository/excepti0000644 0001750 0001750 00000000165 10554073705 033746 0 ustar twerner twerner
Contains exceptions thrown by ComponentRepositories (see container implementation).
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/discovery/ 0000755 0001750 0001750 00000000000 11225420770 032142 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000151 00000000000 011562 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/discovery/package.html plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/discovery/package.0000644 0001750 0001750 00000000151 10554073705 033541 0 ustar twerner twerner
Component discovery in Plexus is the act of finding component metadata.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/composition/ 0000755 0001750 0001750 00000000000 11225420770 032476 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000153 00000000000 011564 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/composition/package.html plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/component/composition/packag0000644 0001750 0001750 00000000303 10554073705 033651 0 ustar twerner twerner
Contains tools used for component composition - which basically means, injecting component objects with its required
dependencies and other configuration data.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/context/ 0000755 0001750 0001750 00000000000 11225420770 027615 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/context/package.html 0000644 0001750 0001750 00000000171 10554073705 032103 0 ustar twerner twerner
Contains classes which hold and help hold context information for the Plexus framework.
plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/ 0000755 0001750 0001750 00000000000 11225420770 030502 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/ 0000755 0001750 0001750 00000000000 11225420770 032022 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000146 00000000000 011566 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/lifecycle/ plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/lifecycle0000755 0001750 0001750 00000000000 11225420770 033702 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000154 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/lifecycle/phase/ plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/lifecycle0000755 0001750 0001750 00000000000 11225420770 033702 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000170 00000000000 011563 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/lifecycle/phase/package.html plexus-component-api-1.0.0~alpha22/src/main/javadoc/org/codehaus/plexus/personality/plexus/lifecycle0000644 0001750 0001750 00000000224 10554073705 033710 0 ustar twerner twerner
Contains the interfaces (and exceptions) which represent the component lifecycle phases of the Plexus personality.
plexus-component-api-1.0.0~alpha22/src/main/java/ 0000755 0001750 0001750 00000000000 11225420767 021547 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/ 0000755 0001750 0001750 00000000000 11225420767 022336 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/ 0000755 0001750 0001750 00000000000 11225420767 024131 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/ 0000755 0001750 0001750 00000000000 11225420770 025443 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/PlexusContainer.java 0000644 0001750 0001750 00000050627 10575515633 031455 0 ustar twerner twerner package org.codehaus.plexus;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.classworlds.realm.ClassRealm;
import org.codehaus.plexus.component.composition.CompositionException;
import org.codehaus.plexus.component.discovery.ComponentDiscoveryListener;
import org.codehaus.plexus.component.repository.ComponentDescriptor;
import org.codehaus.plexus.component.repository.exception.ComponentLifecycleException;
import org.codehaus.plexus.component.repository.exception.ComponentLookupException;
import org.codehaus.plexus.component.repository.exception.ComponentRepositoryException;
import org.codehaus.plexus.context.Context;
import org.codehaus.plexus.logging.Logger;
import org.codehaus.plexus.logging.LoggerManager;
import java.io.File;
import java.util.Date;
import java.util.List;
import java.util.Map;
/**
* The core component of Plexus. This is the entry-point for loading and accessing other components, as well as an
* element in a hierarchy of containers. A Plexus Container can also itself be a component, however, the hierarchy must
* be bootstrapped by a PlexusContainer implementation.
*/
public interface PlexusContainer
{
String ROLE = PlexusContainer.class.getName();
/**
* Returns the unique name of this container in the container hierarchy.
* @return the unique name of this container in the container hierarchy
*/
String getName();
/**
* Returns the date this container was created.
* @return the date this container was created
*/
public Date getCreationDate();
/**
* Returns true if this container has a child with the given name.
* @param name a key unique amongst this container's children
* @return true if this container has a child with the given name
*/
boolean hasChildContainer( String name );
/**
* Removes the keyed child from this container. Does not necessarily dispose the children.
* @param name a key unique amongst this container's children
*/
void removeChildContainer( String name );
/**
* Returns a child container with the unique name.
* @param name a key unique amongst this container's children
* @return the keyed child container
*/
PlexusContainer getChildContainer( String name );
// ------------------------------------------------------------------------
// Lookup
// ------------------------------------------------------------------------
/**
* Looks up and returns a component object with the given unique key or role.
* @param componentKey a unique key for the desired component
* @return a Plexus component object
*/
Object lookup( String componentKey )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique key or role.
* @param componentKey a unique key for the desired component
* @return a Plexus component object
*/
Object lookup( String componentKey, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique role/role-hint combination.
* @param role a non-unique key for the desired component
* @param roleHint a hint for the desired component implementation
* @return a Plexus component object
*/
Object lookup( String role, String roleHint )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique role/role-hint combination.
* @param role a non-unique key for the desired component
* @param roleHint a hint for the desired component implementation
* @return a Plexus component object
*/
Object lookup( String role, String roleHint, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique key or role.
* @param componentClass a unique key for the desired component
* @return a Plexus component object
*/
Object lookup( Class componentClass )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique key or role.
* @param componentClass a unique key for the desired component
* @return a Plexus component object
*/
Object lookup( Class componentClass, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique role/role-hint combination.
* @param role a non-unique class key for the desired component
* @param roleHint a hint for the desired component implementation
* @return a Plexus component object
*/
Object lookup( Class role, String roleHint )
throws ComponentLookupException;
/**
* Looks up and returns a component object with the given unique role/role-hint combination.
* @param role a non-unique class key for the desired component
* @param roleHint a hint for the desired component implementation
* @return a Plexus component object
*/
Object lookup( Class role, String roleHint, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a List of component objects with the given role.
* @param role a non-unique key for the desired components
* @return a List of component objects
*/
List lookupList( String role )
throws ComponentLookupException;
/**
* Looks up and returns a List of component objects with the given role.
* @param role a non-unique key for the desired components
* @return a List of component objects
*/
List lookupList( String role, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a List of component objects with the given role.
* @param role a non-unique class key for the desired components
* @return a List of component objects
*/
List lookupList( Class role )
throws ComponentLookupException;
/**
* Looks up and returns a List of component objects with the given role.
* @param role a non-unique class key for the desired components
* @return a List of component objects
*/
List lookupList( Class role, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a Map of component objects with the given role, keyed by all available role-hints.
* @param role a non-unique key for the desired components
* @return a Map of component objects
*/
Map lookupMap( String role )
throws ComponentLookupException;
/**
* Looks up and returns a Map of component objects with the given role, keyed by all available role-hints.
* @param role a non-unique key for the desired components
* @return a Map of component objects
*/
Map lookupMap( String role, ClassRealm realm )
throws ComponentLookupException;
/**
* Looks up and returns a Map of component objects with the given role, keyed by all available role-hints.
* @param role a non-unique class key for the desired components
* @return a Map of component objects
*/
Map lookupMap( Class role )
throws ComponentLookupException;
/**
* Looks up and returns a Map of component objects with the given role, keyed by all available role-hints.
* @param role a non-unique class key for the desired components
* @return a Map of component objects
*/
Map lookupMap( Class role, ClassRealm realm )
throws ComponentLookupException;
// ----------------------------------------------------------------------
// Component Descriptor Lookup
// ----------------------------------------------------------------------
/**
* Returns the ComponentDescriptor with the given component role and the default role hint.
* Searches up the hierarchy until one is found, null if none is found.
* @param role a unique role for the desired component's descriptor
* @return the ComponentDescriptor with the given component role
*/
ComponentDescriptor getComponentDescriptor( String role );
/**
* Returns the ComponentDescriptor with the given component role and hint.
* Searches up the hierarchy until one is found, null if none is found.
* @param role a unique role for the desired component's descriptor
* @param roleHint a hint showing which implementation should be used
* @return the ComponentDescriptor with the given component role
*/
ComponentDescriptor getComponentDescriptor( String role, String roleHint );
/**
* Returns the ComponentDescriptor with the given component role and the default role hint.
* Searches up the hierarchy until one is found, null if none is found.
* @param role a unique role for the desired component's descriptor
* @param realm The class realm to search
* @return the ComponentDescriptor with the given component role
*/
ComponentDescriptor getComponentDescriptor( String role, ClassRealm realm );
/**
* Returns the ComponentDescriptor with the given component role and hint.
* Searches up the hierarchy until one is found, null if none is found.
* @param role a unique role for the desired component's descriptor
* @param roleHint a hint showing which implementation should be used
* @param realm The class realm to search
* @return the ComponentDescriptor with the given component role
*/
ComponentDescriptor getComponentDescriptor( String role, String roleHint, ClassRealm realm );
/**
* Returns a Map of ComponentDescriptors with the given role, keyed by role-hint. Searches up the hierarchy until
* all are found, an empty Map if none are found.
* @param role a non-unique key for the desired components
* @return a Map of component descriptors keyed by role-hint
*/
Map getComponentDescriptorMap( String role );
/**
* Returns a Map of ComponentDescriptors with the given role, keyed by role-hint. Searches up the hierarchy until
* all are found, an empty Map if none are found.
* @param role a non-unique key for the desired components
* @return a Map of component descriptors keyed by role-hint
*/
Map getComponentDescriptorMap( String role, ClassRealm componentRealm );
/**
* Returns a List of ComponentDescriptors with the given role. Searches up the hierarchy until all are found, an
* empty List if none are found.
* @param role a non-unique key for the desired components
* @return a List of component descriptors
*/
List getComponentDescriptorList( String role );
/**
* Returns a List of ComponentDescriptors with the given role. Searches up the hierarchy until all are found, an
* empty List if none are found.
* @param role a non-unique key for the desired components
* @return a List of component descriptors
*/
List getComponentDescriptorList( String role, ClassRealm componentRealm );
/**
* Adds a component descriptor to this container. componentDescriptor should have realmId set.
* @param componentDescriptor
* @throws ComponentRepositoryException
*/
void addComponentDescriptor( ComponentDescriptor componentDescriptor )
throws ComponentRepositoryException;
/**
* Releases the component from the container. This is dependant upon how the implementation manages the component,
* but usually enacts some standard lifecycle shutdown procedure on the component. In every case, the component is
* no longer accessible from the container (unless another is created).
* @param component the plexus component object to release
* @throws ComponentLifecycleException
*/
void release( Object component )
throws ComponentLifecycleException;
/**
* Releases all Mapped component values from the container.
* @see PlexusContainer#release( Object component )
* @param components Map of plexus component objects to release
* @throws ComponentLifecycleException
*/
void releaseAll( Map components )
throws ComponentLifecycleException;
/**
* Releases all Listed components from the container.
* @see PlexusContainer#release( Object component )
* @param components List of plexus component objects to release
* @throws ComponentLifecycleException
*/
void releaseAll( List components )
throws ComponentLifecycleException;
/**
* Returns true if this container has the keyed component.
* @param role
* @return true if this container has the keyed component
*/
boolean hasComponent( String role );
/**
* Returns true if this container has a component with the given role/role-hint.
* @param role
* @param roleHint
* @return true if this container has a component with the given role/role-hint
*/
boolean hasComponent( String role, String roleHint );
/**
* Attempts to suspend execution of the component.
* @param component a plexus component
* @throws ComponentLifecycleException
*/
void suspend( Object component )
throws ComponentLifecycleException;
/**
* Attempts to resume execution of the component.
* @param component a plexus component
* @throws ComponentLifecycleException
*/
void resume( Object component )
throws ComponentLifecycleException;
/**
* Disposes of this container, which in turn disposes all of it's components. This container should also remove
* itself from the container hierarchy.
*/
void dispose();
// ----------------------------------------------------------------------
// Context
// ----------------------------------------------------------------------
/**
* Add a key/value pair to this container's Context.
* @param key any unique object valid to the Context's implementation
* @param value any object valid to the Context's implementation
*/
void addContextValue( Object key, Object value );
/**
* Returns this container's context. A Context is a simple data store used to hold values which may alter the
* execution of the Container.
* @return this container's context.
*/
Context getContext();
/**
* Returns the Classworld's ClassRealm of this Container, which acts as the default parent for all contained
* components.
* @return the ClassRealm of this Container
*/
ClassRealm getContainerRealm();
// ----------------------------------------------------------------------
// Discovery
// ----------------------------------------------------------------------
/**
* Adds the listener to this container. ComponentDiscoveryListeners have the ability to respond to various
* ComponentDiscoverer events.
* @param listener A listener which responds to differnet ComponentDiscoveryEvents
*/
void registerComponentDiscoveryListener( ComponentDiscoveryListener listener );
/**
* Removes the listener from this container.
* @param listener A listener to remove
*/
void removeComponentDiscoveryListener( ComponentDiscoveryListener listener );
/**
* Adds a directory of jar resources.
* @see PlexusContainer#addJarResource(File)
* @param repository a directory containing JAR files
*/
void addJarRepository( File repository );
/**
* Adds a jar to this container's ClassRealm - whose components are then discovered (via the various registered
* ComponentDiscoverer's).
* @param resource a JAR file
* @throws PlexusContainerException
*/
void addJarResource( File resource )
throws PlexusContainerException;
// ----------------------------------------------------------------------
// Autowiring Support
// ----------------------------------------------------------------------
/**
* Assembles a component and returns it. May bypass the normal component assembly hooks (such as creation of a
* ComponentDescriptor).
* @param component a valid Plexus component
* @return a componsed (dependency-injected) component
*/
Object autowire( Object component )
throws CompositionException;
/**
* Creates a corrosponding component instance found in this container's classrealm, then autowires it.
* @see PlexusContainer#autowire(Object)
* @param clazz A class available in this container's ClassRealm
* @return A newly created and autowired component
* @throws CompositionException
* @throws ClassNotFoundException
* @throws InstantiationException
* @throws IllegalAccessException
*/
Object createAndAutowire( String clazz )
throws CompositionException, ClassNotFoundException, InstantiationException, IllegalAccessException;
// ----------------------------------------------------------------------
// Reloading
// ----------------------------------------------------------------------
/**
* Sets the ability to reload a component's metadata multiple times.
* @param reloadingEnabled true is a component may be reloaded
*/
void setReloadingEnabled( boolean reloadingEnabled );
/**
* Returns true if a component's metadata may be reloaded, otherwise, it may be loaded only once.
* @return true if a component's metadata may be reloaded
*/
boolean isReloadingEnabled();
// ------------------------------------------------------------------------
// Required for compatibility
// ------------------------------------------------------------------------
void setLoggerManager( LoggerManager loggerManager );
// Required by maven
LoggerManager getLoggerManager();
/**
* @deprecated
*/
Logger getLogger();
// Taken from alpha-9 to keep things working
void setName( String name );
/**
* Sets the parent of this container.
* @param container the parent of this container, null if none
*/
void setParentPlexusContainer( PlexusContainer container );
PlexusContainer createChildContainer( String name, List classpathJars, Map context )
throws PlexusContainerException;
public PlexusContainer createChildContainer( String name, List classpathJars, Map context, List discoveryListeners )
throws PlexusContainerException;
// ----------------------------------------------------------------------------
// Component/Plugin ClassRealm creation
// ----------------------------------------------------------------------------
/**
* Creates and returns a new class realm under this container's realm for the given list of jars. If the realm
* already exists, return the realm with the given ID?
* @see PlexusContainer#addJarResource(File)
* @param id unique key for the ClassRealm
* @param jars list of JARs to place in the realm.
* @throws PlexusContainerException
*/
public ClassRealm createComponentRealm( String id, List jars )
throws PlexusContainerException;
ClassRealm getComponentRealm( String realmId );
/**
* Returns the lookup realm for this container, which is either
* the container realm or the realm set by {@see MutablePlexusContainer#setLookupRealm(ClassRealm)}.
*/
ClassRealm getLookupRealm();
/**
* Sets the lookup realm to use for lookup calls that don't have a ClassRealm parameter.
* @param realm the new realm to use.
* @return The previous lookup realm. It is adviced to set it back once the old-style lookups have completed.
*/
ClassRealm setLookupRealm(ClassRealm realm);
/**
* XXX ideally i'd like to place this in a plexus container specific utility class.
*
* Utility method to retrieve the lookup realm for a component instance.
* If the component's classloader is a ClassRealm, that realm is returned,
* otherwise the result of getLookupRealm is returned.
* @param component
* @return
*/
ClassRealm getLookupRealm( Object component );
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/PlexusConstants.java 0000644 0001750 0001750 00000002726 10572657020 031476 0 ustar twerner twerner package org.codehaus.plexus;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
public abstract class PlexusConstants
{
/** Context key for the variable that determines whether to load the container configuration file. */
public static final String IGNORE_CONTAINER_CONFIGURATION = "plexus.ignoreContainerConfiguration";
/** Location of plexus bootstrap configuration file. */
public static final String BOOTSTRAP_CONFIGURATION = "org/codehaus/plexus/plexus-bootstrap.xml";
/** Key used to retrieve the plexus container from the containerContext. */
public static final String PLEXUS_KEY = "plexus";
/** Key used to retrieve the core classworlds realm from the containerContext.*/
public static final String PLEXUS_CORE_REALM = "containerRealm";
/** The role-hint to use for components or lookups that do not specify a role.*/
public static final String PLEXUS_DEFAULT_HINT = "default";
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/ 0000755 0001750 0001750 00000000000 11225420770 027071 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/LoggerManager.java 0000644 0001750 0001750 00000004106 10531410573 032446 0 ustar twerner twerner package org.codehaus.plexus.logging;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @author Jason van Zyl
* @author Trygve Laugstøl
* @version $Id: LoggerManager.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public interface LoggerManager
{
String ROLE = LoggerManager.class.getName();
/**
* Sets the threshold for all new loggers. It will NOT affect the existing loggers.
*
* This is usually only set once while the logger manager is configured.
*
* @param threshold The new threshold.
*/
void setThreshold( int threshold );
/**
* Returns the current threshold for all new loggers.
*
* @return Returns the current threshold for all new loggers.
*/
int getThreshold();
/**
* Sets the threshold for all loggers. It affects all the existing loggers
* as well as future loggers.
*
* @param threshold The new threshold.
*/
void setThresholds( int threshold );
// The new stuff
void setThreshold( String role, int threshold );
void setThreshold( String role, String roleHint, int threshold );
int getThreshold( String role );
int getThreshold( String role, String roleHint );
Logger getLoggerForComponent( String role );
Logger getLoggerForComponent( String role, String roleHint );
void returnComponentLogger( String role );
void returnComponentLogger( String role, String hint );
int getActiveLoggerCount();
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/LogEnabled.java 0000644 0001750 0001750 00000001437 10531410573 031734 0 ustar twerner twerner package org.codehaus.plexus.logging;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @version $Id: LogEnabled.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public interface LogEnabled
{
void enableLogging( Logger logger );
}
././@LongLink 0000000 0000000 0000000 00000000150 00000000000 011561 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/AbstractLoggerManager.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/AbstractLoggerManager.j0000644 0001750 0001750 00000003631 10531410573 033444 0 ustar twerner twerner package org.codehaus.plexus.logging;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @author Jason van Zyl
* @author Trygve Laugstøl
* @version $Id: AbstractLoggerManager.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public abstract class AbstractLoggerManager
implements LoggerManager
{
/** */
public AbstractLoggerManager()
{
}
public void setThreshold( String role, int threshold )
{
setThreshold( role, null, threshold );
}
public int getThreshold( String role )
{
return getThreshold( role, null );
}
public Logger getLoggerForComponent( String role )
{
return getLoggerForComponent( role, null );
}
public void returnComponentLogger( String role )
{
returnComponentLogger( role, null );
}
/**
* Creates a string key useful as keys in Map's.
*
* @param role The component role.
* @param roleHint The component role hint.
* @return Returns a string thats useful as a key for components.
*/
protected String toMapKey( String role, String roleHint )
{
if ( roleHint == null )
{
return role;
}
else
{
return role + ":" + roleHint;
}
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/Logger.java 0000644 0001750 0001750 00000004010 10531410573 031145 0 ustar twerner twerner package org.codehaus.plexus.logging;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @author Jason van Zyl
* @author Trygve Laugstøl
* @version $Id: Logger.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public interface Logger
{
/** Typecode for debugging messages. */
int LEVEL_DEBUG = 0;
/** Typecode for informational messages. */
int LEVEL_INFO = 1;
/** Typecode for warning messages. */
int LEVEL_WARN = 2;
/** Typecode for error messages. */
int LEVEL_ERROR = 3;
/** Typecode for fatal error messages. */
int LEVEL_FATAL = 4;
/** Typecode for disabled log levels. */
int LEVEL_DISABLED = 5;
void debug( String message );
void debug( String message, Throwable throwable );
boolean isDebugEnabled();
void info( String message );
void info( String message, Throwable throwable );
boolean isInfoEnabled();
void warn( String message );
void warn( String message, Throwable throwable );
boolean isWarnEnabled();
void error( String message );
void error( String message, Throwable throwable );
boolean isErrorEnabled();
void fatalError( String message );
void fatalError( String message, Throwable throwable );
boolean isFatalErrorEnabled();
Logger getChildLogger( String name );
int getThreshold();
void setThreshold( int threshold );
String getName();
}
././@LongLink 0000000 0000000 0000000 00000000145 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/AbstractLogEnabled.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/AbstractLogEnabled.java0000644 0001750 0001750 00000003361 10566662762 033437 0 ustar twerner twerner package org.codehaus.plexus.logging;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @author Jason van Zyl
* @author Trygve Laugstøl
* @version $Id: AbstractLogEnabled.java 5812 2007-02-20 21:19:46Z handyande $
*/
public abstract class AbstractLogEnabled
implements LogEnabled
{
private Logger logger;
public void enableLogging( Logger logger )
{
this.logger = logger;
}
protected Logger getLogger()
{
return logger;
}
protected void setupLogger( Object component )
{
setupLogger( component, logger );
}
protected void setupLogger( Object component, String subCategory )
{
if ( subCategory == null )
{
throw new IllegalStateException( "Logging category must be defined." );
}
Logger logger = this.logger.getChildLogger( subCategory );
setupLogger( component, logger );
}
protected void setupLogger( Object component, Logger logger )
{
if ( component instanceof LogEnabled )
{
( (LogEnabled) component ).enableLogging( logger );
}
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/logging/AbstractLogger.java 0000644 0001750 0001750 00000005600 10531410573 032637 0 ustar twerner twerner package org.codehaus.plexus.logging;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* LICENSE
*/
/**
* @author Trygve Laugstøl
* @version $Id: AbstractLogger.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public abstract class AbstractLogger
implements Logger
{
private int threshold;
private String name;
public AbstractLogger( int threshold, String name )
{
if ( !isValidThreshold( threshold ) )
{
throw new IllegalArgumentException( "Threshold " + threshold + " is not valid" );
}
this.threshold = threshold;
this.name = name;
}
public int getThreshold()
{
return threshold;
}
public void setThreshold( int threshold )
{
this.threshold = threshold;
}
public String getName()
{
return name;
}
public void debug( String message )
{
debug( message, null );
}
public boolean isDebugEnabled()
{
return threshold <= LEVEL_DEBUG;
}
public void info( String message )
{
info( message, null );
}
public boolean isInfoEnabled()
{
return threshold <= LEVEL_INFO;
}
public void warn( String message )
{
warn( message, null );
}
public boolean isWarnEnabled()
{
return threshold <= LEVEL_WARN;
}
public void error( String message )
{
error( message, null );
}
public boolean isErrorEnabled()
{
return threshold <= LEVEL_ERROR;
}
public void fatalError( String message )
{
fatalError( message, null );
}
public boolean isFatalErrorEnabled()
{
return threshold <= LEVEL_FATAL;
}
protected boolean isValidThreshold( int threshold )
{
if ( threshold == LEVEL_DEBUG )
{
return true;
}
if ( threshold == LEVEL_INFO )
{
return true;
}
if ( threshold == LEVEL_WARN )
{
return true;
}
if ( threshold == LEVEL_ERROR )
{
return true;
}
if ( threshold == LEVEL_FATAL )
{
return true;
}
if ( threshold == LEVEL_DISABLED )
{
return true;
}
return false;
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/PlexusContainerException.java 0000644 0001750 0001750 00000002720 10553524446 033321 0 ustar twerner twerner package org.codehaus.plexus;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Container execution exception.
*
* @author Brett Porter
* @version $Id: PlexusContainerException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class PlexusContainerException extends Exception
{
private static final long serialVersionUID = 2213861902264275451L;
/**
* Construct a new PlexusContainerException instance.
* @param message exception message
* @param throwable causing exception to chain
*/
public PlexusContainerException( String message, Throwable throwable )
{
super( message, throwable );
}
/**
* Construct a new PlexusContainerException instance.
* @param message exception message
*/
public PlexusContainerException( String message )
{
super( message );
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/configuration/ 0000755 0001750 0001750 00000000000 11225420770 030312 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000165 00000000000 011567 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/configuration/PlexusConfigurationException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/configuration/PlexusConfigurati0000644 0001750 0001750 00000002655 10553524446 033730 0 ustar twerner twerner package org.codehaus.plexus.configuration;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when an expected configuration value encounters
* problems loading correctly.
*/
public class PlexusConfigurationException
extends Exception
{
private static final long serialVersionUID = 7559886640184983689L;
/**
* Construct a new PlexusConfigurationException instance.
* @param message exception message
*/
public PlexusConfigurationException( String message )
{
this( message, null );
}
/**
* Construct a new PlexusConfigurationException instance.
* @param message exception message
* @param throwable causing exception to chain
*/
public PlexusConfigurationException( String message, Throwable throwable )
{
super( message, throwable );
}
}
././@LongLink 0000000 0000000 0000000 00000000154 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/configuration/PlexusConfiguration.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/configuration/PlexusConfigurati0000644 0001750 0001750 00000011012 10553524446 033713 0 ustar twerner twerner package org.codehaus.plexus.configuration;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* A configuration data hierarchy for configuring aspects of plexus. For
* example, to populate a ComponentDescriptor. Implementation of
* PlexusConfiguration may be populated by any means, for example, by XML file.
*/
public interface PlexusConfiguration
{
// ----------------------------------------------------------------------
// Name handling
// ----------------------------------------------------------------------
/**
* Returns the name of this configuration.
* @return the name of this configuration
*/
String getName();
// ----------------------------------------------------------------------
// Value handling
// ----------------------------------------------------------------------
/**
* Returns the value of this configuration.
* @return the value of this configuration
* @throws PlexusConfigurationException
*/
String getValue()
throws PlexusConfigurationException;
/**
* Returns the value of this configuration, or default if one cannot be
* found.
* @param defaultValue value to return if none is found
* @return the value of this configuration
*/
String getValue( String defaultValue );
// ----------------------------------------------------------------------
// Attribute handling
// ----------------------------------------------------------------------
/**
* Returns an array of attribute names.
* @return an array of attribute names
*/
String[] getAttributeNames();
/**
* Returns the value of the named attribute.
* @return the value of the named attribute
* @throws PlexusConfigurationException
*/
String getAttribute( String paramName )
throws PlexusConfigurationException;
/**
* Returns the value of the named attribute, or default if one cannot be
* found.
* @param defaultValue value to return if none is found
* @return the value of the named attribute
*/
String getAttribute( String name, String defaultValue );
// ----------------------------------------------------------------------
// Child handling
// ----------------------------------------------------------------------
/**
* Returns the child configuration of the given name.
* @param child the name of the child to return
* @return the child configuration of the given name
*/
PlexusConfiguration getChild( String child );
/**
* Returns the child configuration at the given location.
* @param i the position of the child under this configuration
* @return the child configuration at the given location
*/
PlexusConfiguration getChild( int i );
/**
* Returns the child configuration of the given name.
* @param child the name of the child to return
* @param createChild true if a new child should be create, if none found
* @return the child configuration of the given name, or new child if
* created
*/
PlexusConfiguration getChild( String child, boolean createChild );
/**
* Returns an array of all child configurations.
* @return an array of all child configurations
*/
PlexusConfiguration[] getChildren();
/**
* Returns an array of all child configurations with the given name.
* @param name the name of the children configurations to return
* @return an array of all child configurations with the given name
*/
PlexusConfiguration[] getChildren( String name );
/**
* Adds a configuration under this configuration, which acts as
* a parent.
* @param configuration the child configuration to add
*/
void addChild( PlexusConfiguration configuration );
/**
* Returns the number of directly children under this configuration.
* @return the number of directly children under this configuration.
*/
int getChildCount();
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/ 0000755 0001750 0001750 00000000000 11225420767 027453 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/reloading/ 0000755 0001750 0001750 00000000000 11225420767 031417 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000172 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/reloading/ComponentReloadingException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/reloading/ComponentRe0000644 0001750 0001750 00000003212 10554073705 033571 0 ustar twerner twerner package org.codehaus.plexus.component.reloading;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception for problems in the reloading strategy.
*
* @author Jason van Zyl
* @version $Revision: 5469 $
*/
public class ComponentReloadingException
extends Exception
{
private static final long serialVersionUID = 2105955080579002718L;
/**
* Construct a new ComponentReloadingException instance.
* @param message exception message
*/
public ComponentReloadingException( String message )
{
super( message );
}
/**
* Construct a new ComponentReloadingException instance.
* @param cause causing exception to chain
*/
public ComponentReloadingException( Throwable cause )
{
super( cause );
}
/**
* Construct a new ComponentReloadingException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentReloadingException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000171 00000000000 011564 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/reloading/ComponentReloadingStrategy.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/reloading/ComponentRe0000644 0001750 0001750 00000003450 10553524446 033577 0 ustar twerner twerner package org.codehaus.plexus.component.reloading;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.PlexusContainer;
/**
* Implementations declares whether a component should reload when
* accessed.
*
* @author Jason van Zyl
* @version $Revision: 5457 $
*/
public interface ComponentReloadingStrategy
{
/**
* Returns true if the given role in the container should be reloaded.
* @param role key of the component
* @param container the container the role lives in
* @return true if the given role in the container should be reloaded
* @throws ComponentReloadingException
*/
boolean shouldReload( String role, PlexusContainer container )
throws ComponentReloadingException;
/**
* Returns true if the given role/role-hint in the container should be
* reloaded.
* @param role key of the component
* @param roleHint sub-key of the component
* @param container the container the role lives in
* @return true if the given role/role-hint in the container should be
* reloaded
* @throws ComponentReloadingException
*/
boolean shouldReload( String role, String roleHint, PlexusContainer container )
throws ComponentReloadingException;
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ 0000755 0001750 0001750 00000000000 11225420767 031672 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000164 00000000000 011566 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentRequirement.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentR0000644 0001750 0001750 00000010702 10572657020 033677 0 ustar twerner twerner package org.codehaus.plexus.component.repository;
import org.codehaus.plexus.PlexusConstants;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* This represents a component this is required by another component.
*
* @author Michal Maczka
* @version $Id: ComponentRequirement.java 6001 2007-03-05 00:02:24Z handyande $
*/
public final class ComponentRequirement
{
private String role;
private String roleHint = PlexusConstants.PLEXUS_DEFAULT_HINT;
private String fieldName;
private String fieldMappingType;
/**
* Returns the field name that this component requirement will inject.
* @return the field name that this component requirement will inject
*/
public String getFieldName()
{
return fieldName;
}
/**
* Sets the name of the field that will be populated by the required
* component.
* @param fieldName the name of the field to be populated
*/
public void setFieldName( String fieldName )
{
this.fieldName = fieldName;
}
/**
* Returns the role of the required component.
* @return the role of the required component
*/
public String getRole()
{
return role;
}
/**
* Sets the role of the require component.
* @param role the required component's role
*/
public void setRole( String role )
{
this.role = role;
}
/**
* Returns the role-hint of the required component.
* @return the role-hint of the required component
*/
public String getRoleHint()
{
return roleHint;
}
/**
* Sets the role-hint of the require component.
* Pasing null will set the hint to the default value.
* @param roleHint the required component's role-hint
*/
public void setRoleHint( String roleHint )
{
if ( roleHint == null || roleHint.trim().equals( "" ) )
{
this.roleHint = PlexusConstants.PLEXUS_DEFAULT_HINT;
}
else
{
this.roleHint = roleHint;
}
}
/**
* Returns the type of the field this component requirement will inject.
* @return the type of the field this component requirement will inject
*/
public String getFieldMappingType()
{
return fieldMappingType;
}
/**
* Sets the type of the field that will be populated by the required
* component.
* @param fieldType the type of the field to be populated
*/
public void setFieldMappingType( String fieldType )
{
this.fieldMappingType = fieldType;
}
public String toString()
{
return "ComponentRequirement{" +
"role='" + role + "'" + ", " +
"roleHint='" + roleHint + "', " +
"fieldName='" + fieldName + "'" +
"}";
}
/**
* Returns a human-friendly key, suitable for display.
* @return a human-friendly key
*/
public String getHumanReadableKey()
{
StringBuffer key = new StringBuffer();
key.append( "role: '").append( getRole() ).append( "'" );
if ( getRoleHint() != null )
{
key.append( ", role-hint: '" ).append( getRoleHint() ).append( "'. " );
}
if ( getFieldName() != null )
{
key.append( ", field name: '" ).append( getFieldName() ).append( "' " );
}
return key.toString();
}
public boolean equals( Object other )
{
if ( other instanceof ComponentRequirement )
{
String myId = role + ":" + roleHint;
ComponentRequirement req = (ComponentRequirement) other;
String otherId = req.role + ":" + req.roleHint;
return myId.equals( otherId );
}
return false;
}
public int hashCode()
{
return ( role + ":" + roleHint ).hashCode();
}
}
././@LongLink 0000000 0000000 0000000 00000000166 00000000000 011570 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentSetDescriptor.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentS0000644 0001750 0001750 00000007654 10575515633 033722 0 ustar twerner twerner package org.codehaus.plexus.component.repository;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
/**
* Contains a set of ComponentDescriptors and the set's dependencies.
*
* @author Jason van Zyl
* @author Trygve Laugstøl
* @version $Id: ComponentSetDescriptor.java 6064 2007-03-13 12:39:55Z trygvis $
*/
public class ComponentSetDescriptor
{
// ComponentDescriptor list
private List components;
private List dependencies;
private boolean isolatedRealm;
private String id;
/**
* Returns a list of components in this set.
* @return a list of components
*/
public List getComponents()
{
return components;
}
/**
* Add a new ComponentDescriptor to this set.
* @param cd the ComponentDescriptor to add
*/
public void addComponentDescriptor( ComponentDescriptor cd )
{
if ( components == null )
{
components = new ArrayList();
}
components.add( cd );
}
/**
* Sets a List of components as this set's contents.
* @param components the List of components to set
*/
public void setComponents( List components )
{
this.components = components;
}
/**
* Returns a List of dependencies of this set of components.
* @return a List of dependencies of this set of components
*/
public List getDependencies()
{
return dependencies;
}
/**
* Add a depenency to this set's contents.
* @param cd the ComponentDependency to add
*/
public void addDependency( ComponentDependency cd )
{
if ( dependencies == null )
{
dependencies = new ArrayList();
}
dependencies.add( cd );
}
/**
* Sets a List of dependencies as this set's component dependencies.
* @param dependencies the List of components to set
*/
public void setDependencies( List dependencies )
{
this.dependencies = dependencies;
}
/**
* Sets that this set of components may be in an isolated classrealm.
* @param isolatedRealm true if this set of components may be in an
* isolated classrealm
*/
public void setIsolatedRealm( boolean isolatedRealm )
{
this.isolatedRealm = isolatedRealm;
}
/**
* Returns true if this set may be in an isolated classrealm.
* @return true if this set may be in an isolated classrealm
*/
public boolean isIsolatedRealm()
{
return isolatedRealm;
}
/**
* Returns the identifier of this set.
* @return the identifier of this set
*/
public String getId()
{
return id;
}
/**
* Sets the identifier of this set.
* @param id the identifier to set
*/
public void setId( String id )
{
this.id = id;
}
public String toString()
{
StringBuffer sb = new StringBuffer();
sb.append( "Component Descriptor: " );
for ( Iterator i = components.iterator(); i.hasNext(); )
{
ComponentDescriptor cd = (ComponentDescriptor) i.next();
sb.append( cd.getHumanReadableKey() ).append( "\n" );
}
sb.append( "---" );
return sb.toString();
}
}
././@LongLink 0000000 0000000 0000000 00000000163 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentDescriptor.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentD0000644 0001750 0001750 00000034024 10575515633 033672 0 ustar twerner twerner package org.codehaus.plexus.component.repository;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.PlexusConstants;
import org.codehaus.plexus.configuration.PlexusConfiguration;
import java.util.ArrayList;
import java.util.List;
/**
* Component instantiation description.
*
* @author Jason van Zyl
* @author bob mcwhirter
* @author Michal Maczka
* @version $Id: ComponentDescriptor.java 6064 2007-03-13 12:39:55Z trygvis $
*/
public class ComponentDescriptor
{
private String alias = null;
private String role = null;
private String roleHint = PlexusConstants.PLEXUS_DEFAULT_HINT;
private String implementation = null;
private String version = null;
private String componentType = null;
private PlexusConfiguration configuration = null;
private String instantiationStrategy = null;
private String lifecycleHandler = null;
private String componentProfile = null;
private List requirements;
private String componentFactory;
private String componentComposer;
private String componentConfigurator;
private String description;
private String realmId;
// ----------------------------------------------------------------------
// These two fields allow for the specification of an isolated class realm
// and dependencies that might be specified in a component configuration
// setup by a user i.e. this is here to allow isolation for components
// that are not picked up by the discovery mechanism.
// ----------------------------------------------------------------------
private boolean isolatedRealm;
private List dependencies;
// ----------------------------------------------------------------------
private ComponentSetDescriptor componentSetDescriptor;
// ----------------------------------------------------------------------
// Instance methods
// ----------------------------------------------------------------------
/**
* Returns a human-friendly key, suitable for display.
* @return a human-friendly key
*/
public String getHumanReadableKey()
{
StringBuffer key = new StringBuffer();
key.append("role: '" + role + "'" );
key.append( ", implementation: '" + implementation + "'" );
if ( roleHint != null )
{
key.append( ", role hint: '" + roleHint + "'" );
}
if ( alias != null )
{
key.append( ", alias: '" + alias + "'" );
}
return key.toString();
}
/**
* Returns an alias for this component. An alias as an
* alternate name other than the normal key.
* @return an alias for this component
*/
public String getAlias()
{
return alias;
}
/**
* Sets the alias for this component.
* @param alias alternate name to set
*/
public void setAlias( String alias )
{
this.alias = alias;
}
/**
* Returns the role of this component.
* @return the role of this component
*/
public String getRole()
{
return role;
}
/**
* Sets the role of this component.
* @param role this component's role
*/
public void setRole( String role )
{
this.role = role;
}
/**
* Returns the role-hint of this component.
* @return the role-hint of this component
*/
public String getRoleHint()
{
return roleHint;
}
/**
* Sets the role-hint of this component.
* Pasing null will set the hint to the default value.
* @param roleHint this component's role-hint
*/
public void setRoleHint( String roleHint )
{
if ( roleHint == null || roleHint.trim().equals( "" ) )
{
this.roleHint = PlexusConstants.PLEXUS_DEFAULT_HINT;
}
else
{
this.roleHint = roleHint;
}
}
/**
* Returns the implementation of this componet. Implementation
* is a string denoting a FQCN in normal Java components, or
* some other name or file for other component factory implementations.
* @return the implementation of this componet's role.
*/
public String getImplementation()
{
return implementation;
}
/**
* Sets the implementation of this componet.
* @param implementation string denoting a FQCN in normal Java components,
* or some other name or file for other component factory implementations
*/
public void setImplementation( String implementation )
{
this.implementation = implementation;
}
/**
* Returns a specific point in a components's project timeline.
* i.e. version 1, or 2.1.4
* @return a specific point in a components's project timeline
*/
public String getVersion()
{
return version;
}
/**
* Sets the point in a components's project development timeline
* @param version the components's version
*/
public void setVersion( String version )
{
this.version = version;
}
/**
* Returns the type of this component.
* @return the type of this component
*/
public String getComponentType()
{
return componentType;
}
/**
* Sets this component's type.
* @param componentType the type to set
*/
public void setComponentType( String componentType )
{
this.componentType = componentType;
}
/**
* Returns the type of instantiation strategy for this component.
* @return the type of instantiation strategy for this component
*/
public String getInstantiationStrategy()
{
return instantiationStrategy;
}
/**
* Returns configuration values defined for this component.
* @return configuration values defined for this component
*/
public PlexusConfiguration getConfiguration()
{
return configuration;
}
/**
* Sets the configuration hierarchy for this component.
* @param configuration the configuration hierarchy to set
*/
public void setConfiguration( PlexusConfiguration configuration )
{
this.configuration = configuration;
}
/**
* Returns true if this component has a configuration.
* @return true if this component has a configuration
*/
public boolean hasConfiguration()
{
return configuration != null;
}
/**
* Returns the lifecycle-handler for this component.
* @return the lifecycle-handler for this component
*/
public String getLifecycleHandler()
{
return lifecycleHandler;
}
/**
* Sets the lifecycle-handler for this component. For example,
* "basic", "passive", "bootstrap".
* @param lifecycleHandler the lifecycle handler string to set
*/
public void setLifecycleHandler( String lifecycleHandler )
{
this.lifecycleHandler = lifecycleHandler;
}
public String getComponentProfile()
{
return componentProfile;
}
public void setComponentProfile( String componentProfile )
{
this.componentProfile = componentProfile;
}
/**
* Add a project requirement to this component.
* @param requirement the requirement to add
*/
public void addRequirement( final ComponentRequirement requirement )
{
getRequirements().add( requirement );
}
/**
* Adds a list of requirements to this component.
* @param requirements the requirements to add
*/
public void addRequirements( List requirements )
{
getRequirements().addAll( requirements );
}
/**
* Returns all project requirements of this component.
* @return all project requirements of this component
*/
public List getRequirements()
{
if ( requirements == null )
{
requirements = new ArrayList();
}
return requirements;
}
/**
* Returns an id of the factory used to create this component.
* @return an id of the factory used to create this component
*/
public String getComponentFactory()
{
return componentFactory;
}
/**
* Sets the id of the factory to use to create this component. For
* example, "jruby" will use a JRuby factory.
* @param componentFactory
*/
public void setComponentFactory( String componentFactory )
{
this.componentFactory = componentFactory;
}
/**
* Returns the ID of the type of composer this component will use. For example,
* "setter" or "field" for the different types of dependency injection.
* @return the ID of the type of composer this component will use
*/
public String getComponentComposer()
{
return componentComposer;
}
/**
* Sets a representation of the composer this component uses.
* @param componentComposer string representation of the composer to use
*/
public void setComponentComposer( String componentComposer )
{
this.componentComposer = componentComposer;
}
/**
* Return a human-readable description of this component.
* @return a human-readable description of this component
*/
public String getDescription()
{
return description;
}
/**
* Sets a description of this component for users to read.
* @param description a human-readable description of this component
*/
public void setDescription( String description )
{
this.description = description;
}
/**
* Sets the instantiation-strategy for this component. For example,
* "container".
* @param instantiationStrategy
*/
public void setInstantiationStrategy( String instantiationStrategy )
{
this.instantiationStrategy = instantiationStrategy;
}
// ----------------------------------------------------------------------
//
// ----------------------------------------------------------------------
/**
* Returns true if this may be in an isolated classrealm.
* @return true if this may be in an isolated classrealm
*/
public boolean isIsolatedRealm()
{
return isolatedRealm;
}
/**
* Sets the component set descriptor of components and dependencies for
* this component.
* @param componentSetDescriptor the component set descriptor of components
* and dependencies
*/
public void setComponentSetDescriptor( ComponentSetDescriptor componentSetDescriptor )
{
this.componentSetDescriptor = componentSetDescriptor;
}
/**
* Returns the component set descriptor.
* @return the component set descriptor
*/
public ComponentSetDescriptor getComponentSetDescriptor()
{
return componentSetDescriptor;
}
/**
* Sets that this component may be in an isolated classrealm.
* @param isolatedRealm true if this component may be in an isolated
* classrealm
*/
public void setIsolatedRealm( boolean isolatedRealm )
{
this.isolatedRealm = isolatedRealm;
}
/**
* Returns a List of dependencies of this component.
* @return a List of dependencies of this component
*/
public List getDependencies()
{
return dependencies;
}
/**
* Returns the type of component configurator for this project. For
* example "basic" for normal, or "map-oriented" for map oriented
* components.
* @return the type of component configurator for this project
*/
public String getComponentConfigurator()
{
return componentConfigurator;
}
/**
* Sets the type of component configurator for this project.
* @param componentConfigurator
*/
public void setComponentConfigurator( String componentConfigurator )
{
this.componentConfigurator = componentConfigurator;
}
/**
* The ClassRealm that this component lives under.
* @return ClassRealm that this component lives under
*/
public String getRealmId()
{
return realmId;
}
/**
* Set the id of the ClassRealm that this component lives under.
* @param realmId ClassRealm id
*/
public void setRealmId( String realmId )
{
this.realmId = realmId;
}
// Component identity established here!
public boolean equals(Object other)
{
if(!(other instanceof ComponentDescriptor))
{
return false;
}
else
{
ComponentDescriptor otherDescriptor = (ComponentDescriptor) other;
boolean isEqual = true;
String role = getRole();
String otherRole = otherDescriptor.getRole();
isEqual = isEqual && ( role == otherRole || role.equals( otherRole ) );
String roleHint = getRoleHint();
String otherRoleHint = otherDescriptor.getRoleHint();
isEqual = isEqual && ( roleHint == otherRoleHint || roleHint.equals( otherRoleHint ) );
return isEqual;
}
}
public String toString()
{
return getClass().getName() + " [role: '" + getRole() + "', hint: '" + getRoleHint() + "', realm: "
+ ( realmId == null ? "NULL" : "'" + realmId + "'" ) + "]";
}
public int hashCode()
{
int result = getRole().hashCode() + 1;
String hint = getRoleHint();
if( hint != null )
{
result += hint.hashCode();
}
return result;
}
}
././@LongLink 0000000 0000000 0000000 00000000145 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000755 0001750 0001750 00000000000 11225420767 033670 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000223 00000000000 011562 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentDescriptorUnmarshallingException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003226 10553524446 033677 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
* @version $Id: ComponentDescriptorUnmarshallingException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentDescriptorUnmarshallingException
extends Exception
{
private static final long serialVersionUID = 6991583130117543536L;
/**
* Construct a new ComponentDescriptorUnmarshallingException instance.
* @param message exception message
*/
public ComponentDescriptorUnmarshallingException( String message )
{
super( message );
}
/**
* Construct a new ComponentDescriptorUnmarshallingException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentDescriptorUnmarshallingException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000231 00000000000 011561 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentManagerImplementationNotFoundException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003272 10554073705 033676 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
* @version $Id: ComponentManagerImplementationNotFoundException.java 5469 2007-01-19 07:48:21Z eredmond $
*/
public class ComponentManagerImplementationNotFoundException
extends Exception
{
private static final long serialVersionUID = 2365017114180373632L;
/**
* Construct a new ComponentManagerImplementationNotFoundException instance.
* @param message exception message
*/
public ComponentManagerImplementationNotFoundException( String message )
{
super( message );
}
/**
* Construct a new ComponentManagerImplementationNotFoundException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentManagerImplementationNotFoundException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000211 00000000000 011557 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentConfigurationException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003132 10553524446 033673 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
* @version $Id: ComponentConfigurationException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentConfigurationException
extends Exception
{
private static final long serialVersionUID = -921278352685045303L;
/**
* Construct a new ComponentConfigurationException instance.
* @param message exception message
*/
public ComponentConfigurationException( String message )
{
super( message );
}
/**
* Construct a new ComponentConfigurationException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentConfigurationException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000222 00000000000 011561 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentImplementationNotFoundException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003224 10553524446 033675 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
*
* @version $Id: ComponentImplementationNotFoundException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentImplementationNotFoundException
extends Exception
{
private static final long serialVersionUID = -9171668987729438489L;
/**
* Construct a new ComponentImplementationNotFoundException instance.
* @param message exception message
*/
public ComponentImplementationNotFoundException( String message )
{
super( message );
}
/**
* Construct a new ComponentImplementationNotFoundException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentImplementationNotFoundException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000205 00000000000 011562 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentLifecycleException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003101 10553524446 033667 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
* @version $Id: ComponentLifecycleException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentLifecycleException
extends Exception
{
private static final long serialVersionUID = 146489359157036908L;
/**
* Construct a new ComponentLifecycleException instance.
* @param message exception message
*/
public ComponentLifecycleException( String message )
{
super( message );
}
/**
* Construct a new ComponentLifecycleException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentLifecycleException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000206 00000000000 011563 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentRepositoryException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003110 10553524446 033667 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
* @version $Id: ComponentRepositoryException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentRepositoryException
extends Exception
{
private static final long serialVersionUID = 3698017788731736736L;
/**
* Construct a new ComponentRepositoryException instance.
* @param message exception message
*/
public ComponentRepositoryException( String message )
{
super( message );
}
/**
* Construct a new ComponentRepositoryException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentRepositoryException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000203 00000000000 011560 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentProfileException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003067 10553524446 033702 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception that is thrown when the class(es) required for a component
* implementation are not available.
*
* @author Jason van Zyl
* @version $Id: ComponentProfileException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentProfileException
extends Exception
{
private static final long serialVersionUID = -4099483467183306853L;
/**
* Construct a new ComponentProfileException instance.
* @param message exception message
*/
public ComponentProfileException( String message )
{
super( message );
}
/**
* Construct a new ComponentProfileException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentProfileException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000202 00000000000 011557 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/ComponentLookupException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/exception/0000644 0001750 0001750 00000003057 10553524446 033701 0 ustar twerner twerner package org.codehaus.plexus.component.repository.exception;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* The exception which is thrown by a component repository when
* the requested component cannot be found.
*
* @author Jason van Zyl
* @version $Id: ComponentLookupException.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentLookupException
extends Exception
{
private static final long serialVersionUID = 3767774496798908291L;
/**
* Construct a new ComponentLookupException instance.
* @param message exception message
*/
public ComponentLookupException( String message )
{
super( message );
}
/**
* Construct a new ComponentLookupException instance.
* @param message exception message
* @param cause causing exception to chain
*/
public ComponentLookupException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000163 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentDependency.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/repository/ComponentD0000644 0001750 0001750 00000006255 10553524446 033675 0 ustar twerner twerner package org.codehaus.plexus.component.repository;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* This represents a project which this component depends upon to function
* properly, for example, a required jar file. See Apache Maven for an
* example of a dependency in action.
*
* @author Jason van Zyl
* @author Trygve Laugstøl
* @version $Id: ComponentDependency.java 5457 2007-01-17 22:54:30Z eredmond $
*/
public class ComponentDependency
{
private static final String DEAULT_DEPENDENCY_TYPE = "jar";
private String groupId;
private String artifactId;
private String type = DEAULT_DEPENDENCY_TYPE;
private String version;
/**
* Gets a key for an artifact, which is an alias for a specific
* project timeline in a group.
* @return a key for an artifact
*/
public String getArtifactId()
{
return artifactId;
}
/**
* Sets the dependency's artifact ID.
* @param artifactId the artifact ID
*/
public void setArtifactId(String artifactId)
{
this.artifactId = artifactId;
}
/**
* Gets a key for a group, which represents a set of artifacts timelines.
* @return a key for a group
*/
public String getGroupId()
{
return groupId;
}
/**
* Sets the dependency's group ID.
* @param groupId the group ID
*/
public void setGroupId(String groupId)
{
this.groupId = groupId;
}
/**
* Gets the type of dependency, for example a "jar".
* @return the type of dependency
*/
public String getType()
{
return type;
}
/**
* Sets the dependency project's type.
* @param type the dependency's type
*/
public void setType(String type)
{
this.type = type;
}
/**
* Returns a specific point in a project's timeline.
* i.e. version 1, or 2.1.4
* @return a specific point in a project's timeline
*/
public String getVersion()
{
return version;
}
/**
* Sets the point in a project's development timeline
* @param version the project's version
*/
public void setVersion(String version)
{
this.version = version;
}
public String toString()
{
StringBuffer sb = new StringBuffer();
sb.append( "groupId = " ).append( groupId ).
append( ", artifactId = " ).append( artifactId ).
append( ", version = " ).append( version ).
append( ", type = " ).append( type );
return sb.toString();
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/discovery/ 0000755 0001750 0001750 00000000000 11225420767 031462 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000166 00000000000 011570 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/discovery/ComponentDiscoveryEvent.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/discovery/ComponentDi0000644 0001750 0001750 00000003106 10553524446 033626 0 ustar twerner twerner package org.codehaus.plexus.component.discovery;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.component.repository.ComponentSetDescriptor;
/**
* Signals to a ComponentDiscoveryListener that an event has taken place
* involving a set of components. It is up to the Listener to decide what
* to do with that information.
*/
public class ComponentDiscoveryEvent
{
private ComponentSetDescriptor componentSetDescriptor;
/**
* Constructs a ComponentDiscoveryEvent with a set of
* ComponentDescriptors.
* @param componentSetDescriptor a set of ComponentDescriptors
*/
public ComponentDiscoveryEvent( ComponentSetDescriptor componentSetDescriptor )
{
this.componentSetDescriptor = componentSetDescriptor;
}
/**
* Returns this event's set of ComponentDescriptors.
* @return this event's set of ComponentDescriptors
*/
public ComponentSetDescriptor getComponentSetDescriptor()
{
return componentSetDescriptor;
}
}
././@LongLink 0000000 0000000 0000000 00000000171 00000000000 011564 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/discovery/ComponentDiscoveryListener.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/discovery/ComponentDi0000644 0001750 0001750 00000002205 10553524446 033625 0 ustar twerner twerner package org.codehaus.plexus.component.discovery;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* A listener which responds in some way to component discovery by a
* PlexusContainer.
*/
public interface ComponentDiscoveryListener
{
/**
* Signals to this listener that a component has been discovered.
* @param event the event that signals what components have been discovered
*/
void componentDiscovered( ComponentDiscoveryEvent event );
/**
* Returns this listener's unique key.
* @return this listener's unique key
*/
String getId();
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/composition/ 0000755 0001750 0001750 00000000000 11225420767 032016 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000165 00000000000 011567 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/composition/CompositionException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/component/composition/Compositi0000644 0001750 0001750 00000003131 10554073705 033705 0 ustar twerner twerner package org.codehaus.plexus.component.composition;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Thrown when component composition goes awry.
*
* @author Jason van Zyl
* @author Michal Maczka
* @version $Id: CompositionException.java 5469 2007-01-19 07:48:21Z eredmond $
*/
public class CompositionException
extends Exception
{
private static final long serialVersionUID = -5587124702588800322L;
/**
* Construct a new CompositionException instance.
*
* @param message The detail message for this exception.
*/
public CompositionException( String message )
{
super( message );
}
/**
* Construct a new CompositionException instance.
*
* @param message The detail message for this exception.
* @param throwable the root cause of the exception
*/
public CompositionException( String message, Throwable throwable )
{
super( message, throwable );
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/context/ 0000755 0001750 0001750 00000000000 11225420767 027135 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/context/ContextException.java 0000644 0001750 0001750 00000003342 10553524446 033307 0 ustar twerner twerner package org.codehaus.plexus.context;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Exception signalling a badly formed Context.
*
* This can be thrown by Context object when a entry is not
* found. It can also be thrown manually in contextualize()
* when Component detects a malformed containerContext value.
*
* @author Avalon Development Team
* @version CVS $Revision: 5457 $ $Date: 2007-01-17 23:54:30 +0100 (Mi, 17. Jan 2007) $
*/
public class ContextException
extends Exception
{
private static final long serialVersionUID = 2030206863811644180L;
/**
* Construct a new ContextException instance.
*
* @param message The detail message for this exception.
*/
public ContextException( final String message )
{
this( message, null );
}
/**
* Construct a new ContextException instance.
*
* @param message The detail message for this exception.
* @param throwable the root cause of the exception
*/
public ContextException( final String message, final Throwable throwable )
{
super( message, throwable );
}
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/context/Context.java 0000644 0001750 0001750 00000004513 10567646103 031431 0 ustar twerner twerner package org.codehaus.plexus.context;
import java.util.Map;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Context of the plexus container.
*/
public interface Context
{
/**
* Returns the value of the key. If the key can't be found it will throw a exception.
*
* @param key The key of the value to look up.
* @return Returns
* @throws ContextException If the key doesn't exist.
*/
Object get( Object key )
throws ContextException;
/**
* Utility method to retrieve containerContext data.
* the returned Map is an unmodifiable view.
* @return the containerContext data
* @since 1.0-alpha-18
*/
Map getContextData();
/**
* Returns true if the map or the parent map contains the key.
*
* @param key The key to search for.
* @return Returns true if the key was found.
*/
boolean contains( Object key );
/**
* Adds the item to the containerContext.
*
* @param key the key of the item
* @param value the item
* @throws java.lang.IllegalStateException if containerContext is read only
*/
public void put( Object key, Object value )
throws IllegalStateException;
/**
* Hides the item in the containerContext.
* After remove(key) has been called, a get(key)
* will always fail, even if the parent containerContext
* has such a mapping.
*
* @param key the items key
* @throws java.lang.IllegalStateException if containerContext is read only
*/
void hide( Object key )
throws IllegalStateException;
/**
* Make the containerContext read-only.
* Any attempt to write to the containerContext via put()
* will result in an IllegalStateException.
*/
void makeReadOnly();
}
plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/ 0000755 0001750 0001750 00000000000 11225420770 030014 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/ 0000755 0001750 0001750 00000000000 11225420770 031334 5 ustar twerner twerner plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ 0000755 0001750 0001750 00000000000 11225420770 033273 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000151 00000000000 011562 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/ plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000755 0001750 0001750 00000000000 11225420770 033623 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000171 00000000000 011564 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Serviceable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000001573 10531410573 033632 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Indicates that a class wants a hold on a ServiceLocator.
*
* @author Dan Diephouse
*/
public interface Serviceable
{
void service( ServiceLocator locator );
}
././@LongLink 0000000 0000000 0000000 00000000177 00000000000 011572 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/StoppingException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000002145 10531410573 033626 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Error occuring while starting a component.
*
* @author Brett Porter
* @version $Id: StoppingException.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public class StoppingException
extends Exception
{
public StoppingException( String message )
{
super( message );
}
public StoppingException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000172 00000000000 011565 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Configurable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000002022 10531410573 033620 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.configuration.PlexusConfiguration;
import org.codehaus.plexus.configuration.PlexusConfigurationException;
/**
* Configures a component.
*
* @author Dan Diephouse
*/
public interface Configurable
{
void configure( PlexusConfiguration configuration ) throws PlexusConfigurationException;
}
././@LongLink 0000000 0000000 0000000 00000000173 00000000000 011566 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Initializable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000001643 10531410573 033630 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
*
*
* @author Jason van Zyl
*
* @version $Id: Initializable.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public interface Initializable
{
public void initialize()
throws InitializationException;
}
././@LongLink 0000000 0000000 0000000 00000000174 00000000000 011567 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/ServiceLocator.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000004372 10531410573 033632 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.component.repository.exception.ComponentLifecycleException;
import org.codehaus.plexus.component.repository.exception.ComponentLookupException;
import java.util.List;
import java.util.Map;
/**
* Provides services to components by means of a lookup.
*
* @author Dan Diephouse
*/
public interface ServiceLocator
{
//----------------------------------------------------------------------
// Component lookup
// ----------------------------------------------------------------------
Object lookup( String componentKey )
throws ComponentLookupException;
Object lookup( String role, String roleHint )
throws ComponentLookupException;
Map lookupMap( String role )
throws ComponentLookupException;
List lookupList( String role )
throws ComponentLookupException;
//----------------------------------------------------------------------
// Component release
// ----------------------------------------------------------------------
void release( Object component )
throws ComponentLifecycleException;
void releaseAll( Map components )
throws ComponentLifecycleException;
void releaseAll( List components )
throws ComponentLifecycleException;
// ----------------------------------------------------------------------
// Component discovery
// ----------------------------------------------------------------------
boolean hasComponent( String componentKey );
boolean hasComponent( String role, String roleHint );
}
././@LongLink 0000000 0000000 0000000 00000000176 00000000000 011571 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Contextualizable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000002017 10531410573 033624 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import org.codehaus.plexus.context.Context;
import org.codehaus.plexus.context.ContextException;
/**
* @author Jason van Zyl
* @version $Id: Contextualizable.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public interface Contextualizable
{
public void contextualize( Context context )
throws ContextException;
}
././@LongLink 0000000 0000000 0000000 00000000170 00000000000 011563 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Disposable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000001563 10531410573 033631 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
*
*
* @author Jason van Zyl
*
* @version $Id: Disposable.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public interface Disposable
{
public void dispose();
}
././@LongLink 0000000 0000000 0000000 00000000171 00000000000 011564 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Suspendable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000001355 10531410573 033630 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
public interface Suspendable
{
void suspend();
void resume();
}
././@LongLink 0000000 0000000 0000000 00000000167 00000000000 011571 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/Startable.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000001451 10531410573 033625 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
public interface Startable
{
void start()
throws StartingException;
void stop()
throws StoppingException;
}
././@LongLink 0000000 0000000 0000000 00000000177 00000000000 011572 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/StartingException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000002145 10531410573 033626 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Error occuring while starting a component.
*
* @author Brett Porter
* @version $Id: StartingException.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public class StartingException
extends Exception
{
public StartingException( String message )
{
super( message );
}
public StartingException( String message, Throwable cause )
{
super( message, cause );
}
}
././@LongLink 0000000 0000000 0000000 00000000205 00000000000 011562 L ustar root root plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/phase/InitializationException.java plexus-component-api-1.0.0~alpha22/src/main/java/org/codehaus/plexus/personality/plexus/lifecycle/ph0000644 0001750 0001750 00000002210 10531410573 033617 0 ustar twerner twerner package org.codehaus.plexus.personality.plexus.lifecycle.phase;
/*
* Copyright 2001-2006 Codehaus Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Indicates a problem occurred when initialising a component.
*
* @author Brett Porter
* @version $Id: InitializationException.java 4796 2006-11-23 21:24:11Z jvanzyl $
*/
public class InitializationException extends Exception
{
public InitializationException( String message )
{
super( message );
}
public InitializationException( String message, Throwable cause )
{
super( message, cause );
}
}
plexus-component-api-1.0.0~alpha22/pom.xml 0000644 0001750 0001750 00000004376 10600650760 020434 0 ustar twerner twerner 4.0.0org.codehaus.plexusplexus-containers1.0-alpha-22plexus-component-apiPlexus Component API1.0-alpha-22maven-surefire-plugin2.2**/Test*.java**/Abstract*.javaorg.codehaus.plexusplexus-classworldsmaven-surefire-report-pluginmaven-pmd-pluginmaven-javadoc-plugin
http://java.sun.com/j2ee/1.4/docs/api
http://java.sun.com/j2se/1.5.0/docs/api
http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_0/
http://jakarta.apache.org/commons/dbcp/apidocs/
http://jakarta.apache.org/commons/fileupload/apidocs/
http://jakarta.apache.org/commons/httpclient/apidocs/
http://jakarta.apache.org/commons/logging/apidocs/
http://jakarta.apache.org/commons/pool/apidocs/
http://www.junit.org/junit/javadoc/
http://logging.apache.org/log4j/docs/api/
http://jakarta.apache.org/regexp/apidocs/
http://jakarta.apache.org/velocity/api/