csbase.logic

Class CommonClientProject

java.lang.Object

java.util.Observable

csbase.logic.CommonClientProject

All Implemented Interfaces:

java.io.Serializable

public class CommonClientProject
extends java.util.Observable
implements java.io.Serializable

Modela a visão cliente de um projeto.

Author:

Tecgraf/PUC-Rio

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected CommonProjectInfo	info Informações do projeto.
protected java.lang.String	name Nome do projeto.
protected ProjectObserver	observer Observador desse projeto no servidor.
protected java.lang.String[]	path Caminho de onde esse projeto está instalado, a partir da raiz de todos os projetos.
protected java.lang.Object	projectId Identificador do projeto.
protected boolean	serverCanWriteProject Informa se o servidor tem a capacidade de escrever no projeto.
protected ClientProjectFile	tree Árvore do projeto.
protected java.lang.Object	userId Identificador do usuário.

Constructor Summary

Constructors

Constructor and Description
CommonClientProject(java.lang.Object id, CommonProjectInfo info, ClientProjectFile tree, java.lang.String[] path) Cria a visão cliente de um projeto.

Method Summary

Methods

Modifier and Type	Method and Description
void	close(boolean notify) Fecha um projeto.
ClientProjectFile	createAndWaitForDirectory(ClientProjectFile dir, java.lang.String dirName) Cria um diretório dentro do projeto e espera que o diretório seja devolvido pelo servidor.
void	createAndWaitForDirectoryPath(ClientProjectFile root, java.lang.String[] dirPath) Cria o caminho de diretórios especificado dentro do projeto, e espera até que todo o caminho de diretórios esteja criado no servidor.
ClientProjectFile	createAndWaitForFile(ClientProjectFile dir, java.lang.String fileName, java.lang.String type) Cria um arquivo dentro de um diretório desse projeto e espera que o arquivo seja devolvido pelo servidor.
ClientProjectFile[]	createAndWaitForFiles(ClientProjectFile dir, java.util.List<ProjectFileInfo> fileInfoList) Cria vários arquivos simultaneamente dentro de um diretório desse projeto e espera que o arquivos sejam devolvidos pelo servidor.
static java.util.List<UserProjectInfo>	getAllProjects(java.lang.Object userId) Retorna todos os projetos de um usuário.
static java.util.List<UserProjectInfo>	getAllProjectsInfo(java.lang.Object userId) Obtém um conjunto com informações sobre todos os projetos de um usuário (inclusive os projetos compartilhados por outros usuários).
static java.util.List<UserProjectInfo>	getAllUserProjectsFromOthers(java.lang.Object userId) Obtém todos os projetos que um usuário participa, mas não é o dono.
java.lang.Object	getAttribute(java.lang.String key) Retorna um atributo da classe info dado a sua chave.
java.util.Hashtable<java.lang.String,java.lang.Object>	getAttributes() Retorna a hash de atributos do projeto.
long	getCreationDate() Retorna a data de criação do projeto.
java.lang.String	getDescription() Fornece a dscrição do projeto.
ClientProjectFile	getFile(java.lang.String[] filePath) Método utilitário para conversão de um array de strings que representa um path em um arquivo no projeto corrente; caso não exista o arquivo, retorna-se null.
java.util.Hashtable<?,?>	getGroupsFrameConfig(java.lang.Object uId) Obtém as configurações do frames de um usuário
java.lang.Object	getId() Retorna o identificador do projeto.
CommonProjectInfo	getInfo() Fornece o CommonProjectInfo do projeto.
long	getLastModificationDate() Retorna a data de última modificação do projeto.
java.lang.String	getLocationInServer() Indica se a área do projeto está sob um link simbólico.
long	getLockingAreaSize() Fornece o tamanho da área reservada para o projeto.
java.lang.String	getName() Fornece o nome do projeto.
java.lang.String	getOwnerServerName() Retorna o nome do servidor que criou o projeto.
java.lang.String[]	getPath() Retorna o caminho onde o projeto está instalado no servidor, a partir da raiz (ROOT) de todos os projetos.
ClientProjectFile	getRoot() Retorna o arquivo associado à raiz do projeto.
ProjectPermissions.SharingType	getSharingType() Obtém o tipo de compartilhamento do projeto.
java.lang.Object	getUserId() Fornece o identificador do usuário ao qual o projeto pertence.
java.util.Set<java.lang.Object>	getUserIdsSet() Obtém um conjunto com todos os usuários que possuem acesso ao projeto.
java.util.Set<java.lang.Object>	getUsersRO() Obtém o conjunto de usuários que têm acesso RO ao projeto no modo de compartilhamento seletivo.
java.util.Set<java.lang.Object>	getUsersRW() Obtém o conjunto de usuários que têm acesso RW ao projeto no modo de compartilhamento seletivo.
void	installObserver(ProjectObserver projObserver) Instala um observador desse projeto no servidor.
boolean	isPrivate() Verifica se o projeto é privativo.
boolean	isPublic() Verifica se um projeto é público.
boolean	isShared() Verifica se o projeto está sendo compartilhado.
boolean	isWritable() Verifica se quem chamou este método tem permissão de escrita neste projeto.
void	makePrivate() Define que o projeto é privado.
void	makePublic(boolean readOnly) Define que o projeto é público (RO ou RW).
void	modify() Persiste as modificações feitas nas informações do projeto.
static CommonClientProject	openProject(java.lang.Object projectId, boolean notify) Abre um projeto de um usuário.
void	refreshDir(ClientProjectFile dir) Atualiza o conteúdo do diretório especificado no cliente, a partir da sua contraparte no servidor.
void	refreshDir(java.lang.String[] dirPath) Atualiza o conteúdo do diretório especificado no cliente, a partir da sua contraparte no servidor.
void	refreshTree() Reconstrói e árvore do projeto a partir do sistema de arquivos do servidor.
static void	remove(java.lang.Object projectId) Remove o projeto.
void	removeFiles(java.util.List<ClientProjectFile> files) Remove uma lista de arquivos.
void	removeFiles(java.lang.String[][] paths) Remove os arquivos especificados pelo paths.
boolean	removeUser(java.lang.Object userID) Remove um usuário das listas de acesso ao projeto.
static boolean	removeUserProjects(java.lang.Object userID) Remove Todos os projetos de um usuário.
void	reopen() Abre novamente o projeto.
void	setAttribute(java.lang.String key, java.lang.Object attribute) Adiciona um atributo ao projeto.
void	setDescription(java.lang.String description) Altera a descrição do projeto.
void	setGroupsFrameInfo(java.lang.Object userId, java.util.Hashtable<?,?> groupsFrameInfo) Altera a configuração dos frames por usuário.
void	setLockingAreaSize(long size) Altera o tamanho da área reservada para o projeto.
void	setOutOfDate() Indica que o projeto pode estar desatualizado.
void	setServerCanWriteProject(boolean serverCanWriteProject) Define a capacidade do servidor de escrever no projeto.
void	setSharingType(ProjectPermissions.SharingType sharingType) Define o tipo de compartilhamento do projeto.
void	uninstallObserver() Desinstala um observador desse projeto no servidor.
void	update(ProjectEvent action) Trata eventos de modificação do projeto, como consequência de alguma ação ocorrida no servidor.
void	updateUsers(ProjectPermissions.SharingType sharingType, java.util.Set<java.lang.Object> usersRO, java.util.Set<java.lang.Object> usersRW) Atualiza as informações de compartilhamento de um projeto.
void	updateUsers(java.util.Set<java.lang.Object> usersRO, java.util.Set<java.lang.Object> usersRW) Atualiza ambas as listas de acesso (RO e RW) ao projeto.
void	updateUsersRO(java.util.Set<java.lang.Object> usersRO) Atualiza o conjunto de usuários com acesso RO ao projeto.
void	updateUsersRW(java.util.Set<java.lang.Object> usersRW) Atualiza o conjunto de usuários com acesso RW ao projeto.
boolean	userHasAccessRO(java.lang.Object userID) Verifica se o usuário tem qualquer tipo de acesso RO ao projeto, ou seja, se uma das seguintes condições é satisfeita: o projeto é público apenas para leitura o compartilhamento é seletivo e o usuário possui acesso RO
boolean	userHasAccessRW(java.lang.Object userID) Verifica se o usuário tem qualquer tipo de acesso RW ao projeto, ou seja, se uma das seguintes condições é satisfeita: usuário é o admin ou o dono do projeto o projeto é público para leitura e escrita o compartilhamento é seletivo e o usuário possui acesso RW
static boolean	userHasHisOwnProjects(java.lang.Object userId) Verifica se o usuário possui algum projeto próprio.
static boolean	userParticipatesOnSharedProjects(java.lang.Object userId) Verifica se um usuário participa de projetos de outros usuários.

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

userId

protected java.lang.Object userId

Identificador do usuário.

name

protected java.lang.String name

Nome do projeto.

projectId

protected java.lang.Object projectId

Identificador do projeto.

info

protected CommonProjectInfo info

Informações do projeto.

tree

protected ClientProjectFile tree

Árvore do projeto.

path

protected java.lang.String[] path

Caminho de onde esse projeto está instalado, a partir da raiz de todos os projetos.

observer

protected ProjectObserver observer

Observador desse projeto no servidor.

serverCanWriteProject

protected boolean serverCanWriteProject

Informa se o servidor tem a capacidade de escrever no projeto. O Valor é true se o servidor for o criador do projeto.

Constructor Detail

CommonClientProject

public CommonClientProject(java.lang.Object id,
                   CommonProjectInfo info,
                   ClientProjectFile tree,
                   java.lang.String[] path)

Cria a visão cliente de um projeto.

Parameters:

id - Identificador do projeto.

info - Informações do projeto.

tree - Visão cliente da árvore do projeto.

path - Caminho de onde esse projeto está instalado, a partir da raiz de todos os projetos.

Method Detail

setServerCanWriteProject

public void setServerCanWriteProject(boolean serverCanWriteProject)

Define a capacidade do servidor de escrever no projeto.

Parameters:

serverCanWriteProject - indicador da capacidade do servidor de escrever no projeto.

getId

public java.lang.Object getId()

Retorna o identificador do projeto.

Returns:

O identificador do projeto.

getUserIdsSet

public java.util.Set<java.lang.Object> getUserIdsSet()

Obtém um conjunto com todos os usuários que possuem acesso ao projeto. O conjunto retornado não inclui o dono do projeto e nem o admin, que tem acesso irrestrito a todos os projetos.

Returns:

Conjunto com todos os usuários com os quais o projeto está compartilhado, seja RO ou RW.

getUsersRO

public java.util.Set<java.lang.Object> getUsersRO()

Obtém o conjunto de usuários que têm acesso RO ao projeto no modo de compartilhamento seletivo.

ATENÇÃO:

• retorna o próprio conjunto, portanto alterações devem ser feitas em uma cópia
• o conjunto (vazio ou não) será retornado mesmo que o tipo de compartilhamento seja privado ou público.

Returns:

conjunto de usuários que têm acesso RO ao projeto

getUsersRW

public java.util.Set<java.lang.Object> getUsersRW()

Obtém o conjunto de usuários que têm acesso RW ao projeto no modo de compartilhamento seletivo.

ATENÇÃO:

• retorna o próprio conjunto, portanto alterações devem ser feitas em uma cópia
• o conjunto (vazio ou não) será retornado mesmo que o tipo de compartilhamento seja privado ou público.

Returns:

conjunto de usuários que têm acesso RW ao projeto

getSharingType

public ProjectPermissions.SharingType getSharingType()

Obtém o tipo de compartilhamento do projeto.

Returns:

tipo de compartilhamento do projeto

setSharingType

public void setSharingType(ProjectPermissions.SharingType sharingType)

Define o tipo de compartilhamento do projeto.

Parameters:

sharingType - - tipo de compartilhamento do projeto

isPublic

public boolean isPublic()

Verifica se um projeto é público.

Returns:

true, caso o projeto seja público, ou false, caso contrário.

getOwnerServerName

public java.lang.String getOwnerServerName()

Retorna o nome do servidor que criou o projeto.

Returns:

nome do servidor

getCreationDate

public long getCreationDate()

Retorna a data de criação do projeto.

Returns:

a data

getLastModificationDate

public long getLastModificationDate()

Retorna a data de última modificação do projeto.

Returns:

a data

isPrivate

public boolean isPrivate()

Verifica se o projeto é privativo.

Returns:

true, caso o projeto seja privativo, ou false, caso contrário.

isShared

public boolean isShared()

Verifica se o projeto está sendo compartilhado.

Returns:

true, caso o projeto seja compartilhado, ou false, caso contrário.

userHasAccessRW

public boolean userHasAccessRW(java.lang.Object userID)

Verifica se o usuário tem qualquer tipo de acesso RW ao projeto, ou seja, se uma das seguintes condições é satisfeita:

• usuário é o admin ou o dono do projeto
• o projeto é público para leitura e escrita
• o compartilhamento é seletivo e o usuário possui acesso RW

Parameters:

userID - - identificador do usuário

Returns:

true se o usuário tem acesso RW ao projeto

userHasAccessRO

public boolean userHasAccessRO(java.lang.Object userID)

Verifica se o usuário tem qualquer tipo de acesso RO ao projeto, ou seja, se uma das seguintes condições é satisfeita:

• o projeto é público apenas para leitura
• o compartilhamento é seletivo e o usuário possui acesso RO

Parameters:

userID - - identificador do usuário

Returns:

true se o usuário tem acesso RO ao projeto

isWritable

public boolean isWritable()

Verifica se quem chamou este método tem permissão de escrita neste projeto.

Returns:

true se quem chamou este método tem permissão de escrita neste projeto e se o servidor possuir permissão para escrever no projeto pois foi o seu criador.

See Also:

userHasAccessRW(Object)

getAttribute

public java.lang.Object getAttribute(java.lang.String key)

Retorna um atributo da classe info dado a sua chave.

Parameters:

key - Chave do atributo.

Returns:

Valor do atributo.

getAttributes

public java.util.Hashtable<java.lang.String,java.lang.Object> getAttributes()

Retorna a hash de atributos do projeto.

Returns:

Hash de atributos do projeto.

setAttribute

public void setAttribute(java.lang.String key,
                java.lang.Object attribute)

Adiciona um atributo ao projeto.

Parameters:

key - Chave do atributo.

attribute - Valor do atributo.

getAllProjects

public static java.util.List<UserProjectInfo> getAllProjects(java.lang.Object userId)
                                                      throws java.rmi.RemoteException

Retorna todos os projetos de um usuário. Retorna null caso o usuário não tenha um "home".

IMPORTANTE: este método faz uma chamada remota, e portanto deve ser executado em uma RemoteTask.

Parameters:

userId - Identificador do usuário.

Returns:

Lista de UserProjectInfo contendo informações sobre todos os projetos do usuário. Retorna null caso o usuário não tenha projetos.

Throws:

java.rmi.RemoteException

userHasHisOwnProjects

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

Verifica se o usuário possui algum projeto próprio.

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), getAllProjects(Object)

getAllUserProjectsFromOthers

public static java.util.List<UserProjectInfo> getAllUserProjectsFromOthers(java.lang.Object userId)
                                                                    throws java.rmi.RemoteException

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

Parameters:

userId - Identificador do usuário.

Returns:

Lista de UserProjectInfo contendo informações sobre os projetos de outros usuários aos quais esse usuário tem acesso.

Throws:

java.rmi.RemoteException

userParticipatesOnSharedProjects

public static 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), getAllUserProjectsFromOthers(Object)

getAllProjectsInfo

public static java.util.List<UserProjectInfo> getAllProjectsInfo(java.lang.Object userId)
                                                          throws java.rmi.RemoteException

Obtém um conjunto com informações sobre todos os projetos de um usuário (inclusive os projetos compartilhados por outros usuários).

Parameters:

userId - O identificador do usuário.

Returns:

Um conjunto com informações sobre todos os projetos de um usuário. Caso o usuário não tenha acesso a nenhum projeto, o conjunto terá tamanho zero.

Throws:

java.rmi.RemoteException

makePublic

public void makePublic(boolean readOnly)
                throws java.rmi.RemoteException

Define que o projeto é público (RO ou RW). As listas de acesso não são alteradas.

Parameters:

readOnly - - flag que indica se o projeto é RO (true) ou RW (false)

Throws:

java.rmi.RemoteException

See Also:

updateUsersRO(Set), updateUsersRW(Set), updateUsers(Set, Set), makePrivate(), makePublic(boolean)

makePrivate

public void makePrivate()
                 throws java.rmi.RemoteException

Define que o projeto é privado. As listas de acesso não são alteradas.

Throws:

java.rmi.RemoteException

See Also:

updateUsersRO(Set), updateUsersRW(Set), updateUsers(Set, Set), makePrivate(), makePublic(boolean)

updateUsers

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

Atualiza as informações de compartilhamento de um projeto.

Parameters:

sharingType - - tipo de compartilhamento

usersRO - - usuários com acesso RO. Este conjunto pode estar preenchido independente do projeto ser compartilhado ou não

usersRW - - usuários com acesso RW. Este conjunto pode estar preenchido independente do projeto ser compartilhado ou não

Throws:

java.rmi.RemoteException

See Also:

updateUsersRO(Set), updateUsersRW(Set), updateUsers(Set, Set), makePrivate(), makePublic(boolean)

updateUsers

public void updateUsers(java.util.Set<java.lang.Object> usersRO,
               java.util.Set<java.lang.Object> usersRW)
                 throws java.rmi.RemoteException

Atualiza ambas as listas de acesso (RO e RW) ao projeto. Não altera o tipo de compartilhamento.

Parameters:

usersRO - - usuários com acesso RO

usersRW - - usuários com acesso RW

Throws:

java.rmi.RemoteException

See Also:

updateUsersRO(Set), updateUsersRW(Set), makePrivate(), makePublic(boolean)

updateUsersRO

public void updateUsersRO(java.util.Set<java.lang.Object> usersRO)
                   throws java.rmi.RemoteException

Atualiza o conjunto de usuários com acesso RO ao projeto. Não altera o tipo de compartilhamento.

Parameters:

usersRO - - usuários com acesso RO. Este conjunto pode estar preenchido independente do projeto ser compartilhado ou não

Throws:

java.rmi.RemoteException

See Also:

updateUsersRW(Set), updateUsers(Set, Set), makePrivate(), makePublic(boolean)

updateUsersRW

public void updateUsersRW(java.util.Set<java.lang.Object> usersRW)
                   throws java.rmi.RemoteException

Atualiza o conjunto de usuários com acesso RW ao projeto. Não altera o tipo de compartilhamento.

Parameters:

usersRW - - usuários com acesso RW. Este conjunto pode estar preenchido independente do projeto ser compartilhado ou não

Throws:

java.rmi.RemoteException

See Also:

updateUsersRO(Set), updateUsers(Set, Set), makePrivate(), makePublic(boolean)

removeUser

public boolean removeUser(java.lang.Object userID)
                   throws java.rmi.RemoteException

Remove um usuário das listas de acesso ao projeto.

Parameters:

userID - - identificador do usuário

Returns:

flag true indicando se o usuário foi removido, false se ele não tinha acesso ao projeto

Throws:

java.rmi.RemoteException

removeUserProjects

public static boolean removeUserProjects(java.lang.Object userID)
                                  throws java.rmi.RemoteException

Remove Todos os projetos de um usuário. Remove também a pasta do usuário.

Parameters:

userID - - identificador do usuário

Returns:

flag true indicando se a remoção foi realizada com sucesso, false se houve algum erro

Throws:

java.rmi.RemoteException

openProject

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

Abre um projeto de um usuário. Cria um observador para esse projeto e registra esse observador no provedor para que ele seja notificado de alterações ocorridas nesse projeto.

Parameters:

projectId - Identificador do projeto a ser aberto.

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

Returns:

Retorna o projeto criado ou null, caso não seja possível criá-lo.

Throws:

java.rmi.RemoteException

reopen

public void reopen()
            throws java.rmi.RemoteException

Abre novamente o projeto. Um projeto aberto pode ser fechado pelo servidor arbitrariamente. Isso acontece, por exemplo, caso o servidor termine e volte à operação enquanto o cliente permanece sendo utilizado.

Throws:

java.rmi.RemoteException

createAndWaitForFile

public ClientProjectFile createAndWaitForFile(ClientProjectFile dir,
                                     java.lang.String fileName,
                                     java.lang.String type)
                                       throws java.rmi.RemoteException

Cria um arquivo dentro de um diretório desse projeto e espera que o arquivo seja devolvido pelo servidor.

Parameters:

dir - Diretório onde o arquivo vai ser criado.

fileName - Nome do arquivo a ser criado.

type - Tipo do arquivo a ser criado.

Returns:

O arquivo criado ou null caso a operação falhe.

Throws:

java.rmi.RemoteException

createAndWaitForFiles

public ClientProjectFile[] createAndWaitForFiles(ClientProjectFile dir,
                                        java.util.List<ProjectFileInfo> fileInfoList)
                                          throws java.rmi.RemoteException

Cria vários arquivos simultaneamente dentro de um diretório desse projeto e espera que o arquivos sejam devolvidos pelo servidor.

Parameters:

dir - Diretório onde os arquivos vão ser criados.

fileInfoList - lista de dados dos arquivos a serem criados.

Returns:

Os arquivos criados.

Throws:

java.rmi.RemoteException

createAndWaitForDirectory

public ClientProjectFile createAndWaitForDirectory(ClientProjectFile dir,
                                          java.lang.String dirName)
                                            throws java.rmi.RemoteException

Cria um diretório dentro do projeto e espera que o diretório seja devolvido pelo servidor.

Parameters:

dir - Raiz do projeto ou um sub-diretório.

dirName - Nome do diretório a ser criado.

Returns:

O diretório criado ou null caso a operação falhe.

Throws:

java.rmi.RemoteException

createAndWaitForDirectoryPath

public void createAndWaitForDirectoryPath(ClientProjectFile root,
                                 java.lang.String[] dirPath)
                                   throws java.rmi.RemoteException

Cria o caminho de diretórios especificado dentro do projeto, e espera até que todo o caminho de diretórios esteja criado no servidor.

Parameters:

root - raiz do projeto

dirPath - caminho do diretório a ser criado, que já deve incluir o nome do diretório raiz do projeto

Throws:

java.rmi.RemoteException - erro de rmi

getUserId

public java.lang.Object getUserId()

Fornece o identificador do usuário ao qual o projeto pertence.

Returns:

Identificador do usuário.

getName

public java.lang.String getName()

Fornece o nome do projeto.

Returns:

Nome do projeto.

getDescription

public java.lang.String getDescription()

Fornece a dscrição do projeto.

Returns:

A descrição do projeto.

getInfo

public CommonProjectInfo getInfo()

Fornece o CommonProjectInfo do projeto.

Returns:

ProjectInfo

setDescription

public void setDescription(java.lang.String description)

Altera a descrição do projeto.

Parameters:

description - descrição.

getLockingAreaSize

public long getLockingAreaSize()

Fornece o tamanho da área reservada para o projeto.

Returns:

o tamanho em GB da área reservada ou zero caso não exista reserva de área.

setLockingAreaSize

public void setLockingAreaSize(long size)

Altera o tamanho da área reservada para o projeto.

Parameters:

size - o tamanho em GB da área reservada ou zero caso não exista reserva de área.

setGroupsFrameInfo

public void setGroupsFrameInfo(java.lang.Object userId,
                      java.util.Hashtable<?,?> groupsFrameInfo)

Altera a configuração dos frames por usuário.

Parameters:

userId - Identificador do usuário logado.

groupsFrameInfo - Configuração do projeto do usuário logado. FIXME - A remoção das warnings deste método exigiria modificações em ApplicationPanel.

getGroupsFrameConfig

public java.util.Hashtable<?,?> getGroupsFrameConfig(java.lang.Object uId)

Obtém as configurações do frames de um usuário

Parameters:

uId - Identificador dos usuários que se deseja a configuração.

Returns:

groupsFrameInfo Configurações dos frames do usuário. FIXME - A remoção das warnings deste método exigiria modificações em ApplicationPanel.

getRoot

public ClientProjectFile getRoot()

Retorna o arquivo associado à raiz do projeto.

IMPORTANTE: não se deve assumir que a árvore está preenchida, só é garantido que o nó-raiz esteja definido

Returns:

arquivo associado à raiz do projeto. Seus filhos podem não ter sido ainda definidos

modify

public void modify()
            throws java.rmi.RemoteException

Persiste as modificações feitas nas informações do projeto. Caso alguma informação não possa ser alterada, seu valor original será reestabelecido.

Throws:

java.rmi.RemoteException

refreshTree

public void refreshTree()
                 throws java.rmi.RemoteException

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

Throws:

java.rmi.RemoteException

refreshDir

public void refreshDir(java.lang.String[] dirPath)
                throws java.rmi.RemoteException

Atualiza o conteúdo do diretório especificado no cliente, a partir da sua contraparte no servidor.

Parameters:

dirPath - caminho para o diretório a ser atualizado

Throws:

java.rmi.RemoteException - em caso de erro na execução remota

refreshDir

public void refreshDir(ClientProjectFile dir)
                throws java.rmi.RemoteException

Atualiza o conteúdo do diretório especificado no cliente, a partir da sua contraparte no servidor.

Parameters:

dir - diretório a ser atualizado

Throws:

java.rmi.RemoteException - em caso de erro na execução remota

remove

public static void remove(java.lang.Object projectId)
                   throws java.rmi.RemoteException

Remove o projeto. Caso este método retorne com sucesso, o objeto que representa o projeto não poderá mais ser utilizado.

Parameters:

projectId - Identificador do projeto.

Throws:

java.rmi.RemoteException

close

public void close(boolean notify)
           throws java.rmi.RemoteException

Fecha um projeto. Após chamado este método, o objeto que representa o projeto não poderá mais ser utilizado.

Parameters:

notify - indicativo de notificação de fechamento aos clientes

Throws:

java.rmi.RemoteException

getLocationInServer

public java.lang.String getLocationInServer()
                                     throws java.rmi.RemoteException,
                                            java.lang.Exception

Indica se a área do projeto está sob um link simbólico.

Returns:

indicativo

Throws:

java.rmi.RemoteException

java.lang.Exception - se houver falhano acesso ao diretório.

removeFiles

public void removeFiles(java.lang.String[][] paths)
                 throws java.rmi.RemoteException

Remove os arquivos especificados pelo paths.

Parameters:

paths - caminhos dos arquivos (incluindo o nome do projeto)

Throws:

java.rmi.RemoteException

removeFiles

public void removeFiles(java.util.List<ClientProjectFile> files)
                 throws java.rmi.RemoteException

Remove uma lista de arquivos. (OBS.: não remove a raiz do projeto)

Parameters:

files - lista de arquivos a serem removidos

Throws:

java.rmi.RemoteException - em caso de erro na execução remota

getPath

public java.lang.String[] getPath()

Retorna o caminho onde o projeto está instalado no servidor, a partir da raiz (ROOT) de todos os projetos.

Returns:

Caminho a partir da raiz dos projetos até este projeto.

update

public void update(ProjectEvent action)

Trata eventos de modificação do projeto, como consequência de alguma ação ocorrida no servidor. Eventos possíveis: - mudança nos dados do projeto - remoção do projeto - mudanças na árvore do projeto - inclusão de um arquivo - remoção de um arquivo - mudança de nome de um arquivo - mudança da localização de um arquivo - mudança do estado do arquivo (global, publicado, construção, normal)

Parameters:

action - Objeto que descreve o evento ocorrido e as informações necessárias para tratá-lo.

Throws:

java.lang.IllegalArgumentException

installObserver

public void installObserver(ProjectObserver projObserver)

Instala um observador desse projeto no servidor.

Parameters:

projObserver - .

uninstallObserver

public void uninstallObserver()
                       throws java.rmi.RemoteException

Desinstala um observador desse projeto no servidor.

Throws:

java.rmi.RemoteException

getFile

public final ClientProjectFile getFile(java.lang.String[] filePath)
                                throws java.rmi.RemoteException

Método utilitário para conversão de um array de strings que representa um path em um arquivo no projeto corrente; caso não exista o arquivo, retorna-se null. O nome do projeto não deve estar no path.

Parameters:

filePath - o array de String com o path.

Returns:

o objeto que representa o arquivo ou null.

Throws:

java.rmi.RemoteException - caso ClientProjectFile.getChild(String) aplicado à raiz do projeto falhe.

See Also:

ClientProjectFile

setOutOfDate

public void setOutOfDate()

Indica que o projeto pode estar desatualizado.