csbase.server.services.csfsservice

Class CSFSService

java.lang.Object

csbase.remote.RemoteObjectObservable

csbase.server.ServerRemoteObjectObservable

csbase.server.Service

csbase.server.services.csfsservice.CSFSService

All Implemented Interfaces:

csbase.remote.RemoteObservable, csbase.remote.RemoteObserverNotifierInterface, csbase.remote.ServiceInterface, Remote

public class CSFSService
extends Service

Serviço para cópia de arquivos utilizando o CSFS Daemon. O CSFS Daemon exporta uma interface remota que dá acesso ao sistema de arquivos local da máquina que executa o servidor. Essa interface pode ser usada para copiar arquivos entre diversas máquinas e para permitir o gerenciamento dos mesmos. No caso do CSFSService, temos a cópia de arquivos entre o CSFS Daemon que exporta a área de projetos (e o repositório de algoritmos) e o CSFS Daemon que gerencia a area local nas máquinas de execução. Esse procedimento de cópia é realizado pela comunicação direta entre esses dois CSFS Daemons. O CSFS Daemon é definido em CORBA.

Author:

Marcelo Nery dos Santos

Field Summary

Fields

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

Fields inherited from class csbase.remote.RemoteObjectObservable

observerManager

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CSFSService() Construtor

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkExistence(String host, int port, String[] path) Verifica a existência de um caminho em um determinado servidor.
void	copyFrom(String host, int port, String[] sourcePath, String[] targetPath) Copia um arquivo de uma máquina de execução para a área de armazenamento principal.
void	copyTo(String host, int port, String[] sourcePath, String[] targetPath) Copia um arquivo da área de armazenamento principal para uma máquina de execução.
void	createDirectory(String host, int port, String[] dir) Cria um diretório em uma máquina.
static void	createService() Constrói a instância do serviço.
String	getCorbalocPattern() Obtém o CORBALOC utilizado pelo csfs.
String[]	getCSFSAlgorithmsRootPath() Obtém o caminho para o repositório de algoritmos visto pelo CSFS.
String[]	getCSFSProjectsRootPath() Obtém o caminho para o repositório de projetos visto pelo CSFS.
String	getHost() Obtém o host utilizado pelo csfs.
static CSFSService	getInstance() Retorna a instância do serviço.
int	getPort() Obtém a porta utilizada pelo csfs.
String	getRootPath(String host, int port) Retorna o caminho absoluto para o diretório raiz do CSFS para o servidor especificado.
Map<String[],Long>	getTimestamps(String[] path) Obtém um mapeamento entre um arquivo e sua data de modificação para todos os arquivos de uma arvore de diretórios, dentro do servidor local.
Map<String[],Long>	getTimestamps(String host, int port, String[] path) Obtém um mapeamento entre um arquivo e sua data de modificação para todos os arquivos de uma árvore de diretórios, dentro do servidor especificado.
protected boolean	has2Update(Object arg, Object event)
void	initService() Método abstrato de inicialização do serviço.
void	remove(String host, int port, String[] path) Remove uma árvore remota recursivamente no servidor especificado.
void	shutdownService() Método invocado no termino do serviço.

Methods inherited from class csbase.server.Service

getBooleanProperty, getDefaultLocale, getDoubleProperty, getExternalPropertyFile, getFormattedString, getFormattedString, getInitializationDependencies, getInstance, getIntProperty, getKey, getLongProperty, getName, getOptionalString, getOptionalString, getOSPropertyPath, getSenderName, getServices, getString, getString, getStringListProperty, getStringProperty, getSystemId, getThreadLocale, getUser, getUserPermission, hasProperty, incrCounter, isActive, isEnabled, isInternalServerRequest, isLoggingNotifications, isPropertyNull, logNotification, setEnabled, setKey, setSystemId, setUserId

Methods inherited from class csbase.server.ServerRemoteObjectObservable

handleException, handleFatalError

Methods inherited from class csbase.remote.RemoteObjectObservable

addObserver, countObservers, deleteObserver, deleteObserver, deleteObservers, has2update, notifyObservers

Methods inherited from class java.lang.Object

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

Field Detail

SERVICE_NAME

public static final String SERVICE_NAME

Nome do serviço para o ServiceManager

See Also:

Constant Field Values

Constructor Detail

CSFSService

protected CSFSService()
               throws ServerException

Construtor

Throws:

ServerException - em caso de erro na construção do serviço.

Method Detail

getInstance

public static CSFSService getInstance()

Retorna a instância do serviço.

Returns:

o serviço.

has2Update

protected boolean has2Update(Object arg,
                 Object event)

Specified by:

has2Update in class csbase.remote.RemoteObjectObservable

createService

public static void createService()
                          throws ServerException

Constrói a instância do serviço.

Throws:

ServerException - em caso de erro na criação d serviço.

initService

public void initService()
                 throws ServerException

Método abstrato de inicialização do serviço.

Specified by:

initService in class Service

Throws:

ServerException - em caso de falha

shutdownService

public void shutdownService()
                     throws ServerException

Método invocado no termino do serviço. Realiza a shutdown do ORB.

Specified by:

shutdownService in class Service

Throws:

ServerException - em caso de falha.

getPort

public int getPort()

Obtém a porta utilizada pelo csfs.

Returns:

a porta utilizada pelo csfs.

getHost

public String getHost()

Obtém o host utilizado pelo csfs.

Returns:

o host utilizado pelo csfs.

getCorbalocPattern

public String getCorbalocPattern()

Obtém o CORBALOC utilizado pelo csfs.

Returns:

o CORBALOC utilizado pelo csfs.

checkExistence

public boolean checkExistence(String host,
                     int port,
                     String[] path)
                       throws ServerException

Verifica a existência de um caminho em um determinado servidor.

Parameters:

host - o servidor que deve ser consultado

port - porta para acessar o servidor.

path - o caminho absoluto do arquivo (relativo a raiz exportada pelo servidor)

Returns:

a indicação de existência

Throws:

ServerException - em caso de erro.

getRootPath

public String getRootPath(String host,
                 int port)
                   throws ServerException

Retorna o caminho absoluto para o diretório raiz do CSFS para o servidor especificado.

Parameters:

host - nome do servidor que exporta um sistema de arquivos via CSFS.

port - porta para acessar o servidor.

Returns:

diretório raiz do CSFS.

Throws:

ServerException - em caso de erro.

getCSFSProjectsRootPath

public String[] getCSFSProjectsRootPath()
                                 throws ServerException

Obtém o caminho para o repositório de projetos visto pelo CSFS.

Returns:

o caminho para o repositório de projetos.

Throws:

ServerException - caso o serviço não esteja disponível

getCSFSAlgorithmsRootPath

public String[] getCSFSAlgorithmsRootPath()
                                   throws ServerException

Obtém o caminho para o repositório de algoritmos visto pelo CSFS.

Returns:

o caminho para o repositório de algoritmos.

Throws:

ServerException - caso o serviço não esteja disponível

getTimestamps

public Map<String[],Long> getTimestamps(String host,
                               int port,
                               String[] path)
                                 throws ServerException

Obtém um mapeamento entre um arquivo e sua data de modificação para todos os arquivos de uma árvore de diretórios, dentro do servidor especificado. Esse valor é obtido sobre o arquivo remoto, o que evita problemas de sincronismo de relógios em uma rede composta por várias máquinas. Esse método é a base para permitir que uma árvore de diretórios seja comparada antes e depois da execução de um algoritmo, fazendo com que a sincronização entre a area de armazenamento no SGA e a área de projetos seja feita de uma forma otimizada. Por outro lado, ele pode ter um custo elevado, dado a operação recursiva sobre a árvore remota.

Parameters:

host - o servidor que mantem a árvore

port - porta para acessar o servidor

path - a raiz que deve ser analisada

Returns:

mapeamento entre um arquivo e sua data de modificação para todos os arquivos de uma árvore de diretórios.

Throws:

ServerException - em caso de erro.

getTimestamps

public Map<String[],Long> getTimestamps(String[] path)
                                 throws ServerException

Obtém um mapeamento entre um arquivo e sua data de modificação para todos os arquivos de uma arvore de diretórios, dentro do servidor local.

Parameters:

path - caminho para uma árvore de diretórios.

Returns:

mapeamento entre um arquivo e sua data de modificação para todos os arquivos de uma árvore de diretórios, dentro do servidor local.

Throws:

ServerException - em caso de erro.

copyTo

public void copyTo(String host,
          int port,
          String[] sourcePath,
          String[] targetPath)
            throws ServerException

Copia um arquivo da área de armazenamento principal para uma máquina de execução.

Parameters:

host - o nome da máquina de execução

port - porta para acessar a máquina

sourcePath - o caminho absoluto do arquivo na area de armazenamento (relativo a raiz exportada pelo CSFS).

targetPath - o caminho absoluto do arquivo a ser criado no destino (relativo a raiz exportada pelo CSFS).

Throws:

ServerException - em caso de erro.

copyFrom

public void copyFrom(String host,
            int port,
            String[] sourcePath,
            String[] targetPath)
              throws ServerException

Copia um arquivo de uma máquina de execução para a área de armazenamento principal.

Parameters:

host - o nome da máquina de execução

port - porta para acessar a máquina

sourcePath - o caminho absoluto do arquivo na máquina de execucao (relativo a raiz exportada pelo CSFS).

targetPath - o caminho absoluto do arquivo a ser criado na área de armazenamento principal (relativo a raiz exportada pelo CSFS).

Throws:

ServerException - em caso de erro.

remove

public void remove(String host,
          int port,
          String[] path)
            throws ServerException

Remove uma árvore remota recursivamente no servidor especificado.

Parameters:

host - o servidor que possui a arvore

port - porta para acessar o servidor

path - o caminho absoluto do arquivo (relativo a raiz exportada pelo CSFS).

Throws:

ServerException - em caso de erro.

createDirectory

public void createDirectory(String host,
                   int port,
                   String[] dir)
                     throws ServerException

Cria um diretório em uma máquina.

Parameters:

host - o servidor onde o diretório deve ser criado

port - porta para acessar o servidor

dir - o caminho absoluto do arquivo (relativo a raiz exportada pelo CSFS).

Throws:

ServerException - em caso de erro.