paolomind.commons.xml
Class XMLObjectContainer

java.lang.Object
  paolomind.commons.xml.XMLObjectContainer

All Implemented Interfaces:

ObjectContainer

public class XMLObjectContainer
extends java.lang.Object
implements ObjectContainer

classe di ogetti che si preoccupano di leggere uno stream di dati in formato XML e ne ricavo degli ogetti. Si consiglia nel file XML di aggiungere alla fine il seguente codice per mappare gli ogetti desiderati:

   <void property="owner">
   <void method="register">
   <string>integer</string>
   <object idref="num" />
   </void>
   </void>
 

owner è questo stesso oggetto

register è il metodo per registrare gli oggetti

la prima stringa è l'argomento chiave,l'identificativo dell'oggetto

il secondo argomento è l'ogetto da mappare

Author:

paolo

See Also:

java.beans.XMLDecoder,

Constructor Summary

XMLObjectContainer()
costruttore vuoto che inizializza la hashmap.

XMLObjectContainer(java.io.InputStream in, XMLListener l)
costruttore che si occupa di interpretare lo stream di input.

XMLObjectContainer(java.io.InputStream in, XMLListener l, java.lang.ClassLoader cl)
costruttore che si occupa di interpretare lo stream di input.

XMLObjectContainer(XMLListener l, java.lang.ClassLoader cl)
costruttore di inizializzazione.

Method Summary

java.lang.Object	get(java.lang.String name) reperisce un elemento registrato.
java.util.Iterator	getAll() restituisce tutti gli elementi.
java.util.Iterator	getIds() restituisce tutti gli identificativi registrati.
protected XMLListener	getListener() restituisce il listener associato.
protected java.util.Map	getObjectmap() restituisce la mappa degli oggetti registrati.
java.io.InputStream	getResourceAsStream(java.lang.String name) restituisce una risorsa ricavandola dal class loader.
java.io.InputStream	getStreamFromUrl(java.lang.String url) apre uno stream da una url specificata come una stringa.
java.io.InputStream	getStreamFromUrl(java.net.URL url) apre uno stream da una url specificata.
void	read(java.io.InputStream in) interpreta da uno stream l'oggetto .
void	register(NamedObject element) registra un ogetto.
void	register(java.lang.String name, java.lang.Object o) registra un ogetto associandolo alla chiave specificata.
boolean	select(java.lang.String name) Deprecated.
void	setListener(XMLListener plistener) setta il listener per la gestione di eventi prevedibili.
void	setLoader(java.lang.ClassLoader ploader) setta il classloader per caricare risorse eventualmente richieste.
protected void	setObjectmap(java.util.Map pobjectmap) setta la mappa degli oggetti registrati.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLObjectContainer

public XMLObjectContainer()

costruttore vuoto che inizializza la hashmap.

XMLObjectContainer

public XMLObjectContainer(java.io.InputStream in,
                          XMLListener l)

costruttore che si occupa di interpretare lo stream di input.

Parameters:

in - stream di input (uno stream con formato XML)

l - il listner degli eventi

XMLObjectContainer

public XMLObjectContainer(java.io.InputStream in,
                          XMLListener l,
                          java.lang.ClassLoader cl)

costruttore che si occupa di interpretare lo stream di input.

Parameters:

in - stream di input (uno stream con formato XML)

l - il listner degli eventi

cl - il classloader da cui caricare le risorse

XMLObjectContainer

public XMLObjectContainer(XMLListener l,
                          java.lang.ClassLoader cl)

costruttore di inizializzazione.

Parameters:

l - il listner degli eventi

cl - il classloader da cui caricare le risorse

Method Detail

read

public final void read(java.io.InputStream in)

interpreta da uno stream l'oggetto .

Parameters:

in - lo stream da interpretare

register

public final void register(java.lang.String name,
                           java.lang.Object o)

registra un ogetto associandolo alla chiave specificata.

Parameters:

name - chiave

o - valore

get

public final java.lang.Object get(java.lang.String name)

reperisce un elemento registrato.

Specified by:

get in interface ObjectContainer

Parameters:

name - nome dell'oggetto registrato

Returns:

restituisce un ogetto registrato oppure null

See Also:

ObjectContainer.get(java.lang.String)

getResourceAsStream

public final java.io.InputStream getResourceAsStream(java.lang.String name)

restituisce una risorsa ricavandola dal class loader.

Parameters:

name - percosro alla risorsa relativo al classpath

Returns:

lo stream aperto dalla risorsa

See Also:

ClassLoader.getResourceAsStream(String)

getStreamFromUrl

public final java.io.InputStream getStreamFromUrl(java.net.URL url)

apre uno stream da una url specificata.

Parameters:

url - url della risorsa

Returns:

lo stream aperto dalla risorsa

getStreamFromUrl

public final java.io.InputStream getStreamFromUrl(java.lang.String url)

apre uno stream da una url specificata come una stringa.

Parameters:

url - la risorsa

Returns:

lo stream aperto dalla risorsa

getIds

public final java.util.Iterator getIds()

restituisce tutti gli identificativi registrati.

Returns:

tutti gli identificativi registrati

register

public final void register(NamedObject element)

registra un ogetto.

Specified by:

register in interface ObjectContainer

Parameters:

element - l'oggetto da registrare con il suo nome

See Also:

ObjectContainer.register(paolomind.commons.NamedObject)

select

public final boolean select(java.lang.String name)

Deprecated.

questo metodo non è supportato da questa classe. rilancia l'eccezione UnsupportedOperationException

Specified by:

select in interface ObjectContainer

Parameters:

name - ho detto che non è supportato

Returns:

ma ci insisti a continuare a leggere!!! non ritorna nulla!!!

See Also:

ObjectContainer.select(java.lang.String)

getAll

public final java.util.Iterator getAll()

restituisce tutti gli elementi.

Specified by:

getAll in interface ObjectContainer

Returns:

tutti gli elementi registrati

See Also:

ObjectContainer.getAll()

setListener

public final void setListener(XMLListener plistener)

setta il listener per la gestione di eventi prevedibili.

Parameters:

plistener - listener per la gestione di eventi prevedibili.

setLoader

public final void setLoader(java.lang.ClassLoader ploader)

setta il classloader per caricare risorse eventualmente richieste. se null usa il proprio classloader.

Parameters:

ploader - classloader per caricare risorse eventualmente richieste.

getObjectmap

protected final java.util.Map getObjectmap()

restituisce la mappa degli oggetti registrati.

Returns:

la mappa degli oggetti registrati

setObjectmap

protected final void setObjectmap(java.util.Map pobjectmap)

setta la mappa degli oggetti registrati.

Parameters:

pobjectmap - la mappa degli oggetti registrati

getListener

protected final XMLListener getListener()

restituisce il listener associato.

Returns:

il listener associato.