Package org.apache.jena.sparql.modify

Class UpdateProcessRemoteBase

java.lang.Object

org.apache.jena.sparql.modify.UpdateProcessRemoteBase

All Implemented Interfaces:

UpdateProcessor

Direct Known Subclasses:

UpdateProcessRemote, UpdateProcessRemoteForm

public abstract class UpdateProcessRemoteBase
extends java.lang.Object
implements UpdateProcessor

Abstract base class for update processors that perform remote updates over HTTP

Field Summary

Fields

Modifier and Type	Field	Description
static Symbol	HTTP_CONTEXT	Symbol used to set a HttpContext which will be used for HTTP requests

Constructor Summary

Constructors

Constructor	Description
UpdateProcessRemoteBase(UpdateRequest request, java.lang.String endpoint, Context context)	Creates a new remote update processor

Method Summary

Modifier and Type	Method	Description
void	addDefaultGraph(java.lang.String defaultGraph)	Adds a default graph
void	addNamedGraph(java.lang.String namedGraph)	Adds a named graph
void	addParam(java.lang.String field, java.lang.String value)	Adds a custom parameter to the request
org.apache.http.client.HttpClient	getClient()	Gets the client that has been set (if any)
Context	getContext()	The properties associated with a query execution - implementation specific parameters This includes Java objects (so it is not an RDF graph).
DatasetGraph	getDatasetGraph()	The dataset against which the query will execute.
java.lang.String	getEndpoint()	Gets the endpoint
org.apache.http.protocol.HttpContext	getHttpContext()	Convenience method to get the HttpContext
Params	getParams()	Gets the parameters for the execution
UpdateRequest	getUpdateRequest()	Gets the update request
java.lang.String	getUpdateString()	Gets the generated HTTP query string portion of the endpoint URL if applicable
void	setClient(org.apache.http.client.HttpClient client)	Sets the client to use
void	setDefaultGraphs(java.util.List<java.lang.String> defaultGraphs)	Sets the default graphs
void	setHttpContext(org.apache.http.protocol.HttpContext httpContext)	Convenience method to set the HttpContext
void	setNamedGraphs(java.util.List<java.lang.String> namedGraphs)	Sets the named graphs

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jena.update.UpdateProcessor

execute

Field Detail

HTTP_CONTEXT

public static final Symbol HTTP_CONTEXT

Symbol used to set a HttpContext which will be used for HTTP requests

Constructor Detail

UpdateProcessRemoteBase

public UpdateProcessRemoteBase(UpdateRequest request,
                               java.lang.String endpoint,
                               Context context)

Creates a new remote update processor

Parameters:

request - Update request

endpoint - Update endpoint

context - Context

Method Detail

getDatasetGraph

public DatasetGraph getDatasetGraph()

Description copied from interface: UpdateProcessor

The dataset against which the query will execute. May be null, implying the there isn't a local GraphStore target for this UpdateProcessor.

Specified by:

getDatasetGraph in interface UpdateProcessor

getEndpoint

public java.lang.String getEndpoint()

Gets the endpoint

Returns:

Endpoint URI

getUpdateString

public java.lang.String getUpdateString()

Gets the generated HTTP query string portion of the endpoint URL if applicable

Generated string will not include leading ? so that consuming code can decide whether to add this themselves since the generated query string may be being used in addition to an existing query string.

Returns:

Generated query string

getParams

public Params getParams()

Gets the parameters for the execution

Returns:

Parameters

getUpdateRequest

public UpdateRequest getUpdateRequest()

Gets the update request

Returns:

Update request

addDefaultGraph

public void addDefaultGraph(java.lang.String defaultGraph)

Adds a default graph

Parameters:

defaultGraph - Default Graph URI

addNamedGraph

public void addNamedGraph(java.lang.String namedGraph)

Adds a named graph

Parameters:

namedGraph - Named Graph URi

addParam

public void addParam(java.lang.String field,
                     java.lang.String value)

Adds a custom parameter to the request

Parameters:

field - Field

value - Value

setDefaultGraphs

public void setDefaultGraphs(java.util.List<java.lang.String> defaultGraphs)

Sets the default graphs

Parameters:

defaultGraphs - Default Graphs

setNamedGraphs

public void setNamedGraphs(java.util.List<java.lang.String> namedGraphs)

Sets the named graphs

Parameters:

namedGraphs - Named Graphs

setHttpContext

public void setHttpContext(org.apache.http.protocol.HttpContext httpContext)

Convenience method to set the HttpContext

Parameters:

httpContext - HTTP Context

getHttpContext

public org.apache.http.protocol.HttpContext getHttpContext()

Convenience method to get the HttpContext

Returns:

HttpContext

getContext

public Context getContext()

Description copied from interface: UpdateProcessor

The properties associated with a query execution - implementation specific parameters This includes Java objects (so it is not an RDF graph). Keys should be URIs as strings. May be null (this implementation does not provide any configuration).

Specified by:

getContext in interface UpdateProcessor

setClient

public void setClient(org.apache.http.client.HttpClient client)

Sets the client to use

Note that you can globally set an client via HttpOp.setDefaultHttpClient(HttpClient) to avoid the need to set client on a per-request basis

Parameters:

client - HTTP client

getClient

public org.apache.http.client.HttpClient getClient()

Gets the client that has been set (if any)

If no client is used then the default client will be used, this can be configured via the HttpOp.setDefaultHttpClient(HttpClient) method.

Returns:

HTTP client if set, null otherwise