csbase.remote

Interface SharedObjectServiceInterface

All Superinterfaces:

Remote, ServiceInterface

public interface SharedObjectServiceInterface
extends ServiceInterface

Serviço de armazenamento e compartilhamento de objetos genéricos. Os dados são guardados separados por categoria e por usuário. Cada objeto é identificado univocamente pela sua categoria, seu usuário e seu nome. Cada objeto pode ser compartilhado com outros usuários quaisquer. Todo objeto possui uma data de criação e uma de última modificação. O conteúdo real do objeto é irrelevante, desde que seja um Object serializável.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME Nome do serviço para o ServiceManager

Method Summary

Modifier and Type	Method and Description
SharedObject	getSharedObject(String category, Object userId, String name) Retorna um objeto específico, dada a categoria, o usuário dono do objeto e o nome deste objeto.
SharedObject[]	getSharedObjectAttributes(String category) Retorna todos os objetos de uma dada categoria que o usuário tem acesso.
void	removeSharedObject(String category, String name) Remove um objeto.
SharedObject	saveSharedObject(SharedObject object) Salva um shared object no servidor, e o registra na respectiva tabela em memória.

Methods inherited from interface csbase.remote.ServiceInterface

getName, isActive

Field Detail

SERVICE_NAME

static final String SERVICE_NAME

Nome do serviço para o ServiceManager

See Also:

Constant Field Values

Method Detail

saveSharedObject

SharedObject saveSharedObject(SharedObject object)
                       throws RemoteException

Salva um shared object no servidor, e o registra na respectiva tabela em memória. Caso o objeto ainda não exista na tabela, um novo objeto é criado. Caso já exista, apenas o timestamp de última modificação é alterado.

Apenas o usuário dono do objeto pode atualizá-lo. Os campos ownerUserId, created e lastModified são especificados pelo serviço: os valores recebidos não são utilizados.

Parameters:

object - shared object (atributos + conteúdo) a ser armazenado

Returns:

o shared object com as data atualizadas, sem o conteúdo

Throws:

RemoteException - se houve algum erro

removeSharedObject

void removeSharedObject(String category,
                        String name)
                 throws RemoteException

Remove um objeto. Note que o usuário dono do objeto não é fornecido, pois ele é determinado automaticamente pelo serviço. Apenas o usuário dono do objeto pode removê-lo.

Parameters:

category - A categoria do objeto.

name - O nome do objeto.

Throws:

RemoteException - em caso de falha na comunicação com o servidor

ServiceFailureException - em caso de falha na operação

getSharedObjectAttributes

SharedObject[] getSharedObjectAttributes(String category)
                                  throws RemoteException

Retorna todos os objetos de uma dada categoria que o usuário tem acesso. Todas as instâncias de SharedObject retornadas por este método possuem o campo content igual a null. Ou seja, este método serve para recuperar os atributos dos objetos acessíveis. Para obter o objeto real, utilize o método getSharedObject(String, Object, String).

Parameters:

category - A categoria na qual os objetos serão pesquisados.

Returns:

Um array com todos os objetos acessíveis pelo usuário.

Throws:

RemoteException - em caso de falha na comunicação com o servidor

ServiceFailureException - em caso de falha na operação

getSharedObject

SharedObject getSharedObject(String category,
                             Object userId,
                             String name)
                      throws RemoteException

Retorna um objeto específico, dada a categoria, o usuário dono do objeto e o nome deste objeto. Todos os campos com os atributos são retornados preenchidos e o campo content possui referência para o objeto real.

Parameters:

category - A categoria do objeto.

userId - O identificador do usuário dono do objeto.

name - O nome do objeto.

Returns:

objeto completo (atributos e o conteúdo), ou null em caso de erro

Throws:

RemoteException - em caso de falha na comunicação com o servidor

ServiceFailureException - em caso de falha na operação