[jboss-cvs] JBossAS SVN: r65458 - trunk/system/src/main/org/jboss/profileservice/spi/repository.

[jboss-cvs-commits at lists.jboss.org]

Author: scott.stark at jboss.org
Date: 2007-09-18 15:34:44 -0400 (Tue, 18 Sep 2007)
New Revision: 65458

Modified:
   trunk/system/src/main/org/jboss/profileservice/spi/repository/MutableRepository.java
Log:
JBAS-4362, update javadoc and add an Exception throws to all methods

Modified: trunk/system/src/main/org/jboss/profileservice/spi/repository/MutableRepository.java
===================================================================
--- trunk/system/src/main/org/jboss/profileservice/spi/repository/MutableRepository.java	2007-09-18 19:28:44 UTC (rev 65457)
+++ trunk/system/src/main/org/jboss/profileservice/spi/repository/MutableRepository.java	2007-09-18 19:34:44 UTC (rev 65458)
@@ -31,11 +31,25 @@
  */
 public interface MutableRepository extends Repository
 {
+   /** */
    public enum ModifyStatus {ADDED, MODIFIED, REMOVED};
 
-   public void addResource(Resource resource);
-   public Resource removeResource(String name);
    /**
+    * Add a resource to the repository.
+    * @param resource the resource to add
+    * @throws Exception thrown on any addition failure
+    */
+   public void addResource(Resource resource)
+      throws Exception;
+   /**
+    * Remove a resource from the repository
+    * @param name the resource SYMBOLIC_NAME or ID
+    * @return the Resource that was removed if found, null otherwise.
+    * @throws Exception thrown on any remove failure
+    */
+   public Resource removeResource(String name)
+      throws Exception;
+   /**
     * Return a collection of resources that have been modified since
     * the last call to this method. The returned resources contain
     * a modifyStatus property of type ModifyStatus to indicate the
@@ -44,5 +58,6 @@
     * @return The Resources that have been modified.
     * @throws Exception
     */
-   public Collection<Resource> getModifiedResources() throws Exception;
+   public Collection<Resource> getModifiedResources()
+      throws Exception;
 }