avalon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dona...@apache.org
Subject cvs commit: jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/extension PackageRepository.java
Date Sat, 17 Nov 2001 00:55:55 GMT
donaldp     01/11/16 16:55:55

  Modified:    src/scratchpad/org/apache/avalon/excalibur/extension
                        PackageRepository.java
  Log:
  Remove install from the interface as we can now assume a read-only repository.
  
  Revision  Changes    Path
  1.2       +11 -26    jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/extension/PackageRepository.java
  
  Index: PackageRepository.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/extension/PackageRepository.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- PackageRepository.java	2001/09/03 03:21:02	1.1
  +++ PackageRepository.java	2001/11/17 00:55:55	1.2
  @@ -11,11 +11,11 @@
   import java.io.IOException;
   
   /**
  - * <p>Interface used to manage a single collection of "Optional Packages" 
  + * <p>Interface used to store a collection of "Optional Packages" 
    * (formerly known as "Standard Extensions"). It is assumed that each 
    * "Optional Package" is represented by a single file on the file system.</p>
    *
  - * <p>This manager is responsible for managing the local repository of
  + * <p>This repository is responsible for storing the local repository of
    * packages. The method used to locate packages on local filesystem
    * and install packages is not specified.</p>
    *
  @@ -25,16 +25,19 @@
    * <code>guide/extensions/versioning.html</code></p>.
    *
    * @author <a href="mailto:donaldp@apache.org">Peter Donald</a>
  - * @version $Revision: 1.1 $ $Date: 2001/09/03 03:21:02 $
  + * @version $Revision: 1.2 $ $Date: 2001/11/17 00:55:55 $
    */
   public interface PackageRepository
   {
       /**
  -     * Return the <code>OptionalPackage</code> that provides specified
  +     * Return an <code>OptionalPackage</code> that provides specified
        * <code>Extension</code>. If the specified <code>Extension</code>

  -     * can not be found then <code>null</code> is returned.
  +     * can not be found then <code>null</code> is returned. If there is
  +     * multiple implementations that satisfy <code>Extension</code>, 
  +     * then an <code>OptionalPackage</code> must be selected by implementation.

        *
  -     * @param extension Description of the optional package
  +     * @param extension Description of the extension that needs to be provided by 
  +     *                  optional package
        * @see #getOptionalPackages()
        * @see OptionalPackage
        * @see Extension
  @@ -45,29 +48,11 @@
        * Return all the <code>OptionalPackage</code>s that satisfy specified
        * <code>Extension</code>. 
        *
  -     * @param extension Description of the optional package
  +     * @param extension Description of the extension that needs to be provided by 
  +     *                  optional packages
        * @see #getOptionalPackage()
        * @see OptionalPackage
        * @see Extension
        */
       OptionalPackage[] getOptionalPackages( Extension extension );
  -
  -    /**
  -     * Install the specified File object (which represents
  -     * an optional package required by another package). The mechanism
  -     * and location of installation is not specified.
  -     *
  -     * <p>It is an error for an extension with the same
  -     * <code>Implementation-Version</code>, <code>Implementation-Vendor-ID</code>
  -     * and <code>Extension-Name</code> to already exist in Repository.</p>
  -     *
  -     * <p>It is expected that after successful completion of this
  -     * method that an OptionalPackage will be accessible via getOptionalPackage().</p>
  -     *
  -     * @param file the file containing "Optional Package".
  -     * @exception IOException if an error occurs
  -     * @exception SecurityException if permission has not been granted to add entries to
repository
  -     */
  -    void install( final File inputFile )
  -        throws IOException, SecurityException;
   }
  
  
  

--
To unsubscribe, e-mail:   <mailto:avalon-cvs-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:avalon-cvs-help@jakarta.apache.org>


Mime
View raw message