Overview Package Class Tree Deprecated Help
PREV CLASS NEXT CLASS
SUMMARY: NESTED | UML | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

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.

---

Overview Package Class Tree Deprecated Help
PREV CLASS NEXT CLASS
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---