jpel.util.dataholder
Class DataHolderURL

java.lang.Object
  |
  +--jpel.util.dataholder.AbstractDataHolder
        |
        +--jpel.util.dataholder.DataHolderURL
All Implemented Interfaces:
DataHolder

public class DataHolderURL
extends AbstractDataHolder

Implementação de uma fonte de recursos para URLs.


Field Summary
 
Fields inherited from interface jpel.util.dataholder.DataHolder
BINARYSTREAM, CHARACTERSTREAM, DATE_UNKNOWN, FILE, OTHER, URL
 
Constructor Summary
DataHolderURL(java.lang.String url)
           
DataHolderURL(java.net.URL url)
           
 
Method Summary
 void close()
          Libera todos os recursos utilizados pela fonte de recursos.
 boolean equals(java.lang.Object obj)
           
 java.io.InputStream getInputStream()
          Retorna o buffer binário associado a fonte de recursos.
 java.io.OutputStream getOutputStream()
          Retorna o buffer binário associado a fonte de recursos.
 java.io.Reader getReader()
          Retorna um buffer de caracteres associado a fonte de recursos.
 java.lang.Object getReference()
          Retorna o objeto java associado a fonte de recursos.
 java.net.URL getURL()
           
 java.io.Writer getWriter()
          Retorna um buffer de caracteres associado a fonte de recursos.
 long lastModified()
          Retorna data da última modificação feita nos dados.
static void main(java.lang.String[] args)
           
 jpel.util.dataholder.DataHolder relative(jpel.util.dataholder.DataHolder absolute)
          Converte uma referencia absoluta em uma referência relativa a este manipulador.
 jpel.util.dataholder.DataHolder resolve(jpel.util.dataholder.DataHolder relative)
          Quando há a utilização de recursos com relação entre si pode haver a necessidade de resolução de nomes relativos.
 void setReference(java.lang.Object reference)
          Ajusta o objeto usado como referencia pela pelo manipulador de dados.
 void setURL(java.net.URL newURL)
           
 java.lang.String toString()
           
 
Methods inherited from class jpel.util.dataholder.AbstractDataHolder
getBInputStream, getBOutputStream, getBReader, getBWriter, getType, setBInputStream, setBOutputStream, setBReader, setBWriter, setType
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DataHolderURL

public DataHolderURL(java.lang.String url)
              throws java.net.MalformedURLException

DataHolderURL

public DataHolderURL(java.net.URL url)
Method Detail

setURL

public void setURL(java.net.URL newURL)

getURL

public java.net.URL getURL()

setReference

public void setReference(java.lang.Object reference)
Description copied from interface: DataHolder
Ajusta o objeto usado como referencia pela pelo manipulador de dados.

Specified by:
setReference in interface DataHolder
Overrides:
setReference in class AbstractDataHolder
Parameters:
reference - Referência do manipulador de dados.

getReference

public java.lang.Object getReference()
Description copied from interface: DataHolder
Retorna o objeto java associado a fonte de recursos. No caso do tipo FILE pode ser um java.io.File, no caso do tipo URL um objeto java do tipo java.net.URL.

Specified by:
getReference in interface DataHolder
Overrides:
getReference in class AbstractDataHolder
Returns:
O objeto Java utilizado.

resolve

public jpel.util.dataholder.DataHolder resolve(jpel.util.dataholder.DataHolder relative)
                                        throws DataHolderException
Description copied from interface: DataHolder
Quando há a utilização de recursos com relação entre si pode haver a necessidade de resolução de nomes relativos. Por exemplo, a relação entre arquivos.

Parameters:
relative - O recurso ao qual se deseja resolver para o universo do recurso atual.
Por exemplo: Se a fonte atual de recursos(a) fosse o arquivo examples/full/name.cfg e houvesse outra fonte de recursos(b) com o nome ../resource.cfg, após a aplicação do a.resolve(b) haveria um fonte de recursos com uma referência para o arquivo examples/resource.cfg.
Returns:
A nova fonte de recursos resolvida.
Throws:
DataHolderException - Quando não é possível construir esta nova fonte de recursos.

relative

public jpel.util.dataholder.DataHolder relative(jpel.util.dataholder.DataHolder absolute)
                                         throws DataHolderException
Description copied from interface: DataHolder
Converte uma referencia absoluta em uma referência relativa a este manipulador.

Parameters:
absolute - Referência absoluta a ser convertida.
Por exemplo: Se a fonte atual de recursos(a) fosse o arquivo c:/examples/full/name.cfg e houvesse outra fonte de recursos(b) com o nome c:/subdir/resource.cfg, após a aplicação do a.relative(b) haveria um fonte de recursos com uma referencia para o arquivo ../../subdir/resource.cfg.
Returns:
A fonte de dados relativa.
Throws:
DataHolderException - Quando não é possível construir esta nova fonte de recursos.

lastModified

public long lastModified()
Description copied from interface: DataHolder
Retorna data da última modificação feita nos dados.

Returns:
O tempo em milisegundos da ultima modificação.

getInputStream

public java.io.InputStream getInputStream()
                                   throws DataHolderException
Description copied from interface: DataHolder
Retorna o buffer binário associado a fonte de recursos.

Returns:
Um buffer p/a leitura do recurso.
Throws:
DataHolderException - Quando há erro no fornecimento deste buffer.

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws DataHolderException
Description copied from interface: DataHolder
Retorna o buffer binário associado a fonte de recursos.

Returns:
Um buffer p/a escrita no recurso.
Throws:
DataHolderException - Quando há erro no fornecimento deste buffer.

getReader

public java.io.Reader getReader()
                         throws DataHolderException
Description copied from interface: DataHolder
Retorna um buffer de caracteres associado a fonte de recursos.

Returns:
Um buffer p/leitura do recurso.
Throws:
DataHolderException - Quando há erro no fornecimento deste buffer.

getWriter

public java.io.Writer getWriter()
                         throws DataHolderException
Description copied from interface: DataHolder
Retorna um buffer de caracteres associado a fonte de recursos.

Returns:
Um buffer p/escrita no recurso.
Throws:
DataHolderException - Quando há erro no fornecimento deste buffer.

close

public void close()
           throws DataHolderException
Description copied from interface: DataHolder
Libera todos os recursos utilizados pela fonte de recursos.

Specified by:
close in interface DataHolder
Overrides:
close in class AbstractDataHolder
Throws:
DataHolderException - Quando há falha na liberação de recursos.

equals

public boolean equals(java.lang.Object obj)
Overrides:
equals in class java.lang.Object

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

main

public static void main(java.lang.String[] args)