hu.akarnokd.xml

Class XSerializables

java.lang.Object

hu.akarnokd.xml.XSerializables

public final class XSerializables
extends java.lang.Object

Utility classes to handle XSerializable object creation and conversion.

Method Summary

Modifier and Type	Method and Description
static XElement	createRequest(java.lang.String function, java.lang.Object... nameValue) Create a request with the given function and name-value pairs.
static XElement	createUpdate(java.lang.String function, XSerializable object) Create an update request and store the contents of the object into it.
static <T extends XSerializable> T	parseItem(XElement item, java.util.function.Supplier<T> creator) Create an XSerializable object through the creator function and load it from the item.
static <T extends XSerializable> java.util.List<T>	parseList(XElement 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 XSerializable object.
static XElement	storeItem(java.lang.String itemName, XSerializable source) Store the value of a single serializable object with the given element name.
static XElement	storeList(java.lang.String container, java.lang.String item, java.lang.Iterable<? extends XSerializable> source) Create an XElement 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 XElement 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 XElement createUpdate(java.lang.String function,
                                    XSerializable 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 XSerializable> java.util.List<T> parseList(XElement 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 XSerializable object.

Type Parameters:

T - the element object type

Parameters:

container - the container XElement

itemName - the item name

creator - the function to create Ts

Returns:

the list of elements

parseItem

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

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

Type Parameters:

T - the XSerializable object

Parameters:

item - the item to load from

creator - the function to create Ts

Returns:

the created and loaded object

storeList

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

Create an XElement 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 XElement

storeItem

public static XElement storeItem(java.lang.String itemName,
                                 XSerializable 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 XElement