org.nuiton.io.xpp3

Class Xpp3Helper

java.lang.Object

org.nuiton.io.xpp3.Xpp3Helper

Deprecated.

since 2.0, will be remove in version 2.1

@Deprecated
public class Xpp3Helper
extends Object

A Helper to read some data stored in xml with a Xpp3Reader.

In this class, there is some methods to obtain a discovered Xpp3Reader registred by a ServiceLoader mecanism.

Since:

1.0.3

Author:

tchemit

See Also:

Xpp3Reader

Field Summary

Fields

Modifier and Type	Field and Description
protected static Map<Class<?>,Xpp3Reader<?>>	readers Deprecated. les readers enregistres via un ServiceLoader sur le contrat Xpp3Reader.

Constructor Summary

Constructors

Constructor and Description
Xpp3Helper() Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addDefaultEntities(org.codehaus.plexus.util.xml.pull.XmlPullParser parser) Deprecated. Add to the parser, the default replacers for all single characters from the XHTML specification.
static void	clearReaders() Deprecated. Clean all the registred readers.
static <T> Xpp3Reader<T>	getReader(Class<T> klass) Deprecated. Obtain the loaded reader which match his Xpp3Reader.getType() with the given type.
static Iterator<Xpp3Reader<?>>	getReaderItetator() Deprecated.
protected static Map<Class<?>,Xpp3Reader<?>>	getReaders() Deprecated. Load (if readers is null the readers via a ServiceLoader of contract Xpp3Reader and returns the dictionnary of discovered associated to their type (Xpp3Reader.getType()).
static <O> O	readObject(Class<O> klass, Reader reader) Deprecated. Read a single object from a xml stream.
static <O> O[]	readObjects(Class<O> klass, Reader reader) Deprecated. Read an array of objects from a xml stream.

Methods inherited from class java.lang.Object

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

Field Detail

readers

protected static Map<Class<?>,Xpp3Reader<?>> readers

Deprecated.

les readers enregistres via un ServiceLoader sur le contrat Xpp3Reader.

Constructor Detail

Xpp3Helper

public Xpp3Helper()

Deprecated.

Method Detail

readObject

public static <O> O readObject(Class<O> klass,
               Reader reader)
                    throws IOException,
                           org.codehaus.plexus.util.xml.pull.XmlPullParserException

Deprecated.

Read a single object from a xml stream.

Type Parameters:

O - the type of object to read

Parameters:

klass - the type of object to read

reader - the reader where to parse the xml

Returns:

the loaded object

Throws:

IOException - if any io pb

org.codehaus.plexus.util.xml.pull.XmlPullParserException - if any parsing pb

readObjects

public static <O> O[] readObjects(Class<O> klass,
                  Reader reader)
                       throws IOException,
                              org.codehaus.plexus.util.xml.pull.XmlPullParserException

Deprecated.

Read an array of objects from a xml stream.

Type Parameters:

O - the type of objects to return

Parameters:

klass - the type of object to read

reader - the reader where to parse the xml

Returns:

the loaded objects

Throws:

IOException - if any io pb

org.codehaus.plexus.util.xml.pull.XmlPullParserException - if any parsing pb

getReaderItetator

public static Iterator<Xpp3Reader<?>> getReaderItetator()

Deprecated.

Returns:

an iterator on all registred Xpp3Reader.

getReader

public static <T> Xpp3Reader<T> getReader(Class<T> klass)

Deprecated.

Obtain the loaded reader which match his Xpp3Reader.getType() with the given type.

Type Parameters:

T - the type of the data which should be parsed by the researched parser

Parameters:

klass - the type of the data which should be parsed by the researched parser

Returns:

the parser for the given type

clearReaders

public static void clearReaders()

Deprecated.

Clean all the registred readers.

To reload them, just call a getReader(Class).

addDefaultEntities

public static void addDefaultEntities(org.codehaus.plexus.util.xml.pull.XmlPullParser parser)
                               throws org.codehaus.plexus.util.xml.pull.XmlPullParserException

Deprecated.

Add to the parser, the default replacers for all single characters from the XHTML specification. The entities used:

• http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent
• http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent
• http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent

Parameters:

parser - the parser to configure

Throws:

org.codehaus.plexus.util.xml.pull.XmlPullParserException - if any pb

getReaders

protected static Map<Class<?>,Xpp3Reader<?>> getReaders()

Deprecated.

Load (if readers is null the readers via a ServiceLoader of contract Xpp3Reader and returns the dictionnary of discovered associated to their type (Xpp3Reader.getType()).

Returns:

all the Xpp3Reader registred via a ServiceLoader on the contract Xpp3Reader associated to their type (Xpp3Reader.getType()).