[Join-cvs] join1/src/main/org/figure8/join/services/remoting ResourceService.java, NONE, 1.1

[Laurent B. <lbr...@us...>]

Update of /cvsroot/join/join1/src/main/org/figure8/join/services/remoting
In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv5316/services/remoting

Added Files:
	ResourceService.java 
Log Message:
Add feature for remote interaction with resources and their versions

--- NEW FILE: ResourceService.java ---
/**
 * Copyright 2005-2007 the original author or authors.
 *
 * Licensed under the Gnu General Pubic License, Version 2.0 (the
 * "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 *
 *      http://www.opensource.org/licenses/gpl-license.php
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the Gnu General Public License for more details.
 */
package org.figure8.join.services.remoting;

import org.figure8.join.core.DuplicateEntityException;
import org.figure8.join.core.InvalidParameterException;
import org.figure8.join.services.remoting.beans.RemoteResourceVersion;

import java.rmi.RemoteException;
/**
 * Remote service interface definition. This service allows to retrieve
 * and update informations onto environment resources.
 * @author <a href="mailto:lau...@fr...">Laurent Broudoux</a>
 * @version $Revision: 1.1 $
 */
public interface ResourceService extends AuthenticatedService{

   // Public -------------------------------------------------------------------

   /**
    * Create a new resource version for a specified type. This operation
    * reqires a valid authentication done first and the permissions corresponding
    * to Joiner security role.
    * @param token Authentication token provided earlier by login() method
    * @param version The remote wrapper for resource version to create into Join
    * @throws InvalidParameterException if one of supplied parameters is invalid
    * @throws DuplicateEntityException if another resource version with same name already exists
    * @throws InvalidSessionException if user has no valid session on server-side
    * @throws RemoteException if an exception occurs during the remote conversation
    */
   public abstract void createResourceVersion(String token, RemoteResourceVersion version)
           throws InvalidParameterException, DuplicateEntityException, InvalidSessionException, RemoteException;


   /**
    * Update an existing resource with an existing reosurce version. Resource and
    * version are specified using their names that should be unique within Join system.
    * This operations requires a valid authentication done first and the persmissions
    * corresponding to Joiner security role.
    * @param token Authentication token provided earlier by login() method
    * @param resourceName The unique name of the resource to update
    * @param versionName The unique name of the version to update resource with
    * @throws InvalidParameterException if one of supplied parameters is invalid
    * @throws InvalidSessionException if user has no valid session on server-side
    * @throws RemoteException if an exception occurs during the remote conversation
    */
   public abstract void updateResource(String token, String resourceName, String versionName)
           throws InvalidParameterException, InvalidSessionException, RemoteException;
}