csbase.server.services.wioservice

Class WIOServerFile

java.lang.Object

org.omg.PortableServer.Servant

csbase.server.services.wioservice.idl.WIOFilePOA

csbase.server.services.wioservice.WIOServerFile

All Implemented Interfaces:

csbase.server.services.wioservice.idl.WIOFileOperations, InvokeHandler

public class WIOServerFile
extends csbase.server.services.wioservice.idl.WIOFilePOA

A classe WIOServerFile implementa o servant associado à interface idl WIOFile.

Author:

Tecgraf/PUC-Rio

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WIOServerFile(WIOServerProject serverProject, String serverPath) Constrói o objeto que representa um arquivo remoto,

Method Summary

Methods

Modifier and Type	Method and Description
protected POA	activateCorbaFile() Método de ativação do objeto CORBA WIOFile.
void	appendDescription(String description) Adiciona um texto à descrição atual do arquivo.
boolean	canRead() Verifica se o arquivo pode ser lido.
boolean	canWrite() Verifica se o arquivo pode ser escrito.
void	close() Fecha o arquivo físico.
csbase.server.services.wioservice.idl.WIODateTimeInfo	creationTime() Obtém a data de criação do arquivo.
protected void	deactivateCorbaFile() Método de desativação do objeto CORBA WIOFile.
void	destroy() Desativa o objeto objeto remoto, liberando os recursos associados .
boolean	eof() Verifica se o arquivo está posicionado no fim.
String	getDescription() Obtém a descrição associada a um arquivo.
csbase.server.services.wioservice.idl.WIOFile	getFile(int i) Obtém o i-ésimo objeto (arquivo ou diretório) contido neste WIOFile.
String	getFileType() Obtém o tipo do arquivo.
csbase.server.services.wioservice.idl.WIOFileMode	getMode() Obtém o modo no qual o arquivo se encontra.
int	getNumFiles() Obtém o número de objetos (arquivos ou diretórios) contidos neste WIOFile.
csbase.server.services.wioservice.idl.WIOFile	getParent() Obtém o diretório que contém este arquivo.
String	getPath() Obtém o caminho (path) deste arquivo.
csbase.server.services.wioservice.idl.WIOProject	getProject() Obtém o projeto ao qual pertence o arquivo.
boolean	isDirectory() Verifica se é um diretório.
boolean	isPublished() Verifica se este arquivo está publicado.
boolean	isUnderConstruction() Verifica se este arquivo está em construção.
csbase.server.services.wioservice.idl.WIODateTimeInfo	lastModificationTime() Obtém a data de última modificação do arquivo.
void	open(csbase.server.services.wioservice.idl.WIOFileMode mode) Abre o arquivo.
int	read(int numBytes, csbase.server.services.wioservice.idl.BytesHolder holder) Método de leitura remota.
void	resize(long size) Redimensiona o arquivo.
void	seek(long offset, csbase.server.services.wioservice.idl.SeekType type) Estabelece a posição corrente do arquivo.
void	setDescription(String desc) Associa uma a descrição ao arquivo.
long	size() Obtém o tamanho do arquivo.
long	tell() Obtém a posição corrente do arquivo.
String	toString()
String	whoCreated() Obtém a identificação do usuário que criou o arquivo.
int	write(byte[] content) Método de escrita remota.

Methods inherited from class csbase.server.services.wioservice.idl.WIOFilePOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

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

Constructor Detail

WIOServerFile

protected WIOServerFile(WIOServerProject serverProject,
             String serverPath)
                 throws Exception

Constrói o objeto que representa um arquivo remoto,

Parameters:

serverProject - o projeto que contém o arquivo

serverPath - o path do arquivo

Throws:

Exception - em caso de falha.

Method Detail

activateCorbaFile

protected POA activateCorbaFile()
                         throws Exception

Método de ativação do objeto CORBA WIOFile.

Returns:

.

Throws:

Exception - em caso de erro.

appendDescription

public void appendDescription(String description)
                       throws csbase.server.services.wioservice.idl.WIOServiceException

Adiciona um texto à descrição atual do arquivo.

Parameters:

description - o texto a ser adicionado à descrição do arquivo.

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

canRead

public boolean canRead()
                throws csbase.server.services.wioservice.idl.WIOServiceException

Verifica se o arquivo pode ser lido.

Returns:

true se o arquivo pode ser lido, false caso contrário

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

canWrite

public boolean canWrite()
                 throws csbase.server.services.wioservice.idl.WIOServiceException

Verifica se o arquivo pode ser escrito.

Returns:

true se o arquivo pode ser escrito, false caso contrário

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

close

public void close()
           throws csbase.server.services.wioservice.idl.WIOServiceException

Fecha o arquivo físico.

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

creationTime

public csbase.server.services.wioservice.idl.WIODateTimeInfo creationTime()
                                                                   throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém a data de criação do arquivo.

Returns:

a data de criação do arquivo, representada por um objeto WIODateTimeInfo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

deactivateCorbaFile

protected void deactivateCorbaFile()
                            throws Exception

Método de desativação do objeto CORBA WIOFile.

Throws:

Exception - em caso de erro.

destroy

public void destroy()
             throws csbase.server.services.wioservice.idl.WIOServiceException

Desativa o objeto objeto remoto, liberando os recursos associados .

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

eof

public boolean eof()
            throws csbase.server.services.wioservice.idl.WIOServiceException

Verifica se o arquivo está posicionado no fim.

Returns:

true se arquivo posicionado no fim, false caso contrário.

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getDescription

public String getDescription()
                      throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém a descrição associada a um arquivo.

Returns:

a descrição do arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getFile

public csbase.server.services.wioservice.idl.WIOFile getFile(int i)
                                                      throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o i-ésimo objeto (arquivo ou diretório) contido neste WIOFile.

Parameters:

i - o índice do objeto desejado. Esse índice deve estar entre 0 e N-1 (número máximo dado por getNumFiles).

Returns:

o arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getFileType

public String getFileType()
                   throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o tipo do arquivo.

Returns:

uma String que identifica o tipo do arquivo.

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getMode

public csbase.server.services.wioservice.idl.WIOFileMode getMode()
                                                          throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o modo no qual o arquivo se encontra.

Returns:

um objeto WIOFileMode que representa o modo atual do arquivo (NOT_OPENED, MODE_READ, MODE_WRITE)

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getNumFiles

public int getNumFiles()
                throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o número de objetos (arquivos ou diretórios) contidos neste WIOFile.

Returns:

o número de arquivos/diretóriosi contidos, ou 0 (zero) se este WIOFile representa um arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getParent

public csbase.server.services.wioservice.idl.WIOFile getParent()
                                                        throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o diretório que contém este arquivo.

Returns:

o objeto WIOFile que representa o diretório "pai"

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getPath

public String getPath()
               throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o caminho (path) deste arquivo.

Returns:

o path como uma string.

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

getProject

public csbase.server.services.wioservice.idl.WIOProject getProject()
                                                            throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o projeto ao qual pertence o arquivo.

Returns:

um objeto WIOProject que representa o projeto que contém o arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

isDirectory

public boolean isDirectory()
                    throws csbase.server.services.wioservice.idl.WIOServiceException

Verifica se é um diretório.

Returns:

true se é um diretório, false caso contrário

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

isPublished

public boolean isPublished()

Verifica se este arquivo está publicado. O mecanismo de publicação foi removido mas, para não alterarmos a IDL do WIO, este método foi mantido. Ele sempre retorna false, uma vez que não existe mais publicação.

Returns:

false

isUnderConstruction

public boolean isUnderConstruction()
                            throws csbase.server.services.wioservice.idl.WIOServiceException

Verifica se este arquivo está em construção.

Returns:

true se o arquivo está em construção, false caso contrário

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

lastModificationTime

public csbase.server.services.wioservice.idl.WIODateTimeInfo lastModificationTime()
                                                                           throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém a data de última modificação do arquivo.

Returns:

a data de modificação do arquivo, representada por um objeto WIODateTimeInfo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

open

public void open(csbase.server.services.wioservice.idl.WIOFileMode mode)
          throws csbase.server.services.wioservice.idl.WIOServiceException

Abre o arquivo.

Parameters:

mode - o modo no qual o arquivo deve ser aberto (leitura ou escrita)

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

read

public int read(int numBytes,
       csbase.server.services.wioservice.idl.BytesHolder holder)
         throws csbase.server.services.wioservice.idl.WIOServiceException

Método de leitura remota.

Parameters:

numBytes - número de bytes a serem lidos

holder - o buffer de leitura (usado na transferência dos dados via CORBA)

Returns:

o número de bytes efetivamente lidos

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

resize

public void resize(long size)
            throws csbase.server.services.wioservice.idl.WIOServiceException

Redimensiona o arquivo.

Parameters:

size - o novo tamanho do arquivo (em bytes)

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

seek

public void seek(long offset,
        csbase.server.services.wioservice.idl.SeekType type)
          throws csbase.server.services.wioservice.idl.WIOServiceException

Estabelece a posição corrente do arquivo. Essa nova posição é determinada pela soma de um deslocamento (offset) a uma posição "base" (inicio do arquivo, posição corrente, fim do arquivo).

Parameters:

offset - o deslocamento a ser somado à posição "base"

type - a posição "base", representada por um objeto do tipo SeekType

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

setDescription

public void setDescription(String desc)
                    throws csbase.server.services.wioservice.idl.WIOServiceException

Associa uma a descrição ao arquivo.

Parameters:

desc - a descrição do arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

size

public long size()
          throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém o tamanho do arquivo.

Returns:

o tamanho do arquivo, em número de bytes

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

tell

public long tell()
          throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém a posição corrente do arquivo.

Returns:

a posição corrente do arquivo, representada como um deslocamento (número de bytes) em relação ao início do arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

toString

public String toString()

Overrides:

toString in class Object

whoCreated

public String whoCreated()
                  throws csbase.server.services.wioservice.idl.WIOServiceException

Obtém a identificação do usuário que criou o arquivo.

Returns:

a identificação do usuário criador do arquivo

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.

write

public int write(byte[] content)
          throws csbase.server.services.wioservice.idl.WIOServiceException

Método de escrita remota.

Parameters:

content - conteúdo (sequência de bytes) a ser escrito a partir da posição corrente.

Returns:

o número de bytes escritos efetivamente

Throws:

csbase.server.services.wioservice.idl.WIOServiceException - em caso de erro.