it.eng.spago.base
Class BaseContainer

java.lang.Object
  extended byit.eng.spago.base.AbstractXMLObject
      extended byit.eng.spago.base.BaseContainer
All Implemented Interfaces:
CloneableObject, java.io.Serializable, XMLObject
Direct Known Subclasses:
ApplicationContainer, RequestContainer, ResponseContainer, SessionContainer

public class BaseContainer
extends AbstractXMLObject
implements CloneableObject, java.io.Serializable

La classe BaseContainer implementa un contenitore di oggetti. Ogni oggetto memorizzato nel contenitore è associato ad una chiave che ne consente il recupero. Un solo oggetto può essere memorizzato con una data chiave. Un BaseContainer può essere annidato all'interno di un altro BaseContainer.

Il contenitore è in grado di ritornare una sua rappresentazione XML.

Un esempio d'uso è il seguente:

 BaseContainer inner = new BaseContainer();
 inner.setAttribute("param1", "value1");
 BaseContainer outer = new BaseContainer();
 outer.setAttribute("param2", "value2");
 outer.setParent(inner);
 

See Also:
RequestContainer, SessionContainer, ApplicationContainer, ResponseContainer, Serialized Form

Constructor Summary
BaseContainer()
          Costruisce un BaseContainer vuoto.
BaseContainer(BaseContainer container)
          Costruisce un BaseContainer copia di container.
 
Method Summary
 CloneableObject cloneObject()
          Ritorna un BaseContainer copia dell'oggetto stesso.
 void delAttribute(java.lang.String key)
          Elimina l'attributo con chiave key.
 void delParent()
          Elimina il BaseContainer annidato.
 java.lang.Object getAttribute(java.lang.String key)
          Ritorna il valore dell'attributo con chiave key cercandolo nel BaseContainer corrente e nei BaseContainer annidati.
 java.util.ArrayList getAttributeNames()
           
protected  java.util.ArrayList getAttributeNames(java.util.ArrayList attributeNames, java.util.ArrayList attributeDeletedNames)
           
 BaseContainer getParent()
          Ritorna il BaseContainer annidato.
protected  java.lang.Object oneStepGetAttribute(java.lang.String key)
          Ritorna il valore dell'attributo con chiave key cercandolo nel BaseContainer corrente e non nei BaseContainer annidati.
 void setAttribute(java.lang.String key, java.lang.Object value)
          Imposta o modifica il valore dell'attributo con chiave key con il nuovo valore value nel BaseContainer corrente.
 void setContainer(BaseContainer container)
          Sostituisce il contenuto del BaseContainer corrente con container.
 void setParent(BaseContainer container)
          Imposta o modifica il BaseContainer annidato con parent.
 org.w3c.dom.Element toElement(org.w3c.dom.Document document)
          Ritorna un oggetto di tipo Element che verrą utilizzato nella rappresentazione in XML dell'oggetto.
 
Methods inherited from class it.eng.spago.base.AbstractXMLObject
toDocument, toXML, toXML, toXML, toXML
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

BaseContainer

public BaseContainer()
Costruisce un BaseContainer vuoto.

See Also:
BaseContainer(BaseContainer)

BaseContainer

public BaseContainer(BaseContainer container)
Costruisce un BaseContainer copia di container.

Parameters:
container - BaseContainer da copiare
See Also:
BaseContainer()
Method Detail

cloneObject

public CloneableObject cloneObject()
Ritorna un BaseContainer copia dell'oggetto stesso.

Specified by:
cloneObject in interface CloneableObject
Returns:
una copia del BaseContainer stesso

oneStepGetAttribute

protected java.lang.Object oneStepGetAttribute(java.lang.String key)
Ritorna il valore dell'attributo con chiave key cercandolo nel BaseContainer corrente e non nei BaseContainer annidati.

Parameters:
key - chiave dell'attributo
Returns:
null se l'attributo non esiste, altrimenti il valore associato.
See Also:
getAttribute(String)

getAttribute

public java.lang.Object getAttribute(java.lang.String key)
Ritorna il valore dell'attributo con chiave key cercandolo nel BaseContainer corrente e nei BaseContainer annidati.

Parameters:
key - chiave dell'attributo
Returns:
null se l'attributo non esiste, altrimenti il valore associato.
See Also:
oneStepGetAttribute(String), setAttribute(String, Object), delAttribute(String)

getAttributeNames

public java.util.ArrayList getAttributeNames()

getAttributeNames

protected java.util.ArrayList getAttributeNames(java.util.ArrayList attributeNames,
                                                java.util.ArrayList attributeDeletedNames)

setAttribute

public void setAttribute(java.lang.String key,
                         java.lang.Object value)
Imposta o modifica il valore dell'attributo con chiave key con il nuovo valore value nel BaseContainer corrente.

Parameters:
key - chiave dell'attributo
value - valore dell'attributo
See Also:
getAttribute(String), delAttribute(String)

delAttribute

public void delAttribute(java.lang.String key)
Elimina l'attributo con chiave key.

Parameters:
key - chiave dell'attributo
See Also:
getAttribute(String), setAttribute(String, Object)

setContainer

public void setContainer(BaseContainer container)
Sostituisce il contenuto del BaseContainer corrente con container.

Parameters:
container - BaseContainer da copiare

getParent

public BaseContainer getParent()
Ritorna il BaseContainer annidato.

Returns:
null se il BaseContainer annidato non esiste, altrimenti il BaseContainer annidato.
See Also:
setParent(BaseContainer), delParent()

setParent

public void setParent(BaseContainer container)
Imposta o modifica il BaseContainer annidato con parent.

Parameters:
container - BaseContainer annidato
See Also:
getParent(), delParent()

delParent

public void delParent()
Elimina il BaseContainer annidato.

See Also:
getParent(), setParent(BaseContainer)

toElement

public org.w3c.dom.Element toElement(org.w3c.dom.Document document)
Description copied from interface: XMLObject
Ritorna un oggetto di tipo Element che verrą utilizzato nella rappresentazione in XML dell'oggetto.

Specified by:
toElement in interface XMLObject
Returns:
Document un oggetto di tipo Document.