cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From p...@locus.apache.org
Subject cvs commit: xml-cocoon/src/org/apache/arch ComponentNotAccessibleException.java ComponentNotFoundException.java Modifiable.java Component.java ComponentManager.java Composer.java AbstractComponent.java Changeable.java Service.java Stoppable.java
Date Sun, 27 Feb 2000 01:19:00 GMT
pier        00/02/26 17:19:00

  Modified:    src/org/apache/arch Tag: xml-cocoon2 Component.java
                        ComponentManager.java Composer.java
  Added:       src/org/apache/arch Tag: xml-cocoon2
                        ComponentNotAccessibleException.java
                        ComponentNotFoundException.java Modifiable.java
  Removed:     src/org/apache/arch Tag: xml-cocoon2 AbstractComponent.java
                        Changeable.java Service.java Stoppable.java
  Log:
  [Cocoon 2.0] modified avalon subinterfaces
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.1.2.2   +8 -38     xml-cocoon/src/org/apache/arch/Attic/Component.java
  
  Index: Component.java
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/src/org/apache/arch/Attic/Component.java,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- Component.java	1999/12/11 23:28:46	1.1.2.1
  +++ Component.java	2000/02/27 01:18:58	1.1.2.2
  @@ -5,51 +5,21 @@
    * version 1.1, a copy of which has been included  with this distribution in *
    * the LICENSE file.                                                         *
    *****************************************************************************/
  -
   package org.apache.arch;
   
   /**
    * This interface identifies classes that can be used as components
  - * by composers.
  + * by a <code>Composer</code>.
  + * <br>
  + * A <code>Component</code> must always declare an empty constructor.
    *
    * @author <a href="mailto:scoobie@betaversion.org">Federico Barbieri</a>
  - * @author <a href="mailto:pier@apache.org">Pierpaolo Fumagalli</a>
  + *         (Betaversion Productions)
    * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a>
  - * @version $Revision: 1.1.2.1 $ $Date: 1999/12/11 23:28:46 $
  + *         (Apache Software Foundation)
  + * @author <a href="mailto:fumagalli@exoffice.com">Pierpaolo Fumagalli</a>
  + *         (Apache Software Foundation, Exoffice Technologies)
  + * @version CVS $Revision: 1.1.2.2 $ $Date: 2000/02/27 01:18:58 $
    */
   public interface Component {
  -
  -	/**
  -	 * Return a string identifying the component author.
  -	 */
  -    public String getVersion();
  -    
  -	/**
  -	 * Return a string identifying the component name. (i.e. "SuperCheeser")
  -	 */
  -    public String getName();
  -
  -	/**
  -	 * Return a string identifying the component author. (i.e. "Cheese Inc.")
  -	 */
  -    public String getAuthor();
  -
  -	/**
  -	 * Return a string identifying the component type. (i.e. "Cheese Producer")
  -	 */
  -    public String getType();
  -    
  -    /*
  -     * Return a string identifying the component status 
  -     * (configurations, statistics, performance)
  -     *
  -     * <p><strong>FIXME (SM):</strong>
  -     * should this method return a Status class instead? This would
  -     * allow to return something different from a string and also to control
  -     * what DTD (if any) is used for the string markup. This follows the MVC
  -     * design pattern where Component is the "controller/model" and Status is 
  -     * the "view".
  -     */
  -    public String getStatus();
  -    
   }
  
  
  
  1.1.2.2   +22 -18    xml-cocoon/src/org/apache/arch/Attic/ComponentManager.java
  
  Index: ComponentManager.java
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/src/org/apache/arch/Attic/ComponentManager.java,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- ComponentManager.java	1999/12/11 23:28:46	1.1.2.1
  +++ ComponentManager.java	2000/02/27 01:18:58	1.1.2.2
  @@ -5,31 +5,35 @@
    * version 1.1, a copy of which has been included  with this distribution in *
    * the LICENSE file.                                                         *
    *****************************************************************************/
  -
   package org.apache.arch;
   
   /**
  - * A component manager holds the mapping between component roles and their
  - * actual implementations. It's beyond the scope of this interface
  - * to define how the mapping is created and managed, but only to
  - * provide a way for composers to access the components they require.
  - * 
  + * This interface specifies how the mapping between <code>Component</code>
  + * roles and their actual implementations is held.
  + * <br>
  + * It's beyond the scope of this interface to define how the mapping is created
  + * and managed, but only to provide a way for composers to access the
  + * components they require.
  + *
    * @author <a href="mailto:scoobie@betaversion.org">Federico Barbieri</a>
  - * @author <a href="mailto:pier@apache.org">Pierpaolo Fumagalli</a>
  + *         (Betaversion Productions)
    * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a>
  - * @version $Revision: 1.1.2.1 $ $Date: 1999/12/11 23:28:46 $
  + *         (Apache Software Foundation)
  + * @author <a href="mailto:fumagalli@exoffice.com">Pierpaolo Fumagalli</a>
  + *         (Apache Software Foundation, Exoffice Technologies)
  + * @version CVS $Revision: 1.1.2.2 $ $Date: 2000/02/27 01:18:58 $
    */
  -
   public interface ComponentManager {
  -    
  +
       /**
  -     * Get the component associated with the given role.
  +     * Get the <code>Component</code> associated with the given role.
        *
  -     * @exception IllegalStateException this exception is thrown
  -     * if there is no object associated to the requested role. This
  -     * signal is preferred instead of returning null since
  -     * this should occur rarely and only for design problems
  +     * @param name The role of the <code>Component</code> to retrieve.
  +     * @exception ComponentNotFoundException If the given role is not associated
  +     *                                       with a <code>Component</code>.
  +     * @exception ComponentNotAccessibleException If a <code>Component</code>
  +     *                                            instance cannot be created.
        */
  -    Component getComponent(String role);
  -   
  -}
  \ No newline at end of file
  +    public Component getComponent(String role)
  +    throws ComponentNotFoundException, ComponentNotAccessibleException;
  +}
  
  
  
  1.1.2.2   +18 -16    xml-cocoon/src/org/apache/arch/Attic/Composer.java
  
  Index: Composer.java
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/src/org/apache/arch/Attic/Composer.java,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- Composer.java	1999/12/11 23:28:46	1.1.2.1
  +++ Composer.java	2000/02/27 01:18:58	1.1.2.2
  @@ -5,32 +5,34 @@
    * version 1.1, a copy of which has been included  with this distribution in *
    * the LICENSE file.                                                         *
    *****************************************************************************/
  -
   package org.apache.arch;
   
   /**
  - * A composer is a class that need to connect to software components using 
  - * a "role" abstraction, thus not depending on particular implementations 
  - * but on behavioral interfaces.
  - * 
  + * A <code>Composer</code> is a class that need to connect to software
  + * components using a &quot;role&quot; abstraction, thus not depending on
  + * particular implementations.
  + *
    * @author <a href="mailto:scoobie@betaversion.org">Federico Barbieri</a>
  - * @author <a href="mailto:pier@apache.org">Pierpaolo Fumagalli</a>
  + *         (Betaversion Productions)
    * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a>
  - * @version $Revision: 1.1.2.1 $ $Date: 1999/12/11 23:28:46 $
  + *         (Apache Software Foundation)
  + * @author <a href="mailto:fumagalli@exoffice.com">Pierpaolo Fumagalli</a>
  + *         (Apache Software Foundation, Exoffice Technologies)
  + * @version CVS $Revision: 1.1.2.2 $ $Date: 2000/02/27 01:18:58 $
    */
  -
   public interface Composer {
       
       /**
  -     * Pass the component manager to the composer. The composer implementation
  -     * should use this method to acquire the components it needs for
  -     * execution.
  +     * Set the current <code>ComponentManager</code> instance used by this
  +     * <code>Composer</code>.
  +     * <br>
  +     * The <code>Composer</code> implementation should use this method to
  +     * acquire the instance of the <code>ComponentManager</code> nedeed for
  +     * retrieving those <code>Component</code> objects it needs for execution.
        *
  -     * @param manager the component manager to which this composer can 
  -     * request the needed components.
  -     * @exception if a required Component is not found, this method
  -     * should throw an <code>IllegalStateException</code> indicating
  -     * the cause of such failure.
  +     * @param manager The <code>ComponentManager</code> to which this
  +     *                <code>Composer</code> can request the needed 
  +     *                <code>Component</code> instances.
        */
       public void setComponentManager(ComponentManager manager);
       
  
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.1.2.1   +37 -0     xml-cocoon/src/org/apache/arch/Attic/ComponentNotAccessibleException.java
  
  
  
  
  1.1.2.1   +26 -0     xml-cocoon/src/org/apache/arch/Attic/ComponentNotFoundException.java
  
  
  
  
  1.1.2.1   +38 -0     xml-cocoon/src/org/apache/arch/Attic/Modifiable.java
  
  
  
  

Mime
View raw message