/*
    * <cvs:source>$Source: /devel/astrogrid/community/client/src/java/org/astrogrid/community/client/policy/manager/PolicyManagerCoreDelegate.java,v $</cvs:source>
    * <cvs:author>$Author: jdt $</cvs:author>
    * <cvs:date>$Date: 2004/11/22 13:03:04 $</cvs:date>
    * <cvs:version>$Revision: 1.11 $</cvs:version>
    *
    * <cvs:log>
    *   $Log: PolicyManagerCoreDelegate.java,v $
    *   Revision 1.11  2004/11/22 13:03:04  jdt
   *   Merges from Comm_KMB_585
   *
   *
   *   Revision 1.9.18.1.4.4  2004/11/12 09:12:09  KevinBenson
   *   Still need to javadoc and check exceptions on a couple of new methods
   *   for ResourceManager and PermissionManager, but for the most part it is ready.
   *   I will also add some stylesheets around the jsp pages later.
   *
   *   Revision 1.9.18.1.4.3  2004/11/10 12:28:54  KevinBenson
   *   needed to add throw exceptions
   *
   *   Revision 1.9.18.1.4.2  2004/11/08 22:08:21  KevinBenson
   *   added groupmember and permissionmanager tests.  Changed the install.xml to use eperate file names
   *   instead of the same filename
   *
   *   Revision 1.9.18.1.4.1  2004/11/05 08:55:49  KevinBenson
   *   Moved the GroupMember out of PolicyManager in the commons and client section.
   *   Added more unit tests for GroupMember and PermissionManager for testing.
   *   Still have some errors that needs some fixing.
   *
   *   Revision 1.10  2004/10/29 15:50:05  jdt
   *   merges from Community_AdminInterface (bug 579)
   *
   *   Revision 1.9.18.1  2004/10/18 22:10:28  KevinBenson
   *   some bug fixes to the PermissionManager.  Also made it throw some exceptions.
   *   Made  it and GroupManagerImnpl use the Resolver objects to actually get a group(PermissionManageriMnpl)
   *   or account (GroupMember) from the other community.  Changed also for it to grab a ResourceData from the
   *   database to verifity it is in our database.  Add a few of these resolver dependencies as well.
   *   And last but not least fixed the GroupMemberData object to get rid of a few set methods so Castor
   *   will now work correctly in Windows
   *
   *   Revision 1.9  2004/09/16 23:18:08  dave
   *   Replaced debug logging in Community.
   *   Added stream close() to FileStore.
   *
   *   Revision 1.8.82.1  2004/09/16 09:58:48  dave
   *   Replaced debug with commons logging ....
   *
   *   Revision 1.8  2004/06/18 13:45:19  dave
   *   Merged development branch, dave-dev-200406081614, into HEAD
   *
   *   Revision 1.7.32.3  2004/06/17 15:10:03  dave
   *   Removed unused imports (PMD report).
   *
   *   Revision 1.7.32.2  2004/06/17 13:38:58  dave
   *   Tidied up old CVS log entries
   *
   * </cvs:log>
   *
   */
  package org.astrogrid.community.client.policy.manager ;
  
  import org.apache.commons.logging.Log ;
  import org.apache.commons.logging.LogFactory ;
  
  import java.rmi.RemoteException ;
  
  import org.astrogrid.community.client.service.CommunityServiceCoreDelegate ;
  
  import org.astrogrid.community.common.policy.data.AccountData ;
  import org.astrogrid.community.common.policy.data.GroupData ;
  import org.astrogrid.community.common.policy.data.ResourceData ;
  import org.astrogrid.community.common.policy.data.PolicyPermission ;
  import org.astrogrid.community.common.policy.data.GroupMemberData ;
  
  import org.astrogrid.community.common.policy.manager.PolicyManager ;
  
  import org.astrogrid.community.common.exception.CommunityPolicyException     ;
  import org.astrogrid.community.common.exception.CommunityServiceException    ;
  import org.astrogrid.community.common.exception.CommunityResourceException   ;
  import org.astrogrid.community.common.exception.CommunityIdentifierException ;
  
  
  /***
   * The core delegate for our PolicyManager service.
   * This acts as a wrapper for a PolicyManager service, and converts RemoteExceptions into CommunityServiceException.
   * @todo Refactor this as a number of smaller classes.
   *
   */
  public class PolicyManagerCoreDelegate
      extends CommunityServiceCoreDelegate
      implements PolicyManager, PolicyManagerDelegate
      {
      /***
       * Our debug logger.
       *
       */
      private static Log log = LogFactory.getLog(PolicyManagerCoreDelegate.class);
  
      /***
      * Public constructor.
      *
      */
     protected PolicyManagerCoreDelegate()
         {
         }
 
     /***
      * Our PolicyManager service.
      *
      */
     private PolicyManager manager = null ;
 
     /***
      * Get a reference to our PolicyManager service.
      *
      */
     protected PolicyManager getPolicyManager()
         {
         return this.manager ;
         }
 
     /***
      * Set our our PolicyManager service.
      *
      */
     protected void setPolicyManager(PolicyManager manager)
         {
         this.setCommunityService(manager) ;
         this.manager = manager ;
         }
 
     /***
      * Add a new Account, given the Account ident.
      * @param  ident The Account identifier.
      * @return An AccountData for the Account.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is already in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public AccountData addAccount(String ident)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.addAccount(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Add a new Account, given the Account data.
      * @param  account The AccountData to add.
      * @return A new AccountData for the Account.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is already in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public AccountData addAccount(AccountData account)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.addAccount(account) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request an Account details, given the Account ident.
      * @param  ident The Account identifier.
      * @return An AccountData for the Account.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public AccountData getAccount(String ident)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getAccount(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Update an Account.
      * @param  account The new AccountData to update.
      * @return A new AccountData for the Account.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public AccountData setAccount(AccountData account)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.setAccount(account) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Delete an Account.
      * @param  ident The Account identifier.
      * @return The AccountData for the old Account.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public AccountData delAccount(String ident)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.delAccount(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request a list of local Accounts.
      * @return An array of AccountData objects.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public Object[] getLocalAccounts()
         throws CommunityServiceException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getLocalAccounts() ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Add a new Group.
      * @param  ident The Group identifier.
      * @return A GroupData for the Group.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is already in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupData addGroup(String ident)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.addGroup(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Add a new Group.
      * @param  group The GroupData to add.
      * @return A new GroupData for the Group.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is already in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupData addGroup(GroupData data)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.addGroup(data) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request a Group details.
      * @param  ident The Group identifier.
      * @return A GroupData for the Group.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupData getGroup(String ident)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getGroup(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Update a Group.
      * @param  data The new GroupData to update.
      * @return A new GroupData for the Group.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupData setGroup(GroupData data)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.setGroup(data) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Delete a Group.
      * @param  ident The Group identifier.
      * @return The GroupData for the old Group.
      * @throws CommunityIdentifierException If the identifier is not valid.
      * @throws CommunityPolicyException If the identifier is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupData delGroup(String ident)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException 
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.delGroup(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request a list of local Groups.
      * @return An array of GroupData objects.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public Object[] getLocalGroups()
         throws CommunityServiceException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getLocalGroups() ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request a list of local Groups that an Account belongs to, given the Account ident.
      * @param  account The Account ifentifier.
      * @return An array of GroupData objects.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public Object[] getLocalAccountGroups(String account)
         throws CommunityServiceException, CommunityIdentifierException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getLocalAccountGroups(account) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Register a new Resource.
      * @return A new ResourceData object to represent the resource.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public ResourceData addResource()
         throws CommunityServiceException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.addResource() ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request the details for a Resource.
      * @param The resource identifier.
      * @return The requested ResourceData object.
      * @throws CommunityResourceException If unable to locate the resource.
      * @throws CommunityServiceException If there is an internal error in the service.
      * @throws CommunityIdentifierException If the resource identifier is not valid.
      *
      */
    public ResourceData getResource(String ident)
         throws CommunityIdentifierException, CommunityResourceException, CommunityServiceException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getResource(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 resourceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
    
    /***
     * Request the details for a Resource.
     * @param The resource identifier.
     * @return The requested ResourceData object.
     * @throws CommunityResourceException If unable to locate the resource.
     * @throws CommunityServiceException If there is an internal error in the service.
     * @throws CommunityIdentifierException If the resource identifier is not valid.
     *
     */
    public Object[] getResources()
        {
        //
        // If we have a valid service reference.
        if (null != this.manager)
            {
            //
            // Try calling the service method.
            try {
                return this.manager.getResources() ;
                }
            //
            // Catch anything that went BANG.
            catch (RemoteException ouch)
                {
                //
                // Try converting the Exception.
                //serviceException(ouch) ;
                //resourceException(ouch) ;
                //identifierException(ouch) ;
                }
        }
            return null;
    }
    
 
     /***
      * Update the details for a Resource.
      * @param The ResourceData to update.
      * @return The updated ResourceData.
      * @throws CommunityResourceException If unable to locate the resource.
      * @throws CommunityServiceException If there is an internal error in the service.
      * @throws CommunityIdentifierException If the resource identifier is not valid.
      *
      */
     public ResourceData setResource(ResourceData resource)
         throws CommunityIdentifierException, CommunityResourceException, CommunityServiceException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.setResource(resource) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 resourceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Delete a Resource.
      * @param The resource identifier.
      * @return The original ResourceData.
      * @throws CommunityResourceException If unable to locate the resource.
      * @throws CommunityServiceException If there is an internal error in the service.
      * @throws CommunityIdentifierException If the identifier is not valid.
      *
      */
     public ResourceData delResource(String ident)
         throws CommunityIdentifierException, CommunityResourceException, CommunityServiceException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.delResource(ident) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 serviceException(ouch) ;
                 resourceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Create a new PolicyPermission.
      * @todo Better Exception handling.
      *
      */
     public PolicyPermission addPermission(String resource, String group, String action)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         PolicyPermission result = null ;
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 result = this.manager.addPermission(resource, group, action) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Unpack the RemoteException, and re-throw the real Exception.
                 //
                 }
             }
         return result ;
         }
 
     /***
      * Request a PolicyPermission.
      * @todo Better Exception handling.
      *
      */
     public PolicyPermission getPermission(String resource, String group, String action)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException    
         {
         PolicyPermission result = null ;
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 result = this.manager.getPermission(resource, group, action) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Unpack the RemoteException, and re-throw the real Exception.
                 //
                 }
             }
         return result ;
         }
     
     /***
      * Request a PolicyPermission.
      * @todo Better Exception handling.
      *
      */
     public Object[] getPermissions()    
         {
         Object[] result = null ;
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 result = this.manager.getPermissions();
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Unpack the RemoteException, and re-throw the real Exception.
                 //
                 }
             }
         return result ;
      }
     
 
     /***
      * Update a PolicyPermission.
      * @todo Better Exception handling.
      *
      */
     public PolicyPermission setPermission(PolicyPermission permission)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         PolicyPermission result = null ;
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 result = this.manager.setPermission(permission) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Unpack the RemoteException, and re-throw the real Exception.
                 //
                 }
             }
         return result ;
         }
 
     /***
      * Delete a PolicyPermission.
      * @todo Better Exception handling.
      *
      */
     public boolean delPermission(String resource, String group, String action)
        throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         boolean result = false ;
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 result = this.manager.delPermission(resource, group, action) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Unpack the RemoteException, and re-throw the real Exception.
                 //
                 }
             }
         return result ;
         }
 
     /***
      * Add an Account to a Group.
      * The group must be local, but Account can be local or remote.
      * @param  account The Account identifier.
      * @param  group   The Group identifier.
      * @return An GroupMemberData to confirm the membership.
      * @throws CommunityIdentifierException If one of the identifiers is not valid.
      * @throws CommunityPolicyException If one the identifiers is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupMemberData addGroupMember(String account, String group)
         throws CommunityServiceException, CommunityIdentifierException, CommunityPolicyException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.addGroupMember(account, group) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Remove an Account from a Group.
      * The group must be local, but Account can be local or remote.
      * @param  account The Account identifier.
      * @param  group   The Group identifier.
      * @return A GroupMemberData to confirm the membership.
      * @throws CommunityIdentifierException If one of the identifiers is not valid.
      * @throws CommunityPolicyException If one the identifiers is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupMemberData delGroupMember(String account, String group)
         throws CommunityServiceException, CommunityPolicyException, CommunityIdentifierException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.delGroupMember(account, group) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
 
     /***
      * Request a list of Group members.
      * The group must be local.
      * @param  group   The Group identifier.
      * @return An array of GroupMemberData objects..
      * @throws CommunityIdentifierException If one of the identifiers is not valid.
      * @throws CommunityPolicyException If one the identifiers is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public Object[] getGroupMembers(String group)
         throws CommunityServiceException, CommunityPolicyException, CommunityIdentifierException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getGroupMembers(group) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
     
     /***
      * Request a list of Group members.
      * The group must be local.
      * @param  group   The Group identifier.
      * @return An array of GroupMemberData objects..
      * @throws CommunityIdentifierException If one of the identifiers is not valid.
      * @throws CommunityPolicyException If one the identifiers is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public GroupMemberData getGroupMember(String account, String group)
         throws CommunityServiceException, CommunityPolicyException, CommunityIdentifierException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getGroupMember(account,group) ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }    
     
     /***
      * Request a list of Group members.
      * The group must be local.
      * @param  group   The Group identifier.
      * @return An array of GroupMemberData objects..
      * @throws CommunityIdentifierException If one of the identifiers is not valid.
      * @throws CommunityPolicyException If one the identifiers is not in the database.
      * @throws CommunityServiceException If there is an internal error in the service.
      *
      */
     public Object[] getGroupMembers()
         throws CommunityServiceException, CommunityPolicyException, CommunityIdentifierException
         {
         //
         // If we have a valid service reference.
         if (null != this.manager)
             {
             //
             // Try calling the service method.
             try {
                 return this.manager.getGroupMembers() ;
                 }
             //
             // Catch anything that went BANG.
             catch (RemoteException ouch)
                 {
                 //
                 // Try converting the Exception.
                 policyException(ouch) ;
                 serviceException(ouch) ;
                 identifierException(ouch) ;
                 //
                 // If we get this far, then we don't know what it is.
                 throw new CommunityServiceException(
                     "WebService call failed - " + ouch,
                     ouch
                     ) ;
                 }
             }
         //
         // If we don't have a valid service.
         else {
             throw new CommunityServiceException(
                 "Service not initialised"
                 ) ;
             }
         }
     
     
     }