com.google.gerrit.httpd.restapi

Class RestApiServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

com.google.gerrit.httpd.restapi.RestApiServlet

All Implemented Interfaces:

java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

Direct Known Subclasses:

AccessRestApiServlet, AccountsRestApiServlet, ChangesRestApiServlet, ConfigRestApiServlet, GroupsRestApiServlet, ProjectsRestApiServlet

public class RestApiServlet
extends javax.servlet.http.HttpServlet

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RestApiServlet.Globals

Field Summary

Fields

Modifier and Type	Field and Description
static byte[]	JSON_MAGIC Garbage prefix inserted before JSON output to prevent XSSI.
static java.lang.String	X_GERRIT_TRACE
static java.lang.String	XD_AUTHORIZATION
static java.lang.String	XD_CONTENT_TYPE
static java.lang.String	XD_METHOD

Constructor Summary

Constructors

Constructor and Description
RestApiServlet(RestApiServlet.Globals globals, com.google.inject.Provider<? extends RestCollection<? extends RestResource,? extends RestResource>> members)
RestApiServlet(RestApiServlet.Globals globals, RestCollection<? extends RestResource,? extends RestResource> members)

Method Summary

Modifier and Type	Method and Description
static long	replyError(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, int statusCode, java.lang.String msg, CacheControl c, java.lang.Throwable err)
static long	replyError(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, int statusCode, java.lang.String msg, java.lang.Throwable err)
static long	replyJson(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res, boolean allowTracing, com.google.common.collect.ListMultimap<java.lang.String,java.lang.String> config, java.lang.Object result) Sets a JSON reply on the given HTTP servlet response.
protected void	service(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res)

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, init, log, log

Methods inherited from class java.lang.Object

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

Field Detail

X_GERRIT_TRACE

public static final java.lang.String X_GERRIT_TRACE

See Also:

Constant Field Values

XD_AUTHORIZATION

public static final java.lang.String XD_AUTHORIZATION

See Also:

Constant Field Values

XD_CONTENT_TYPE

public static final java.lang.String XD_CONTENT_TYPE

See Also:

Constant Field Values

XD_METHOD

public static final java.lang.String XD_METHOD

See Also:

Constant Field Values

JSON_MAGIC

public static final byte[] JSON_MAGIC

Garbage prefix inserted before JSON output to prevent XSSI.

This prefix is ")]}'\n" and is designed to prevent a web browser from executing the response body if the resource URI were to be referenced using a <script src="...> HTML tag from another web site. Clients using the HTTP interface will need to always strip the first line of response data to remove this magic header.

Constructor Detail

RestApiServlet

public RestApiServlet(RestApiServlet.Globals globals,
                      RestCollection<? extends RestResource,? extends RestResource> members)

RestApiServlet

public RestApiServlet(RestApiServlet.Globals globals,
                      com.google.inject.Provider<? extends RestCollection<? extends RestResource,? extends RestResource>> members)

Method Detail

service

protected final void service(javax.servlet.http.HttpServletRequest req,
                             javax.servlet.http.HttpServletResponse res)
                      throws javax.servlet.ServletException,
                             java.io.IOException

Overrides:

service in class javax.servlet.http.HttpServlet

Throws:

javax.servlet.ServletException

java.io.IOException

replyJson

public static long replyJson(javax.servlet.http.HttpServletRequest req,
                             javax.servlet.http.HttpServletResponse res,
                             boolean allowTracing,
                             com.google.common.collect.ListMultimap<java.lang.String,java.lang.String> config,
                             java.lang.Object result)
                      throws java.io.IOException

Sets a JSON reply on the given HTTP servlet response.

Parameters:

req - the HTTP servlet request

res - the HTTP servlet response on which the reply should be set

allowTracing - whether it is allowed to log the reply if tracing is enabled, must not be set to true if the reply may contain sensitive data

config - config parameters for the JSON formatting

result - the object that should be formatted as JSON

Returns:

the length of the response

Throws:

java.io.IOException

replyError

public static long replyError(javax.servlet.http.HttpServletRequest req,
                              javax.servlet.http.HttpServletResponse res,
                              int statusCode,
                              java.lang.String msg,
                              java.lang.Throwable err)
                       throws java.io.IOException

Throws:

java.io.IOException

replyError

public static long replyError(javax.servlet.http.HttpServletRequest req,
                              javax.servlet.http.HttpServletResponse res,
                              int statusCode,
                              java.lang.String msg,
                              CacheControl c,
                              java.lang.Throwable err)
                       throws java.io.IOException

Throws:

java.io.IOException