Sidar, principal.
>>contenido
Fundación Sidar - Acceso Universal
Seminario SIDAR
Principal >> Aplicación: UAW >> Documentación de las clases java

uaw
Class Plana

java.lang.Object
  |
  +--uaw.Plana
Direct Known Subclasses:
CompostMarcs

public class Plana
extends java.lang.Object

Plana representa a nivel de programación cada una de las páginas reales del web. En la versión actual Plana sólo guarda información del título, hojas de estilo relacionadas y vínculos internos; en el caso de las páginas de definición de marcos también guarda información de la disposición espacial de los marcos.

Algunas de las operaciones de Plana se basan en los valores de BaseWeb, que habrá que inicializar préviamente.

Version:
1.0, 2004/06
Author:
Mireia Ribera
See Also:
wwww.w3.org/TR/xhtml1/xhtml1-strict.dtd, wwww.w3.org/TR/xhtml1/xhtml1-transitional.dtd, wwww.w3.org/TR/xhtml1/xhtml1-frameset.dtd

UML data model
legend graphical representation



Field Summary
protected static int comptadorPlanes
Contador para generar nombres de páginas correlativos de forma automática.
protected EstructuraDivisions ed
Si esta Plana corresponde a una página de definición de marcos en este campo se guarda la EstructuraDivisions correspondiente, resultado del analisis SAX realizado por el ContentHandler uaw.sensemarcs.AnalitzadorFramesets ; en caso contrario tiene valor nulo.
protected boolean esFrameset
Indica si el documento XHTML a partir del cual se ha creado esta Plana es una página de definición de marcos.
protected java.lang.String id
El identificador de la Plana (se recomienda usar su URI local absoluto).
StyleSheetListImpl llistaCSS
Una lista de todas las hojas de estilo asociadas a la Plana.
protected java.lang.String titol
Una cadena descriptiva del contenido de la Plana correspondiente al elemento title del documento XHTML.
protected UawURI uawUriOrig
La ubicación de la página original en el sistema de ficheros, indicada de forma absoluta.
protected UawURI uawUriRes
La ubicación de la página resultado en el sistema de ficheros, indicada de forma absoluta.
protected java.util.TreeMap vinclesLlegits
Los vínculos que contenía originalmente el documento XHTML correspondiente.
protected java.util.TreeMap vinclesPlana
Tabla que relaciona los vínculos originales del fichero XHTML con los objetos Plana vinculados creados por el programa.
Constructor Summary
Plana ()
Crea un objeto vacío.
Plana (java.net.URI uri)
A partir de la URI parsea el fichero y rellena los campos titol y vinclesLlegits.
Method Summary
protected void addVinclesLlegits (Vincle v)
Añade un Vincle a los vínculos leídos.
void addVinclesPlana (java.lang.String href, Plana plana)
Crea y guarda una nueva relación entre el vínculo original href y el objeto Plana.
void crearResultat (boolean relativizar)
Escribe el documento XHTML correspondiente a la Plana actual en el sistema de ficheros, y traduce los vínculos originales según las modificaciones realizadas por el programa.
protected void crearVinclesLlegits (org.w3c.dom.Element el, java.lang.String targetb)
Añade la información del vínculo a la lista de vínculos leídos de la Plana a partir de un elemento a, area o link.
void eliminarVinclePlana (java.lang.String href)
Elimina el vínculo referenciado por href de la lista de vínculos del objeto actual.
boolean esFrameset ()
Indica si el documento XHTML a partir del cual se ha creado esta Plana es una página de definición de marcos.
void generarId ()
Genera un identificador para Plana a partir de la dirección del fichero original.
EstructuraDivisions getEstructuraDivisions ()
Devuelve la EstructuraDivisions de la Plana.
java.lang.String getId ()
Devuelve el identificador de la Plana.
static java.lang.String getNouNomFitxer ()
Devuelve el nombre del fichero secuencial, según el modelo 'PlanaX.htm' donde X es un entero correlativo.
java.lang.String getTitol ()
Devuelve el título de la Plana.
UawURI getUawUriOrig ()
Devuelve la dirección UawURI correspondiente a la página original.
UawURI getUawUriRes ()
Devuelve la dirección UawURI correspondiente a la página resultado.
java.util.TreeMap getVinclesLlegits ()
Devuelve los vínculos que contenía originalmente el documento XHTML correspondiente.
java.util.TreeMap getVinclesPlana ()
Devuelve una tabla que relaciona los vínculos originales del fichero XHTML con los objetos Plana creados por programa.
void modificarVinclePlana (java.lang.String origen, Plana nuevaPlana)
Modifica el objeto relacionado inicialmente con origen por nuevaPlana.
void mostrar (java.io.PrintStream salida)
Método creado a efectos de depuración de código que simplemente muestra el contenido de los campos del objeto por el canal de salida especificado.
void setId (java.lang.String id)
Establece id como identificador de la Plana.
void setTitol (java.lang.String titulo)
Asigna la cadena titulo como titol de la Plana.
void setUawUriOrig (UawURI wUri)
Asigna la UawURI dada como ubicación original de la Plana.
void setUawUriRes ()
Asigna una UawURI generada automáticamente como ubicación de la Plana resultado.
void setUawUriRes (UawURI wUri)
Asigna la UawURI dada como ubicación destino de la Plana.
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

comptadorPlanes

protected static int comptadorPlanes

Contador para generar nombres de páginas correlativos de forma automática.


ed

protected EstructuraDivisions ed

Si esta Plana corresponde a una página de definición de marcos en este campo se guarda la EstructuraDivisions correspondiente, resultado del análisis SAX realizado por el ContentHandler uaw.sensemarcs.AnalitzadorFramesets ; en caso contrario tiene valor nulo

See Also:
uaw.sensemarcs.AnalitzadorFramesets

esFrameset

protected boolean esFrameset

Indica si el documento XHTML a partir del cual se ha creado esta Plana es una página de definición de marcos.


id

protected java.lang.String id

El identificador de la Plana (se recomienda usar su URI local absoluto).


llistaCSS

public StyleSheetListImpl llistaCSS

Una lista de todas las hojas de estilo asociadas a la Plana.


titol

protected java.lang.String titol

Una cadena descriptiva del contenido de Plana que se corresponde al elemento title del documento XHTML.


uawUriOrig

protected UawURI uawUriOrig

La ubicación de la página original en el sistema de ficheros, indicada de forma absoluta. Por ejemplo: 'c:\webs\prueba\plana30.htm'


uawUriRes

protected UawURI uawUriRes

La ubicación de la página resultado en el sistema de ficheros, indicada de forma absoluta. Por ejemplo: 'c:\webs\res\plana30.htm'


vinclesLlegits

protected java.util.TreeMap vinclesLlegits

Los vínculos que contenía originalmente el documento XHTML correspondiente. Se recomienda guardar sólo los vínculos internos. La lista no puede contener repeticiones.

El control de repeticiones se realiza a partir de la UawURI del fichero en local en el web original del objeto Vincle (el resultado de Vincle.getId()). Ello puede provocar problemas en los casos en que el texto de los vínculos originales no sea homogéneo: por ejemplo si el vínculo ../../pub/docs/hola.php y hola.php apuntan al mismo fichero, sólo uno de ellos aparecerá en la lista. Se prevé en versiones posteriores solucionar este caso.

Se recomienda añadir vínculos a la lista sólo a través de la función addVinclesLlegits, que por una parte independiza de la implementación, y por otra garantiza que no se produzcan repeticiones.

Esta lista, según los intereses de la aplicación, puede no ser exhaustiva.


vinclesPlana

protected java.util.TreeMap vinclesPlana

Tabla que relaciona los vínculos originales del fichero XHTML con los objetos Plana vinculados creados por programa. La lista no puede contener repeticiones, y el control de repeticiones se basa en el texto del vínculo original.

Se recomienda añadir vínculos a la lista sólo a través de la función addVinclesPlana, que por una parte independiza de la implementación, y por otra garantiza que no se produzcan repeticiones.

Constructor Detail

Plana

public Plana()

Crea un objeto vacío.


Plana

public Plana(java.net.URI uri)
      throws java.lang.NullPointerException,
             java.lang.IllegalArgumentException,
             UawException

A partir de la URI parsea el fichero y rellena los campos titol y vinclesLlegits. Si el documento XHTML original no tenia título este campo se rellena con la URI del fichero. Si el documento XHTML original es una página de definición de marcos crea la EstructuraDivisions correspondiente. Si en el documento XHTML se había definido un destino base para la página, este destino se tiene en cuenta en la creación de los vínculos.

Throws:
java.lang.NullPointerException - si uri es nulo
java.lang.IllegalArgumentException - si no se ha podido leer el fichero dado, o si no se ha podido parsear
UawException - si la configuración del Parser ha dado problemas
Method Detail

getNouNomFitxer

public static java.lang.String getNouNomFitxer()

Devuelve un nombre de fichero secuencial, según el modelo 'PlanaX.htm', donde X es un entero correlativo.


addVinclesLlegits

protected void addVinclesLlegits(Vincle v)
                          throws java.lang.NullPointerException

Añade un Vincle a los vínculos leídos. Se recomienda usar este método como única vía para añadir nuevos vínculos, ya que asegura la no repetición en la lista de vínculos leídos.

Si el vínculo ya pertenecía a la lista, simplemente no se añade, no se devuelve ninguna excepción.

Parameters:
v - El Vincle a añadir
Throws:
java.lang.NullPointerException - si v es nulo

addVinclesPlana

public void addVinclesPlana(java.lang.String href,
                            Plana plana)

Crea y guarda una nueva relación entre el vínculo original href y el objeto Plana.

Parameters:
href - el vínculo original en el fichero XHTML
plana - objeto que sustituirá el vínculo original

crearResultat

public void crearResultat(boolean relativizar)
                   throws UawException

Escribe el documento XHTML correspondiente a la Plana actual en el sistema de ficheros, y traduce los vínculos originales según las modificaciones hechas por el programa.

Si relativizar es TRUE los vínculos se relativizan en función de la dirección base resultado del web.

Throws:
UawException - si no se ha podido generar o escribir el resultado

crearVinclesLlegits

protected void crearVinclesLlegits(org.w3c.dom.Element el,
                                   java.lang.String targetb)
                            throws UawException

Añade la información del vínculo a la lista de vínculos leídos de la página a partir de un elemento a, area o link. En la versión actual no trata los vínculos javascript, y de los demás sólo añade los vínculos internos.

Parameters:
el - el elemento DOM correspondiente a una etiqueta XHTML a, area o link
targetb - una cadena con el valor del destino base de la página, si hay
Throws:
UawException - si no se ha podido crear alguno de los vínculos

eliminarVinclePlana

public void eliminarVinclePlana(java.lang.String href)

Elimina el vínculo referenciado por href de la lista de vínculos del objeto actual

Parameters:
href - el vínculo a eliminar

esFrameset

public boolean esFrameset()

Indica si el documento XHTML a partir del cual se ha creado esta página es una página de definición de marcos.


generarId

public void generarId()
               throws UawException

Genera un identificador para la página a partir de la dirección URL del fichero original

Throws:
UawException - si la dirección original no estaba definida

getEstructuraDivisions

public EstructuraDivisions getEstructuraDivisions()

Devuelve la EstructuraDivisions de la página.


getId

public final java.lang.String getId()

Devuelve el identificador de la página.


getTitol

public java.lang.String getTitol()

Devuelve el título de la página.


getUawUriOrig

public UawURI getUawUriOrig()

Devuelve la dirección UawURI correspondiente a la página original.


getUawUriRes

public UawURI getUawUriRes()

Devuelve la dirección UawURI correspondiente a la página resultado.


getVinclesLlegits

public java.util.TreeMap getVinclesLlegits()

Devuelve los vínculos que contenía originalmente el documento XHTML correspondiente.


getVinclesPlana

public java.util.TreeMap getVinclesPlana()

Devuelve una tabla que relaciona los vínculos originales del fichero XHTML con los objetos Plana creados por programa.


modificarVinclePlana

public void modificarVinclePlana(java.lang.String origen,
                                 Plana nuevaPagina)
                          throws java.lang.NullPointerException

Modifica el objeto relacionado inicialmente a origen por nuevaPagina.

Parameters:
origen - referencia a una URI tal y como se leyó en el fichero XHTML original
nuevaPagina - objeto Plana que sustituirá el destino original
Throws:
java.lang.NullPointerException - si origen o nuevaPagina son nulos
java.lang.IllegalArgumentException - si origen no pertenece al documento original o no es interno

mostrar

public void mostrar(java.io.PrintStream salida)

Método creado a efectos de depuración del código que simplemente muestra el contenido de los campos del objeto por el canal de salida especificado.


setId

public void setId(java.lang.String id)

Establece id como identificador de la página.

Parameters:
id - un identificador para la página

setTitol

public void setTitol(java.lang.String titulo)

Asigna la cadena titulo como título de la página.


setUawUriOrig

public void setUawUriOrig(UawURI wUri)

Asigna la UawURI dada como ubicación original de la página.


setUawUriRes

public void setUawUriRes()
                  throws UawException

Asigna una UawURI generada automáticamente como ubicación de la página resultado.

UawException

setUawUriRes

public void setUawUriRes(UawURI wUri)

Asigna la UawURI dada como ubicación destino de la página.