com.github.jsonldjava.core

Class DocumentLoader

java.lang.Object

com.github.jsonldjava.core.DocumentLoader

public class DocumentLoader
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACCEPT_HEADER An HTTP Accept header that prefers JSONLD.
protected static org.apache.http.impl.client.CloseableHttpClient	defaultHttpClient
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
protected static org.apache.http.impl.client.CloseableHttpClient	createDefaultHttpClient()
Object	fromURL(URL url) Returns a Map, List, or String containing the contents of the JSON resource resolved from the JsonLdUrl.
protected static org.apache.http.impl.client.CloseableHttpClient	getDefaultHttpClient()
org.apache.http.impl.client.CloseableHttpClient	getHttpClient()
RemoteDocument	loadDocument(String url)
InputStream	openStreamFromURL(URL url) Opens an InputStream for the given URL, including support for http and https URLs that are requested using Content Negotiation with application/ld+json as the preferred content type.
void	setHttpClient(org.apache.http.impl.client.CloseableHttpClient nextHttpClient)

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

ACCEPT_HEADER

public static final String ACCEPT_HEADER

An HTTP Accept header that prefers JSONLD.

See Also:

Constant Field Values

defaultHttpClient

protected static volatile org.apache.http.impl.client.CloseableHttpClient defaultHttpClient

Constructor Detail

DocumentLoader

public DocumentLoader()

Method Detail

loadDocument

public RemoteDocument loadDocument(String url)
                            throws JsonLdError

Throws:

JsonLdError

fromURL

public Object fromURL(URL url)
               throws com.fasterxml.jackson.core.JsonParseException,
                      IOException

Returns a Map, List, or String containing the contents of the JSON resource resolved from the JsonLdUrl.

Parameters:

url - The JsonLdUrl to resolve

Returns:

The Map, List, or String that represent the JSON resource resolved from the JsonLdUrl

Throws:

com.fasterxml.jackson.core.JsonParseException - If the JSON was not valid.

IOException - If there was an error resolving the resource.

openStreamFromURL

public InputStream openStreamFromURL(URL url)
                              throws IOException

Opens an InputStream for the given URL, including support for http and https URLs that are requested using Content Negotiation with application/ld+json as the preferred content type.

Parameters:

url - The URL identifying the source.

Returns:

An InputStream containing the contents of the source.

Throws:

IOException - If there was an error resolving the URL.

getDefaultHttpClient

protected static org.apache.http.impl.client.CloseableHttpClient getDefaultHttpClient()

createDefaultHttpClient

protected static org.apache.http.impl.client.CloseableHttpClient createDefaultHttpClient()

getHttpClient

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

setHttpClient

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