csbase.remote

Interface ProjectServiceInterface

All Superinterfaces:

java.rmi.Remote, RemoteObservable, ServiceInterface

public interface ProjectServiceInterface
extends ServiceInterface, RemoteObservable

Define a interface remota do serviço de projetos do Server.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CURRENT_PROJECT_SESSION_PROPERTY Nome da propriedade da sessão do usuário no servidor que indica o projeto corrente (na árvore) do usuário.
static int	INFINITE_TIMEOUT Constante que representa a espera, sem timeout, por um lock de arquivo.
static java.lang.String	SERVICE_NAME Nome do serviço para o ServiceManager

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	acquireExclusiveLock(java.lang.Object projectId, java.lang.String[] path) Obtém lock de escrita exclusivo para um arquivo.
java.lang.Object	acquireExclusiveLock(java.lang.Object projectId, java.lang.String[] path, FileLockListenerInterface listener, long timeout) Tenta obter um lock de escrita exclusivo para um arquivo.
java.lang.Object	acquireSharedLock(java.lang.Object projectId, java.lang.String[] path) Obtém lock de escrita compartilhado para um arquivo.
java.lang.Object	acquireSharedLock(java.lang.Object projectId, java.lang.String[] path, FileLockListenerInterface listener, long timeout) Tenta obter lock de escrita compartilhado para um arquivo.
void	addObserver(RemoteObserver observer, java.lang.Object arg) Registra um observador interessado nas mudanças que ocorrerem em um projeto.
void	appendFileDescription(java.lang.Object projectId, java.lang.String[] path, java.lang.String text) Anexa um texto à descrição atual deste arquivo.
void	changeFileType(java.lang.Object projectId, java.lang.String[] path, java.lang.String type) Muda o tipo de um arquivo de um projeto.
void	closeProject(java.lang.Object projectId, boolean notify) Fecha um projeto.
void	copyFile(java.lang.Object sourceProjectId, java.lang.String[] filePathSource, java.lang.Object targetProjectId, java.lang.String[] dirPathTarget) Copia um arquivo de um projeto para um diretório de outro projeto.
void	copyFile(java.lang.Object projectId, java.lang.String[] filePath, java.lang.String[] dirPath) Copia um arquivo de um projeto para outro diretório.
void	createDirectory(java.lang.Object projectId, java.lang.String[] path) Cria um novo diretório, ou uma nova árvore de diretórios, dentro de um projeto.
void	createFile(java.lang.Object projectId, java.lang.String[] path, java.lang.String name, java.lang.String type) Cria um novo arquivo em um projeto.
void	createFiles(java.lang.Object projectId, java.lang.String[] parentPath, java.util.List<ProjectFileInfo> fileInfoList) Cria simultaneamente vários arquivos dentro de um mesmo diretório.
CommonClientProject	createProject(CommonProjectInfo info) Cria, abre e retorna um novo projeto.
void	createProjectWithAllocation(CommonProjectInfo info, long size) Cria um novo projeto solicitando alocação de área em disco.
boolean	deleteObserver(RemoteObserver observer, java.lang.Object arg) Remove um observador registrado em um projeto.
boolean	existsFile(java.lang.Object projectId, java.lang.String[] path) Verifica se um arquivo existe no servidor.
boolean	existsProject(java.lang.Object projectId) Informa se um dado projeto existe.
long	fileSize(java.lang.Object projectId, java.lang.String[] path) Retorna o tamanho de um arquivo.
int	forceReleaseLock(java.lang.Object projectId, java.lang.String[] path) Força a remoção do lock do arquivo.
void	freeAreaForProjects(ProjectAdminInfo[] infos) Informa que um ou mais projetos tiveram sua área liberada.
java.util.List<FileInfoSearchResult>	getAllFileInfoSearchResult(java.lang.Object projectId, java.lang.String text, boolean isCaseInsensitive, boolean isRegex) Obtém a lista de resultados de uma busca de arquivos em um projeto, de acordo com as condições solicitadas (nome do arquivo, se deve ignorar maíusculas/minúsculas, se usa ou não uma expressão regular).
java.util.Map<java.lang.String,ProjectFileTypeInfo>	getAllFileTypes(java.util.Locale loc) Obtém as propriedades de todos os tipos de arquivos cadastrados.
ClientProjectFile	getChild(java.lang.Object projectId, java.lang.String[] path) Retorna um arquivo.
ClientProjectFile	getChild(java.lang.Object projectId, java.lang.String[] path, java.lang.String name) Retorna um arquivo.
ClientProjectFile[]	getChildren(java.lang.Object projectId, java.lang.String[] path) Retorna a lista de filhos imediatos de um diretório (ou null se o arquivo não for um diretório).
ClientProjectFile[]	getChildren(java.lang.Object projectId, java.lang.String[] path, boolean recursive) Retorna a lista de filhos imediatos de um diretório (ou null se o arquivo não for um diretório).
java.lang.String	getFileDescription(java.lang.Object projectId, java.lang.String[] path) Obtém a descrição atual deste arquivo.
ProjectFileTypeInfo	getFileType(java.lang.String type) Obtem todas as propriedades de um tipo de arquivo.
java.lang.String	getLocalProjectPath()
ProjectAdminInfo[]	getLockedProjectAdminInfo() Obtém as informações de todos os projetos dos usuários.
java.util.Set<java.lang.Object>	getManageableProjectsId() Obtém um conjunto com o identificador de todos os projetos gerenciáveis pelo usuário corrente. No caso de um usuário comum isso representa todos os projetos daquele usuário, diferente do administrador que pode gerenciar todos os projetos.
java.lang.String	getMimeType(java.lang.String type) Obtem o mimeType a partir do tipo do arquivo.
long	getModificationDate(java.lang.Object projectId, java.lang.String[] path) Retorna a data de modificação de um arquivo.
ClientOptimizationMode	getOptimizationMode()
ProjectAdminInfo	getProjectAdminInfo(java.lang.Object projectId) Obtém as informações administrativas de um projeto de um usuário.
java.lang.String	getProjectLocationInServer(java.lang.Object projectId) Informa onde o diretório do projeto está instalado no servidor.
java.util.List<UserProjectInfo>	getProjectsFromUser(java.lang.Object userId) Retorna os nomes de todos os projetos de um usuário.
java.util.List<UserProjectInfo>	getProjectsSharedWithUser(java.lang.Object userId) Obtém todos os projetos que um usuário participa, mas não é o administrador do projeto.
ClientProjectFileInfo	getUpdatedFileInfo(java.lang.Object projectId, java.lang.String[] path) Atualiza as informações de um arquivo.
boolean	isAreaReserved() Indica se o serviço de projetos utiliza reserva de área.
boolean	isUnlockedWithAreaAllocated(java.lang.Object projectId) Verifica se um projeto está desbloqueado utilizando área reservada.
CommonProjectInfo	modifyProject(java.lang.Object projectId, CommonProjectInfo info) Modifica as informações de um projeto.
void	moveFile(java.lang.Object sourceProjectId, java.lang.String[] filePathSource, java.lang.Object targetProjectId, java.lang.String[] dirPathTarget) Move um arquivo de um projeto para um diretório de outro projeto.
void	moveFile(java.lang.Object projectId, java.lang.String[] filePath, java.lang.String[] dirPath) Move um arquivo de um projeto para outro diretório.
tecgraf.ftc.common.logic.RemoteFileChannelInfo	openFileChannel(java.lang.Object projectId, java.lang.String[] path, boolean readOnly) Abre um arquivo para leitura e escrita.
CommonClientProject	openProject(java.lang.Object projectId, boolean notify) Abre um projeto de um usuário.
void	rebuildDir(java.lang.Object projectId, java.lang.String[] path) Reconstrói a árvore do diretório especificado a partir do sistema de arquivos do servidor.
void	rebuildTree(java.lang.Object projectId) Reconstrói a árvore do projeto a partir do sistema de arquivos do servidor.
void	refreshDir(java.lang.Object projectId, java.lang.String[] path) Atualiza a árvore, a partir do diretório especificado.
void	refreshTree(java.lang.Object projectId) Atualiza a árvore, a partir da sua raiz.
int	releaseLock(java.lang.Object projectId, java.lang.String[] path, java.lang.Object lockId) Libera lock de um arquivo.
void	removeFile(java.lang.Object projectId, java.lang.String[] path) Remove um arquivo de um projeto.
void	removeFiles(java.lang.Object projectId, java.lang.String[][] paths) Remove vários arquivos de um projeto.
void	removeProject(java.lang.Object projectId) Remove um projeto.
boolean	removeUser(java.lang.Object projectId, java.lang.Object userId) Remove um usuário das listas de acesso.
boolean	removeUserProjects(java.lang.Object userId) Remove todos os projetos de um usuário e seu diretório-base
void	removeUsers(java.lang.Object projectId, java.util.Set<java.lang.Object> usersId) Remove um conjunto de usuários de ambas as listas de acesso (RO e RW).
void	renameFile(java.lang.Object projectId, java.lang.String[] path, java.lang.String name) Troca o nome de um arquivo de um projeto.
void	setAllocatedProjectAsUnallocated(java.lang.Object projectId) Converte um projeto com alocação de área em um projeto sem alocação.
void	setFileDescription(java.lang.Object projectId, java.lang.String[] path, java.lang.String text) Muda a descrição atual deste arquivo.
void	setFileModificationDate(java.lang.Object projectId, java.lang.String[] path, long date) Muda a data de alteração de um arquivo.
void	setUnallocatedProjectAsAllocated(java.lang.Object projectId, int areaSize) Converte um projeto sem alocação de área em um projeto com alocação.
void	setUnallocatedProjectAsLocked(java.lang.Object projectId, int areaSize) Converte um projeto sem alocação de área em um projeto que aguarda alocação.
void	setUnderConstruction(java.lang.Object projectId, java.lang.String[] path, boolean underConstruction) Altera o estado do arquivo para o valor dado no parâmetro underConstruction.
void	startUpdate(java.lang.Object projectId, java.lang.String[] path, long interval, boolean notification) Inicia ou altera o intervalo de atualização de um arquivo.
void	startUpdate(java.lang.Object projectId, java.lang.String[] path, long interval, boolean notification, java.io.Serializable extraInfo) Inicia ou altera o intervalo de atualização de um arquivo.
void	stopUpdate(java.lang.Object projectId, java.lang.String[] path) Pára a atualização de um arquivo.
void	unlockProjectsWithAllocation(ProjectAdminInfo[] infos) Informa que um ou mais projetos tiveram sua área concedida.
void	updateUsers(java.lang.Object projectId, ProjectPermissions.SharingType sharingType, java.util.Set<java.lang.Object> usersRO, java.util.Set<java.lang.Object> usersRW) Configura as permissões de acesso ao projeto.
java.util.List<java.lang.Boolean>	userCanWrite(java.util.List<java.lang.Object> projects, java.lang.Object userId) Verifica se um usuário possui permissão de escrita em diferentes projetos.
boolean	userCanWrite(java.lang.Object projectId, java.lang.Object userId) Verifica se um usuário possui acesso de escrita a um projeto.
boolean	userHasHisOwnProjects(java.lang.Object userId) Verifica se o usuário possui algum projeto.
boolean	userOwnsLock(java.lang.Object projectId, java.lang.String[] path) Verifica se o usuário corrente é o dono do lock de um arquivo.
boolean	userParticipatesOnSharedProjects(java.lang.Object userId) Verifica se um usuário participa de projetos de outros usuários.

Methods inherited from interface csbase.remote.ServiceInterface

getName, isActive

Methods inherited from interface csbase.remote.RemoteObservable

countObservers, deleteObservers, notifyObservers

Field Detail

SERVICE_NAME

static final java.lang.String SERVICE_NAME

Nome do serviço para o ServiceManager

See Also:

Constant Field Values

CURRENT_PROJECT_SESSION_PROPERTY

static final java.lang.String CURRENT_PROJECT_SESSION_PROPERTY

Nome da propriedade da sessão do usuário no servidor que indica o projeto corrente (na árvore) do usuário.

See Also:

Constant Field Values

INFINITE_TIMEOUT

static final int INFINITE_TIMEOUT

Constante que representa a espera, sem timeout, por um lock de arquivo.

See Also:

Constant Field Values

Method Detail

userHasHisOwnProjects

boolean userHasHisOwnProjects(java.lang.Object userId)
                              throws java.rmi.RemoteException

Verifica se o usuário possui algum projeto.

Parameters:

userId - identificador do usuário

Returns:

true se o usuário possui algum projeto próprio

Throws:

java.rmi.RemoteException

See Also:

userParticipatesOnSharedProjects(Object), getProjectsFromUser(Object)

userCanWrite

boolean userCanWrite(java.lang.Object projectId,
                   java.lang.Object userId)
                     throws java.rmi.RemoteException

Verifica se um usuário possui acesso de escrita a um projeto.

Parameters:

projectId - identificador do projeto

userId - identificador do usuário

Returns:

true se o usuário tem permissão de escrita no projeto

Throws:

java.rmi.RemoteException

userCanWrite

java.util.List<java.lang.Boolean> userCanWrite(java.util.List<java.lang.Object> projects,
                                             java.lang.Object userId)
                                               throws java.rmi.RemoteException

Verifica se um usuário possui permissão de escrita em diferentes projetos.

Parameters:

projects - lista com identificadores dos projetos

userId - identificador do usuário

Returns:

lista com booleanos indicando com true aqueles para os quais o usuário tem permissão de escrita. Os índices correspondem aos índices dos projetos na lista recebida como parâmetro

Throws:

java.rmi.RemoteException

getProjectsFromUser

java.util.List<UserProjectInfo> getProjectsFromUser(java.lang.Object userId)
                                                    throws java.rmi.RemoteException

Retorna os nomes de todos os projetos de um usuário. A lista retornada inclui apenas os projetos dos quais o usuário especificado é dono, não incluindo os projetos de outros usuários aos quais ele tem acesso.

Parameters:

userId - Identificador do usuário.

Returns:

Lista de UserProjectInfo contendo informações dos projetos dos quais o usuário indicado é o dono. Retorna null se o usuário ainda não possui "home".

Throws:

java.rmi.RemoteException

getProjectsSharedWithUser

java.util.List<UserProjectInfo> getProjectsSharedWithUser(java.lang.Object userId)
                                                          throws java.rmi.RemoteException

Obtém todos os projetos que um usuário participa, mas não é o administrador do projeto.

Parameters:

userId - Identificador do usuário.

Returns:

Lista de UserProjectInfo contendo informações dos projetos aos quais o usuário indicado tem acesso.

Throws:

java.rmi.RemoteException

userParticipatesOnSharedProjects

boolean userParticipatesOnSharedProjects(java.lang.Object userId)
                                         throws java.rmi.RemoteException

Verifica se um usuário participa de projetos de outros usuários.

Parameters:

userId - identificador do usuário

Returns:

true se o usuário participa de projetos de outros usuários

Throws:

java.rmi.RemoteException

See Also:

userHasHisOwnProjects(Object), getProjectsSharedWithUser(Object)

updateUsers

void updateUsers(java.lang.Object projectId,
               ProjectPermissions.SharingType sharingType,
               java.util.Set<java.lang.Object> usersRO,
               java.util.Set<java.lang.Object> usersRW)
                 throws java.rmi.RemoteException

Configura as permissões de acesso ao projeto.

Parameters:

projectId - - identificador do projeto

sharingType - - tipo do compartilhamento

usersRO - - conjunto de usuários com acesso RO. O valor null indica que a lista não foi alterada

usersRW - - conjunto de usuários com acesso RW. O valor null indica que a lista não foi alterada

Throws:

java.rmi.RemoteException

removeUser

boolean removeUser(java.lang.Object projectId,
                 java.lang.Object userId)
                   throws java.rmi.RemoteException

Remove um usuário das listas de acesso. Cada usuário por construção pode pertencer a apenas uma das listas; este método tenta a remoção em ambas as listas antes de falhar.

Parameters:

projectId - - identificador do projeto

userId - - identificador do usuário

Returns:

flag indicando se o usuário foi removido de alguma das listas

Throws:

java.rmi.RemoteException

removeUsers

void removeUsers(java.lang.Object projectId,
               java.util.Set<java.lang.Object> usersId)
                 throws java.rmi.RemoteException

Remove um conjunto de usuários de ambas as listas de acesso (RO e RW).

Parameters:

projectId - - identificador do projeto

usersId - - conjunto de identificadores de usuários a serem removidos

Throws:

java.rmi.RemoteException

removeUserProjects

boolean removeUserProjects(java.lang.Object userId)
                           throws java.rmi.RemoteException

Remove todos os projetos de um usuário e seu diretório-base

Parameters:

userId - Id do usuário

Returns:

true se removeu os projetos e o diretório-base com sucesso ou se o diretório-base já não existia ou false caso a remoção tenha falhado.

Throws:

java.rmi.RemoteException

openProject

CommonClientProject openProject(java.lang.Object projectId,
                              boolean notify)
                                throws java.rmi.RemoteException

Abre um projeto de um usuário.

Parameters:

projectId - Identificador do projeto a ser aberto.

notify - indicativo de notificação aos clientes de projeto aberto.

Returns:

Objeto da classe CommonClientProject que representa o projeto.

Throws:

java.rmi.RemoteException

createProject

CommonClientProject createProject(CommonProjectInfo info)
                                  throws java.rmi.RemoteException

Cria, abre e retorna um novo projeto.

Parameters:

info - Informações do projeto.

Returns:

o projeto criado

Throws:

java.rmi.RemoteException

createProjectWithAllocation

void createProjectWithAllocation(CommonProjectInfo info,
                               long size)
                                 throws java.rmi.RemoteException

Cria um novo projeto solicitando alocação de área em disco.

Parameters:

info - Informações do projeto.

size - O tamanho da área de alocação.

Throws:

java.rmi.RemoteException

unlockProjectsWithAllocation

void unlockProjectsWithAllocation(ProjectAdminInfo[] infos)
                                  throws java.rmi.RemoteException

Informa que um ou mais projetos tiveram sua área concedida. Os projetos passam a estar bloqueados. Esse método somente pode ser chamado pelo administrador do sistema.

Parameters:

infos - Um array com os objetos ProjectAdminInfo com as informações de desbloqueio de projetos devido a alocação de área pelo administrador.

Throws:

java.rmi.RemoteException

freeAreaForProjects

void freeAreaForProjects(ProjectAdminInfo[] infos)
                         throws java.rmi.RemoteException

Informa que um ou mais projetos tiveram sua área liberada. Esse método somente pode ser chamado pelo administrador do sistema.

Parameters:

infos - Um array com os objetos ProjectAdminInfo com as informações de liberação da área.

Throws:

java.rmi.RemoteException

modifyProject

CommonProjectInfo modifyProject(java.lang.Object projectId,
                              CommonProjectInfo info)
                                throws java.rmi.RemoteException

Modifica as informações de um projeto.

Parameters:

projectId - Identificador do projeto.

info - Novas informações do projeto.

Returns:

As novas informações do projeto. Caso alguma informação não possa ser alterada, o valor anterior é retornado.

Throws:

java.rmi.RemoteException

removeProject

void removeProject(java.lang.Object projectId)
                   throws java.rmi.RemoteException

Remove um projeto.

Parameters:

projectId - Identificador do projeto.

Throws:

java.rmi.RemoteException

closeProject

void closeProject(java.lang.Object projectId,
                boolean notify)
                  throws java.rmi.RemoteException

Fecha um projeto.

Parameters:

projectId - Identificador do projeto a ser fechado.

notify - indicativo de notificação ao cliente.

Throws:

java.rmi.RemoteException

existsProject

boolean existsProject(java.lang.Object projectId)
                      throws java.rmi.RemoteException

Informa se um dado projeto existe.

Parameters:

projectId - Identificador do projeto.

Returns:

Verdadeiro caso exista, falso caso contrário.

Throws:

java.rmi.RemoteException

rebuildTree

void rebuildTree(java.lang.Object projectId)
                 throws java.rmi.RemoteException

Reconstrói a árvore do projeto a partir do sistema de arquivos do servidor.

IMPORTANTE: toda a árvore é obtida recursivamente a partir da raiz; portanto, esta é uma operação potencialmente custosa.

Parameters:

projectId - Identificador do projeto.

Throws:

java.rmi.RemoteException

See Also:

refreshTree(Object)

refreshTree

void refreshTree(java.lang.Object projectId)
                 throws java.rmi.RemoteException

Atualiza a árvore, a partir da sua raiz. Ao contrário de rebuildTree(Object), não obtém toda a árvore a priori, deixando que isto seja feito por demanda pelos handlers do evento correspondente.

Parameters:

projectId - identificador do projeto

Throws:

java.rmi.RemoteException

See Also:

rebuildTree(Object)

rebuildDir

void rebuildDir(java.lang.Object projectId,
              java.lang.String[] path)
                throws java.rmi.RemoteException

Reconstrói a árvore do diretório especificado a partir do sistema de arquivos do servidor.

IMPORTANTE: toda a árvore é obtida recursivamente a partir do diretório especificado; portanto, esta é uma operação potencialmente custosa.

Parameters:

projectId - Identificador do projeto.

path - Caminho do diretório a ser atualizado. Se o array tiver tamanho zero, significa que a atualização será feita a partir da raiz.

Throws:

java.rmi.RemoteException

refreshDir

void refreshDir(java.lang.Object projectId,
              java.lang.String[] path)
                throws java.rmi.RemoteException

Atualiza a árvore, a partir do diretório especificado. Ao contrário de rebuildDir(Object, String[]), não obtém toda a árvore a priori, deixando que isto seja feito por demanda pelos handlers do evento correspondente.

Parameters:

projectId - Identificador do projeto.

path - Caminho do diretório a ser atualizado. Se o array tiver tamanho zero, significa que a atualização será feita a partir da raiz.

Throws:

java.rmi.RemoteException

createDirectory

void createDirectory(java.lang.Object projectId,
                   java.lang.String[] path)
                     throws java.rmi.RemoteException

Cria um novo diretório, ou uma nova árvore de diretórios, dentro de um projeto.

Parameters:

projectId - Identificador do projeto.

path - Caminho do diretório a ser criado. Todos os elementos do array que ainda não existam serão criados no projeto como diretórios, a partir da raiz.

Throws:

java.rmi.RemoteException

getChildren

ClientProjectFile[] getChildren(java.lang.Object projectId,
                              java.lang.String[] path)
                                throws java.rmi.RemoteException

Retorna a lista de filhos imediatos de um diretório (ou null se o arquivo não for um diretório). Não percorre a subárvore recursivamente.

Parameters:

projectId - Identificador do projeto.

path - Caminho do diretório, a partir da raiz.

Returns:

Lista de filhos imediatos do diretório, ou null se arquivo indicado não for um diretório.

Throws:

java.rmi.RemoteException

See Also:

getChildren(Object, String[], boolean)

getChildren

ClientProjectFile[] getChildren(java.lang.Object projectId,
                              java.lang.String[] path,
                              boolean recursive)
                                throws java.rmi.RemoteException

Retorna a lista de filhos imediatos de um diretório (ou null se o arquivo não for um diretório).

Parameters:

projectId - Identificador do projeto.

path - Caminho do diretório, a partir da raiz.

recursive - Indica se a sub-árvore deve ser obtida recursivamente.

Returns:

Lista de filhos imediatos do diretório, ou null se arquivo indicado não for um diretório.

Throws:

java.rmi.RemoteException

See Also:

getChildren(Object, String[])

getChild

ClientProjectFile getChild(java.lang.Object projectId,
                         java.lang.String[] path,
                         java.lang.String name)
                           throws java.rmi.RemoteException

Retorna um arquivo.

Parameters:

projectId - identificador do projeto.

path - caminho para o diretório que contém o arquivo, a partir da raiz. Não inclui o nome do projeto, nem o nome do arquivo.

name - nome do arquivo.

Returns:

o arquivo

Throws:

java.rmi.RemoteException

See Also:

getChild(Object, String[])

getChild

ClientProjectFile getChild(java.lang.Object projectId,
                         java.lang.String[] path)
                           throws java.rmi.RemoteException

Retorna um arquivo.

Parameters:

projectId - identificador do projeto

path - path para o arquivo, a partir da raiz. Não inclui o nome do projeto

Returns:

o arquivo

Throws:

java.rmi.RemoteException

See Also:

getChild(Object, String[], String)

createFile

void createFile(java.lang.Object projectId,
              java.lang.String[] path,
              java.lang.String name,
              java.lang.String type)
                throws java.rmi.RemoteException

Cria um novo arquivo em um projeto.

Parameters:

projectId - Identificador do projeto.

path - Caminho do diretório pai, a partir da raiz.

name - Nome do arquivo a ser criado.

type - Tipo do arquivo a ser criado.

Throws:

java.rmi.RemoteException

createFiles

void createFiles(java.lang.Object projectId,
               java.lang.String[] parentPath,
               java.util.List<ProjectFileInfo> fileInfoList)
                 throws java.rmi.RemoteException

Cria simultaneamente vários arquivos dentro de um mesmo diretório. Os caminhos dos arquivos devem ser passados relativamente ao diretório-base, que atua como raiz da árvore de arquivos.

Parameters:

projectId - Identificador do projeto.

parentPath - Caminho do diretório-base, a partir da raiz, ancestral de todos os arquivos a serem criados.

fileInfoList - Lista de dados dos arquivos a serem criados.

Throws:

java.rmi.RemoteException

renameFile

void renameFile(java.lang.Object projectId,
              java.lang.String[] path,
              java.lang.String name)
                throws java.rmi.RemoteException

Troca o nome de um arquivo de um projeto.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo a ser renomeado, a partir da raiz.

name - Novo nome do arquivo.

Throws:

java.rmi.RemoteException

changeFileType

void changeFileType(java.lang.Object projectId,
                  java.lang.String[] path,
                  java.lang.String type)
                    throws java.rmi.RemoteException

Muda o tipo de um arquivo de um projeto.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz, cujo tipo será alterado.

type - Novo tipo do arquivo.

Throws:

java.rmi.RemoteException

copyFile

void copyFile(java.lang.Object projectId,
            java.lang.String[] filePath,
            java.lang.String[] dirPath)
              throws java.rmi.RemoteException

Copia um arquivo de um projeto para outro diretório.

Parameters:

projectId - Identificador do projeto.

filePath - Caminho do arquivo a ser copiado, a partir da raiz.

dirPath - Caminho do diretório destino, a partir da raiz.

Throws:

java.rmi.RemoteException

copyFile

void copyFile(java.lang.Object sourceProjectId,
            java.lang.String[] filePathSource,
            java.lang.Object targetProjectId,
            java.lang.String[] dirPathTarget)
              throws java.rmi.RemoteException

Copia um arquivo de um projeto para um diretório de outro projeto.

Parameters:

sourceProjectId - Identificador do projeto Origem.

filePathSource - Caminho do arquivo a ser copiado, a partir da raiz.

targetProjectId - Identificador do projeto Destino.

dirPathTarget - Caminho do diretório destino, a partir da raiz.

Throws:

java.rmi.RemoteException

moveFile

void moveFile(java.lang.Object projectId,
            java.lang.String[] filePath,
            java.lang.String[] dirPath)
              throws java.rmi.RemoteException

Move um arquivo de um projeto para outro diretório.

Parameters:

projectId - Identificador do projeto.

filePath - Caminho do arquivo a ser movido, a partir da raiz.

dirPath - Caminho do diretório destino, a partir da raiz.

Throws:

java.rmi.RemoteException

moveFile

void moveFile(java.lang.Object sourceProjectId,
            java.lang.String[] filePathSource,
            java.lang.Object targetProjectId,
            java.lang.String[] dirPathTarget)
              throws java.rmi.RemoteException

Move um arquivo de um projeto para um diretório de outro projeto.

Parameters:

sourceProjectId - Identificador do projeto Origem.

filePathSource - Caminho do arquivo a ser copiado, a partir da raiz.

targetProjectId - Identificador do projeto Destino.

dirPathTarget - Caminho do diretório destino, a partir da raiz.

Throws:

java.rmi.RemoteException

removeFile

void removeFile(java.lang.Object projectId,
              java.lang.String[] path)
                throws java.rmi.RemoteException

Remove um arquivo de um projeto.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo a ser removido, a partir da raiz.

Throws:

java.rmi.RemoteException

getUpdatedFileInfo

ClientProjectFileInfo getUpdatedFileInfo(java.lang.Object projectId,
                                       java.lang.String[] path)
                                         throws java.rmi.RemoteException

Atualiza as informações de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo a ser atualizado, a partir da raiz.

Returns:

A nova representação do arquivo.

Throws:

java.rmi.RemoteException

removeFiles

void removeFiles(java.lang.Object projectId,
               java.lang.String[][] paths)
                 throws java.rmi.RemoteException

Remove vários arquivos de um projeto.

Parameters:

projectId - Identificador do projeto.

paths - Lista de caminhos, a partir da raiz, especificando os arquivos a serem removidos.

Throws:

java.rmi.RemoteException

getFileDescription

java.lang.String getFileDescription(java.lang.Object projectId,
                                  java.lang.String[] path)
                                    throws java.rmi.RemoteException

Obtém a descrição atual deste arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

O texto com a descrição do arquivo.

Throws:

java.rmi.RemoteException

setFileDescription

void setFileDescription(java.lang.Object projectId,
                      java.lang.String[] path,
                      java.lang.String text)
                        throws java.rmi.RemoteException

Muda a descrição atual deste arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

text - O novo texto da descrição do arquivo.

Throws:

java.rmi.RemoteException

appendFileDescription

void appendFileDescription(java.lang.Object projectId,
                         java.lang.String[] path,
                         java.lang.String text)
                           throws java.rmi.RemoteException

Anexa um texto à descrição atual deste arquivo. Permite a geração de históricos de modificação.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

text - O texto a ser anexado.

Throws:

java.rmi.RemoteException

existsFile

boolean existsFile(java.lang.Object projectId,
                 java.lang.String[] path)
                   throws java.rmi.RemoteException

Verifica se um arquivo existe no servidor.

Parameters:

projectId - Identificador do projeto.

path - Caminho para o arquivo, a partir da raiz.

Returns:

Verdadeiro se o arquivo existe no servidor, falso caso contrário.

Throws:

java.rmi.RemoteException

openFileChannel

tecgraf.ftc.common.logic.RemoteFileChannelInfo openFileChannel(java.lang.Object projectId,
                                                             java.lang.String[] path,
                                                             boolean readOnly)
                                                               throws java.rmi.RemoteException

Abre um arquivo para leitura e escrita.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo a ser aberto, a partir da raiz.

readOnly - Indica se o arquivo deve ser aberto apenas para leitura ou para leitura e escrita.

Returns:

O channel que conecta ao arquivo no servidor.

Throws:

java.rmi.RemoteException

getProjectLocationInServer

java.lang.String getProjectLocationInServer(java.lang.Object projectId)
                                            throws java.rmi.RemoteException

Informa onde o diretório do projeto está instalado no servidor.

Parameters:

projectId - Identificador do projeto.

Returns:

O caminho canonico do diretório do projeto no servidor.

Throws:

java.rmi.RemoteException

See Also:

File.getCanonicalPath()

acquireExclusiveLock

java.lang.Object acquireExclusiveLock(java.lang.Object projectId,
                                    java.lang.String[] path)
                                      throws java.rmi.RemoteException

Obtém lock de escrita exclusivo para um arquivo. Locks exclusivos são obtidos apenas uma vez.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

Identificador do lock se o lock foi obtido, ou null caso contrário.

Throws:

java.rmi.RemoteException

acquireExclusiveLock

java.lang.Object acquireExclusiveLock(java.lang.Object projectId,
                                    java.lang.String[] path,
                                    FileLockListenerInterface listener,
                                    long timeout)
                                      throws java.rmi.RemoteException

Tenta obter um lock de escrita exclusivo para um arquivo. Locks exclusivos são obtidos apenas uma vez. Este método cadastra uma solicitação de lock numa fila priorizada pela ordem de chegada dos pedidos de lock. Quando o lock é obtido, o método FileLockListenerInterface.fileLocked é chamado. Quando o tempo máximo de espera do lock é atingido e o lock não foi obtido o método FileLockListenerInterface.fileLockExpired é chamado.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

listener - Observador do lock cadastrado.

timeout - Tempo máximo de espera pelo lock em milisegundos. A constante INFINITE_TIMOUT existe para especificar timeout infinito.

Returns:

Identificador do pedido de lock.

Throws:

java.rmi.RemoteException

acquireSharedLock

java.lang.Object acquireSharedLock(java.lang.Object projectId,
                                 java.lang.String[] path)
                                   throws java.rmi.RemoteException

Obtém lock de escrita compartilhado para um arquivo. Locks compartilhados podem ser obtidos múltiplas vezes; cada novo lock para o arquivo incrementa o contador de referências para o lock. Locks compartilhados só podem ser removidos se o contador de referências for igual a zero.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

Identificador do lock se o lock foi obtido, ou null caso contrário.

Throws:

java.rmi.RemoteException

acquireSharedLock

java.lang.Object acquireSharedLock(java.lang.Object projectId,
                                 java.lang.String[] path,
                                 FileLockListenerInterface listener,
                                 long timeout)
                                   throws java.rmi.RemoteException

Tenta obter lock de escrita compartilhado para um arquivo. Locks compartilhados podem ser obtidos múltiplas vezes; cada novo lock para o arquivo incrementa o contador de referências para o lock. Locks compartilhados só podem ser removidos se o contador de referências for igual a zero. Este método cadastra uma solicitação de lock compartilhado em uma fila priorizada pela ordem de chegada dos pedidos de lock. Quando o lock é obtido, o método FileLockListenerInterface.fileLocked é chamado. Quando o tempo máximo de espera do lock é atingido e o lock não foi obtido o método FileLockListenerInterface.fileLockExpired é chamado.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

listener - Observador do lock cadastrado.

timeout - Tempo máximo de espera pelo lock em milisegundos. A constante INFINITE_TIMOUT existe para especificar timeout infinito.

Returns:

Identificador do pedido de lock.

Throws:

java.rmi.RemoteException

releaseLock

int releaseLock(java.lang.Object projectId,
              java.lang.String[] path,
              java.lang.Object lockId)
                throws java.rmi.RemoteException

Libera lock de um arquivo. O lock só é liberado se o identificador for o mesmo do lock obtido. Se o lock é compartilhado, a contagem de referências para o lock é decrementada. Quando o número de referências chega a zero, o lock é efetivamente removido.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

lockId - Identificador do lock.

Returns:

Contagem de referências para o lock.

Throws:

java.rmi.RemoteException

forceReleaseLock

int forceReleaseLock(java.lang.Object projectId,
                   java.lang.String[] path)
                     throws java.rmi.RemoteException

Força a remoção do lock do arquivo. Só pode ser usado pelo administrador ou pelo usuário dono do projeto, se acontencer alguma situação de ter um lock "preso". Situações onde as sessão do usuário que foi finalizadas por falha na comunicação, ou usuários que terminam o cliente abruptamente já estão previstas e não devem precisar deste mecanismo de segurança.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

Contagem de referências para o lock.

Throws:

java.rmi.RemoteException

userOwnsLock

boolean userOwnsLock(java.lang.Object projectId,
                   java.lang.String[] path)
                     throws java.rmi.RemoteException

Verifica se o usuário corrente é o dono do lock de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

Verdadeiro se o usuário é o dono do lock, falso caso contrário.

Throws:

java.rmi.RemoteException

fileSize

long fileSize(java.lang.Object projectId,
            java.lang.String[] path)
              throws java.rmi.RemoteException

Retorna o tamanho de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

Tamanho do arquivo.

Throws:

java.rmi.RemoteException

getModificationDate

long getModificationDate(java.lang.Object projectId,
                       java.lang.String[] path)
                         throws java.rmi.RemoteException

Retorna a data de modificação de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Returns:

Data de modificação do arquivo.

Throws:

java.rmi.RemoteException

addObserver

void addObserver(RemoteObserver observer,
               java.lang.Object arg)
                 throws java.rmi.RemoteException

Registra um observador interessado nas mudanças que ocorrerem em um projeto.

Specified by:

addObserver in interface RemoteObservable

Parameters:

observer - O observador remoto que registra o interesse nas mudanças sobre um projeto.

arg - Identificador do projeto no qual o observador está interessado.

Throws:

java.rmi.RemoteException

deleteObserver

boolean deleteObserver(RemoteObserver observer,
                     java.lang.Object arg)
                       throws java.rmi.RemoteException

Remove um observador registrado em um projeto.

Specified by:

deleteObserver in interface RemoteObservable

Parameters:

observer - O observador remoto a ser removido.

arg - Identificador do projeto.

Returns:

Verdadeiro se o observador foi removido, falso caso contrário.

Throws:

java.rmi.RemoteException

getAllFileTypes

java.util.Map<java.lang.String,ProjectFileTypeInfo> getAllFileTypes(java.util.Locale loc)
                                                                    throws java.rmi.RemoteException

Obtém as propriedades de todos os tipos de arquivos cadastrados.

Parameters:

loc - O locale para tradução dos termos, quando aplicável.

Returns:

Map com as propriedades de todos os tipos de arquivos.

Throws:

java.rmi.RemoteException

getFileType

ProjectFileTypeInfo getFileType(java.lang.String type)
                                throws java.rmi.RemoteException

Obtem todas as propriedades de um tipo de arquivo.

Parameters:

type - o tipo do arquivo desejado

Returns:

informações de um tipo de arquivo

Throws:

java.rmi.RemoteException

getMimeType

java.lang.String getMimeType(java.lang.String type)
                             throws java.rmi.RemoteException

Obtem o mimeType a partir do tipo do arquivo.

Parameters:

type - O tipo de arquivo.

Returns:

O mime-type correspondente.

Throws:

java.rmi.RemoteException

getLockedProjectAdminInfo

ProjectAdminInfo[] getLockedProjectAdminInfo()
                                             throws java.rmi.RemoteException

Obtém as informações de todos os projetos dos usuários.

Returns:

um array de ProjectAdminInfo.

Throws:

java.rmi.RemoteException

isUnlockedWithAreaAllocated

boolean isUnlockedWithAreaAllocated(java.lang.Object projectId)
                                    throws java.rmi.RemoteException

Verifica se um projeto está desbloqueado utilizando área reservada.

Parameters:

projectId - O identificador do projeto.

Returns:

verdadeiro, se o projeto está desbloqueado utilizando área reservada ou falso, caso contrário.

Throws:

java.rmi.RemoteException

setFileModificationDate

void setFileModificationDate(java.lang.Object projectId,
                           java.lang.String[] path,
                           long date)
                             throws java.rmi.RemoteException

Muda a data de alteração de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

date - Data, como um long.

Throws:

java.rmi.RemoteException

setUnderConstruction

void setUnderConstruction(java.lang.Object projectId,
                        java.lang.String[] path,
                        boolean underConstruction)
                          throws java.rmi.RemoteException

Altera o estado do arquivo para o valor dado no parâmetro underConstruction.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

underConstruction - Indica se o arquivo deve ficar em construção.

Throws:

java.rmi.RemoteException

startUpdate

void startUpdate(java.lang.Object projectId,
               java.lang.String[] path,
               long interval,
               boolean notification)
                 throws java.rmi.RemoteException

Inicia ou altera o intervalo de atualização de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

interval - O intervalo (em segundos) de atualização do arquivo.

notification - Indica se o usuário deseja ou não receber notificações.

Throws:

java.rmi.RemoteException

startUpdate

void startUpdate(java.lang.Object projectId,
               java.lang.String[] path,
               long interval,
               boolean notification,
               java.io.Serializable extraInfo)
                 throws java.rmi.RemoteException

Inicia ou altera o intervalo de atualização de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

interval - O intervalo (em segundos) de atualização do arquivo.

notification - Indica se o usuário deseja ou não receber notificações.

extraInfo - informações extras para parametrizar a atualização

Throws:

java.rmi.RemoteException

stopUpdate

void stopUpdate(java.lang.Object projectId,
              java.lang.String[] path)
                throws java.rmi.RemoteException

Pára a atualização de um arquivo.

Parameters:

projectId - Identificador do projeto.

path - Caminho do arquivo, a partir da raiz.

Throws:

java.rmi.RemoteException

getAllFileInfoSearchResult

java.util.List<FileInfoSearchResult> getAllFileInfoSearchResult(java.lang.Object projectId,
                                                              java.lang.String text,
                                                              boolean isCaseInsensitive,
                                                              boolean isRegex)
                                                                throws java.rmi.RemoteException

Obtém a lista de resultados de uma busca de arquivos em um projeto, de acordo com as condições solicitadas (nome do arquivo, se deve ignorar maíusculas/minúsculas, se usa ou não uma expressão regular).

Parameters:

projectId - O identificador do projeto.

text - - Texto sendo pesquisado.

isCaseInsensitive - - Considerar maiúsculas/minúsculas.

isRegex - - Indica que o texto é uma expressão regular.

Returns:

Lista com as informações sobre todos arquivos encontrados. Caso nenhum arquivo tenha sido encontrado, retorna uma lista vazia.

Throws:

java.rmi.RemoteException

getManageableProjectsId

java.util.Set<java.lang.Object> getManageableProjectsId()
                                                        throws java.rmi.RemoteException

Obtém um conjunto com o identificador de todos os projetos gerenciáveis pelo usuário corrente.
No caso de um usuário comum isso representa todos os projetos daquele usuário, diferente do administrador que pode gerenciar todos os projetos.

Returns:

Um conjunto com o identificador de todos os projetos gerenciáveis pelo usuário corrente. Caso o usuário não tenha acesso a nenhum projeto, o conjunto terá tamanho zero.

Throws:

java.rmi.RemoteException

setUnallocatedProjectAsLocked

void setUnallocatedProjectAsLocked(java.lang.Object projectId,
                                 int areaSize)
                                   throws java.rmi.RemoteException

Converte um projeto sem alocação de área em um projeto que aguarda alocação.

Parameters:

projectId - Identificador do projeto.

areaSize - Tamanho (em Gb) da área a ser alocada ao projeto.

Throws:

java.rmi.RemoteException - Exceção no acesso remoto aos dados.

setAllocatedProjectAsUnallocated

void setAllocatedProjectAsUnallocated(java.lang.Object projectId)
                                      throws java.rmi.RemoteException

Converte um projeto com alocação de área em um projeto sem alocação. OBS. Este método foi criado para atender uma necessidade específica. Deve ser usado com a mesma cautela exigida pelo método freeAreaForProjects() (ambos descartam informações administrativas).

Parameters:

projectId - Identificador do projeto.

Throws:

java.rmi.RemoteException - Exceção no acesso remoto aos dados.

setUnallocatedProjectAsAllocated

void setUnallocatedProjectAsAllocated(java.lang.Object projectId,
                                    int areaSize)
                                      throws java.rmi.RemoteException

Converte um projeto sem alocação de área em um projeto com alocação. OBS. Este método foi criado para atender uma necessidade específica e deve ser usado com cautela.

Parameters:

projectId - Identificador do projeto.

areaSize - Tamanho (em Gb) da área a ser alocada ao projeto.

Throws:

java.rmi.RemoteException - Exceção no acesso remoto aos dados.

getProjectAdminInfo

ProjectAdminInfo getProjectAdminInfo(java.lang.Object projectId)
                                     throws java.rmi.RemoteException

Obtém as informações administrativas de um projeto de um usuário.

Parameters:

projectId - Identificador do projeto.

Returns:

O ProjectAdminInfo do projeto de um usuário ou nulo caso o projeto não esteja bloqueado.

Throws:

java.rmi.RemoteException - Exceção no acesso remoto aos dados.

isAreaReserved

boolean isAreaReserved()
                       throws java.rmi.RemoteException

Indica se o serviço de projetos utiliza reserva de área.

Returns:

Boolean que indica se o serviço de projetos utiliza reserva de área.

Throws:

java.rmi.RemoteException - Exceção no acesso remoto aos dados.

getOptimizationMode

ClientOptimizationMode getOptimizationMode()
                                           throws java.rmi.RemoteException

Returns:

O modo de otimização que foi definido neste serviço.

Throws:

java.rmi.RemoteException

getLocalProjectPath

java.lang.String getLocalProjectPath()
                                     throws java.rmi.RemoteException

Returns:

O path de acesso local no cliente para a pasta de projetos. É utilizada quando o Modo de Otimização estiver definido como ClientOptimizationMode.GLOBAL

Throws:

java.rmi.RemoteException