csbase.client.project

Class ClientFileLock

java.lang.Object

csbase.client.project.ClientFileLock

public class ClientFileLock
extends java.lang.Object

Representa um arquivo com as operações de lock no cliente. Esta classe obtém o lock e caso ocorra algum problema na obtenção, o remove. Também gerencia o listener responsável pelas notificações de lock vindas do servidor.

Author:

Tecgraf/PUC-Rio

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ClientFileLock.LockStatus Indica o tipo de lock obtido para um determinado arquivo.

Method Summary

Methods

Modifier and Type	Method and Description
static ClientFileLock	acquireExclusiveLock(java.awt.Window window, csbase.logic.ClientProjectFile file) Tenta obter lock exclusivo para o arquivo.
static ClientFileLock	acquireExclusiveLock(java.awt.Window window, csbase.logic.ClientProjectFile file, long timeout) Tenta obter lock exclusivo para o arquivo.
static ClientFileLock	acquireSharedLock(java.awt.Window window, csbase.logic.ClientProjectFile file) Tenta obter lock compartilhado para o arquivo.
static ClientFileLock	acquireSharedLock(java.awt.Window window, csbase.logic.ClientProjectFile file, long timeout) Tenta obter lock compartilhado para o arquivo.
ClientFileLock.LockStatus	getLockStatus() Obtém o status do lock do arquivo
void	releaseLock(java.awt.Window window) Remove o lock do arquivo se tem o lock compartilhado ou exclusivo.

Methods inherited from class java.lang.Object

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

Method Detail

releaseLock

public void releaseLock(java.awt.Window window)

Remove o lock do arquivo se tem o lock compartilhado ou exclusivo.

Parameters:

window - janela pai para a RemoteTask

getLockStatus

public ClientFileLock.LockStatus getLockStatus()

Obtém o status do lock do arquivo

Returns:

o status do lock do arquivo

acquireExclusiveLock

public static ClientFileLock acquireExclusiveLock(java.awt.Window window,
                                  csbase.logic.ClientProjectFile file,
                                  long timeout)

Tenta obter lock exclusivo para o arquivo. Locks exclusivo pode ser obtido apenas um por vez, por arquivo. Este método cadastra uma solicitação de lock exclusivo em uma fila priorizada pela ordem de chegada dos pedidos de lock e espera pela notificação de que o lock foi obtido ou seu timeout foi atingido. Caso a RemoteTask de obtenção de lock seja cancelada, chama o método para remover o pedido de lock no servidor

Parameters:

window - janela pai para a RemoteTask

file - arquivo sobre o qual se tenta obter o lock

timeout - tempo máximo de espera pelo lock em milisegundos. A constante ProjectServiceInterface.INFINITE_TIMOUT foi criada para timout infinito.

Returns:

ClientFileLock que possui o status do lock

acquireExclusiveLock

public static ClientFileLock acquireExclusiveLock(java.awt.Window window,
                                  csbase.logic.ClientProjectFile file)

Tenta obter lock exclusivo para o arquivo. Locks exclusivo pode ser obtido apenas um por vez, por arquivo. Caso a RemoteTask seja cancelada, chama o método para remover o lock no servidor

Parameters:

window - janela pai para a RemoteTask

file - arquivo sobre o qual se tenta obter o lock

Returns:

ClientFileLock que possui o status do lock

acquireSharedLock

public static ClientFileLock acquireSharedLock(java.awt.Window window,
                               csbase.logic.ClientProjectFile file,
                               long timeout)

Tenta obter lock compartilhado para o arquivo. Locks compartilhados podem ser obtidos múltiplas vezes. Este método cadastra uma solicitação de lock compartilhado em uma fila priorizada pela ordem de chegada dos pedidos de lock e espera pela notificação de que o lock foi obtido ou seu timeout foi atingido. Caso a RemoteTask de obtenção de lock seja cancelada, chama o método para remover o pedido de lock no servidor

Parameters:

window - janela pai para a RemoteTask

file - arquivo sobre o qual se tenta obter o lock

timeout - tempo máximo de espera pelo lock em milisegundos. A constante ProjectServiceInterface.INFINITE_TIMOUT foi criada para timout infinito.

Returns:

ClientFileLock que possui o status do lock

acquireSharedLock

public static ClientFileLock acquireSharedLock(java.awt.Window window,
                               csbase.logic.ClientProjectFile file)

Tenta obter lock compartilhado para o arquivo. Locks compartilhados podem ser obtidos múltiplas vezes. Caso a RemoteTask seja cancelada, chama o método para remover o lock no servidor

Parameters:

window - janela pai para a RemoteTask

file - arquivo sobre o qual se tenta obter o lock

Returns:

ClientFileLock que possui o status do lock