Fundación Sidar: UAW. Javadocs. EstructuraDivisions

Packages
org.w3c.tidy
uaw
uaw.fullesEstil
uaw.sensemarcs
uaw.tidy
uaw.util

uaw

Classes
BaseWeb
BaseWebContentHandler
Caixa
Configuracio
EstructuraDivisions
FramesetContentHandler
LlistaPlanes
Plana
UawConfiguracio
UawDOMSAX
Vincle
Web

Exceptions
SAXUawException
UawException

Overview

Package

Class

Tree

Deprecated

Help

PREV CLASS NEXT CLASS

SUMMARY: NESTED | UML | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

uaw
Class EstructuraDivisions

java.lang.Object
  |
  +--com.steadystate.css.dom.CSSStyleSheetImpl
        |
        +--uaw.EstructuraDivisions

All Implemented Interfaces:: org.w3c.dom.css.CSSStyleSheet, java.io.Serializable, org.w3c.dom.stylesheets.StyleSheet

public class EstructuraDivisions
extends com.steadystate.css.dom.CSSStyleSheetImpl

EstructuraDivisions es una particularización de hoja de estilo especializada en guardar la información de compaginación de una página XHTML. La información se guarda en una estructura de árbol, en la que los nodos son reglas CSS (de la clase Caixa), cada una con unas propiedades básicas de posicionamiento.

Las subdivisiones verticales (filas) se realizan por cajas posicionadas de forma relativa (es decir, si se rebasa el tamaño previso, las cajas posteriores se desplazaran para acomodar el contenido adicional); las subdivisiones horizontales se realizan por cajas posicionadas de forma absoluta.

Version:: 1.0, 2004/06
Author:: Mireia Ribera
See Also:: uaw.Caixa , especificació CSS2, Serialized Form

UML data model
legend	`graphical representation`

Field Summary
`private static int`	`comptadorFullesEstil` Contador para generar nombres de hojas de estilo correlativos de forma automática.
`protected java.lang.String`	`id` Identificador de la `EstructuraDivisions`.
`static java.lang.String`	`nomDirectori`
`static java.lang.String`	`nomFullesEstil`
`protected java.util.Stack`	`pilaCaixes` La estructura real donde se guarda la información.
`private int`	`posicioSel` Número de orden del marco seleccionado para leer los datos básicos de la página conjunta (título, nombre de fichero, metadatos...).
`private static int`	`posicioSelDefecte` El valor per defecto de posicioSel en caso de no establecerse por programa.

Fields inherited from class com.steadystate.css.dom.CSSStyleSheetImpl

Constructor Summary
`EstructuraDivisions ()` Crea una `EstructuraDivisions` vacía.

Method Summary
`boolean`	`buida ()` Indica si la `EstructuraDivisions` contiene cajas o no.
`java.lang.Object`	`clone ()`
`void`	`colsInicials (java.util.Stack pilaCaixes)` Inicializa la `EstructuraDivisions` haciendo subdivisiones horizontales según las medidas y posicionamiento dados en `pilaCaixes`.
`void`	`colsTots (java.util.Stack pilaCaixes)` Crea subdivisiones horizontales en todas las cajas de la `EstructuraDivisions` inicial según las medidas y posicionamiento dados en `pilaCaixes`.
`void`	`crearSubdivisio (java.lang.String nombre, EstructuraDivisions ed)` Divide la caja de nombre `nombre` ya existente en la `EstructuraDivisions` según las divisiones d'`ed` y la convierte en una caja contenedora.
`void`	`deleteRule (int index)` Borra la regla de índice `index` siempre y cuando no sea una regla generada dentro del mismo programa.
`boolean`	`esFill (java.lang.String nombre, java.lang.String nombrePadre)` Indica si la caja de nombre `nombre` es una subdivisión de la caja de nombre `nombrePadre`.
`void`	`fusionar (EstructuraDivisions ed)` Divide la primera caja de contenido según las divisiones de `ed` y la convierte en una caja contenedora.
`void`	`generarId ()` Genera un identificador de la `EstructuraDivisions`.
`Caixa`	`getCaixa ()` Devuelve la última caja y la borra de la `EstructuraDivisions` , o si no hay ninguna devuelve null.
`Caixa`	`getCaixa (java.lang.String nombre)` Devuelve la caja de nombre `nombre` si existe, o null en caso contrario.
`static int`	`getComptadorFullesEstil ()` Devuelve un número secuencial que se usará en la generación de nombres de hojas de estilo.
`org.w3c.dom.css.CSSRuleList`	`getCssRules ()` Recupera las reglas CSS que componen la hoja de estilo.
`EstructuraDivisions`	`getEstructuraPare (java.lang.String nombre)` Devuelve una `EstructuraDivisions` idéntica en la que se han podado el hijo (caja `nombre`) y todos sus hermanos.
`java.lang.String`	`getHref ()` Devuelve el nombre del fichero de la hoja de estilo.
`java.lang.String`	`getId ()` Devuelve el identificador de la `EstructuraDivisions`.
`protected java.util.Iterator`	`getIterator ()` Devuelve un iterador para recorrer `EstructuraDivisions` en preorden.
`java.lang.String`	`getPare (java.lang.String nombre)` Indica el nombre de la caja que contiene la caja `nombre`, es decir, su nodo padre.
`java.util.Stack`	`getPila ()`
`int`	`getPosicioSel ()` Devuelve el número de orden de la caja de contenido correspondiente al marco seleccionado.
`void`	`guardar ()` Serializa la hoja de estilo en sintaxis CSS en el sistema de ficheros.
`void`	`mostrar (java.io.PrintStream sortida)` Método creado a efectos de depuración de código que simplemente muestra el contenido del objeto por el canal de salida especificado.
`void`	`mostrarCSS (java.io.PrintStream sortida)` Presenta los valores de las propiedades de todas las cajas según la sintaxis CSS y las muestra por el canal de salida especificado.
`void`	`putCaixa (Caixa c)` Añade la caja `c` a la `EstructuraDivisions`.
`void`	`rowsInicials (java.util.Stack pilaCaixes)` Inicializa la EstructuraDivisions haciendo subdivisiones verticales según las medidas dadas en `pilaCaixes`.
`void`	`setHref ()` Asigna un nombre de fichero a la hoja, seguiendo el modelo 'estilX.css' en el que X es un entero correlativo.
`void`	`setPosicioSel (int i)` Establece el marco seleccionado como el designado por la caja de tipo `CONTINGUT` de orden `i`.
`void`	`setPosicioSel (java.lang.String nomPosicio)` Establece el marco seleccionado como el designado por la caja de tipo `CONTINGUT` de nombre `nomPosicio`.

Methods inherited from class com.steadystate.css.dom.CSSStyleSheetImpl

getDisabled, getMedia, getOwnerNode, getOwnerRule,
            getParentStyleSheet, getTitle, getType, insertRule,
            isReadOnly, setDisabled, setHref, setMedia, setOwnerNode,
            setOwnerRule, setParentStyleSheet, setReadOnly,
            setRuleList, setTitle, toString

Methods inherited from class java.lang.Object

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

Field Detail

comptadorFullesEstil

private static int comptadorFullesEstil

Contador para generar nombres de hojas de estilo correlativos de forma automática.

nomDirectori

public static final java.lang.String nomDirectori

See Also:: Constant Field Values

nomFullesEstil

public static final java.lang.String nomFullesEstil

See Also:: Constant Field Values

posicioSelDefecte

private static final int posicioSelDefecte

El valor por defecto de posicioSel si no se ha establecido por programa.

See Also:: Constant Field Values

id

protected java.lang.String id

Identificador de la EstructuraDivisions.

pilaCaixes

protected java.util.Stack pilaCaixes

La estructura real en la que se guarda la información.

posicioSel

private int posicioSel

Marco seleccionado para leer los datos básicos de la página conjunta (título, nombre de fichero, metadatos...).

Constructor Detail

EstructuraDivisions

public EstructuraDivisions()

Crea una EstructuraDivisions vacía.

Method Detail

getComptadorFullesEstil

public static int getComptadorFullesEstil()

Devuelve un número secuencial que se usará en la generación de nombres de hojas de estilo.

buida

public boolean buida()

Indica si la EstructuraDivisions contiene cajas o no.

clone

public java.lang.Object clone()

Overrides:: clone in class java.lang.Object

colsInicials

public void colsInicials(java.util.Stack pilaCaixes)
                  throws java.lang.NullPointerException,
                         java.lang.IllegalArgumentException,
                         UawException

Inicializa la EstructuraDivisions creando subdivisiones horitzontales según las medidas y posicionamiento dados en pilaCaixes. El árbol resultante tendrá tantas hojas como objetos en pilaCaixes y cada una de ellas representará una columna en la compaginación.

Parameters:: pilaCaixes - una pila con las cajas correspondientes a las columnas.
Throws:: java.lang.NullPointerException - si pilaCaixes es nula; UawException - si la EstructuraDivisions actual esta vacía; java.lang.IllegalArgumentException - si pilaCaixes no es una pila de Cajas.

colsTots

public void colsTots(java.util.Stack pilaCaixes)
              throws java.lang.NullPointerException,
                     java.lang.IllegalArgumentException,
                     UawException

Crea subdivisiones horizontales en todas las cajas de la EstructuraDivisions inicial según las medidas y posicionamiento dados en pilaCaixes.

Parameters:: pilaCaixes - una pila con las cajas correspondientes a las columnas
Throws:: java.lang.NullPointerException - si pilaCaixes es nula; java.lang.IllegalArgumentException - si pilaCaixes no es una pila de cajas.; UawException - si la EstructuraDivisions actual esta vacía

crearSubdivisio

public void crearSubdivisio(java.lang.String nombre,
                            EstructuraDivisions ed)
                     throws java.lang.NullPointerException,
                            UawException

Divide la Caixa de nombre nombre ya existente en EstructuraDivisions según las divisiones de ed y la convierte en una caja contenedora.

Crear una división en este contexto significa que las cajas de ed seran hijas de la caja nombre y que sus coordenadas y medidas se tomarán en relación a la caja nombre.

Parameters:: nombre - la caja a subdividir; ed - las divisiones a realizar
Throws:: java.lang.NullPointerException - si nombre o ed son nulos; UawException - si se pretende crear una subdivisión a '_top' cuando ya existen divisiones, o bien si el nombre de la caja a dividir no existe.

deleteRule

public void deleteRule(int index)
                throws org.w3c.dom.DOMException

Borra la regla de índice index siempre y cuando no sea una regla generada dentro del programa.

Specified by:: deleteRule in interface org.w3c.dom.css.CSSStyleSheet
Overrides:: deleteRule in class com.steadystate.css.dom.CSSStyleSheetImpl

Parameters:: index - índice de la regla a borrar
Throws:: org.w3c.dom.DOMException - si índice no corresponde a una regla CSS parseada.

esFill

public boolean esFill(java.lang.String nombre,
                      java.lang.String nombrePadre)
               throws java.lang.NullPointerException,
                      UawException

Indica si la caja de nombre nombre es una subdivisión de la caja de nombre nombrePadre.

Throws:: java.lang.NullPointerException - si nombre o nombrePadre son nulos.; UawException - si no existe ninguna caja de nombre nombre

fusionar

public void fusionar(EstructuraDivisions ed)
              throws java.lang.NullPointerException,
                     java.lang.IllegalArgumentException,
                     UawException

Divide la primera caja de contenido según las divisiones de ed y la convierte en una caja contenedora.

Parameters:: ed - las divisiones a crear
Throws:: UawException - si no hay ninguna caja de contenido; java.lang.NullPointerException - si ed es nula; java.lang.IllegalArgumentException - si ed está vacía
See Also:: crearSubdivisio para una explicación más detallada

generarId

public void generarId()

Genera un identificador para la EstructuraDivisions.

Since:: versio 1.0, id esta formado por los nombres de las cajas de la EstructuraDivisions que no han sido creadas por programa.

getCaixa

public Caixa getCaixa()

Devuelve la última caja y la borra de la EstructuraDivisions , o en caso de que no haya ninguna devuelve null.

getCaixa

public Caixa getCaixa(java.lang.String nombre)
               throws java.lang.NullPointerException

Devuelve la caja de nombre nombre si existe, o null en caso contrario

Throws:: java.lang.NullPointerException - si nombre es nulo

getCssRules

public org.w3c.dom.css.CSSRuleList getCssRules()

Recupera las reglas CSS que componen la hoja de estilo.

Specified by:: getCssRules in interface org.w3c.dom.css.CSSStyleSheet
Overrides:: getCssRules in class com.steadystate.css.dom.CSSStyleSheetImpl

getEstructuraPare

public EstructuraDivisions getEstructuraPare(java.lang.String nombre)
                                      throws java.lang.NullPointerException,
                                             UawException

Devuelve una EstructuraDivisions idéntica en la que se han podado el hijo (Caja de nombre nombre) y todos sus hermanos.

Returns:: l'EstructuraDivisions correspondiente a eliminar la caja nombre y todos sus hermanos
Throws:: java.lang.NullPointerException - si nombre es nulo.; UawException - si no existe ninguna caja de nombre nombre

getHref

public java.lang.String getHref()

Devuelve el nombre del fichero de la hoja de estilo. Si no se había definido se genera de forma automática según el modelo 'estilX', en el que X es un entero correlativo.

Specified by:: getHref in interface org.w3c.dom.stylesheets.StyleSheet
Overrides:: getHref in class com.steadystate.css.dom.CSSStyleSheetImpl

getId

public java.lang.String getId()

Devuelve el identificador de la EstructuraDivisions.

getIterator

protected java.util.Iterator getIterator()

Devuelve un iterador para recorrer la EstructuraDivisions en preorden.

getPare

public java.lang.String getPare(java.lang.String nombre)
                         throws java.lang.NullPointerException,
                                UawException

Indica el nombre de la caja que contiene a la caja nombre, es decir, su nodo padre.

Returns:: el nombre de la caja contenedora de nombre
Throws:: java.lang.NullPointerException - si nombre es nulo.; UawException - si no existe ninguna caja de nombre nombre

getPila

public java.util.Stack getPila()

getPosicioSel

public int getPosicioSel()

Devuelve el número de orden de la caja de contenido correspondiente al marco seleccionado.

guardar

public void guardar()
             throws UawException

Serializa la hoja de estilo con sintaxis CSS en el sistema de ficheros.

UawException

mostrar

public void mostrar(java.io.PrintStream sortida)

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

Parameters:: sortida - canal de salida por el que mostrar los campos. Si es nulo, se toma como salida el canal por defecto.

mostrarCSS

public void mostrarCSS(java.io.PrintStream sortida)

Presenta los valores de las propiedades de todas las cajas según la sintaxis CSS y los muestra por el canal de salida especificado. Las cajas de tipo TANCAMENT no se muestran.

Parameters:: sortida - canal de salida por el que mostrar los campos; si es nulo se toma el canal de salida por defecto del programa.
See Also:: uaw.Caixa

putCaixa

public void putCaixa(Caixa c)
              throws java.lang.NullPointerException

Añade la caja c a la EstructuraDivisions.

Parameters:: c - Una caja a incluir en la EstructuraDivisions
Throws:: java.lang.NullPointerException - si c es nula

rowsInicials

public void rowsInicials(java.util.Stack pilaCaixes)
                  throws java.lang.NullPointerException,
                         java.lang.IllegalArgumentException,
                         UawException

Inicializa la EstructuraDivisions creando subdivisiones verticales según las medidas dadas en pilaCaixes.

Parameters:: pilaCaixes - una pila con las cajas correspondientes a las filas
Throws:: java.lang.NullPointerException - si pilaCaixes es nula; java.lang.IllegalArgumentException - si pilaCaixes no es una pila de cajas; UawException - si la EstructuraDivisions no estava vacía

setHref

public void setHref()

Asigna un nombre de fichero a la hoja de estilo, según el modelo 'estilX.css', en el que X es un entero correlativo.

Como efecto lateral si no existía un directorio base para las hojas de estilo definido en BaseWeb , este se establece en nomDirectori dentro del directorio base del web resultado.

setPosicioSel

public void setPosicioSel(int i)

Establece el marco seleccionado como la caja de tipo CONTINGUT de orden i.

Si i no es un valor correcto se comunica al Informe de Excepciones y se establece el valor en 1, que corresponde al segundo marco, usualmente el de contenido.

Parameters:: i - el número de orden de la caja de contenido correspondiente al marco seleccionado.

setPosicioSel

public void setPosicioSel(java.lang.String nomPosicio)
                   throws java.lang.NullPointerException

Establece el marco seleccionado como la caja de tipo CONTINGUT de nombre nomPosicio.

Si nomPosicio no es un valor correcto se comunica al Informe de Excepciones y se establece el valor en el segundo marco, usualmente el de contenido.

Parameters:: nomPosicio - el nombre de la caja de contenido correspondiente al marco seleccionado.
Throws:: java.lang.NullPointerException - si nomPosicio es nulo.

Overview

Package

Class

Tree

Deprecated

Help

PREV CLASS NEXT CLASS

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

uaw Class EstructuraDivisions

comptadorFullesEstil

nomDirectori

nomFullesEstil

posicioSelDefecte

id

pilaCaixes

posicioSel

EstructuraDivisions

getComptadorFullesEstil

buida

clone

colsInicials

colsTots

crearSubdivisio

deleteRule

esFill

fusionar

generarId

getCaixa

getCaixa

getCssRules

getEstructuraPare

getHref

getId

getIterator

getPare

getPila

getPosicioSel

guardar

mostrar

mostrarCSS

putCaixa

rowsInicials

setHref

setPosicioSel

setPosicioSel

uaw
Class EstructuraDivisions