thredds.util

Class ServletUtil

java.lang.Object

thredds.util.ServletUtil

public class ServletUtil
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static org.slf4j.Logger	logServerStartup

Constructor Summary

Constructors

Constructor and Description
ServletUtil()

Method Summary

Modifier and Type	Method and Description
static String	formFilename(String dirPath, String filePath) Return the file path dealing with leading and trailing path seperators (which must be a slash ("/")) for the given directory and file paths.
static void	forwardToCatalogServices(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res) Forward this request to the CatalogServices servlet ("/catalog.html").
static String	getParameterIgnoreCase(javax.servlet.http.HttpServletRequest req, String paramName) Return the value of the given parameter for the given request.
static String	getReletiveURL(javax.servlet.http.HttpServletRequest req) Return the request URL relative to the server (i.e., starting with the context path).
static String	getRequest(javax.servlet.http.HttpServletRequest req) The entire request including query string
static String	getRequestBase(javax.servlet.http.HttpServletRequest req) This is everything except the query string
static String	getRequestPath(javax.servlet.http.HttpServletRequest req) servletPath + pathInfo
static String	getRequestServer(javax.servlet.http.HttpServletRequest req) This is the server part, eg http://motherlode:8080
static URI	getRequestURI(javax.servlet.http.HttpServletRequest req) The request base as a URI
static void	returnFile(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, File file, String contentType) Write a file to the response stream.
static void	returnString(String contents, javax.servlet.http.HttpServletResponse res) Send given content string as the HTTP response.
static int	setResponseContentLength(javax.servlet.http.HttpServletResponse response, String s) Set the proper content length for the string
static String	showRequestDetail(javax.servlet.http.HttpServletRequest req) Show details about the request
static String	showRequestHeaders(javax.servlet.http.HttpServletRequest req)
static void	showSystemProperties(PrintStream out)

Methods inherited from class java.lang.Object

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

Field Detail

logServerStartup

public static final org.slf4j.Logger logServerStartup

Constructor Detail

ServletUtil

public ServletUtil()

Method Detail

formFilename

public static String formFilename(String dirPath,
                                  String filePath)

Return the file path dealing with leading and trailing path seperators (which must be a slash ("/")) for the given directory and file paths.

Note: Dealing with path strings is fragile. ToDo: Switch from using path strings to java.io.Files.

Parameters:

dirPath - the directory path.

filePath - the file path.

Returns:

a full file path with the given directory and file paths.

returnFile

public static void returnFile(javax.servlet.http.HttpServletRequest req,
                              javax.servlet.http.HttpServletResponse res,
                              File file,
                              String contentType)
                       throws IOException

Write a file to the response stream. Handles Range requests.

Parameters:

req - request

res - response

file - must exist and not be a directory

contentType - must not be null

Throws:

IOException - or error

returnString

public static void returnString(String contents,
                                javax.servlet.http.HttpServletResponse res)
                         throws IOException

Send given content string as the HTTP response.

Parameters:

contents - the string to return as the HTTP response.

res - the HttpServletResponse

Throws:

IOException - if an I/O error occurs while writing the response.

setResponseContentLength

public static int setResponseContentLength(javax.servlet.http.HttpServletResponse response,
                                           String s)
                                    throws UnsupportedEncodingException

Set the proper content length for the string

Parameters:

response - the HttpServletResponse to act upon

s - the string that will be returned

Returns:

the number of bytes

Throws:

UnsupportedEncodingException - on bad character encoding

getReletiveURL

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

Return the request URL relative to the server (i.e., starting with the context path).

Parameters:

req - request

Returns:

URL relative to the server

forwardToCatalogServices

public static void forwardToCatalogServices(javax.servlet.http.HttpServletRequest req,
                                            javax.servlet.http.HttpServletResponse res)
                                     throws IOException,
                                            javax.servlet.ServletException

Forward this request to the CatalogServices servlet ("/catalog.html").

Parameters:

req - request

res - response

Throws:

IOException - on IO error

javax.servlet.ServletException - other error

showSystemProperties

public static void showSystemProperties(PrintStream out)

getRequestServer

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

This is the server part, eg http://motherlode:8080

Parameters:

req - the HttpServletRequest

Returns:

request server

getRequestBase

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

This is everything except the query string

Parameters:

req - the HttpServletRequest

Returns:

parsed request base

getRequestURI

public static URI getRequestURI(javax.servlet.http.HttpServletRequest req)

The request base as a URI

Parameters:

req - the HttpServletRequest

Returns:

parsed request as a URI

getRequestPath

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

servletPath + pathInfo

Parameters:

req - the HttpServletRequest

Returns:

parsed request servletPath + pathInfo

getRequest

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

The entire request including query string

Parameters:

req - the HttpServletRequest

Returns:

entire parsed request

getParameterIgnoreCase

public static String getParameterIgnoreCase(javax.servlet.http.HttpServletRequest req,
                                            String paramName)

Return the value of the given parameter for the given request. Should only be used if the parameter is known to only have one value. If used on a multi-valued parameter, the first value is returned.

Parameters:

req - the HttpServletRequest

paramName - the name of the parameter to find.

Returns:

the value of the given parameter for the given request.

showRequestDetail

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

Show details about the request

Parameters:

req - the request

Returns:

string showing the details of the request.

showRequestHeaders

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