hu.akarnokd.xml

Class XNSerializables

java.lang.Object

hu.akarnokd.xml.XNSerializables

public final class XNSerializables
extends java.lang.Object

Utility classes to handle XNSerializable object creation and conversion.

Method Summary

Modifier and Type	Method and Description
static XNElement	createRequest(java.lang.String function, java.lang.Object... nameValue) Create a request with the given function and name-value pairs.
static XNElement	createUpdate(java.lang.String function, XNSerializable object) Create an update request and store the contents of the object into it.
static <T extends XNSerializable> T	parseItem(XNElement item, java.util.function.Supplier<T> creator) Create an XNSerializable object through the creator function and load it from the item.
static <T extends XNSerializable> java.util.List<T>	parseList(XNElement container, java.lang.String itemName, java.util.function.Supplier<T> creator) Parses an container for the given itemName elements and loads them into the given Java XNSerializable object.
static XNElement	storeItem(java.lang.String itemName, XNSerializable source) Store the value of a single serializable object with the given element name.
static XNElement	storeList(java.lang.String container, java.lang.String item, java.lang.Iterable<? extends XNSerializable> source) Create an XNElement with the given name and items stored from the source sequence.

Methods inherited from class java.lang.Object

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

Method Detail

createRequest

public static XNElement createRequest(java.lang.String function,
                                      java.lang.Object... nameValue)

Create a request with the given function and name-value pairs.

Parameters:

function - the remote function name

nameValue - the array of String name and Object attributes.

Returns:

the request XML

createUpdate

public static XNElement createUpdate(java.lang.String function,
                                     XNSerializable object)

Create an update request and store the contents of the object into it.

Parameters:

function - the remote function name

object - the object to store.

Returns:

the request XML

parseList

public static <T extends XNSerializable> java.util.List<T> parseList(XNElement container,
                                                                     java.lang.String itemName,
                                                                     java.util.function.Supplier<T> creator)

Parses an container for the given itemName elements and loads them into the given Java XNSerializable object.

Type Parameters:

T - the element object type

Parameters:

container - the container XNElement

itemName - the item name

creator - the function to create Ts

Returns:

the list of elements

parseItem

public static <T extends XNSerializable> T parseItem(XNElement item,
                                                     java.util.function.Supplier<T> creator)

Create an XNSerializable object through the creator function and load it from the item.

Type Parameters:

T - the XNSerializable object

Parameters:

item - the item to load from

creator - the function to create Ts

Returns:

the created and loaded object

storeList

public static XNElement storeList(java.lang.String container,
                                  java.lang.String item,
                                  java.lang.Iterable<? extends XNSerializable> source)

Create an XNElement with the given name and items stored from the source sequence.

Parameters:

container - the container name

item - the item name

source - the source of items

Returns:

the list in XNElement

storeItem

public static XNElement storeItem(java.lang.String itemName,
                                  XNSerializable source)

Store the value of a single serializable object with the given element name.

Parameters:

itemName - the item element name

source - the object to store

Returns:

the created XNElement