You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2018/01/14 16:02:33 UTC
[05/32] juneau git commit: Javadoc updates.
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestHeaders.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestHeaders.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestHeaders.java
index a08bbd7..d94c02b 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestHeaders.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestHeaders.java
@@ -28,7 +28,7 @@ import org.apache.juneau.parser.*;
/**
* Represents the headers in an HTTP request.
- *
+ *
* <p>
* Entries are stored in a case-insensitive map.
*/
@@ -60,10 +60,10 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Adds default entries to these headers.
- *
+ *
* <p>
* This includes the default headers defined on the servlet and method levels.
- *
+ *
* @param defaultEntries The default entries. Can be <jk>null</jk>.
* @return This object (for method chaining).
*/
@@ -82,7 +82,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Adds a set of header values to this object.
- *
+ *
* @param name The header name.
* @param values The header values.
* @return This object (for method chaining).
@@ -101,11 +101,11 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the specified header value, or <jk>null</jk> if the header doesn't exist.
- *
+ *
* <p>
* If {@code allowHeaderParams} init parameter is <jk>true</jk>, then first looks for {@code &HeaderName=x} in the
* URL query string.
- *
+ *
* @param name The header name.
* @return The header value, or <jk>null</jk> if it doesn't exist.
*/
@@ -122,11 +122,11 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the specified header value, or a default value if the header doesn't exist.
- *
+ *
* <p>
* If {@code allowHeaderParams} init parameter is <jk>true</jk>, then first looks for {@code &HeaderName=x} in the
* URL query string.
- *
+ *
* @param name The HTTP header name.
* @param def The default value to return if the header value isn't found.
* @return The header value, or the default value if the header isn't present.
@@ -138,7 +138,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #getString(String)} but converts the value to an integer.
- *
+ *
* @param name The HTTP header name.
* @return The header value, or the default value if the header isn't present.
*/
@@ -148,7 +148,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #getString(String,String)} but converts the value to an integer.
- *
+ *
* @param name The HTTP header name.
* @param def The default value to return if the header value isn't found.
* @return The header value, or the default value if the header isn't present.
@@ -160,7 +160,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #getString(String)} but converts the value to a boolean.
- *
+ *
* @param name The HTTP header name.
* @return The header value, or the default value if the header isn't present.
*/
@@ -170,7 +170,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #getString(String,String)} but converts the value to a boolean.
- *
+ *
* @param name The HTTP header name.
* @param def The default value to return if the header value isn't found.
* @return The header value, or the default value if the header isn't present.
@@ -182,7 +182,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Sets a request header value.
- *
+ *
* @param name The header name.
* @param value The header value.
*/
@@ -192,20 +192,20 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the specified header value converted to a POJO.
- *
+ *
* <p>
* The type can be any POJO type convertible from a <code>String</code>
* (See <a class="doclink" href="package-summary.html#PojosConvertableFromString">POJOs Convertible From Strings</a>).
- *
+ *
* <h5 class='section'>Examples:</h5>
* <p class='bcode'>
* <jc>// Parse into an integer.</jc>
* <jk>int</jk> myheader = req.getHeader(<js>"My-Header"</js>, <jk>int</jk>.<jk>class</jk>);
- *
+ *
* <jc>// Parse a UUID.</jc>
* UUID myheader = req.getHeader(<js>"My-Header"</js>, UUID.<jk>class</jk>);
* </p>
- *
+ *
* @param name The HTTP header name.
* @param type The class type to convert the header value to.
* @param <T> The class type to convert the header value to.
@@ -218,7 +218,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #get(String, Class)} but allows you to override the part parser used.
- *
+ *
* @param parser
* The parser to use for parsing the string header.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
@@ -234,7 +234,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #get(String, Class)} but returns a default value if not found.
- *
+ *
* @param name The HTTP header name.
* @param def The default value if the header was not specified or is <jk>null</jk>.
* @param type The class type to convert the header value to.
@@ -248,7 +248,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #get(String, Object, Class)} but allows you to override the part parser used.
- *
+ *
* @param parser
* The parser to use for parsing the string header.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
@@ -270,17 +270,17 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the specified header value converted to a POJO.
- *
+ *
* <p>
* The type can be any POJO type convertible from a <code>String</code>
* (See <a class="doclink" href="package-summary.html#PojosConvertableFromString">POJOs Convertible From Strings</a>).
- *
+ *
* <h5 class='section'>Examples:</h5>
* <p class='bcode'>
* <jc>// Parse into a linked-list of strings.</jc>
* List<String> myheader = req.getHeader(<js>"My-Header"</js>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
* </p>
- *
+ *
* @param name The HTTP header name.
* @param type
* The type of object to create.
@@ -332,7 +332,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns a copy of this object, but only with the specified header names copied.
- *
+ *
* @param headers The headers to include in the copy.
* @return A new headers object.
*/
@@ -346,7 +346,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Same as {@link #subset(String...)}, but allows you to specify header names as a comma-delimited list.
- *
+ *
* @param headers The headers to include in the copy.
* @return A new headers object.
*/
@@ -356,15 +356,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Accept</code> header on the request.
- *
+ *
* <p>
* Content-Types that are acceptable for the response.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Accept: text/plain
* </p>
- *
+ *
* @return The parsed <code>Accept</code> header on the request, or <jk>null</jk> if not found.
*/
public Accept getAccept() {
@@ -373,15 +373,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Accept-Charset</code> header on the request.
- *
+ *
* <p>
* Character sets that are acceptable.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Accept-Charset: utf-8
* </p>
- *
+ *
* @return The parsed <code>Accept-Charset</code> header on the request, or <jk>null</jk> if not found.
*/
public AcceptCharset getAcceptCharset() {
@@ -390,15 +390,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Accept-Encoding</code> header on the request.
- *
+ *
* <p>
* List of acceptable encodings.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Accept-Encoding: gzip, deflate
* </p>
- *
+ *
* @return The parsed <code>Accept-Encoding</code> header on the request, or <jk>null</jk> if not found.
*/
public AcceptEncoding getAcceptEncoding() {
@@ -407,15 +407,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Accept-Language</code> header on the request.
- *
+ *
* <p>
* List of acceptable human languages for response.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Accept-Language: en-US
* </p>
- *
+ *
* @return The parsed <code>Accept-Language</code> header on the request, or <jk>null</jk> if not found.
*/
public AcceptLanguage getAcceptLanguage() {
@@ -424,15 +424,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Authorization</code> header on the request.
- *
+ *
* <p>
* Authentication credentials for HTTP authentication.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
* </p>
- *
+ *
* @return The parsed <code>Authorization</code> header on the request, or <jk>null</jk> if not found.
*/
public Authorization getAuthorization() {
@@ -441,15 +441,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Cache-Control</code> header on the request.
- *
+ *
* <p>
* Used to specify directives that must be obeyed by all caching mechanisms along the request-response chain.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Cache-Control: no-cache
* </p>
- *
+ *
* @return The parsed <code>Cache-Control</code> header on the request, or <jk>null</jk> if not found.
*/
public CacheControl getCacheControl() {
@@ -458,16 +458,16 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Connection</code> header on the request.
- *
+ *
* <p>
* Control options for the current connection and list of hop-by-hop request fields.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Connection: keep-alive
* Connection: Upgrade
* </p>
- *
+ *
* @return The parsed <code></code> header on the request, or <jk>null</jk> if not found.
*/
public Connection getConnection() {
@@ -476,15 +476,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Content-Length</code> header on the request.
- *
+ *
* <p>
* The length of the request body in octets (8-bit bytes).
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Content-Length: 348
* </p>
- *
+ *
* @return The parsed <code>Content-Length</code> header on the request, or <jk>null</jk> if not found.
*/
public ContentLength getContentLength() {
@@ -493,15 +493,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Content-Type</code> header on the request.
- *
+ *
* <p>
* The MIME type of the body of the request (used with POST and PUT requests).
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Content-Type: application/x-www-form-urlencoded
* </p>
- *
+ *
* @return The parsed <code>Content-Type</code> header on the request, or <jk>null</jk> if not found.
*/
public ContentType getContentType() {
@@ -510,15 +510,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Date</code> header on the request.
- *
+ *
* <p>
* The date and time that the message was originated (in "HTTP-date" format as defined by RFC 7231 Date/Time Formats).
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Date: Tue, 15 Nov 1994 08:12:31 GMT
* </p>
- *
+ *
* @return The parsed <code>Date</code> header on the request, or <jk>null</jk> if not found.
*/
public Date getDate() {
@@ -527,15 +527,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Expect</code> header on the request.
- *
+ *
* <p>
* Indicates that particular server behaviors are required by the client.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Expect: 100-continue
* </p>
- *
+ *
* @return The parsed <code>Expect</code> header on the request, or <jk>null</jk> if not found.
*/
public Expect getExpect() {
@@ -544,15 +544,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>From</code> header on the request.
- *
+ *
* <p>
* The email address of the user making the request.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* From: user@example.com
* </p>
- *
+ *
* @return The parsed <code>From</code> header on the request, or <jk>null</jk> if not found.
*/
public From getFrom() {
@@ -561,17 +561,17 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Host</code> header on the request.
- *
+ *
* <p>
* The domain name of the server (for virtual hosting), and the TCP port number on which the server is listening.
* The port number may be omitted if the port is the standard port for the service requested.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Host: en.wikipedia.org:8080
* Host: en.wikipedia.org
* </p>
- *
+ *
* @return The parsed <code>Host</code> header on the request, or <jk>null</jk> if not found.
*/
public Host getHost() {
@@ -580,17 +580,17 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>If-Match</code> header on the request.
- *
+ *
* <p>
* Only perform the action if the client supplied entity matches the same entity on the server.
* This is mainly for methods like PUT to only update a resource if it has not been modified since the user last
* updated it.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* If-Match: "737060cd8c284d8af7ad3082f209582d"
* </p>
- *
+ *
* @return The parsed <code>If-Match</code> header on the request, or <jk>null</jk> if not found.
*/
public IfMatch getIfMatch() {
@@ -599,15 +599,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>If-Modified-Since</code> header on the request.
- *
+ *
* <p>
* Allows a 304 Not Modified to be returned if content is unchanged.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT
* </p>
- *
+ *
* @return The parsed <code>If-Modified-Since</code> header on the request, or <jk>null</jk> if not found.
*/
public IfModifiedSince getIfModifiedSince() {
@@ -616,15 +616,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>If-None-Match</code> header on the request.
- *
+ *
* <p>
* Allows a 304 Not Modified to be returned if content is unchanged, see HTTP ETag.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* If-None-Match: "737060cd8c284d8af7ad3082f209582d"
* </p>
- *
+ *
* @return The parsed <code>If-None-Match</code> header on the request, or <jk>null</jk> if not found.
*/
public IfNoneMatch getIfNoneMatch() {
@@ -633,15 +633,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>If-Range</code> header on the request.
- *
+ *
* <p>
* If the entity is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new entity.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* If-Range: "737060cd8c284d8af7ad3082f209582d"
* </p>
- *
+ *
* @return The parsed <code>If-Range</code> header on the request, or <jk>null</jk> if not found.
*/
public IfRange getIfRange() {
@@ -650,15 +650,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>If-Unmodified-Since</code> header on the request.
- *
+ *
* <p>
* Only send the response if the entity has not been modified since a specific time.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT
* </p>
- *
+ *
* @return The parsed <code>If-Unmodified-Since</code> header on the request, or <jk>null</jk> if not found.
*/
public IfUnmodifiedSince getIfUnmodifiedSince() {
@@ -667,15 +667,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Max-Forwards</code> header on the request.
- *
+ *
* <p>
* Limit the number of times the message can be forwarded through proxies or gateways.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Max-Forwards: 10
* </p>
- *
+ *
* @return The parsed <code>Max-Forwards</code> header on the request, or <jk>null</jk> if not found.
*/
public MaxForwards getMaxForwards() {
@@ -684,15 +684,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Pragma</code> header on the request.
- *
+ *
* <p>
* Implementation-specific fields that may have various effects anywhere along the request-response chain.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Pragma: no-cache
* </p>
- *
+ *
* @return The parsed <code>Pragma</code> header on the request, or <jk>null</jk> if not found.
*/
public Pragma getPragma() {
@@ -701,15 +701,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Proxy-Authorization</code> header on the request.
- *
+ *
* <p>
* Authorization credentials for connecting to a proxy.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Proxy-Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
* </p>
- *
+ *
* @return The parsed <code>Proxy-Authorization</code> header on the request, or <jk>null</jk> if not found.
*/
public ProxyAuthorization getProxyAuthorization() {
@@ -718,15 +718,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Range</code> header on the request.
- *
+ *
* <p>
* Request only part of an entity. Bytes are numbered from 0.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Range: bytes=500-999
* </p>
- *
+ *
* @return The parsed <code>Range</code> header on the request, or <jk>null</jk> if not found.
*/
public Range getRange() {
@@ -735,15 +735,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Referer</code> header on the request.
- *
+ *
* <p>
* This is the address of the previous web page from which a link to the currently requested page was followed.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Referer: http://en.wikipedia.org/wiki/Main_Page
* </p>
- *
+ *
* @return The parsed <code>Referer</code> header on the request, or <jk>null</jk> if not found.
*/
public Referer getReferer() {
@@ -752,17 +752,17 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>TE</code> header on the request.
- *
+ *
* <p>
* The transfer encodings the user agent is willing to accept: the same values as for the response header field
* Transfer-Encoding can be used, plus the "trailers" value (related to the "chunked" transfer method) to notify the
* server it expects to receive additional fields in the trailer after the last, zero-sized, chunk.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* TE: trailers, deflate
* </p>
- *
+ *
* @return The parsed <code>TE</code> header on the request, or <jk>null</jk> if not found.
*/
public TE getTE() {
@@ -771,10 +771,10 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Time-Zone</code> header value on the request if there is one.
- *
+ *
* <p>
* Example: <js>"GMT"</js>.
- *
+ *
* @return The <code>Time-Zone</code> header value on the request, or <jk>null</jk> if not present.
*/
public TimeZone getTimeZone() {
@@ -786,15 +786,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>User-Agent</code> header on the request.
- *
+ *
* <p>
* The user agent string of the user agent.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:12.0) Gecko/20100101 Firefox/21.0
* </p>
- *
+ *
* @return The parsed <code>User-Agent</code> header on the request, or <jk>null</jk> if not found.
*/
public UserAgent getUserAgent() {
@@ -803,15 +803,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Upgrade</code> header on the request.
- *
+ *
* <p>
* Ask the server to upgrade to another protocol.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Upgrade: HTTP/2.0, HTTPS/1.3, IRC/6.9, RTA/x11, websocket
* </p>
- *
+ *
* @return The parsed <code>Upgrade</code> header on the request, or <jk>null</jk> if not found.
*/
public Upgrade getUpgrade() {
@@ -820,15 +820,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Via</code> header on the request.
- *
+ *
* <p>
* Informs the server of proxies through which the request was sent.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Via: 1.0 fred, 1.1 example.com (Apache/1.1)
* </p>
- *
+ *
* @return The parsed <code>Via</code> header on the request, or <jk>null</jk> if not found.
*/
public Via getVia() {
@@ -837,15 +837,15 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Returns the <code>Warning</code> header on the request.
- *
+ *
* <p>
* A general warning about possible problems with the entity body.
- *
+ *
* <h6 class='figure'>Example:</h6>
* <p class='bcode'>
* Warning: 199 Miscellaneous warning
* </p>
- *
+ *
* @return The parsed <code>Warning</code> header on the request, or <jk>null</jk> if not found.
*/
public Warning getWarning() {
@@ -854,7 +854,7 @@ public class RequestHeaders extends TreeMap<String,String[]> {
/**
* Converts the headers to a readable string.
- *
+ *
* @param sorted Sort the headers by name.
* @return A JSON string containing the contents of the headers.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestPathMatch.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestPathMatch.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestPathMatch.java
index 48288f9..ea30efa 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestPathMatch.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestPathMatch.java
@@ -23,7 +23,7 @@ import org.apache.juneau.parser.*;
/**
* Contains information about the matched path on the HTTP request.
- *
+ *
* <p>
* Provides access to the matched path variables and path match remainder.
*/
@@ -56,7 +56,7 @@ public class RequestPathMatch extends TreeMap<String,String> {
/**
* Sets a request query parameter value.
- *
+ *
* @param name The parameter name.
* @param value The parameter value.
*/
@@ -66,29 +66,29 @@ public class RequestPathMatch extends TreeMap<String,String> {
/**
* Returns the specified path parameter converted to a POJO.
- *
+ *
* <p>
* The type can be any POJO type convertible from a <code>String</code> (See <a class="doclink"
* href="package-summary.html#PojosConvertibleFromString">POJOs Convertible From Strings</a>).
- *
+ *
* <h5 class='section'>Examples:</h5>
* <p class='bcode'>
* <jc>// Parse into an integer.</jc>
* <jk>int</jk> myparam = req.getPathParameter(<js>"myparam"</js>, <jk>int</jk>.<jk>class</jk>);
- *
+ *
* <jc>// Parse into an int array.</jc>
* <jk>int</jk>[] myparam = req.getPathParameter(<js>"myparam"</js>, <jk>int</jk>[].<jk>class</jk>);
* <jc>// Parse into a bean.</jc>
* MyBean myparam = req.getPathParameter(<js>"myparam"</js>, MyBean.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a linked-list of objects.</jc>
* List myparam = req.getPathParameter(<js>"myparam"</js>, LinkedList.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a map of object keys/values.</jc>
* Map myparam = req.getPathParameter(<js>"myparam"</js>, TreeMap.<jk>class</jk>);
* </p>
- *
+ *
* @param name The attribute name.
* @param type The class type to convert the attribute value to.
* @param <T> The class type to convert the attribute value to.
@@ -101,29 +101,29 @@ public class RequestPathMatch extends TreeMap<String,String> {
/**
* Returns the specified path parameter converted to a POJO.
- *
+ *
* <p>
* The type can be any POJO type convertible from a <code>String</code> (See <a class="doclink"
* href="package-summary.html#PojosConvertibleFromString">POJOs Convertible From Strings</a>).
- *
+ *
* <p>
* Use this method if you want to parse into a parameterized <code>Map</code>/<code>Collection</code> object.
- *
+ *
* <h5 class='section'>Examples:</h5>
* <p class='bcode'>
* <jc>// Parse into a linked-list of strings.</jc>
* List<String> myparam = req.getPathParameter(<js>"myparam"</js>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a linked-list of linked-lists of strings.</jc>
* List<List<String>> myparam = req.getPathParameter(<js>"myparam"</js>, LinkedList.<jk>class</jk>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a map of string keys/values.</jc>
* Map<String,String> myparam = req.getPathParameter(<js>"myparam"</js>, TreeMap.<jk>class</jk>, String.<jk>class</jk>, String.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a map containing string keys and values of lists containing beans.</jc>
* Map<String,List<MyBean>> myparam = req.getPathParameter(<js>"myparam"</js>, TreeMap.<jk>class</jk>, String.<jk>class</jk>, List.<jk>class</jk>, MyBean.<jk>class</jk>);
* </p>
- *
+ *
* @param name The attribute name.
* @param type
* The type of object to create.
@@ -155,7 +155,7 @@ public class RequestPathMatch extends TreeMap<String,String> {
/**
* Returns the decoded remainder of the URL following any path pattern matches.
- *
+ *
* <p>
* The behavior of path remainder is shown below given the path pattern "/foo/*":
* <table class='styled'>
@@ -192,7 +192,7 @@ public class RequestPathMatch extends TreeMap<String,String> {
* <td><js>"a/b"</js></td>
* </tr>
* </table>
- *
+ *
* <h5 class='section'>Example:</h5>
* <p class='bcode'>
* <jc>// REST method</jc>
@@ -200,11 +200,11 @@ public class RequestPathMatch extends TreeMap<String,String> {
* <jk>public</jk> String doGetById(RequestPathParams pathParams, <jk>int</jk> bar) {
* <jk>return</jk> pathParams.getRemainder();
* }
- *
+ *
* <jc>// Prints "path/remainder"</jc>
* <jk>new</jk> RestCall(servletPath + <js>"/foo/123/path/remainder"</js>).connect();
* </p>
- *
+ *
* @return The path remainder string.
*/
public String getRemainder() {
@@ -213,7 +213,7 @@ public class RequestPathMatch extends TreeMap<String,String> {
/**
* Same as {@link #getRemainder()} but doesn't decode characters.
- *
+ *
* @return The un-decoded path remainder.
*/
public String getRemainderUndecoded() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestQuery.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestQuery.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestQuery.java
index 8f1d62f..f51d5be 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestQuery.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RequestQuery.java
@@ -58,10 +58,10 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Adds default entries to these query parameters.
- *
+ *
* <p>
* This includes the default queries defined on the servlet and method levels.
- *
+ *
* @param defaultEntries The default entries. Can be <jk>null</jk>.
* @return This object (for method chaining).
*/
@@ -80,7 +80,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Sets a request query parameter value.
- *
+ *
* @param name The parameter name.
* @param value The parameter value.
*/
@@ -90,18 +90,18 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Returns a query parameter value.
- *
+ *
* <p>
* Same as {@link HttpServletRequest#getParameter(String)} except only looks in the URL string, not parameters from
* URL-Encoded FORM posts.
- *
+ *
* <p>
* This method can be used to retrieve a parameter without triggering the underlying servlet API to load and parse
* the request body.
- *
+ *
* <p>
* If multiple query parameters have the same name, this returns only the first instance.
- *
+ *
* @param name The URL parameter name.
* @return The parameter value, or <jk>null</jk> if parameter not specified or has no value (e.g. <js>"&foo"</js>.
*/
@@ -122,7 +122,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #getString(String)} but returns the specified default value if the query parameter was not
* specified.
- *
+ *
* @param name The URL parameter name.
* @param def The default value.
* @return
@@ -136,7 +136,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #getString(String)} but converts the value to an integer.
- *
+ *
* @param name The URL parameter name.
* @return
* The parameter value, or <code>0</code> if parameter not specified or has no value
@@ -148,7 +148,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #getString(String,String)} but converts the value to an integer.
- *
+ *
* @param name The URL parameter name.
* @param def The default value.
* @return
@@ -162,7 +162,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #getString(String)} but converts the value to a boolean.
- *
+ *
* @param name The URL parameter name.
* @return
* The parameter value, or <jk>false</jk> if parameter not specified or has no value
@@ -174,7 +174,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #getString(String,String)} but converts the value to a boolean.
- *
+ *
* @param name The URL parameter name.
* @param def The default value.
* @return
@@ -188,29 +188,29 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Returns the specified query parameter value converted to a POJO.
- *
+ *
* <p>
* This method can be used to retrieve a parameter without triggering the underlying servlet API to load and parse
* the request body.
- *
+ *
* <h5 class='section'>Examples:</h5>
* <p class='bcode'>
* <jc>// Parse into an integer.</jc>
* <jk>int</jk> myparam = req.getQueryParameter(<js>"myparam"</js>, <jk>int</jk>.<jk>class</jk>);
- *
+ *
* <jc>// Parse into an int array.</jc>
* <jk>int</jk>[] myparam = req.getQueryParameter(<js>"myparam"</js>, <jk>int</jk>[].<jk>class</jk>);
* <jc>// Parse into a bean.</jc>
* MyBean myparam = req.getQueryParameter(<js>"myparam"</js>, MyBean.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a linked-list of objects.</jc>
* List myparam = req.getQueryParameter(<js>"myparam"</js>, LinkedList.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a map of object keys/values.</jc>
* Map myparam = req.getQueryParameter(<js>"myparam"</js>, TreeMap.<jk>class</jk>);
* </p>
- *
+ *
* @param name The parameter name.
* @param type The class type to convert the parameter value to.
* @param <T> The class type to convert the parameter value to.
@@ -223,7 +223,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Class)} but allows you to override the part parser.
- *
+ *
* @param parser
* The parser to use for parsing the string value.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
@@ -239,7 +239,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Class)} except returns a default value if not found.
- *
+ *
* @param name The parameter name.
* @param def The default value if the parameter was not specified or is <jk>null</jk>.
* @param type The class type to convert the parameter value to.
@@ -253,7 +253,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Object, Class)} but allows you to override the part parser.
- *
+ *
* @param parser
* The parser to use for parsing the string value.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
@@ -270,29 +270,29 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Returns the specified query parameter value converted to a POJO.
- *
+ *
* <p>
* This method can be used to retrieve a parameter without triggering the underlying servlet API to load and parse
* the request body.
- *
+ *
* <p>
* Use this method if you want to parse into a parameterized <code>Map</code>/<code>Collection</code> object.
- *
+ *
* <h5 class='section'>Examples:</h5>
* <p class='bcode'>
* <jc>// Parse into a linked-list of strings.</jc>
* List<String> myparam = req.getQueryParameter(<js>"myparam"</js>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a linked-list of linked-lists of strings.</jc>
* List<List<String>> myparam = req.getQueryParameter(<js>"myparam"</js>, LinkedList.<jk>class</jk>, LinkedList.<jk>class</jk>, String.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a map of string keys/values.</jc>
* Map<String,String> myparam = req.getQueryParameter(<js>"myparam"</js>, TreeMap.<jk>class</jk>, String.<jk>class</jk>, String.<jk>class</jk>);
- *
+ *
* <jc>// Parse into a map containing string keys and values of lists containing beans.</jc>
* Map<String,List<MyBean>> myparam = req.getQueryParameter(<js>"myparam"</js>, TreeMap.<jk>class</jk>, String.<jk>class</jk>, List.<jk>class</jk>, MyBean.<jk>class</jk>);
* </p>
- *
+ *
* @param name The parameter name.
* @param type
* The type of object to create.
@@ -313,11 +313,11 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Type, Type...)} but allows you to override the part parser.
- *
+ *
* @param parser
* The parser to use for parsing the string value.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
- *
+ *
* @param name The parameter name.
* @param type
* The type of object to create.
@@ -338,7 +338,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Class)} except returns a default value if not found.
- *
+ *
* @param name The parameter name.
* @param type
* The type of object to create.
@@ -360,7 +360,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Object, Type, Type...)} but allows you to override the part parser.
- *
+ *
* @param parser
* The parser to use for parsing the string value.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
@@ -386,10 +386,10 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Class)} except for use on multi-part parameters
* (e.g. <js>"&key=1&key=2&key=3"</js> instead of <js>"&key=(1,2,3)"</js>).
- *
+ *
* <p>
* This method must only be called when parsing into classes of type Collection or array.
- *
+ *
* @param name The query parameter name.
* @param c The class type to convert the parameter value to.
* @param <T> The class type to convert the parameter value to.
@@ -403,10 +403,10 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #get(String, Type, Type...)} except for use on multi-part parameters
* (e.g. <js>"&key=1&key=2&key=3"</js> instead of <js>"&key=(1,2,3)"</js>).
- *
+ *
* <p>
* This method must only be called when parsing into classes of type Collection or array.
- *
+ *
* @param name The query parameter name.
* @param type
* The type of object to create.
@@ -427,7 +427,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Same as {@link #getAll(String, Type, Type...)} but allows you to override the part parser.
- *
+ *
* @param parser
* The parser to use for parsing the string value.
* <br>If <jk>null</jk>, uses the part parser defined on the servlet/method.
@@ -451,7 +451,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Returns <jk>true</jk> if the request contains any of the specified query parameters.
- *
+ *
* @param params The list of parameters to check for.
* @return <jk>true</jk> if the request contains any of the specified query parameters.
*/
@@ -464,7 +464,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Locates the special search query arguments in the query and returns them as a {@link SearchArgs} object.
- *
+ *
* <p>
* The query arguments are as follows:
* <ul>
@@ -489,10 +489,10 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
* <js>"&i="</js> - The case-insensitive search flag.
* <br>Example: <js>"&i=true"</js>
* </ul>
- *
+ *
* <p>
* Whitespace is trimmed in the parameters.
- *
+ *
* @return
* A new {@link SearchArgs} object initialized with the special search query arguments.
* <jk>null</jk> if no search arguments were found.
@@ -513,7 +513,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Returns <jk>true</jk> if the query parameters contains any of the specified names.
- *
+ *
* @param paramNames The parameter names to check for.
* @return <jk>true</jk> if the query parameters contains any of the specified names.
*/
@@ -575,7 +575,7 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Converts the query parameters to a readable string.
- *
+ *
* @param sorted Sort the query parameters by name.
* @return A JSON string containing the contents of the query parameters.
*/
@@ -590,10 +590,10 @@ public final class RequestQuery extends LinkedHashMap<String,String[]> {
/**
* Converts this object to a query string.
- *
+ *
* <p>
* Returned query string does not start with <js>'?'</js>.
- *
+ *
* @return A new query string, or an empty string if this object is empty.
*/
public String toQueryString() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ResponseHandler.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ResponseHandler.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ResponseHandler.java
index 34bc79a..475d4f4 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ResponseHandler.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/ResponseHandler.java
@@ -22,11 +22,11 @@ import org.apache.juneau.rest.response.*;
/**
* Defines the interface for handlers that convert POJOs to appropriate HTTP responses.
- *
+ *
* <p>
* The {@link RestServlet} API uses the concept of registered response handlers for converting objects returned by REST
* methods or set through {@link RestResponse#setOutput(Object)} into appropriate HTTP responses.
- *
+ *
* <p>
* Response handlers can be associated with {@link RestServlet RestServlets} through the following ways:
* <ul class='spaced-list'>
@@ -36,7 +36,7 @@ import org.apache.juneau.rest.response.*;
* By calling the {@link RestContextBuilder#responseHandlers(Class...)} and augmenting or creating your
* own list of handlers.
* </ul>
- *
+ *
* <p>
* By default, {@link RestServlet RestServlets} are registered with the following response handlers:
* <ul class='spaced-list'>
@@ -55,11 +55,11 @@ import org.apache.juneau.rest.response.*;
* <li>
* {@link StreamableHandler} - Handles {@link Streamable} objects.
* </ul>
- *
+ *
* <p>
* Response handlers can be used to process POJOs that cannot normally be handled through Juneau serializers, or
* because it's simply easier to define response handlers for special cases.
- *
+ *
* <p>
* The following example shows how to create a response handler to handle special <code>Foo</code> objects outside the
* normal Juneau architecture.
@@ -69,12 +69,12 @@ import org.apache.juneau.rest.response.*;
* responseHandlers=FooHandler.<jk>class</jk>
* )
* <jk>public class</jk> Example <jk>extends</jk> RestServlet {
- *
+ *
* <ja>@RestMethod</ja>(name=<jsf>GET</jsf>, path=<js>"/"</js>)
* <jk>public</jk> Foo test1() {
* <jk>return new</jk> Foo(<js>"123"</js>);
* }
- *
+ *
* <jk>public static class</jk> FooHandler <jk>implements</jk> ResponseHandler {
* <ja>@Override</ja>
* <jk>public boolean</jk> handle(RestRequest req, RestResponse res, Object output) <jk>throws</jk> IOException, RestException {
@@ -96,7 +96,7 @@ public interface ResponseHandler {
/**
* Process this response if possible.
* This method should return <jk>false</jk> if it wasn't able to process the response.
- *
+ *
* @param req The HTTP servlet request.
* @param res The HTTP servlet response;
* @param output The POJO returned by the REST method that now needs to be sent to the response.
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
index b8ac10d..70e66a3 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallHandler.java
@@ -28,11 +28,11 @@ import org.apache.juneau.rest.vars.*;
/**
* Class that handles the basic lifecycle of an HTTP REST call.
- *
+ *
* <p>
* Subclasses can override these methods to tailor how HTTP REST calls are handled.
* Subclasses MUST implement a public constructor that takes in a {@link RestContext} object.
- *
+ *
* <p>
* RestCallHandlers are associated with servlets/resources in one of the following ways:
* <ul>
@@ -48,7 +48,7 @@ public class RestCallHandler {
/**
* Constructor.
- *
+ *
* @param context The resource context.
*/
public RestCallHandler(RestContext context) {
@@ -59,10 +59,10 @@ public class RestCallHandler {
/**
* Creates a {@link RestRequest} object based on the specified incoming {@link HttpServletRequest} object.
- *
+ *
* <p>
* Subclasses may choose to override this method to provide a specialized request object.
- *
+ *
* @param req The request object from the {@link #service(HttpServletRequest, HttpServletResponse)} method.
* @return The wrapped request object.
* @throws ServletException If any errors occur trying to interpret the request.
@@ -74,10 +74,10 @@ public class RestCallHandler {
/**
* Creates a {@link RestResponse} object based on the specified incoming {@link HttpServletResponse} object
* and the request returned by {@link #createRequest(HttpServletRequest)}.
- *
+ *
* <p>
* Subclasses may choose to override this method to provide a specialized response object.
- *
+ *
* @param req The request object returned by {@link #createRequest(HttpServletRequest)}.
* @param res The response object from the {@link #service(HttpServletRequest, HttpServletResponse)} method.
* @return The wrapped response object.
@@ -89,10 +89,10 @@ public class RestCallHandler {
/**
* The main service method.
- *
+ *
* <p>
* Subclasses can optionally override this method if they want to tailor the behavior of requests.
- *
+ *
* @param r1 The incoming HTTP servlet request object.
* @param r2 The incoming HTTP servlet response object.
* @throws ServletException
@@ -202,16 +202,16 @@ public class RestCallHandler {
/**
* The main method for serializing POJOs passed in through the {@link RestResponse#setOutput(Object)} method or
* returned by the Java method.
- *
+ *
* <p>
* Subclasses may override this method if they wish to modify the way the output is rendered or support other output
* formats.
- *
+ *
* <p>
* The default implementation simply iterates through the response handlers on this resource
* looking for the first one whose {@link ResponseHandler#handle(RestRequest, RestResponse, Object)} method returns
* <jk>true</jk>.
- *
+ *
* @param req The HTTP request.
* @param res The HTTP response.
* @param output The output to serialize in the response.
@@ -228,11 +228,11 @@ public class RestCallHandler {
/**
* Handle the case where a matching method was not found.
- *
+ *
* <p>
* Subclasses can override this method to provide a 2nd-chance for specifying a response.
* The default implementation will simply throw an exception with an appropriate message.
- *
+ *
* @param rc The HTTP response code.
* @param req The HTTP request.
* @param res The HTTP response.
@@ -254,14 +254,14 @@ public class RestCallHandler {
/**
* Method for handling response errors.
- *
+ *
* <p>
* The default implementation logs the error and calls
* {@link #renderError(HttpServletRequest,HttpServletResponse,RestException)}.
- *
+ *
* <p>
* Subclasses can override this method to provide their own custom error response handling.
- *
+ *
* @param req The servlet request.
* @param res The servlet response.
* @param e The exception that occurred.
@@ -275,14 +275,14 @@ public class RestCallHandler {
/**
* Method for rendering response errors.
- *
+ *
* <p>
* The default implementation renders a plain text English message, optionally with a stack trace if
* {@link RestResource#renderResponseStackTraces() @RestResource.renderResponseStackTraces()} is enabled.
- *
+ *
* <p>
* Subclasses can override this method to provide their own custom error response handling.
- *
+ *
* @param req The servlet request.
* @param res The servlet response.
* @param e The exception that occurred.
@@ -321,10 +321,10 @@ public class RestCallHandler {
/**
* Returns the session objects for the specified request.
- *
+ *
* <p>
* The default implementation simply returns a single map containing <code>{'req':req}</code>.
- *
+ *
* @param req The REST request.
* @return The session objects for that request.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallRouter.java
----------------------------------------------------------------------
diff --git a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallRouter.java b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallRouter.java
index 48bac28..78c5e43 100644
--- a/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallRouter.java
+++ b/juneau-rest/juneau-rest-server/src/main/java/org/apache/juneau/rest/RestCallRouter.java
@@ -21,7 +21,7 @@ import javax.servlet.http.*;
/**
* Represents a group of CallMethods on a REST resource that handle the same HTTP Method name but with different
* paths/matchers/guards/etc...
- *
+ *
* <p>
* Incoming requests for a particular HTTP method type (e.g. <js>"GET"</js>) are handed off to this class and then
* dispatched to the appropriate RestJavaMethod.
@@ -68,10 +68,10 @@ public class RestCallRouter {
/**
* Workhorse method.
- *
+ *
* <p>
* Routes this request to one of the CallMethods.
- *
+ *
* @param pathInfo The value of {@link HttpServletRequest#getPathInfo()} (sorta)
* @return The HTTP response code.
*/