org.eclipse.rdf4j.http.server

Class ProtocolUtil

java.lang.Object

org.eclipse.rdf4j.http.server.ProtocolUtil

public class ProtocolUtil
extends Object

Utilities to help with the transition between HTTP requests/responses and values expected by the protocol.

Author:

Herko ter Horst, Arjohn Kampman

Constructor Summary

Constructors

Constructor and Description
ProtocolUtil()

Method Summary

Modifier and Type	Method and Description
static <FF extends FileFormat,S> S	getAcceptableService(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, FileFormatServiceRegistry<FF,S> serviceRegistry)
static void	logAcceptableFormats(javax.servlet.http.HttpServletRequest request)
static void	logRequestParameters(javax.servlet.http.HttpServletRequest request) Logs all request parameters of the supplied request.
static boolean	parseBooleanParam(javax.servlet.http.HttpServletRequest request, String paramName, boolean defaultValue)
static Resource[]	parseContextParam(javax.servlet.http.HttpServletRequest request, String paramName, ValueFactory vf)
static IRI	parseGraphParam(javax.servlet.http.HttpServletRequest request, ValueFactory vf)
static long	parseLongParam(javax.servlet.http.HttpServletRequest request, String paramName, long defaultValue)
static Resource	parseResourceParam(javax.servlet.http.HttpServletRequest request, String paramName, ValueFactory vf)
static int	parseTimeoutParam(javax.servlet.http.HttpServletRequest request) Reads the Protocol.TIMEOUT_PARAM_NAME parameter from the request and (if present) parses it into an integer value.
static IRI	parseURIParam(javax.servlet.http.HttpServletRequest request, String paramName, ValueFactory vf)
static Value	parseValueParam(javax.servlet.http.HttpServletRequest request, String paramName, ValueFactory vf)

Methods inherited from class java.lang.Object

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

Constructor Detail

ProtocolUtil

public ProtocolUtil()

Method Detail

parseValueParam

public static Value parseValueParam(javax.servlet.http.HttpServletRequest request,
                                    String paramName,
                                    ValueFactory vf)
                             throws ClientHTTPException

Throws:

ClientHTTPException

parseResourceParam

public static Resource parseResourceParam(javax.servlet.http.HttpServletRequest request,
                                          String paramName,
                                          ValueFactory vf)
                                   throws ClientHTTPException

Throws:

ClientHTTPException

parseURIParam

public static IRI parseURIParam(javax.servlet.http.HttpServletRequest request,
                                String paramName,
                                ValueFactory vf)
                         throws ClientHTTPException

Throws:

ClientHTTPException

parseGraphParam

public static IRI parseGraphParam(javax.servlet.http.HttpServletRequest request,
                                  ValueFactory vf)
                           throws ClientHTTPException

Throws:

ClientHTTPException

parseContextParam

public static Resource[] parseContextParam(javax.servlet.http.HttpServletRequest request,
                                           String paramName,
                                           ValueFactory vf)
                                    throws ClientHTTPException

Throws:

ClientHTTPException

parseBooleanParam

public static boolean parseBooleanParam(javax.servlet.http.HttpServletRequest request,
                                        String paramName,
                                        boolean defaultValue)

parseLongParam

public static long parseLongParam(javax.servlet.http.HttpServletRequest request,
                                  String paramName,
                                  long defaultValue)
                           throws ClientHTTPException

Throws:

ClientHTTPException

logRequestParameters

public static void logRequestParameters(javax.servlet.http.HttpServletRequest request)

Logs all request parameters of the supplied request.

getAcceptableService

public static <FF extends FileFormat,S> S getAcceptableService(javax.servlet.http.HttpServletRequest request,
                                                               javax.servlet.http.HttpServletResponse response,
                                                               FileFormatServiceRegistry<FF,S> serviceRegistry)
                                                        throws ClientHTTPException

Throws:

ClientHTTPException

parseTimeoutParam

public static int parseTimeoutParam(javax.servlet.http.HttpServletRequest request)
                             throws ClientHTTPException

Reads the Protocol.TIMEOUT_PARAM_NAME parameter from the request and (if present) parses it into an integer value.

Parameters:

request - the HttpServletRequest to read the parameter from

Returns:

the value of the timeout parameter as an integer (representing the timeout time in seconds), or 0 if no timeout parameter is specified in the request.

Throws:

ClientHTTPException - if the value of the timeout parameter is not a valid integer.

logAcceptableFormats

public static void logAcceptableFormats(javax.servlet.http.HttpServletRequest request)