com.helger.commons.microdom.util

Class XMLListHandler

java.lang.Object

com.helger.commons.microdom.util.XMLListHandler

@Immutable
public final class XMLListHandler
extends Object

Simple class that reads a list from an XML input stream.
The XML file needs to look as follows:

 <list>
   <item value="..."/>
   <item value="..."/>
   ...
 </list>
 

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static String	ATTR_VALUE Attribute name for the item value
static String	ELEMENT_ITEM Element name of a single item
static String	ELEMENT_LIST Name of the root element

Method Summary

Methods

Modifier and Type	Method and Description
static IMicroDocument	createListDocument(Collection<String> aCollection)
static List<String>	readList(IHasInputStream aISP)
static ESuccess	readList(IHasInputStream aISP, Collection<String> aTargetList)
static ESuccess	readList(IMicroElement aParentElement, Collection<String> aTargetList)
static List<String>	readList(InputStream aIS) Read a predefined XML file that contains list items.
static ESuccess	readList(InputStream aIS, Collection<String> aTargetList) Read a predefined XML file that contains list items.
static ESuccess	writeList(Collection<String> aCollection, IHasOutputStream aOSP)
static ESuccess	writeList(Collection<String> aCollection, OutputStream aOS) Write the passed collection to the passed output stream using the predefined XML layout.

Methods inherited from class java.lang.Object

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

Field Detail

ELEMENT_LIST

public static final String ELEMENT_LIST

Name of the root element

See Also:

Constant Field Values

ELEMENT_ITEM

public static final String ELEMENT_ITEM

Element name of a single item

See Also:

Constant Field Values

ATTR_VALUE

public static final String ATTR_VALUE

Attribute name for the item value

See Also:

Constant Field Values

Method Detail

readList

@Nullable
@ReturnsMutableCopy
public static List<String> readList(@Nonnull
                                                IHasInputStream aISP)

readList

@Nonnull
public static ESuccess readList(@Nonnull
                        IHasInputStream aISP,
                        @Nonnull
                        Collection<String> aTargetList)

readList

@Nullable
@ReturnsMutableCopy
public static List<String> readList(@Nonnull@WillClose
                                                InputStream aIS)

Read a predefined XML file that contains list items.

Parameters:

aIS - The input stream to read from. May not be null. Automatically closed no matter whether reading succeeded or not.

Returns:

null if reading fails - all list items otherwise.

readList

@Nonnull
public static ESuccess readList(@Nonnull@WillClose
                        InputStream aIS,
                        @Nonnull
                        Collection<String> aTargetList)

Read a predefined XML file that contains list items.

Parameters:

aIS - The input stream to read from. May not be null. Automatically closed no matter whether reading succeeded or not.

aTargetList - The target collection to be filled. May not be null.

Returns:

ESuccess.SUCCESS if reading succeeded, ESuccess.FAILURE if the input stream is no valid XML or any other error occurred.

readList

@Nonnull
public static ESuccess readList(@Nonnull
                        IMicroElement aParentElement,
                        @Nonnull
                        Collection<String> aTargetList)

createListDocument

@Nonnull
public static IMicroDocument createListDocument(@Nonnull
                                        Collection<String> aCollection)

writeList

@Nonnull
public static ESuccess writeList(@Nonnull
                         Collection<String> aCollection,
                         @Nonnull
                         IHasOutputStream aOSP)

writeList

@Nonnull
public static ESuccess writeList(@Nonnull
                         Collection<String> aCollection,
                         @Nonnull@WillClose
                         OutputStream aOS)

Write the passed collection to the passed output stream using the predefined XML layout.

Parameters:

aCollection - The map to be written. May not be null.

aOS - The output stream to write to. The stream is closed independent of success or failure. May not be null.

Returns:

ESuccess.SUCCESS when everything went well, ESuccess.FAILURE otherwise.