Package cdc.util.data.util

Class AbstractResourceLoader<R>

java.lang.Object

cdc.util.data.util.AbstractResourceLoader<R>

Type Parameters:

R - The return type.

public abstract class AbstractResourceLoader<R>
extends java.lang.Object

Helper class for data loading.

Author:

Damien Carbonne

Constructor Summary

Constructors

Constructor	Description
AbstractResourceLoader(cdc.util.lang.FailureReaction reaction)

Method Summary

Modifier and Type	Method	Description
org.apache.logging.log4j.Logger	getLogger()
cdc.util.lang.FailureReaction	getReaction()
protected abstract R	loadRoot(Element root)	Method that must be implemented by concrete classes to load the file.
R	loadXml(java.io.File file, cdc.util.compress.Compressor compressor, XmlDataReader.Feature... features)
R	loadXml(java.io.File file, XmlDataReader.Feature... features)
R	loadXml(java.io.InputStream is, java.lang.String systemId, XmlDataReader.Feature... features)
R	loadXml(java.lang.String filename, cdc.util.compress.Compressor compressor, XmlDataReader.Feature... features)
R	loadXml(java.lang.String filename, XmlDataReader.Feature... features)
R	loadXml(java.net.URL url, cdc.util.compress.Compressor compressor, XmlDataReader.Feature... features)
R	loadXml(java.net.URL url, XmlDataReader.Feature... features)
void	loadXml(java.util.List<java.net.URL> urls, cdc.util.compress.Compressor compressor, XmlDataReader.Feature... features)
void	loadXml(java.util.List<java.net.URL> urls, XmlDataReader.Feature... features)
protected void	onError(java.lang.String message)	Function that either keeps silent, warns or raises an exception, depending on error reaction.
protected <T> T	onError(java.lang.String message, T def)	Function that either silently returns a value, warns and returns a value or raises an exception, depending on error reaction.
protected <T> T	onResult(T result, java.lang.String message, T def)	Function that returns a computed value if it is not null, or silently returns a default value, warns and returns a default value or throws an exception.
protected void	unexpectedElement(Element element, java.lang.String... expected)
protected <V> V	unexpectedElement(Element element, V def, java.lang.String... expected)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractResourceLoader

public AbstractResourceLoader(cdc.util.lang.FailureReaction reaction)

Method Detail

getLogger

public final org.apache.logging.log4j.Logger getLogger()

Returns:

The logger to use.

getReaction

public final cdc.util.lang.FailureReaction getReaction()

Returns:

The reaction to adopt in case of error.

loadXml

public final R loadXml(java.io.File file,
                       cdc.util.compress.Compressor compressor,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadXml

public final R loadXml(java.io.File file,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadXml

public final R loadXml(java.lang.String filename,
                       cdc.util.compress.Compressor compressor,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadXml

public final R loadXml(java.lang.String filename,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadXml

public final R loadXml(java.net.URL url,
                       cdc.util.compress.Compressor compressor,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadXml

public final R loadXml(java.net.URL url,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadXml

public final void loadXml(java.util.List<java.net.URL> urls,
                          cdc.util.compress.Compressor compressor,
                          XmlDataReader.Feature... features)

loadXml

public final void loadXml(java.util.List<java.net.URL> urls,
                          XmlDataReader.Feature... features)

loadXml

public final R loadXml(java.io.InputStream is,
                       java.lang.String systemId,
                       XmlDataReader.Feature... features)
                throws java.io.IOException

Throws:

java.io.IOException

loadRoot

protected abstract R loadRoot(Element root)

Method that must be implemented by concrete classes to load the file.

Parameters:

root - The root element.

Returns:

The result.

onError

protected final void onError(java.lang.String message)

Function that either keeps silent, warns or raises an exception, depending on error reaction.

Parameters:

message - The error message.

Throws:

DataException - When error reaction is FailureReaction.FAIL.

onError

protected final <T> T onError(java.lang.String message,
                              T def)

Function that either silently returns a value, warns and returns a value or raises an exception, depending on error reaction.

Type Parameters:

T - The return type.

Parameters:

message - The error message.

def - The default return value.

Returns:

def if error reaction is FailureReaction.DEFAULT or FailureReaction.WARN.

Throws:

DataException - When error reaction is FailureReaction.FAIL.

onResult

protected final <T> T onResult(T result,
                               java.lang.String message,
                               T def)

Function that returns a computed value if it is not null, or silently returns a default value, warns and returns a default value or throws an exception.

Type Parameters:

T - The return type.

Parameters:

result - The computed result.

message - The error message.

def - The default return value.

Returns:

result if it is not null, or def if error reaction is FailureReaction.DEFAULT or FailureReaction.WARN.

Throws:

DataException - When result is null and error reaction is FailureReaction.FAIL.

unexpectedElement

protected final void unexpectedElement(Element element,
                                       java.lang.String... expected)

unexpectedElement

protected final <V> V unexpectedElement(Element element,
                                        V def,
                                        java.lang.String... expected)