com.github.jsonldjava.core

Class DocumentLoader

java.lang.Object

com.github.jsonldjava.core.DocumentLoader

public class DocumentLoader
extends Object

Resolves URLs to RemoteDocuments. Subclass this class to change the behaviour of loadDocument to suit your purposes.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DISALLOW_REMOTE_CONTEXT_LOADING Identifies a system property that can be set to "true" in order to disallow remote context loading.

Constructor Summary

Constructors

Constructor and Description
DocumentLoader()

Method Summary

Modifier and Type	Method and Description
DocumentLoader	addInjectedDoc(String url, String doc) Avoid resolving a document by instead using the given serialised representation.
org.apache.http.impl.client.CloseableHttpClient	getHttpClient() Get the CloseableHttpClient which will be used by this DocumentLoader to resolve HTTP and HTTPS resources.
RemoteDocument	loadDocument(String url) Loads the URL if possible, returning it as a RemoteDocument.
void	setHttpClient(org.apache.http.impl.client.CloseableHttpClient nextHttpClient) Call this method to override the default CloseableHttpClient provided by JsonUtils.getDefaultHttpClient.

Methods inherited from class java.lang.Object

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

Field Detail

DISALLOW_REMOTE_CONTEXT_LOADING

public static final String DISALLOW_REMOTE_CONTEXT_LOADING

Identifies a system property that can be set to "true" in order to disallow remote context loading.

See Also:

Constant Field Values

Constructor Detail

DocumentLoader

public DocumentLoader()

Method Detail

addInjectedDoc

public DocumentLoader addInjectedDoc(String url,
                                     String doc)
                              throws JsonLdError

Avoid resolving a document by instead using the given serialised representation.

Parameters:

url - The URL this document represents.

doc - The serialised document as a String

Returns:

This object for fluent addition of other injected documents.

Throws:

JsonLdError - If loading of the document failed for any reason.

loadDocument

public RemoteDocument loadDocument(String url)
                            throws JsonLdError

Loads the URL if possible, returning it as a RemoteDocument.

Parameters:

url - The URL to load

Returns:

The resolved URL as a RemoteDocument

Throws:

JsonLdError - If there are errors loading or remote context loading has been disallowed.

getHttpClient

public org.apache.http.impl.client.CloseableHttpClient getHttpClient()

Get the CloseableHttpClient which will be used by this DocumentLoader to resolve HTTP and HTTPS resources.

Returns:

The CloseableHttpClient which this DocumentLoader uses.

setHttpClient

public void setHttpClient(org.apache.http.impl.client.CloseableHttpClient nextHttpClient)

Call this method to override the default CloseableHttpClient provided by JsonUtils.getDefaultHttpClient.

Parameters:

nextHttpClient - The CloseableHttpClient to replace the default with.