com.ejie.r01f.xml.marshalling
Class XOManager

java.lang.Object
  extended bycom.ejie.r01f.xml.marshalling.XOManager
Direct Known Subclasses:
XMLManager

public class XOManager
extends java.lang.Object

Clase que maneja los marshallers XML<->Objetos En esta clase se cachean las marshallers para cada definición de mapeo de XML a objetos, de forma que NO sea necesario volver a leer el mapa con la definción (ahorrando tiempos) Para cargar los mapas se pueden utilizar DOS sistemas: - Loader en base a ficheros (por defecto) Lee los ficheros desde la ruta que se pasa como parametro - Loader en base a ClassPath Lee los ficheros desde el classPath, para lo cual es necesario que el fichero con el mapeo XML<->Objetos esté en algún lugar del ClassPath Ejemplo: Si los ficheros de mapeo están en /aplic/[appCode]/html/datos: - Si se utiliza el loader en base a ficheros, en el nombre del fichero que hay que pasar a las funciones de esta clase es la ruta absoluta: /aplic/[appCode]/html/datos/[ficheroMapeo].xml - Si se utiliza el loader en base al classPath, en el nombre del fichero que hay que pasar a las funciones de esta clase hay que pasar una ruta que este en el classPath: Si el classpath contiene /aplic, bastaría con pasar: /[appCode]/html/datos/[ficheroMapeo].xml Es posible indicar el Loader a utilizar estableciendo la propiedad xoMarshalling/mapFilesLoader del fichero r01f.properties.xml a uno de los siguientes valores: FILESYSTEM Carga directa desde la localización absoluta en disco CLASSPATH Carga relativa desde cualquier localización del classPath


Constructor Summary
XOManager()
          Constructor vacio
 
Method Summary
static XOMarshaller getInstance(java.lang.String mapFileName)
          Devuelve una instancia de Marshaller para el fichero de mapeo dado Si el marshaller no esta inicializado, se inicializa en este momento
static java.lang.Object getObject(java.io.InputStream mapIS, java.io.InputStream objectXML)
          Obtiene un objeto a partir de un xml en forma de inputStream
static java.lang.Object getObject(java.io.InputStream mapIS, java.lang.String objectXML)
          Obtiene un objeto a partir de un xml en forma de inputStream
static java.lang.Object getObject(java.lang.String mapFileName, java.io.InputStream objectXML)
          Obtiene un objeto a partir de un xml en forma de InputStream
static java.lang.Object getObject(java.lang.String mapFileName, java.lang.String objectXML)
          Obtiene un objeto a partir de un xml en forma de String
static java.lang.Object getObject(XOMarshaller marshaller, java.io.InputStream objectXML)
          Obtiene un objeto a partir de un xml en forma de inputStream
static java.lang.Object getObject(XOMarshaller marshaller, java.lang.String objectXML)
          Obtiene un objeto a partir de un xml en forma de inputStream
static java.lang.String getXML(java.lang.String mapFileName, java.lang.Object obj)
          Obtiene una cadena xml a partir de un objeto
static java.lang.String getXML(XOMarshaller marshaller, java.lang.Object obj)
          Obtiene una cadena xml a partir de un objeto
static java.lang.String getXMLIgnoringExceptions(java.lang.String mapFileName, java.lang.Object obj)
          Devuelve un objeto en forma de xml ignorando cualquier excepcion que pueda lanzarse en el proceso
static XOMap getXOMap(java.lang.String mapFileName)
          Devuelve el mapeo correspondiente al nombre de fichero
static void main(java.lang.String[] args)
          Main Method
static void reset()
          Resetea los marshallers... forzando que se vuelvan a cargar todos los ficheros de mapeo.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XOManager

public XOManager()
Constructor vacio

Method Detail

getInstance

public static XOMarshaller getInstance(java.lang.String mapFileName)
                                throws XOMarshallerException
Devuelve una instancia de Marshaller para el fichero de mapeo dado Si el marshaller no esta inicializado, se inicializa en este momento

Throws:
XOMarshallerException: - Si ha algun error al inicializar el marshaller
XOMarshallerException

getXOMap

public static XOMap getXOMap(java.lang.String mapFileName)
                      throws XOMarshallerException
Devuelve el mapeo correspondiente al nombre de fichero

Parameters:
mapFileName - El nombre del fichero de mapeo
Returns:
El objeto de mapeo
Throws:
XOMarshallerException - Si ocurre una excepcion en el proceso

reset

public static void reset()
Resetea los marshallers... forzando que se vuelvan a cargar todos los ficheros de mapeo.


getObject

public static java.lang.Object getObject(java.lang.String mapFileName,
                                         java.lang.String objectXML)
                                  throws XOMarshallerException
Obtiene un objeto a partir de un xml en forma de String

Parameters:
mapFileName - ruta al fichero de mapeo
objectXML - El xml a convertir a objetos en forma de String
Returns:
El objeto creado por el marshaller que representa el fichero XML.
Throws:
XOMarshallerException

getObject

public static java.lang.Object getObject(java.lang.String mapFileName,
                                         java.io.InputStream objectXML)
                                  throws XOMarshallerException
Obtiene un objeto a partir de un xml en forma de InputStream

Parameters:
mapFileName - ruta al fichero de mapeo
objectXML - El xml a convertir a objetos en forma de InputStream (normalmente un ByteArrayInputStream)
Returns:
El objeto creado por el marshaller que representa el fichero XML.
Throws:
XOMarshallerException

getObject

public static java.lang.Object getObject(java.io.InputStream mapIS,
                                         java.io.InputStream objectXML)
                                  throws XOMarshallerException
Obtiene un objeto a partir de un xml en forma de inputStream

Parameters:
mapIS - inputStream al fichero de mapeo
objectXML - inputStream al xml a convertir
Returns:
El objeto creado por el marshaller que representa el fichero XML.
Throws:
XOMarshallerException

getObject

public static java.lang.Object getObject(java.io.InputStream mapIS,
                                         java.lang.String objectXML)
                                  throws XOMarshallerException
Obtiene un objeto a partir de un xml en forma de inputStream

Parameters:
mapIS - inputStream al fichero de mapeo
objectXML - inputStream al xml a convertir
Returns:
El objeto creado por el marshaller que representa el fichero XML.
Throws:
XOMarshallerException

getObject

public static java.lang.Object getObject(XOMarshaller marshaller,
                                         java.io.InputStream objectXML)
                                  throws XOMarshallerException
Obtiene un objeto a partir de un xml en forma de inputStream

Parameters:
marshaller - marshaller
objectXML - inputStream al xml a convertir
Returns:
El objeto creado por el marshaller que representa el fichero XML.
Throws:
XOMarshallerException

getObject

public static java.lang.Object getObject(XOMarshaller marshaller,
                                         java.lang.String objectXML)
                                  throws XOMarshallerException
Obtiene un objeto a partir de un xml en forma de inputStream

Parameters:
marshaller - marshaller
objectXML - inputStream al xml a convertir
Returns:
El objeto creado por el marshaller que representa el fichero XML.
Throws:
XOMarshallerException

getXML

public static java.lang.String getXML(java.lang.String mapFileName,
                                      java.lang.Object obj)
                               throws XOMarshallerException
Obtiene una cadena xml a partir de un objeto

Parameters:
mapFileName - ruta al fichero de mapeo
obj - el objeto a partir del cual debe crearse el XML
Returns:
cadena que representa el XML creado por el marshaller.
Throws:
XOMarshallerException

getXML

public static java.lang.String getXML(XOMarshaller marshaller,
                                      java.lang.Object obj)
                               throws XOMarshallerException
Obtiene una cadena xml a partir de un objeto

Parameters:
marshaller - marshaller
obj - el objeto a partir del cual debe crearse el XML
Returns:
cadena que representa el XML creado por el marshaller
Throws:
XOMarshallerException

getXMLIgnoringExceptions

public static java.lang.String getXMLIgnoringExceptions(java.lang.String mapFileName,
                                                        java.lang.Object obj)
Devuelve un objeto en forma de xml ignorando cualquier excepcion que pueda lanzarse en el proceso

Parameters:
mapFileName - fichero de mapeo de xml a objetos
obj - objeto a convertir
Returns:
el xml

main

public static void main(java.lang.String[] args)
Main Method

Parameters:
args -