org.apache.jena.riot.web

Class HttpOp

java.lang.Object

org.apache.jena.riot.web.HttpOp

public class HttpOp
extends Object

Simplified HTTP operations; simplification means only supporting certain uses of HTTP. The expectation is that the simplified operations in this class can be used by other code to generate more application specific HTTP interactions (e.g. SPARQL queries). For more complictaed requirments of HTTP, then the application wil need to use org.apache.http.client directly.

For HTTP GET, the application supplies a URL, the accept header string, and a list of handlers to deal with different content type responses.

For HTTP POST, the application supplies a URL, content, the accept header string, and a list of handlers to deal with different content type responses, or no response is expected.

For HTTP PUT, the application supplies a URL, content, the accept header string

See Also:

HttpNames, for HTTP related constants, WebContent, for content type name constants

Constructor Summary

Constructors

Constructor and Description
HttpOp()

Method Summary

Methods

Modifier and Type	Method and Description
static String	execHttpGet(String url, org.apache.http.protocol.HttpContext httpContext) Simple GET - no content negotiation
static TypedInputStreamHttp	execHttpGet(String url, String acceptHeader, org.apache.http.protocol.HttpContext httpContext) GET
static void	execHttpGet(String url, String acceptHeader, Map<String,HttpResponseHandler> handlers, org.apache.http.protocol.HttpContext httpContext) GET
static void	execHttpPost(String url, org.apache.http.HttpEntity provider, String acceptType, Map<String,HttpResponseHandler> handlers, org.apache.http.protocol.HttpContext context) POST with response body.
static void	execHttpPost(String url, String contentType, ContentProducer provider, String acceptType, Map<String,HttpResponseHandler> handlers) POST with response body
static void	execHttpPost(String url, String contentType, InputStream input, long length) POST without response body.
static void	execHttpPost(String url, String contentType, InputStream input, long length, String acceptType, Map<String,HttpResponseHandler> handlers) POST with response body.
static void	execHttpPost(String url, String contentType, String content) POST a string without response body.
static void	execHttpPost(String url, String contentType, String content, String acceptType, Map<String,HttpResponseHandler> handlers, org.apache.http.protocol.HttpContext httpContext) POST a string, expect a response body.
static void	execHttpPostForm(String url, Params params, Map<String,HttpResponseHandler> handlers) Execute an HTTP POST form operation
static void	execHttpPostForm(String url, Params params, Map<String,HttpResponseHandler> handlers, org.apache.http.protocol.HttpContext httpContext) Execute an HTTP POST form operation
static void	execHttpPut(String url, org.apache.http.HttpEntity entity, org.apache.http.protocol.HttpContext httpContext) Execute an HTTP PUT operation
static void	execHttpPut(String url, String contentType, InputStream input, long length, org.apache.http.protocol.HttpContext httpContext) Execute an HTTP PUT operation
static void	execHttpPut(String url, String contentType, String content, org.apache.http.protocol.HttpContext httpContext) Execute an HTTP PUT operation

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpOp

public HttpOp()

Method Detail

execHttpGet

public static void execHttpGet(String url,
               String acceptHeader,
               Map<String,HttpResponseHandler> handlers,
               org.apache.http.protocol.HttpContext httpContext)

GET

The acceptHeader string is any legal value for HTTP Accept: field.

The handlers are the set of content types (without charset), used to dispatch the response body for handling.

A Map entry of ("*",....) is used "no handler found".

HTTP responses 400 and 500 become exceptions.

execHttpGet

public static TypedInputStreamHttp execHttpGet(String url,
                               String acceptHeader,
                               org.apache.http.protocol.HttpContext httpContext)

GET

The acceptHeader string is any legal value for HTTP Accept: field.

execHttpGet

public static String execHttpGet(String url,
                 org.apache.http.protocol.HttpContext httpContext)

Simple GET - no content negotiation

execHttpPost

public static void execHttpPost(String url,
                String contentType,
                String content)

POST a string without response body.

Execute an HTTP POST, with the string as content.

No response content expected or processed.

execHttpPost

public static void execHttpPost(String url,
                String contentType,
                InputStream input,
                long length)

POST without response body. Content read from the the input stream.

Execute an HTTP POST, with the string as content.

No response content expected or processed.

execHttpPost

public static void execHttpPost(String url,
                String contentType,
                String content,
                String acceptType,
                Map<String,HttpResponseHandler> handlers,
                org.apache.http.protocol.HttpContext httpContext)

POST a string, expect a response body.

Additional headers e.g. for authentication can be injected through an HttpContext.

execHttpPost

public static void execHttpPost(String url,
                String contentType,
                InputStream input,
                long length,
                String acceptType,
                Map<String,HttpResponseHandler> handlers)

POST with response body. The input stream is assumed to be UTF-8.

execHttpPost

public static void execHttpPost(String url,
                String contentType,
                ContentProducer provider,
                String acceptType,
                Map<String,HttpResponseHandler> handlers)

POST with response body

execHttpPost

public static void execHttpPost(String url,
                org.apache.http.HttpEntity provider,
                String acceptType,
                Map<String,HttpResponseHandler> handlers,
                org.apache.http.protocol.HttpContext context)

POST with response body.

The content for the POST body comes from the HttpEntity.

The response is handled by the handler map, as per execHttpGet(String, String, Map, HttpContext)

Additional headers e.g. for authentication can be injected through an HttpContext

execHttpPostForm

public static void execHttpPostForm(String url,
                    Params params,
                    Map<String,HttpResponseHandler> handlers)

Execute an HTTP POST form operation

execHttpPostForm

public static void execHttpPostForm(String url,
                    Params params,
                    Map<String,HttpResponseHandler> handlers,
                    org.apache.http.protocol.HttpContext httpContext)

Execute an HTTP POST form operation

execHttpPut

public static void execHttpPut(String url,
               String contentType,
               String content,
               org.apache.http.protocol.HttpContext httpContext)

Execute an HTTP PUT operation

execHttpPut

public static void execHttpPut(String url,
               String contentType,
               InputStream input,
               long length,
               org.apache.http.protocol.HttpContext httpContext)

Execute an HTTP PUT operation

execHttpPut

public static void execHttpPut(String url,
               org.apache.http.HttpEntity entity,
               org.apache.http.protocol.HttpContext httpContext)

Execute an HTTP PUT operation