org.figure8.join.services.remoting
Interface ResourceService

All Superinterfaces:

AuthenticatedService, java.rmi.Remote

All Known Implementing Classes:

ResourceServiceImpl

public interface ResourceService
extends AuthenticatedService

Remote service interface definition. This service allows to retrieve and update informations onto environment resources.

Version:

$Revision: 1.1 $

Author:

Laurent Broudoux

Method Summary

void	createResourceVersion(java.lang.String token, RemoteResourceVersion version) Create a new resource version for a specified type.
void	updateResource(java.lang.String token, java.lang.String resourceName, java.lang.String versionName) Update an existing resource with an existing reosurce version.

Methods inherited from interface org.figure8.join.services.remoting.AuthenticatedService

login, logout

Method Detail

createResourceVersion

void createResourceVersion(java.lang.String token,
                           RemoteResourceVersion version)
                           throws InvalidParameterException,
                                  DuplicateEntityException,
                                  InvalidSessionException,
                                  java.rmi.RemoteException

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.

Parameters:

token - Authentication token provided earlier by login() method

version - The remote wrapper for resource version to create into Join

Throws:

InvalidParameterException - if one of supplied parameters is invalid

DuplicateEntityException - if another resource version with same name already exists

InvalidSessionException - if user has no valid session on server-side

java.rmi.RemoteException - if an exception occurs during the remote conversation

updateResource

void updateResource(java.lang.String token,
                    java.lang.String resourceName,
                    java.lang.String versionName)
                    throws InvalidParameterException,
                           InvalidSessionException,
                           java.rmi.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.

Parameters:

token - Authentication token provided earlier by login() method

resourceName - The unique name of the resource to update

versionName - The unique name of the version to update resource with

Throws:

InvalidParameterException - if one of supplied parameters is invalid

InvalidSessionException - if user has no valid session on server-side

java.rmi.RemoteException - if an exception occurs during the remote conversation