org.apache.juneau.rest

Class RestUtils

java.lang.Object

org.apache.juneau.rest.RestUtils

public final class RestUtils
extends Object

Various reusable utility methods.

Constructor Summary

Constructors

Constructor and Description
RestUtils()

Method Summary

Modifier and Type	Method and Description
static String	getHttpResponseText(int rc) Returns readable text for an HTTP response code.
static String	getPathInfoUndecoded(javax.servlet.http.HttpServletRequest req) Identical to HttpServletRequest.getPathInfo() but doesn't decode encoded characters.
static Map<String,String[]>	parseQuery(Object qs) Parses a URL query string or form-data body.
static Map<String,String[]>	parseQuery(Object qs, Map<String,String[]> map) Same as parseQuery(Object) but allows you to specify the map to insert values into.
static StringBuffer	trimPathInfo(StringBuffer requestURI, String contextPath, String servletPath) Efficiently trims the path info part from a request URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

RestUtils

public RestUtils()

Method Detail

getHttpResponseText

public static String getHttpResponseText(int rc)

Returns readable text for an HTTP response code.

Parameters:

rc - The HTTP response code.

Returns:

Readable text for an HTTP response code, or null if it's an invalid code.

getPathInfoUndecoded

public static String getPathInfoUndecoded(javax.servlet.http.HttpServletRequest req)

Identical to HttpServletRequest.getPathInfo() but doesn't decode encoded characters.

Parameters:

req - The HTTP request

Returns:

The un-decoded path info.

trimPathInfo

public static StringBuffer trimPathInfo(StringBuffer requestURI,
                                        String contextPath,
                                        String servletPath)

Efficiently trims the path info part from a request URI.

The result is the URI of the servlet itself.

Parameters:

requestURI - The value returned by HttpServletRequest.getRequestURL()

contextPath - The value returned by HttpServletRequest.getContextPath()

servletPath - The value returned by HttpServletRequest.getServletPath()

Returns:

The same StringBuilder with remainder trimmed.

parseQuery

public static Map<String,String[]> parseQuery(Object qs)
                                       throws Exception

Parses a URL query string or form-data body.

Parameters:

qs - A reader or string containing the query string to parse.

Returns:

A new map containing the parsed query.

Throws:

Exception

parseQuery

public static Map<String,String[]> parseQuery(Object qs,
                                              Map<String,String[]> map)
                                       throws Exception

Same as parseQuery(Object) but allows you to specify the map to insert values into.

Parameters:

qs - A reader containing the query string to parse.

map - The map to pass the values into.

Returns:

The same map passed in, or a new map if it was null.

Throws:

Exception