You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by do...@apache.org on 2001/11/17 01:55:55 UTC
cvs commit: jakarta-avalon-excalibur/src/scratchpad/org/apache/avalon/excalibur/extension PackageRepository.java
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: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>