You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by gg...@apache.org on 2014/08/21 17:09:07 UTC
svn commit: r1619429 [4/5] - in /httpcomponents:
contrib/httpcore/trunk/src/main/java/org/apache/http/contrib/sip/
httpasyncclient/trunk/httpasyncclient/src/main/java-deprecated/org/apache/http/nio/conn/scheme/
httpasyncclient/trunk/httpasyncclient/src...
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderIterator.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderIterator.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderIterator.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderIterator.java Thu Aug 21 15:09:04 2014
@@ -60,7 +60,7 @@ public class BasicHeaderIterator impleme
/**
* The header name to filter by.
- * <code>null</code> to iterate over all headers in the array.
+ * {@code null} to iterate over all headers in the array.
*/
protected String headerName;
@@ -71,7 +71,7 @@ public class BasicHeaderIterator impleme
*
* @param headers an array of headers over which to iterate
* @param name the name of the headers over which to iterate, or
- * <code>null</code> for any
+ * {@code null} for any
*/
public BasicHeaderIterator(final Header[] headers, final String name) {
super();
@@ -111,8 +111,8 @@ public class BasicHeaderIterator impleme
*
* @param index the index of the header to check
*
- * @return <code>true</code> if the header should be part of the
- * iteration, <code>false</code> to skip
+ * @return {@code true} if the header should be part of the
+ * iteration, {@code false} to skip
*/
protected boolean filterHeader(final int index) {
return (this.headerName == null) ||
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueFormatter.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueFormatter.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueFormatter.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueFormatter.java Thu Aug 21 15:09:04 2014
@@ -78,9 +78,9 @@ public class BasicHeaderValueFormatter i
* Formats an array of header elements.
*
* @param elems the header elements to format
- * @param quote <code>true</code> to always format with quoted values,
- * <code>false</code> to use quotes only when necessary
- * @param formatter the formatter to use, or <code>null</code>
+ * @param quote {@code true} to always format with quoted values,
+ * {@code false} to use quotes only when necessary
+ * @param formatter the formatter to use, or {@code null}
* for the {@link #INSTANCE default}
*
* @return the formatted header elements
@@ -122,7 +122,7 @@ public class BasicHeaderValueFormatter i
/**
* Estimates the length of formatted header elements.
*
- * @param elems the header elements to format, or <code>null</code>
+ * @param elems the header elements to format, or {@code null}
*
* @return a length estimate, in number of characters
*/
@@ -145,9 +145,9 @@ public class BasicHeaderValueFormatter i
* Formats a header element.
*
* @param elem the header element to format
- * @param quote <code>true</code> to always format with quoted values,
- * <code>false</code> to use quotes only when necessary
- * @param formatter the formatter to use, or <code>null</code>
+ * @param quote {@code true} to always format with quoted values,
+ * {@code false} to use quotes only when necessary
+ * @param formatter the formatter to use, or {@code null}
* for the {@link #INSTANCE default}
*
* @return the formatted header element
@@ -197,7 +197,7 @@ public class BasicHeaderValueFormatter i
/**
* Estimates the length of a formatted header element.
*
- * @param elem the header element to format, or <code>null</code>
+ * @param elem the header element to format, or {@code null}
*
* @return a length estimate, in number of characters
*/
@@ -231,9 +231,9 @@ public class BasicHeaderValueFormatter i
* Formats a set of parameters.
*
* @param nvps the parameters to format
- * @param quote <code>true</code> to always format with quoted values,
- * <code>false</code> to use quotes only when necessary
- * @param formatter the formatter to use, or <code>null</code>
+ * @param quote {@code true} to always format with quoted values,
+ * {@code false} to use quotes only when necessary
+ * @param formatter the formatter to use, or {@code null}
* for the {@link #INSTANCE default}
*
* @return the formatted parameters
@@ -275,7 +275,7 @@ public class BasicHeaderValueFormatter i
/**
* Estimates the length of formatted parameters.
*
- * @param nvps the parameters to format, or <code>null</code>
+ * @param nvps the parameters to format, or {@code null}
*
* @return a length estimate, in number of characters
*/
@@ -297,9 +297,9 @@ public class BasicHeaderValueFormatter i
* Formats a name-value pair.
*
* @param nvp the name-value pair to format
- * @param quote <code>true</code> to always format with a quoted value,
- * <code>false</code> to use quotes only when necessary
- * @param formatter the formatter to use, or <code>null</code>
+ * @param quote {@code true} to always format with a quoted value,
+ * {@code false} to use quotes only when necessary
+ * @param formatter the formatter to use, or {@code null}
* for the {@link #INSTANCE default}
*
* @return the formatted name-value pair
@@ -341,7 +341,7 @@ public class BasicHeaderValueFormatter i
/**
* Estimates the length of a formatted name-value pair.
*
- * @param nvp the name-value pair to format, or <code>null</code>
+ * @param nvp the name-value pair to format, or {@code null}
*
* @return a length estimate, in number of characters
*/
@@ -365,10 +365,10 @@ public class BasicHeaderValueFormatter i
* This does not include a leading = character.
* Called from {@link #formatNameValuePair formatNameValuePair}.
*
- * @param buffer the buffer to append to, never <code>null</code>
- * @param value the value to append, never <code>null</code>
- * @param quote <code>true</code> to always format with quotes,
- * <code>false</code> to use quotes only when necessary
+ * @param buffer the buffer to append to, never {@code null}
+ * @param value the value to append, never {@code null}
+ * @param quote {@code true} to always format with quotes,
+ * {@code false} to use quotes only when necessary
*/
protected void doFormatValue(final CharArrayBuffer buffer,
final String value,
@@ -402,8 +402,8 @@ public class BasicHeaderValueFormatter i
*
* @param ch the character to check
*
- * @return <code>true</code> if the character is a separator,
- * <code>false</code> otherwise
+ * @return {@code true} if the character is a separator,
+ * {@code false} otherwise
*/
protected boolean isSeparator(final char ch) {
return SEPARATORS.indexOf(ch) >= 0;
@@ -415,8 +415,8 @@ public class BasicHeaderValueFormatter i
*
* @param ch the character to check
*
- * @return <code>true</code> if the character is unsafe,
- * <code>false</code> otherwise
+ * @return {@code true} if the character is unsafe,
+ * {@code false} otherwise
*/
protected boolean isUnsafe(final char ch) {
return UNSAFE_CHARS.indexOf(ch) >= 0;
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueParser.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueParser.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueParser.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHeaderValueParser.java Thu Aug 21 15:09:04 2014
@@ -80,9 +80,9 @@ public class BasicHeaderValueParser impl
* Parses elements with the given parser.
*
* @param value the header value to parse
- * @param parser the parser to use, or <code>null</code> for default
+ * @param parser the parser to use, or {@code null} for default
*
- * @return array holding the header elements, never <code>null</code>
+ * @return array holding the header elements, never {@code null}
* @throws ParseException in case of a parsing error
*/
public static
@@ -119,7 +119,7 @@ public class BasicHeaderValueParser impl
* Parses an element with the given parser.
*
* @param value the header element to parse
- * @param parser the parser to use, or <code>null</code> for default
+ * @param parser the parser to use, or {@code null} for default
*
* @return the parsed header element
*/
@@ -172,9 +172,9 @@ public class BasicHeaderValueParser impl
* Parses parameters with the given parser.
*
* @param value the parameter list to parse
- * @param parser the parser to use, or <code>null</code> for default
+ * @param parser the parser to use, or {@code null} for default
*
- * @return array holding the parameters, never <code>null</code>
+ * @return array holding the parameters, never {@code null}
*/
public static
NameValuePair[] parseParameters(final String value,
@@ -213,7 +213,7 @@ public class BasicHeaderValueParser impl
* Parses a name-value-pair with the given parser.
*
* @param value the NVP to parse
- * @param parser the parser to use, or <code>null</code> for default
+ * @param parser the parser to use, or {@code null} for default
*
* @return the parsed name-value pair
*/
@@ -292,7 +292,7 @@ public class BasicHeaderValueParser impl
* Called from {@link #parseNameValuePair}.
*
* @param name the name
- * @param value the value, or <code>null</code>
+ * @param value the value, or {@code null}
*
* @return a name-value pair representing the arguments
*/
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHttpResponse.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHttpResponse.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHttpResponse.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicHttpResponse.java Thu Aug 21 15:09:04 2014
@@ -62,10 +62,10 @@ public class BasicHttpResponse extends A
*
* @param statusline the status line
* @param catalog the reason phrase catalog, or
- * <code>null</code> to disable automatic
+ * {@code null} to disable automatic
* reason phrase lookup
* @param locale the locale for looking up reason phrases, or
- * <code>null</code> for the system locale
+ * {@code null} for the system locale
*/
public BasicHttpResponse(final StatusLine statusline,
final ReasonPhraseCatalog catalog,
@@ -104,7 +104,7 @@ public class BasicHttpResponse extends A
* @param ver the protocol version of the response
* @param code the status code of the response
* @param reason the reason phrase to the status code, or
- * <code>null</code>
+ * {@code null}
*/
public BasicHttpResponse(final ProtocolVersion ver,
final int code,
@@ -214,7 +214,7 @@ public class BasicHttpResponse extends A
*
* @param code the status code for which to look up the reason
*
- * @return the reason phrase, or <code>null</code> if there is none
+ * @return the reason phrase, or {@code null} if there is none
*/
protected String getReason(final int code) {
return this.reasonCatalog != null ? this.reasonCatalog.getReason(code,
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineFormatter.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineFormatter.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineFormatter.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineFormatter.java Thu Aug 21 15:09:04 2014
@@ -71,7 +71,7 @@ public class BasicLineFormatter implemen
/**
* Obtains a buffer for formatting.
*
- * @param charBuffer a buffer already available, or <code>null</code>
+ * @param charBuffer a buffer already available, or {@code null}
*
* @return the cleared argument buffer if there is one, or
* a new empty buffer that can be used for formatting
@@ -92,7 +92,7 @@ public class BasicLineFormatter implemen
*
* @param version the protocol version to format
* @param formatter the formatter to use, or
- * <code>null</code> for the
+ * {@code null} for the
* {@link #INSTANCE default}
*
* @return the formatted protocol version
@@ -133,7 +133,7 @@ public class BasicLineFormatter implemen
* Guesses the length of a formatted protocol version.
* Needed to guess the length of a formatted request or status line.
*
- * @param version the protocol version to format, or <code>null</code>
+ * @param version the protocol version to format, or {@code null}
*
* @return the estimated length of the formatted protocol version,
* in characters
@@ -148,7 +148,7 @@ public class BasicLineFormatter implemen
*
* @param reqline the request line to format
* @param formatter the formatter to use, or
- * <code>null</code> for the
+ * {@code null} for the
* {@link #INSTANCE default}
*
* @return the formatted request line
@@ -177,8 +177,8 @@ public class BasicLineFormatter implemen
* Called from {@link #formatRequestLine}.
*
* @param buffer the empty buffer into which to format,
- * never <code>null</code>
- * @param reqline the request line to format, never <code>null</code>
+ * never {@code null}
+ * @param reqline the request line to format, never {@code null}
*/
protected void doFormatRequestLine(final CharArrayBuffer buffer,
final RequestLine reqline) {
@@ -204,7 +204,7 @@ public class BasicLineFormatter implemen
*
* @param statline the status line to format
* @param formatter the formatter to use, or
- * <code>null</code> for the
+ * {@code null} for the
* {@link #INSTANCE default}
*
* @return the formatted status line
@@ -233,8 +233,8 @@ public class BasicLineFormatter implemen
* Called from {@link #formatStatusLine}.
*
* @param buffer the empty buffer into which to format,
- * never <code>null</code>
- * @param statline the status line to format, never <code>null</code>
+ * never {@code null}
+ * @param statline the status line to format, never {@code null}
*/
protected void doFormatStatusLine(final CharArrayBuffer buffer,
final StatusLine statline) {
@@ -262,7 +262,7 @@ public class BasicLineFormatter implemen
*
* @param header the header to format
* @param formatter the formatter to use, or
- * <code>null</code> for the
+ * {@code null} for the
* {@link #INSTANCE default}
*
* @return the formatted header
@@ -298,8 +298,8 @@ public class BasicLineFormatter implemen
* Called from {@link #formatHeader}.
*
* @param buffer the empty buffer into which to format,
- * never <code>null</code>
- * @param header the header to format, never <code>null</code>
+ * never {@code null}
+ * @param header the header to format, never {@code null}
*/
protected void doFormatHeader(final CharArrayBuffer buffer,
final Header header) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineParser.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineParser.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineParser.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicLineParser.java Thu Aug 21 15:09:04 2014
@@ -83,7 +83,7 @@ public class BasicLineParser implements
* Creates a new line parser for the given HTTP-like protocol.
*
* @param proto a version of the protocol to parse, or
- * <code>null</code> for HTTP. The actual version
+ * {@code null} for HTTP. The actual version
* is not relevant, only the protocol name.
*/
public BasicLineParser(final ProtocolVersion proto) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicListHeaderIterator.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicListHeaderIterator.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicListHeaderIterator.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicListHeaderIterator.java Thu Aug 21 15:09:04 2014
@@ -68,7 +68,7 @@ public class BasicListHeaderIterator imp
/**
* The header name to filter by.
- * <code>null</code> to iterate over all headers in the array.
+ * {@code null} to iterate over all headers in the array.
*/
protected String headerName;
@@ -79,7 +79,7 @@ public class BasicListHeaderIterator imp
*
* @param headers a list of headers over which to iterate
* @param name the name of the headers over which to iterate, or
- * <code>null</code> for any
+ * {@code null} for any
*/
public BasicListHeaderIterator(final List<Header> headers, final String name) {
super();
@@ -120,8 +120,8 @@ public class BasicListHeaderIterator imp
*
* @param index the index of the header to check
*
- * @return <code>true</code> if the header should be part of the
- * iteration, <code>false</code> to skip
+ * @return {@code true} if the header should be part of the
+ * iteration, {@code false} to skip
*/
protected boolean filterHeader(final int index) {
if (this.headerName == null) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicStatusLine.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicStatusLine.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicStatusLine.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicStatusLine.java Thu Aug 21 15:09:04 2014
@@ -62,7 +62,7 @@ public class BasicStatusLine implements
* @param version the protocol version of the response
* @param statusCode the status code of the response
* @param reasonPhrase the reason phrase to the status code, or
- * <code>null</code>
+ * {@code null}
*/
public BasicStatusLine(final ProtocolVersion version, final int statusCode,
final String reasonPhrase) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicTokenIterator.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicTokenIterator.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicTokenIterator.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/BasicTokenIterator.java Thu Aug 21 15:09:04 2014
@@ -64,7 +64,7 @@ public class BasicTokenIterator implemen
/**
* The token to be returned by the next call to {@link #nextToken()}.
- * <code>null</code> if the iteration is over.
+ * {@code null} if the iteration is over.
*/
protected String currentToken;
@@ -154,7 +154,7 @@ public class BasicTokenIterator implemen
* The return value indicates the position after the token
* in {@link #currentHeader}. If necessary, the next header
* will be obtained from {@link #headerIt}.
- * If not found, {@link #currentToken} is set to <code>null</code>.
+ * If not found, {@link #currentToken} is set to {@code null}.
*
* @param pos the position in the current header at which to
* start the search, -1 to search in the first header
@@ -311,7 +311,7 @@ public class BasicTokenIterator implemen
* @param from the position of the first character of the token
*
* @return the position after the last character of the token.
- * The behavior is undefined if <code>from</code> does not
+ * The behavior is undefined if {@code from} does not
* point to a token character in the current header value.
*/
protected int findTokenEnd(final int from) {
@@ -334,8 +334,8 @@ public class BasicTokenIterator implemen
*
* @param ch the character to check
*
- * @return <code>true</code> if the character is a token separator,
- * <code>false</code> otherwise
+ * @return {@code true} if the character is a token separator,
+ * {@code false} otherwise
*/
protected boolean isTokenSeparator(final char ch) {
return (ch == ',');
@@ -350,8 +350,8 @@ public class BasicTokenIterator implemen
*
* @param ch the character to check
*
- * @return <code>true</code> if the character is whitespace,
- * <code>false</code> otherwise
+ * @return {@code true} if the character is whitespace,
+ * {@code false} otherwise
*/
protected boolean isWhitespace(final char ch) {
@@ -370,8 +370,8 @@ public class BasicTokenIterator implemen
*
* @param ch the character to check
*
- * @return <code>true</code> if the character is a valid token start,
- * <code>false</code> otherwise
+ * @return {@code true} if the character is a valid token start,
+ * {@code false} otherwise
*/
protected boolean isTokenChar(final char ch) {
@@ -408,7 +408,7 @@ public class BasicTokenIterator implemen
*
* @param ch the character to check
*
- * @return <code>true</code> if the character is an HTTP separator
+ * @return {@code true} if the character is an HTTP separator
*/
protected boolean isHttpSeparator(final char ch) {
return (HTTP_SEPARATORS.indexOf(ch) >= 0);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderGroup.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderGroup.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderGroup.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderGroup.java Thu Aug 21 15:09:04 2014
@@ -140,7 +140,7 @@ public class HeaderGroup implements Clon
* <p>Header name comparison is case insensitive.
*
* @param name the name of the header(s) to get
- * @return a header with a condensed value or <code>null</code> if no
+ * @return a header with a condensed value or {@code null} if no
* headers by the given name are present
*/
public Header getCondensedHeader(final String name) {
@@ -193,7 +193,7 @@ public class HeaderGroup implements Clon
* <p>Header name comparison is case insensitive.
*
* @param name the name of the header to get
- * @return the first header or <code>null</code>
+ * @return the first header or {@code null}
*/
public Header getFirstHeader(final String name) {
// HTTPCORE-361 : we don't use the for-each syntax, i.e.
@@ -214,7 +214,7 @@ public class HeaderGroup implements Clon
* <p>Header name comparison is case insensitive.
*
* @param name the name of the header to get
- * @return the last header or <code>null</code>
+ * @return the last header or {@code null}
*/
public Header getLastHeader(final String name) {
// start at the end of the list and work backwards
@@ -243,8 +243,8 @@ public class HeaderGroup implements Clon
* <p>Header name comparison is case insensitive.
*
* @param name the header name to test for
- * @return <code>true</code> if at least one header with the name is
- * contained, <code>false</code> otherwise
+ * @return {@code true} if at least one header with the name is
+ * contained, {@code false} otherwise
*/
public boolean containsHeader(final String name) {
// HTTPCORE-361 : we don't use the for-each syntax, i.e.
@@ -275,7 +275,7 @@ public class HeaderGroup implements Clon
* Returns an iterator over the headers with a given name in this group.
*
* @param name the name of the headers over which to iterate, or
- * <code>null</code> for all headers
+ * {@code null} for all headers
*
* @return iterator over some headers in this group.
*
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueFormatter.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueFormatter.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueFormatter.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueFormatter.java Thu Aug 21 15:09:04 2014
@@ -52,13 +52,13 @@ public interface HeaderValueFormatter {
* Formats an array of header elements.
*
* @param buffer the buffer to append to, or
- * <code>null</code> to create a new buffer
+ * {@code null} to create a new buffer
* @param elems the header elements to format
- * @param quote <code>true</code> to always format with quoted values,
- * <code>false</code> to use quotes only when necessary
+ * @param quote {@code true} to always format with quoted values,
+ * {@code false} to use quotes only when necessary
*
* @return a buffer with the formatted header elements.
- * If the <code>buffer</code> argument was not <code>null</code>,
+ * If the {@code buffer} argument was not {@code null},
* that buffer will be used and returned.
*/
CharArrayBuffer formatElements(CharArrayBuffer buffer,
@@ -69,13 +69,13 @@ public interface HeaderValueFormatter {
* Formats one header element.
*
* @param buffer the buffer to append to, or
- * <code>null</code> to create a new buffer
+ * {@code null} to create a new buffer
* @param elem the header element to format
- * @param quote <code>true</code> to always format with quoted values,
- * <code>false</code> to use quotes only when necessary
+ * @param quote {@code true} to always format with quoted values,
+ * {@code false} to use quotes only when necessary
*
* @return a buffer with the formatted header element.
- * If the <code>buffer</code> argument was not <code>null</code>,
+ * If the {@code buffer} argument was not {@code null},
* that buffer will be used and returned.
*/
CharArrayBuffer formatHeaderElement(CharArrayBuffer buffer,
@@ -88,13 +88,13 @@ public interface HeaderValueFormatter {
* This method will <i>not</i> generate a leading semicolon.
*
* @param buffer the buffer to append to, or
- * <code>null</code> to create a new buffer
+ * {@code null} to create a new buffer
* @param nvps the parameters (name-value pairs) to format
- * @param quote <code>true</code> to always format with quoted values,
- * <code>false</code> to use quotes only when necessary
+ * @param quote {@code true} to always format with quoted values,
+ * {@code false} to use quotes only when necessary
*
* @return a buffer with the formatted parameters.
- * If the <code>buffer</code> argument was not <code>null</code>,
+ * If the {@code buffer} argument was not {@code null},
* that buffer will be used and returned.
*/
CharArrayBuffer formatParameters(CharArrayBuffer buffer,
@@ -105,13 +105,13 @@ public interface HeaderValueFormatter {
* Formats one name-value pair, where the value is optional.
*
* @param buffer the buffer to append to, or
- * <code>null</code> to create a new buffer
+ * {@code null} to create a new buffer
* @param nvp the name-value pair to format
- * @param quote <code>true</code> to always format with a quoted value,
- * <code>false</code> to use quotes only when necessary
+ * @param quote {@code true} to always format with a quoted value,
+ * {@code false} to use quotes only when necessary
*
* @return a buffer with the formatted name-value pair.
- * If the <code>buffer</code> argument was not <code>null</code>,
+ * If the {@code buffer} argument was not {@code null},
* that buffer will be used and returned.
*/
CharArrayBuffer formatNameValuePair(CharArrayBuffer buffer,
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueParser.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueParser.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueParser.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/HeaderValueParser.java Thu Aug 21 15:09:04 2014
@@ -42,7 +42,7 @@ public interface HeaderValueParser {
/**
* Parses a header value into elements.
- * Parse errors are indicated as <code>RuntimeException</code>.
+ * Parse errors are indicated as {@code RuntimeException}.
* <p>
* Some HTTP headers (such as the set-cookie header) have values that
* can be decomposed into multiple elements. In order to be processed
@@ -101,7 +101,7 @@ public interface HeaderValueParser {
/**
* Parses a list of name-value pairs.
* These lists are used to specify parameters to a header element.
- * Parse errors are indicated as <code>ParseException</code>.
+ * Parse errors are indicated as {@code ParseException}.
*
* @param buffer buffer holding the name-value list to parse
* @param cursor the parser cursor containing the current position and
@@ -123,7 +123,7 @@ public interface HeaderValueParser {
* @param cursor the parser cursor containing the current position and
* the bounds within the buffer for the parsing operation
*
- * @return the name-value pair, where the value is <code>null</code>
+ * @return the name-value pair, where the value is {@code null}
* if no value is specified
*/
NameValuePair parseNameValuePair(
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineFormatter.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineFormatter.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineFormatter.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineFormatter.java Thu Aug 21 15:09:04 2014
@@ -48,7 +48,7 @@ import org.apache.http.util.CharArrayBuf
* a buffer can be passed as argument to all formatting methods.
* The implementation may or may not actually use that buffer for formatting.
* If it is used, the buffer will first be cleared by the
- * <code>formatXXX</code> methods.
+ * {@code formatXXX} methods.
* The argument buffer can always be re-used after the call. The buffer
* returned as the result, if it is different from the argument buffer,
* MUST NOT be modified.
@@ -61,18 +61,18 @@ public interface LineFormatter {
/**
* Formats a protocol version.
* This method does <i>not</i> follow the general contract for
- * <code>buffer</code> arguments.
+ * {@code buffer} arguments.
* It does <i>not</i> clear the argument buffer, but appends instead.
* The returned buffer can always be modified by the caller.
* Because of these differing conventions, it is not named
- * <code>formatProtocolVersion</code>.
+ * {@code formatProtocolVersion}.
*
- * @param buffer a buffer to which to append, or <code>null</code>
+ * @param buffer a buffer to which to append, or {@code null}
* @param version the protocol version to format
*
* @return a buffer with the formatted protocol version appended.
* The caller is allowed to modify the result buffer.
- * If the <code>buffer</code> argument is not <code>null</code>,
+ * If the {@code buffer} argument is not {@code null},
* the returned buffer is the argument buffer.
*/
CharArrayBuffer appendProtocolVersion(CharArrayBuffer buffer,
@@ -82,7 +82,7 @@ public interface LineFormatter {
* Formats a request line.
*
* @param buffer a buffer available for formatting, or
- * <code>null</code>.
+ * {@code null}.
* The buffer will be cleared before use.
* @param reqline the request line to format
*
@@ -95,7 +95,7 @@ public interface LineFormatter {
* Formats a status line.
*
* @param buffer a buffer available for formatting, or
- * <code>null</code>.
+ * {@code null}.
* The buffer will be cleared before use.
* @param statline the status line to format
*
@@ -117,11 +117,11 @@ public interface LineFormatter {
* </p>
*
* @param buffer a buffer available for formatting, or
- * <code>null</code>.
+ * {@code null}.
* The buffer will be cleared before use.
* @param header the header to format
*
- * @return a buffer holding the formatted header, never <code>null</code>.
+ * @return a buffer holding the formatted header, never {@code null}.
* The returned buffer may be different from the argument buffer.
*
* @throws org.apache.http.ParseException in case of a parse error
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineParser.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineParser.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineParser.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/LineParser.java Thu Aug 21 15:09:04 2014
@@ -78,9 +78,9 @@ public interface LineParser {
* whitespace before or after the protocol version is
* implementation dependent.
*
- * @return <code>true</code> if there is a protocol version at the
+ * @return {@code true} if there is a protocol version at the
* argument index (possibly ignoring whitespace),
- * <code>false</code> otherwise
+ * {@code false} otherwise
*/
boolean hasProtocolVersion(
CharArrayBuffer buffer,
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/TokenParser.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/TokenParser.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/TokenParser.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/message/TokenParser.java Thu Aug 21 15:09:04 2014
@@ -81,7 +81,7 @@ public class TokenParser {
*
* @param buf buffer with the sequence of chars to be parsed
* @param cursor defines the bounds and current position of the buffer
- * @param delimiters set of delimiting characters. Can be <code>null</code> if the token
+ * @param delimiters set of delimiting characters. Can be {@code null} if the token
* is not delimited by any character.
*/
public String parseToken(final CharArrayBuffer buf, final ParserCursor cursor, final BitSet delimiters) {
@@ -112,7 +112,7 @@ public class TokenParser {
*
* @param buf buffer with the sequence of chars to be parsed
* @param cursor defines the bounds and current position of the buffer
- * @param delimiters set of delimiting characters. Can be <code>null</code> if the value
+ * @param delimiters set of delimiting characters. Can be {@code null} if the value
* is not delimited by any character.
*/
public String parseValue(final CharArrayBuffer buf, final ParserCursor cursor, final BitSet delimiters) {
@@ -170,7 +170,7 @@ public class TokenParser {
*
* @param buf buffer with the sequence of chars to be parsed
* @param cursor defines the bounds and current position of the buffer
- * @param delimiters set of delimiting characters. Can be <code>null</code> if the value
+ * @param delimiters set of delimiting characters. Can be {@code null} if the value
* is delimited by a whitespace only.
* @param dst destination buffer
*/
@@ -197,7 +197,7 @@ public class TokenParser {
*
* @param buf buffer with the sequence of chars to be parsed
* @param cursor defines the bounds and current position of the buffer
- * @param delimiters set of delimiting characters. Can be <code>null</code> if the value
+ * @param delimiters set of delimiting characters. Can be {@code null} if the value
* is delimited by a whitespace or a quote only.
* @param dst destination buffer
*/
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreConnectionPNames.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreConnectionPNames.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreConnectionPNames.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreConnectionPNames.java Thu Aug 21 15:09:04 2014
@@ -39,7 +39,7 @@ package org.apache.http.params;
public interface CoreConnectionPNames {
/**
- * Defines the socket timeout (<code>SO_TIMEOUT</code>) in milliseconds,
+ * Defines the socket timeout ({@code SO_TIMEOUT}) in milliseconds,
* which is the timeout for waiting for data or, put differently,
* a maximum period inactivity between two consecutive data packets).
* A timeout value of zero is interpreted as an infinite timeout.
@@ -75,8 +75,8 @@ public interface CoreConnectionPNames {
/**
* Sets SO_LINGER with the specified linger time in seconds. The maximum
- * timeout value is platform specific. Value <code>0</code> implies that
- * the option is disabled. Value <code>-1</code> implies that the JRE
+ * timeout value is platform specific. Value {@code 0} implies that
+ * the option is disabled. Value {@code -1} implies that the JRE
* default is used. The setting only affects the socket close operation.
* <p>
* This parameter expects a value of type {@link Integer}.
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreProtocolPNames.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreProtocolPNames.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreProtocolPNames.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/CoreProtocolPNames.java Thu Aug 21 15:09:04 2014
@@ -63,7 +63,7 @@ public interface CoreProtocolPNames {
public static final String HTTP_CONTENT_CHARSET = "http.protocol.content-charset";
/**
- * Defines the content of the <code>User-Agent</code> header.
+ * Defines the content of the {@code User-Agent} header.
* <p>
* This parameter expects a value of type {@link String}.
* </p>
@@ -71,7 +71,7 @@ public interface CoreProtocolPNames {
public static final String USER_AGENT = "http.useragent";
/**
- * Defines the content of the <code>Server</code> header.
+ * Defines the content of the {@code Server} header.
* <p>
* This parameter expects a value of type {@link String}.
* </p>
@@ -79,7 +79,7 @@ public interface CoreProtocolPNames {
public static final String ORIGIN_SERVER = "http.origin-server";
/**
- * Defines whether responses with an invalid <code>Transfer-Encoding</code>
+ * Defines whether responses with an invalid {@code Transfer-Encoding}
* header should be rejected.
* <p>
* This parameter expects a value of type {@link Boolean}.
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/HttpParams.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/HttpParams.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/HttpParams.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/params/HttpParams.java Thu Aug 21 15:09:04 2014
@@ -56,8 +56,8 @@ public interface HttpParams {
* @param name the parent name.
*
* @return an object that represents the value of the parameter,
- * <code>null</code> if the parameter is not set or if it
- * is explicitly set to <code>null</code>
+ * {@code null} if the parameter is not set or if it
+ * is explicitly set to {@code null}
*
* @see #setParameter(String, Object)
*/
@@ -172,23 +172,23 @@ public interface HttpParams {
HttpParams setBooleanParameter(String name, boolean value);
/**
- * Checks if a boolean parameter is set to <code>true</code>.
+ * Checks if a boolean parameter is set to {@code true}.
*
* @param name parameter name
*
* @return {@code true</tt> if the parameter is set to value <tt>true},
- * {@code false} if it is not set or set to <code>false</code>
+ * {@code false} if it is not set or set to {@code false}
*/
boolean isParameterTrue(String name);
/**
- * Checks if a boolean parameter is not set or <code>false</code>.
+ * Checks if a boolean parameter is not set or {@code false}.
*
* @param name parameter name
*
* @return {@code true} if the parameter is either not set or
* set to value {@code false},
- * {@code false} if it is set to <code>true</code>
+ * {@code false} if it is set to {@code true}
*/
boolean isParameterFalse(String name);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/AbstractConnPool.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/AbstractConnPool.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/AbstractConnPool.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/AbstractConnPool.java Thu Aug 21 15:09:04 2014
@@ -204,7 +204,7 @@ public abstract class AbstractConnPool<T
* @param state arbitrary object that represents a particular state
* (usually a security principal or a unique token identifying
* the user whose credentials have been used while establishing the connection).
- * May be <code>null</code>.
+ * May be {@code null}.
* @return future for a leased pool entry.
*/
public Future<E> lease(final T route, final Object state) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/ConnPool.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/ConnPool.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/ConnPool.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/ConnPool.java Thu Aug 21 15:09:04 2014
@@ -49,7 +49,7 @@ public interface ConnPool<T, E> {
* @param state arbitrary object that represents a particular state
* (usually a security principal or a unique token identifying
* the user whose credentials have been used while establishing the connection).
- * May be <code>null</code>.
+ * May be {@code null}.
* @param callback operation completion callback.
*
* @return future for a leased pool entry.
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/PoolEntry.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/PoolEntry.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/PoolEntry.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/pool/PoolEntry.java Thu Aug 21 15:09:04 2014
@@ -68,7 +68,7 @@ public abstract class PoolEntry<T, C> {
/**
* Creates new {@code PoolEntry} instance.
*
- * @param id unique identifier of the pool entry. May be <code>null</code>.
+ * @param id unique identifier of the pool entry. May be {@code null}.
* @param route route to the opposite endpoint.
* @param conn the connection.
* @param timeToLive maximum time to live. May be zero if the connection
@@ -96,7 +96,7 @@ public abstract class PoolEntry<T, C> {
/**
* Creates new {@code PoolEntry} instance without an expiry deadline.
*
- * @param id unique identifier of the pool entry. May be <code>null</code>.
+ * @param id unique identifier of the pool entry. May be {@code null}.
* @param route route to the opposite endpoint.
* @param conn the connection.
*/
@@ -174,7 +174,7 @@ public abstract class PoolEntry<T, C> {
public abstract void close();
/**
- * Returns <code>true</code> if the pool entry has been invalidated.
+ * Returns {@code true} if the pool entry has been invalidated.
*/
public abstract boolean isClosed();
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpContext.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpContext.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpContext.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpContext.java Thu Aug 21 15:09:04 2014
@@ -52,7 +52,7 @@ public interface HttpContext {
* Obtains attribute with the given name.
*
* @param id the attribute name.
- * @return attribute value, or <code>null</code> if not set.
+ * @return attribute value, or {@code null} if not set.
*/
Object getAttribute(String id);
@@ -68,7 +68,7 @@ public interface HttpContext {
* Removes attribute with the given name from the context.
*
* @param id the attribute name.
- * @return attribute value, or <code>null</code> if not set.
+ * @return attribute value, or {@code null} if not set.
*/
Object removeAttribute(String id);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpExpectationVerifier.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpExpectationVerifier.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpExpectationVerifier.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpExpectationVerifier.java Thu Aug 21 15:09:04 2014
@@ -65,10 +65,10 @@ public interface HttpExpectationVerifier
* If the request fails to meet particular criteria, this method can
* trigger a terminal response back to the client by setting the status
* code of the response object to a value greater or equal to
- * <code>200</code>. In this case the client will not have to transmit
+ * {@code 200}. In this case the client will not have to transmit
* the request body. If the request meets expectations this method can
* terminate without modifying the response object. Per default the status
- * code of the response object will be set to <code>100</code>.
+ * code of the response object will be set to {@code 100}.
*
* @param request the HTTP request.
* @param response the HTTP response.
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestExecutor.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestExecutor.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestExecutor.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestExecutor.java Thu Aug 21 15:09:04 2014
@@ -182,7 +182,7 @@ public class HttpRequestExecutor {
*
* @return a terminal response received as part of an expect-continue
* handshake, or
- * <code>null</code> if the expect-continue handshake is not used
+ * {@code null} if the expect-continue handshake is not used
*
* @throws IOException in case of an I/O error.
* @throws HttpException in case of HTTP protocol violation or a processing
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerMapper.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerMapper.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerMapper.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerMapper.java Thu Aug 21 15:09:04 2014
@@ -42,7 +42,7 @@ public interface HttpRequestHandlerMappe
* Looks up a handler matching the given request.
*
* @param request the request to map to a handler
- * @return HTTP request handler or <code>null</code> if no match
+ * @return HTTP request handler or {@code null} if no match
* is found.
*/
HttpRequestHandler lookup(HttpRequest request);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerResolver.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerResolver.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerResolver.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestHandlerResolver.java Thu Aug 21 15:09:04 2014
@@ -43,7 +43,7 @@ public interface HttpRequestHandlerResol
* Looks up a handler matching the given request URI.
*
* @param requestURI the request URI
- * @return HTTP request handler or <code>null</code> if no match
+ * @return HTTP request handler or {@code null} if no match
* is found.
*/
HttpRequestHandler lookup(String requestURI);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestInterceptorList.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestInterceptorList.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestInterceptorList.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpRequestInterceptorList.java Thu Aug 21 15:09:04 2014
@@ -72,7 +72,7 @@ public interface HttpRequestInterceptorL
* 0 for first
*
* @return the interceptor at the given index, or
- * <code>null</code> if the index is out of range
+ * {@code null} if the index is out of range
*/
HttpRequestInterceptor getRequestInterceptor(int index);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpResponseInterceptorList.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpResponseInterceptorList.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpResponseInterceptorList.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpResponseInterceptorList.java Thu Aug 21 15:09:04 2014
@@ -72,7 +72,7 @@ public interface HttpResponseInterceptor
* 0 for first
*
* @return the interceptor at the given index, or
- * <code>null</code> if the index is out of range
+ * {@code null} if the index is out of range
*/
HttpResponseInterceptor getResponseInterceptor(int index);
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpService.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpService.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpService.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/HttpService.java Thu Aug 21 15:09:04 2014
@@ -167,9 +167,9 @@ public class HttpService {
* Create a new HTTP service.
*
* @param processor the processor to use on requests and responses
- * @param connStrategy the connection reuse strategy. If <code>null</code>
+ * @param connStrategy the connection reuse strategy. If {@code null}
* {@link DefaultConnectionReuseStrategy#INSTANCE} will be used.
- * @param responseFactory the response factory. If <code>null</code>
+ * @param responseFactory the response factory. If {@code null}
* {@link DefaultHttpResponseFactory#INSTANCE} will be used.
* @param handlerMapper the handler mapper. May be null.
* @param expectationVerifier the expectation verifier. May be null.
@@ -196,9 +196,9 @@ public class HttpService {
* Create a new HTTP service.
*
* @param processor the processor to use on requests and responses
- * @param connStrategy the connection reuse strategy. If <code>null</code>
+ * @param connStrategy the connection reuse strategy. If {@code null}
* {@link DefaultConnectionReuseStrategy#INSTANCE} will be used.
- * @param responseFactory the response factory. If <code>null</code>
+ * @param responseFactory the response factory. If {@code null}
* {@link DefaultHttpResponseFactory#INSTANCE} will be used.
* @param handlerMapper the handler mapper. May be null.
*
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestConnControl.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestConnControl.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestConnControl.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestConnControl.java Thu Aug 21 15:09:04 2014
@@ -36,9 +36,9 @@ import org.apache.http.annotation.Immuta
import org.apache.http.util.Args;
/**
- * RequestConnControl is responsible for adding <code>Connection</code> header
+ * RequestConnControl is responsible for adding {@code Connection} header
* to the outgoing requests, which is essential for managing persistence of
- * <code>HTTP/1.0</code> connections. This interceptor is recommended for
+ * {@code HTTP/1.0} connections. This interceptor is recommended for
* client side protocol processors.
*
* @since 4.0
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestContent.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestContent.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestContent.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestContent.java Thu Aug 21 15:09:04 2014
@@ -43,7 +43,7 @@ import org.apache.http.util.Args;
/**
* RequestContent is the most important interceptor for outgoing requests.
* It is responsible for delimiting content length by adding
- * <code>Content-Length</code> or <code>Transfer-Content</code> headers based
+ * {@code Content-Length} or {@code Transfer-Content} headers based
* on the properties of the enclosed entity and the protocol version.
* This interceptor is required for correct functioning of client side protocol
* processors.
@@ -56,7 +56,7 @@ public class RequestContent implements H
private final boolean overwrite;
/**
- * Default constructor. The <code>Content-Length</code> or <code>Transfer-Encoding</code>
+ * Default constructor. The {@code Content-Length} or {@code Transfer-Encoding}
* will cause the interceptor to throw {@link ProtocolException} if already present in the
* response message.
*/
@@ -67,10 +67,10 @@ public class RequestContent implements H
/**
* Constructor that can be used to fine-tune behavior of this interceptor.
*
- * @param overwrite If set to <code>true</code> the <code>Content-Length</code> and
- * <code>Transfer-Encoding</code> headers will be created or updated if already present.
- * If set to <code>false</code> the <code>Content-Length</code> and
- * <code>Transfer-Encoding</code> headers will cause the interceptor to throw
+ * @param overwrite If set to {@code true} the {@code Content-Length} and
+ * {@code Transfer-Encoding} headers will be created or updated if already present.
+ * If set to {@code false} the {@code Content-Length} and
+ * {@code Transfer-Encoding} headers will cause the interceptor to throw
* {@link ProtocolException} if already present in the response message.
*
* @since 4.2
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestDate.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestDate.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestDate.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestDate.java Thu Aug 21 15:09:04 2014
@@ -37,7 +37,7 @@ import org.apache.http.annotation.Thread
import org.apache.http.util.Args;
/**
- * RequestDate interceptor is responsible for adding <code>Date</code> header
+ * RequestDate interceptor is responsible for adding {@code Date} header
* to the outgoing requests This interceptor is optional for client side
* protocol processors.
*
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestExpectContinue.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestExpectContinue.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestExpectContinue.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestExpectContinue.java Thu Aug 21 15:09:04 2014
@@ -42,7 +42,7 @@ import org.apache.http.util.Args;
/**
* RequestExpectContinue is responsible for enabling the 'expect-continue'
- * handshake by adding <code>Expect</code> header. This interceptor is
+ * handshake by adding {@code Expect} header. This interceptor is
* recommended for client side protocol processors.
*
* @since 4.0
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestTargetHost.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestTargetHost.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestTargetHost.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestTargetHost.java Thu Aug 21 15:09:04 2014
@@ -43,7 +43,7 @@ import org.apache.http.annotation.Immuta
import org.apache.http.util.Args;
/**
- * RequestTargetHost is responsible for adding <code>Host</code> header. This
+ * RequestTargetHost is responsible for adding {@code Host} header. This
* interceptor is required for client side protocol processors.
*
* @since 4.0
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestUserAgent.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestUserAgent.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestUserAgent.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/RequestUserAgent.java Thu Aug 21 15:09:04 2014
@@ -38,7 +38,7 @@ import org.apache.http.params.HttpParams
import org.apache.http.util.Args;
/**
- * RequestUserAgent is responsible for adding <code>User-Agent</code> header.
+ * RequestUserAgent is responsible for adding {@code User-Agent} header.
* This interceptor is recommended for client side protocol processors.
*
* @since 4.0
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseConnControl.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseConnControl.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseConnControl.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseConnControl.java Thu Aug 21 15:09:04 2014
@@ -42,9 +42,9 @@ import org.apache.http.annotation.Immuta
import org.apache.http.util.Args;
/**
- * ResponseConnControl is responsible for adding <code>Connection</code> header
+ * ResponseConnControl is responsible for adding {@code Connection} header
* to the outgoing responses, which is essential for managing persistence of
- * <code>HTTP/1.0</code> connections. This interceptor is recommended for
+ * {@code HTTP/1.0} connections. This interceptor is recommended for
* server side protocol processors.
*
* @since 4.0
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseContent.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseContent.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseContent.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseContent.java Thu Aug 21 15:09:04 2014
@@ -43,7 +43,7 @@ import org.apache.http.util.Args;
/**
* ResponseContent is the most important interceptor for outgoing responses.
* It is responsible for delimiting content length by adding
- * <code>Content-Length</code> or <code>Transfer-Content</code> headers based
+ * {@code Content-Length} or {@code Transfer-Content} headers based
* on the properties of the enclosed entity and the protocol version.
* This interceptor is required for correct functioning of server side protocol
* processors.
@@ -56,7 +56,7 @@ public class ResponseContent implements
private final boolean overwrite;
/**
- * Default constructor. The <code>Content-Length</code> or <code>Transfer-Encoding</code>
+ * Default constructor. The {@code Content-Length} or {@code Transfer-Encoding}
* will cause the interceptor to throw {@link ProtocolException} if already present in the
* response message.
*/
@@ -67,10 +67,10 @@ public class ResponseContent implements
/**
* Constructor that can be used to fine-tune behavior of this interceptor.
*
- * @param overwrite If set to <code>true</code> the <code>Content-Length</code> and
- * <code>Transfer-Encoding</code> headers will be created or updated if already present.
- * If set to <code>false</code> the <code>Content-Length</code> and
- * <code>Transfer-Encoding</code> headers will cause the interceptor to throw
+ * @param overwrite If set to {@code true} the {@code Content-Length} and
+ * {@code Transfer-Encoding} headers will be created or updated if already present.
+ * If set to {@code false} the {@code Content-Length} and
+ * {@code Transfer-Encoding} headers will cause the interceptor to throw
* {@link ProtocolException} if already present in the response message.
*
* @since 4.2
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseServer.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseServer.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseServer.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/ResponseServer.java Thu Aug 21 15:09:04 2014
@@ -36,7 +36,7 @@ import org.apache.http.annotation.Immuta
import org.apache.http.util.Args;
/**
- * ResponseServer is responsible for adding <code>Server</code> header. This
+ * ResponseServer is responsible for adding {@code Server} header. This
* interceptor is recommended for server side protocol processors.
*
* @since 4.0
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriHttpRequestHandlerMapper.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriHttpRequestHandlerMapper.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriHttpRequestHandlerMapper.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriHttpRequestHandlerMapper.java Thu Aug 21 15:09:04 2014
@@ -36,9 +36,9 @@ import org.apache.http.util.Args;
* <br>
* Patterns may have three formats:
* <ul>
- * <li><code>*</code></li>
- * <li><code>*<uri></code></li>
- * <li><code><uri>*</code></li>
+ * <li>{@code *}</li>
+ * <li>{@code *<uri>}</li>
+ * <li>{@code <uri>*}</li>
* </ul>
* <br>
* This class can be used to map an instance of
@@ -105,7 +105,7 @@ public class UriHttpRequestHandlerMapper
* Looks up a handler matching the given request URI.
*
* @param request the request
- * @return handler or <code>null</code> if no match is found.
+ * @return handler or {@code null} if no match is found.
*/
@Override
public HttpRequestHandler lookup(final HttpRequest request) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriPatternMatcher.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriPatternMatcher.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriPatternMatcher.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/protocol/UriPatternMatcher.java Thu Aug 21 15:09:04 2014
@@ -39,9 +39,9 @@ import org.apache.http.util.Args;
* <br>
* Patterns may have three formats:
* <ul>
- * <li><code>*</code></li>
- * <li><code>*<uri></code></li>
- * <li><code><uri>*</code></li>
+ * <li>{@code *}</li>
+ * <li>{@code *<uri>}</li>
+ * <li>{@code <uri>*}</li>
* </ul>
* <br>
* This class can be used to resolve an object matching a particular request
@@ -115,7 +115,7 @@ public class UriPatternMatcher<T> {
* Looks up an object matching the given request path.
*
* @param path the request path
- * @return object or <code>null</code> if no match is found.
+ * @return object or {@code null} if no match is found.
*/
public synchronized T lookup(final String path) {
Args.notNull(path, "Request path");
@@ -144,8 +144,8 @@ public class UriPatternMatcher<T> {
*
* @param pattern the pattern
* @param path the request path
- * @return <code>true</code> if the request URI matches the pattern,
- * <code>false</code> otherwise.
+ * @return {@code true} if the request URI matches the pattern,
+ * {@code false} otherwise.
*/
protected boolean matchUriRequestPattern(final String pattern, final String path) {
if (pattern.equals("*")) {
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContexts.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContexts.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContexts.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/SSLContexts.java Thu Aug 21 15:09:04 2014
@@ -44,7 +44,7 @@ public class SSLContexts {
/**
* Creates default factory based on the standard JSSE trust material
- * (<code>cacerts</code> file in the security properties directory). System properties
+ * ({@code cacerts} file in the security properties directory). System properties
* are not taken into consideration.
*
* @return the default SSL socket factory
@@ -63,10 +63,10 @@ public class SSLContexts {
/**
* Creates default SSL context based on system properties. This method obtains
- * default SSL context by calling <code>SSLContext.getInstance("Default")</code>.
- * Please note that <code>Default</code> algorithm is supported as of Java 6.
+ * default SSL context by calling {@code SSLContext.getInstance("Default")}.
+ * Please note that {@code Default} algorithm is supported as of Java 6.
* This method will fall back onto {@link #createDefault()} when
- * <code>Default</code> algorithm is not available.
+ * {@code Default} algorithm is not available.
*
* @return default system SSL context
*/
Modified: httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/TrustStrategy.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/TrustStrategy.java?rev=1619429&r1=1619428&r2=1619429&view=diff
==============================================================================
--- httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/TrustStrategy.java (original)
+++ httpcomponents/httpcore/trunk/httpcore/src/main/java/org/apache/http/ssl/TrustStrategy.java Thu Aug 21 15:09:04 2014
@@ -43,13 +43,13 @@ public interface TrustStrategy {
* configured in the actual SSL context. This method can be used to override the standard JSSE
* certificate verification process.
* <p>
- * Please note that, if this method returns <code>false</code>, the trust manager configured
+ * Please note that, if this method returns {@code false}, the trust manager configured
* in the actual SSL context can still clear the certificate as trusted.
*
* @param chain the peer certificate chain
* @param authType the authentication type based on the client certificate
- * @return <code>true</code> if the certificate can be trusted without verification by
- * the trust manager, <code>false</code> otherwise.
+ * @return {@code true} if the certificate can be trusted without verification by
+ * the trust manager, {@code false} otherwise.
* @throws CertificateException thrown if the certificate is not trusted or invalid.
*/
boolean isTrusted(X509Certificate[] chain, String authType) throws CertificateException;