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

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.