de.gerdiproject.harvest.utils.data

Interface IDataRetriever

All Known Implementing Classes:

DiskIO, WebDataRetriever

public interface IDataRetriever

This interface describes a means for retrieving data from an arbitrary source.

Author:

Robin Weiss

Method Summary

Modifier and Type	Method and Description
org.jsoup.nodes.Document	getHtml(String path) Tries to parse the content from a specified path as a HTML document.
<T> T	getObject(String path, Class<T> targetClass) Tries to parse the content from a specified path as a JSON object.
<T> T	getObject(String path, Type targetType) Tries to parse the content from a specified path as a JSON object.
String	getString(String path) Tries to parse the content from a specified path as a string.
void	setCharset(Charset charset) Changes the charset used for (de-)serializing requests.

Method Detail

getString

String getString(String path)

Tries to parse the content from a specified path as a string.

Parameters:

path - the path to a HTML file

Returns:

a text, or null if the file could not be parsed

getObject

<T> T getObject(String path,
                Class<T> targetClass)

Tries to parse the content from a specified path as a JSON object.

Type Parameters:

T - the type of the object that is to be read

Parameters:

path - the path to a JSON file

targetClass - the class of the object that is read from disc

Returns:

an object, or null if the file could not be parsed

getObject

<T> T getObject(String path,
                Type targetType)

Tries to parse the content from a specified path as a JSON object.

Type Parameters:

T - the type of the object that is to be read

Parameters:

path - the path to a JSON file

targetType - the type of the object that is read from disc

Returns:

an object, or null if the file could not be parsed

getHtml

org.jsoup.nodes.Document getHtml(String path)

Tries to parse the content from a specified path as a HTML document.

Parameters:

path - the path to a HTML file

Returns:

a HTML document, or null if the file could not be parsed

setCharset

void setCharset(Charset charset)

Changes the charset used for (de-)serializing requests.

Parameters:

charset - the new charset