csbase.logic

Class SyncRemoteFileChannel

java.lang.Object

csbase.logic.SyncRemoteFileChannel

All Implemented Interfaces:

Serializable, tecgraf.ftc.common.logic.RemoteFileChannel

public class SyncRemoteFileChannel
extends Object
implements tecgraf.ftc.common.logic.RemoteFileChannel

Abstração de um canal que exporta os métodos padrão de RemoteFileChannel e acrescenta variantes de métodos com prefixo "sync" que tentam realizar a transferência completa dos dados em questão, ou lançam uma exceção caso não consigam.

Author:

Tecgraf

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SyncRemoteFileChannel(byte[] id, boolean writable, String host, int port, byte[] key) Constrói um canal para acesso a um arquivo remoto.
SyncRemoteFileChannel(tecgraf.ftc.common.logic.RemoteFileChannel channel) Constrói um canal para acesso a um arquivo remoto.
SyncRemoteFileChannel(tecgraf.ftc.common.logic.RemoteFileChannelInfo info) Constrói um canal para acesso a um arquivo remoto.

Method Summary

Modifier and Type	Method and Description
void	close()
long	getPosition()
long	getSize()
boolean	isOpen()
boolean	open(boolean readOnly)
int	read(byte[] target)
int	read(byte[] target, int offset, int length)
int	read(byte[] target, int offset, int length, long position)
int	read(byte[] target, long position)
void	setPosition(long position)
void	setSize(long size)
int	syncRead(byte[] target, int offset, int length, long position) Lê uma sequência de bytes do arquivo.
long	syncTransferFrom(InputStream source, long position, long count) Transfere os dados de um fluxo de entrada para o arquivo.
long	syncTransferFrom(tecgraf.ftc.common.logic.RemoteFileChannel source, long position, long count) Transfere os dados de um outro arquivo remoto para o arquivo.
long	syncTransferTo(long position, long count, OutputStream target) Transfere os dados do arquivo para um fluxo de saída.
long	syncTransferTo(long position, long count, tecgraf.ftc.common.logic.RemoteFileChannel target) Transfere os dados do arquivo para um outro arquivo remoto.
void	syncWrite(byte[] source, int offset, int length, long position) Escreve uma sequência de bytes do arquivo.
long	transferFrom(InputStream source, long position, long count)
long	transferFrom(tecgraf.ftc.common.logic.RemoteFileChannel source, long position, long count)
long	transferTo(long position, long count, OutputStream target)
long	transferTo(long position, long count, tecgraf.ftc.common.logic.RemoteFileChannel target)
int	write(byte[] source)
int	write(byte[] source, int offset, int length)
int	write(byte[] source, int offset, int length, long position)
int	write(byte[] source, long position)

Methods inherited from class java.lang.Object

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

Constructor Detail

SyncRemoteFileChannel

public SyncRemoteFileChannel(tecgraf.ftc.common.logic.RemoteFileChannelInfo info)

Constrói um canal para acesso a um arquivo remoto.

Parameters:

info - Informações que descrevem o canal para um arquivo remoto.

SyncRemoteFileChannel

public SyncRemoteFileChannel(byte[] id,
                             boolean writable,
                             String host,
                             int port,
                             byte[] key)

Constrói um canal para acesso a um arquivo remoto.

Parameters:

id - O identificador do arquivo.

writable - Indica se a escrita é permitida no arquivo.

host - A máquina do servidor de arquivos.

port - A porta do servidor de arquivos.

key - A chave de acesso ao arquivo.

SyncRemoteFileChannel

public SyncRemoteFileChannel(tecgraf.ftc.common.logic.RemoteFileChannel channel)

Constrói um canal para acesso a um arquivo remoto.

Parameters:

channel - O canal sobre o qual este irá atuar.

Method Detail

open

public boolean open(boolean readOnly)
             throws tecgraf.ftc.common.exception.PermissionException,
                    FileNotFoundException,
                    tecgraf.ftc.common.exception.FailureException,
                    tecgraf.ftc.common.exception.MaxClientsReachedException

Specified by:

open in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

FileNotFoundException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.MaxClientsReachedException

isOpen

public boolean isOpen()

Specified by:

isOpen in interface tecgraf.ftc.common.logic.RemoteFileChannel

close

public void close()
           throws tecgraf.ftc.common.exception.FailureException

Specified by:

close in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

getPosition

public long getPosition()

Specified by:

getPosition in interface tecgraf.ftc.common.logic.RemoteFileChannel

setPosition

public void setPosition(long position)
                 throws tecgraf.ftc.common.exception.FailureException

Specified by:

setPosition in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

getSize

public long getSize()

Specified by:

getSize in interface tecgraf.ftc.common.logic.RemoteFileChannel

setSize

public void setSize(long size)
             throws tecgraf.ftc.common.exception.PermissionException,
                    tecgraf.ftc.common.exception.FailureException

Specified by:

setSize in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

read

public int read(byte[] target)
         throws tecgraf.ftc.common.exception.FailureException

Specified by:

read in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

read

public int read(byte[] target,
                long position)
         throws tecgraf.ftc.common.exception.FailureException

Specified by:

read in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

read

public int read(byte[] target,
                int offset,
                int length)
         throws tecgraf.ftc.common.exception.FailureException

Specified by:

read in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

read

public int read(byte[] target,
                int offset,
                int length,
                long position)
         throws tecgraf.ftc.common.exception.FailureException

Specified by:

read in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

syncRead

public int syncRead(byte[] target,
                    int offset,
                    int length,
                    long position)
             throws tecgraf.ftc.common.exception.FailureException

Lê uma sequência de bytes do arquivo. Esse método tenta fazer leituras consecutivas até conseguir a quantidade de bytes solicitada, ou atingir o final do arquivo. Caso não consiga recuperar a quantidade solicitada sem ter atingido o final do arquivo (isto é, por problemas de comunicação ou outros), o método lança uma exceção.

Parameters:

target - O array a ser preenchido.

offset - O deslocamento no array a partir do qual os bytes serão armazenados.

length - A quantidade de bytes a serem lidos do arquivo.

position - A posição do arquivo a partir da qual a leitura deve ser iniciada.

Returns:

A quantidade de bytes lidos. Se for menor que o número de bytes solicitados, o final do arquivo foi atingido.

Throws:

tecgraf.ftc.common.exception.FailureException - Caso ocorra alguma falha no procedimento.

write

public int write(byte[] source)
          throws tecgraf.ftc.common.exception.PermissionException,
                 tecgraf.ftc.common.exception.FailureException,
                 tecgraf.ftc.common.exception.FileLockedException

Specified by:

write in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

write

public int write(byte[] source,
                 long position)
          throws tecgraf.ftc.common.exception.PermissionException,
                 tecgraf.ftc.common.exception.FailureException,
                 tecgraf.ftc.common.exception.FileLockedException

Specified by:

write in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

write

public int write(byte[] source,
                 int offset,
                 int length)
          throws tecgraf.ftc.common.exception.PermissionException,
                 tecgraf.ftc.common.exception.FailureException,
                 tecgraf.ftc.common.exception.FileLockedException

Specified by:

write in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

write

public int write(byte[] source,
                 int offset,
                 int length,
                 long position)
          throws tecgraf.ftc.common.exception.PermissionException,
                 tecgraf.ftc.common.exception.FailureException,
                 tecgraf.ftc.common.exception.FileLockedException

Specified by:

write in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

syncWrite

public void syncWrite(byte[] source,
                      int offset,
                      int length,
                      long position)
               throws tecgraf.ftc.common.exception.PermissionException,
                      tecgraf.ftc.common.exception.FailureException,
                      tecgraf.ftc.common.exception.FileLockedException

Escreve uma sequência de bytes do arquivo. Esse método tenta fazer escritas consecutivas até conseguir enviar a quantidade de bytes solicitada. Caso não consiga, o método lança uma exceção.

Parameters:

source - O array contendo os bytes a serem escritos no arquivo.

offset - O deslocamento no array a partir do qual os bytes serão lidos.

length - A quantidade de bytes a serem escritos do arquivo.

position - A posição do arquivo a partir da qual a escrita deve ser iniciada.

Throws:

tecgraf.ftc.common.exception.PermissionException - em caso de erro de permissão

tecgraf.ftc.common.exception.FailureException - em caso de falha no procedimento.

tecgraf.ftc.common.exception.FileLockedException - no caso do arquivo estar bloqueado.

transferTo

public long transferTo(long position,
                       long count,
                       OutputStream target)
                throws tecgraf.ftc.common.exception.FailureException

Specified by:

transferTo in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.FailureException

syncTransferTo

public long syncTransferTo(long position,
                           long count,
                           OutputStream target)
                    throws tecgraf.ftc.common.exception.FailureException

Transfere os dados do arquivo para um fluxo de saída. Esse método tenta fazer leituras consecutivas do arquivo até conseguir a quantidade de bytes solicitada, ou atingir o final do arquivo. Caso não consiga recuperar a quantidade solicitada sem ter atingido o final do arquivo (isto é, por problemas de comunicação ou outros), o método lança uma exceção.

Parameters:

position - A posição inicial a partir da qual o arquivo será lido.

count - A quantidade de bytes que serão transferidos.

target - O fluxo de saída que receberá os dados do arquivo.

Returns:

O número de bytes lidos do arquivo e enviados para o fluxo de saída. Só será menor que count caso o final do arquivo seja atingido antes.

Throws:

tecgraf.ftc.common.exception.FailureException - Caso ocorra alguma falha no procedimento.

transferTo

public long transferTo(long position,
                       long count,
                       tecgraf.ftc.common.logic.RemoteFileChannel target)
                throws tecgraf.ftc.common.exception.PermissionException,
                       tecgraf.ftc.common.exception.FailureException,
                       tecgraf.ftc.common.exception.FileLockedException

Specified by:

transferTo in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

syncTransferTo

public long syncTransferTo(long position,
                           long count,
                           tecgraf.ftc.common.logic.RemoteFileChannel target)
                    throws tecgraf.ftc.common.exception.PermissionException,
                           tecgraf.ftc.common.exception.FailureException,
                           tecgraf.ftc.common.exception.FileLockedException

Transfere os dados do arquivo para um outro arquivo remoto. Esse método tenta fazer leituras consecutivas do arquivo até conseguir a quantidade de bytes solicitada, ou atingir o final do arquivo. Caso não consiga recuperar a quantidade solicitada sem ter atingido o final do arquivo (isto é, por problemas de comunicação ou outros), o método lança uma exceção.

Parameters:

position - A posição inicial a partir da qual o arquivo será lido.

count - A quantidade de bytes que serão transferidos.

target - O canal do arquivo que receberá os dados.

Returns:

O número de bytes lidos do arquivo e enviados para o arquivo de saída remoto. Só será menor que count caso o final do arquivo seja atingido antes.

Throws:

tecgraf.ftc.common.exception.PermissionException - Caso o outro arquivo remoto tenha sido aberto somente para leitura.

tecgraf.ftc.common.exception.FailureException - Caso ocorra alguma falha no procedimento.

tecgraf.ftc.common.exception.FileLockedException - Caso o outro arquivo remoto esteja reservado para outro usuário.

transferFrom

public long transferFrom(InputStream source,
                         long position,
                         long count)
                  throws tecgraf.ftc.common.exception.PermissionException,
                         tecgraf.ftc.common.exception.FailureException,
                         tecgraf.ftc.common.exception.FileLockedException

Specified by:

transferFrom in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

syncTransferFrom

public long syncTransferFrom(InputStream source,
                             long position,
                             long count)
                      throws tecgraf.ftc.common.exception.PermissionException,
                             tecgraf.ftc.common.exception.FailureException,
                             tecgraf.ftc.common.exception.FileLockedException

Transfere os dados de um fluxo de entrada para o arquivo. Esse método tenta fazer escritas consecutivas no arquivo até conseguir enviar a quantidade de bytes solicitada. Caso não consiga enviar a quantidade solicitada sem ter atingido o final do fluxo de entrada (isto é, por problemas de comunicação ou outros), o método lança uma exceção.

Parameters:

source - O fluxo de entrada.

position - A posição inicial a partir da qual o arquivo será escrito.

count - A quantidade de bytes que serão transferidos.

Returns:

O número de bytes lidos do fluxo de entrada e escritos no arquivo. Só será menor que count caso o final do fluxo de entrada seja atingido antes.

Throws:

tecgraf.ftc.common.exception.PermissionException - Caso o arquivo tenha sido aberto somente para leitura.

tecgraf.ftc.common.exception.FailureException - Caso ocorra alguma falha no procedimento.

tecgraf.ftc.common.exception.FileLockedException - Indica que o arquivo está reservado para outro usuário.

transferFrom

public long transferFrom(tecgraf.ftc.common.logic.RemoteFileChannel source,
                         long position,
                         long count)
                  throws tecgraf.ftc.common.exception.PermissionException,
                         tecgraf.ftc.common.exception.FailureException,
                         tecgraf.ftc.common.exception.FileLockedException

Specified by:

transferFrom in interface tecgraf.ftc.common.logic.RemoteFileChannel

Throws:

tecgraf.ftc.common.exception.PermissionException

tecgraf.ftc.common.exception.FailureException

tecgraf.ftc.common.exception.FileLockedException

syncTransferFrom

public long syncTransferFrom(tecgraf.ftc.common.logic.RemoteFileChannel source,
                             long position,
                             long count)
                      throws tecgraf.ftc.common.exception.PermissionException,
                             tecgraf.ftc.common.exception.FailureException,
                             tecgraf.ftc.common.exception.FileLockedException

Transfere os dados de um outro arquivo remoto para o arquivo. Esse método tenta fazer escritas consecutivas no arquivo até conseguir enviar a quantidade de bytes solicitada. Caso não consiga enviar a quantidade solicitada sem ter atingido o final do arquivo remoto de entrada (isto é, por problemas de comunicação ou outros), o método lança uma exceção.

Parameters:

source - O fluxo de entrada.

position - A posição inicial a partir da qual o arquivo será escrito.

count - A quantidade de bytes que serão transferidos.

Returns:

O número de bytes lidos do fluxo de entrada e escritos no arquivo. Só será menor que count caso o final do fluxo de entrada seja atingido antes.

Throws:

tecgraf.ftc.common.exception.PermissionException - Caso o arquivo tenha sido aberto somente para leitura.

tecgraf.ftc.common.exception.FailureException - Caso ocorra alguma falha no procedimento.

tecgraf.ftc.common.exception.FileLockedException - Indica que o arquivo está reservado para outro usuário.