View Javadoc

1   /*
2    * <cvs:source>$Source: /devel/astrogrid/community/client/src/java/org/astrogrid/community/client/policy/manager/ResourceManagerDelegate.java,v $</cvs:source>
3    * <cvs:author>$Author: jdt $</cvs:author>
4    * <cvs:date>$Date: 2004/11/22 13:03:04 $</cvs:date>
5    * <cvs:version>$Revision: 1.7 $</cvs:version>
6    *
7    * <cvs:log>
8    *   $Log: ResourceManagerDelegate.java,v $
9    *   Revision 1.7  2004/11/22 13:03:04  jdt
10   *   Merges from Comm_KMB_585
11   *
12   *   Revision 1.6.104.1  2004/11/12 09:12:09  KevinBenson
13   *   Still need to javadoc and check exceptions on a couple of new methods
14   *   for ResourceManager and PermissionManager, but for the most part it is ready.
15   *   I will also add some stylesheets around the jsp pages later.
16   *
17   *   Revision 1.6  2004/06/18 13:45:19  dave
18   *   Merged development branch, dave-dev-200406081614, into HEAD
19   *
20   *   Revision 1.5.38.3  2004/06/17 15:10:03  dave
21   *   Removed unused imports (PMD report).
22   *
23   *   Revision 1.5.38.2  2004/06/17 13:38:58  dave
24   *   Tidied up old CVS log entries
25   *
26   * </cvs:log>
27   *
28   */
29  package org.astrogrid.community.client.policy.manager ;
30  
31  import org.astrogrid.community.client.service.CommunityServiceDelegate ;
32  
33  import org.astrogrid.community.common.policy.data.ResourceData ;
34  
35  import org.astrogrid.community.common.exception.CommunityServiceException  ;
36  import org.astrogrid.community.common.exception.CommunityResourceException ;
37  import org.astrogrid.community.common.exception.CommunityIdentifierException ;
38  
39  /***
40   * Interface for our ResourceManager delegate.
41   * This mirrors the ResourceManager interface, without the RemoteExceptions.
42   *
43   */
44  public interface ResourceManagerDelegate
45      extends CommunityServiceDelegate
46      {
47      /***
48       * Register a new Resource.
49       * @return A new ResourceData object to represent the resource.
50       * @throws CommunityServiceException If there is an internal error in the service.
51       *
52       */
53      public ResourceData addResource()
54          throws CommunityServiceException ;
55  
56      /***
57       * Request the details for a Resource.
58       * @param The resource identifier.
59       * @return The requested ResourceData object.
60       * @throws CommunityResourceException If unable to locate the resource.
61       * @throws CommunityServiceException If there is an internal error in the service.
62       * @throws CommunityIdentifierException If the resource identifier is not valid.
63       *
64       */
65     public ResourceData getResource(String ident)
66          throws CommunityIdentifierException, CommunityResourceException, CommunityServiceException ;
67     
68     /***
69      * Request the details for a Resource.
70      * @return The requested ResourceData object.
71      * @throws CommunityResourceException If unable to locate the resource.
72      * @throws CommunityServiceException If there is an internal error in the service.
73      * @throws CommunityIdentifierException If the resource identifier is not valid.
74      *
75      */
76    public Object[] getResources();
77     
78  
79      /***
80       * Update the details for a Resource.
81       * @param The ResourceData to update.
82       * @return The updated ResourceData.
83       * @throws CommunityResourceException If unable to locate the resource.
84       * @throws CommunityServiceException If there is an internal error in the service.
85       * @throws CommunityIdentifierException If the resource identifier is not valid.
86       *
87       */
88      public ResourceData setResource(ResourceData resource)
89          throws CommunityIdentifierException, CommunityResourceException, CommunityServiceException ;
90  
91      /***
92       * Delete a Resource.
93       * @param The resource identifier.
94       * @return The original ResourceData.
95       * @throws CommunityResourceException If unable to locate the resource.
96       * @throws CommunityServiceException If there is an internal error in the service.
97       * @throws CommunityIdentifierException If the identifier is not valid.
98       *
99       */
100     public ResourceData delResource(String ident)
101         throws CommunityIdentifierException, CommunityResourceException, CommunityServiceException ;
102 
103     }