Package io.netty.handler.codec.http
Class HttpHeaders
- java.lang.Object
-
- io.netty.handler.codec.http.HttpHeaders
-
- All Implemented Interfaces:
java.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>>
- Direct Known Subclasses:
DefaultHttpHeaders
,EmptyHttpHeaders
,ReadOnlyHttpHeaders
public abstract class HttpHeaders extends java.lang.Object implements java.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>>
Provides the constants for the standard HTTP header names and values and commonly used utility methods that accesses anHttpMessage
.Concrete instances of this class are most easily obtained from its default factory:
DefaultHttpHeadersFactory.headersFactory()
.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
HttpHeaders.Names
Deprecated.UseHttpHeaderNames
instead.static class
HttpHeaders.Values
Deprecated.UseHttpHeaderValues
instead.
-
Field Summary
Fields Modifier and Type Field Description static HttpHeaders
EMPTY_HEADERS
Deprecated.
-
Constructor Summary
Constructors Modifier Constructor Description protected
HttpHeaders()
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description HttpHeaders
add(HttpHeaders headers)
Adds all header entries of the specifiedheaders
.HttpHeaders
add(java.lang.CharSequence name, java.lang.Iterable<?> values)
Adds a new header with the specified name and values.HttpHeaders
add(java.lang.CharSequence name, java.lang.Object value)
Adds a new header with the specified name and value.abstract HttpHeaders
add(java.lang.String name, java.lang.Iterable<?> values)
abstract HttpHeaders
add(java.lang.String name, java.lang.Object value)
static void
addDateHeader(HttpMessage message, java.lang.CharSequence name, java.util.Date value)
Deprecated.Useadd(CharSequence, Object)
instead.static void
addDateHeader(HttpMessage message, java.lang.String name, java.util.Date value)
Deprecated.Useadd(CharSequence, Object)
instead.static void
addHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Object value)
Deprecated.Useadd(CharSequence, Object)
instead.static void
addHeader(HttpMessage message, java.lang.String name, java.lang.Object value)
Deprecated.Useadd(CharSequence, Object)
instead.abstract HttpHeaders
addInt(java.lang.CharSequence name, int value)
Add thename
tovalue
.static void
addIntHeader(HttpMessage message, java.lang.CharSequence name, int value)
Deprecated.UseaddInt(CharSequence, int)
instead.static void
addIntHeader(HttpMessage message, java.lang.String name, int value)
Deprecated.Useadd(CharSequence, Iterable)
instead.abstract HttpHeaders
addShort(java.lang.CharSequence name, short value)
Add thename
tovalue
.abstract HttpHeaders
clear()
Removes all headers from thisHttpMessage
.static void
clearHeaders(HttpMessage message)
Deprecated.Useclear()
instead.boolean
contains(java.lang.CharSequence name)
Checks to see if there is a header with the specified nameboolean
contains(java.lang.CharSequence name, java.lang.CharSequence value, boolean ignoreCase)
Returnstrue
if a header with thename
andvalue
exists,false
otherwise.abstract boolean
contains(java.lang.String name)
boolean
contains(java.lang.String name, java.lang.String value, boolean ignoreCase)
boolean
containsValue(java.lang.CharSequence name, java.lang.CharSequence value, boolean ignoreCase)
Returnstrue
if a header with thename
andvalue
exists,false
otherwise.HttpHeaders
copy()
Returns a deep copy of the passed inHttpHeaders
.static void
encodeAscii(java.lang.CharSequence seq, ByteBuf buf)
Deprecated.abstract java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>>
entries()
Returns a newList
that contains all headers in this object.static boolean
equalsIgnoreCase(java.lang.CharSequence name1, java.lang.CharSequence name2)
Deprecated.java.lang.String
get(java.lang.CharSequence name)
Returns the value of a header with the specified name.java.lang.String
get(java.lang.CharSequence name, java.lang.String defaultValue)
Returns the value of a header with the specified name.abstract java.lang.String
get(java.lang.String name)
java.util.List<java.lang.String>
getAll(java.lang.CharSequence name)
Returns the values of headers with the specified nameabstract java.util.List<java.lang.String>
getAll(java.lang.String name)
java.util.List<java.lang.String>
getAllAsString(java.lang.CharSequence name)
java.lang.String
getAsString(java.lang.CharSequence name)
Headers.get(Object)
and convert the result to aString
.static long
getContentLength(HttpMessage message)
Deprecated.UseHttpUtil.getContentLength(HttpMessage)
instead.static long
getContentLength(HttpMessage message, long defaultValue)
Deprecated.UseHttpUtil.getContentLength(HttpMessage, long)
instead.static java.util.Date
getDate(HttpMessage message)
Deprecated.UsegetTimeMillis(CharSequence)
instead.static java.util.Date
getDate(HttpMessage message, java.util.Date defaultValue)
Deprecated.UsegetTimeMillis(CharSequence, long)
instead.static java.util.Date
getDateHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.UsegetTimeMillis(CharSequence)
instead.static java.util.Date
getDateHeader(HttpMessage message, java.lang.CharSequence name, java.util.Date defaultValue)
Deprecated.UsegetTimeMillis(CharSequence, long)
instead.static java.util.Date
getDateHeader(HttpMessage message, java.lang.String name)
Deprecated.UsegetTimeMillis(CharSequence)
instead.static java.util.Date
getDateHeader(HttpMessage message, java.lang.String name, java.util.Date defaultValue)
Deprecated.UsegetTimeMillis(CharSequence, long)
instead.static java.lang.String
getHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.Useget(CharSequence)
instead.static java.lang.String
getHeader(HttpMessage message, java.lang.CharSequence name, java.lang.String defaultValue)
Deprecated.Useget(CharSequence, String)
instead.static java.lang.String
getHeader(HttpMessage message, java.lang.String name)
Deprecated.Useget(CharSequence)
instead.static java.lang.String
getHeader(HttpMessage message, java.lang.String name, java.lang.String defaultValue)
Deprecated.Useget(CharSequence, String)
instead.static java.lang.String
getHost(HttpMessage message)
Deprecated.Useget(CharSequence)
instead.static java.lang.String
getHost(HttpMessage message, java.lang.String defaultValue)
Deprecated.Useget(CharSequence, String)
instead.abstract java.lang.Integer
getInt(java.lang.CharSequence name)
Returns the integer value of a header with the specified name.abstract int
getInt(java.lang.CharSequence name, int defaultValue)
Returns the integer value of a header with the specified name.static int
getIntHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.UsegetInt(CharSequence)
instead.static int
getIntHeader(HttpMessage message, java.lang.CharSequence name, int defaultValue)
Deprecated.UsegetInt(CharSequence, int)
instead.static int
getIntHeader(HttpMessage message, java.lang.String name)
Deprecated.UsegetInt(CharSequence)
instead.static int
getIntHeader(HttpMessage message, java.lang.String name, int defaultValue)
Deprecated.UsegetInt(CharSequence, int)
instead.abstract java.lang.Short
getShort(java.lang.CharSequence name)
Returns the short value of a header with the specified name.abstract short
getShort(java.lang.CharSequence name, short defaultValue)
Returns the short value of a header with the specified name.abstract java.lang.Long
getTimeMillis(java.lang.CharSequence name)
Returns the date value of a header with the specified name.abstract long
getTimeMillis(java.lang.CharSequence name, long defaultValue)
Returns the date value of a header with the specified name.static boolean
is100ContinueExpected(HttpMessage message)
Deprecated.UseHttpUtil.is100ContinueExpected(HttpMessage)
instead.static boolean
isContentLengthSet(HttpMessage m)
Deprecated.UseHttpUtil.isContentLengthSet(HttpMessage)
instead.abstract boolean
isEmpty()
Checks if no header exists.static boolean
isKeepAlive(HttpMessage message)
Deprecated.UseHttpUtil.isKeepAlive(HttpMessage)
instead.static boolean
isTransferEncodingChunked(HttpMessage message)
Deprecated.UseHttpUtil.isTransferEncodingChunked(HttpMessage)
instead.abstract java.util.Iterator<java.util.Map.Entry<java.lang.String,java.lang.String>>
iterator()
Deprecated.It is preferred to useiteratorCharSequence()
unless you needString
.java.util.Iterator<java.util.Map.Entry<java.lang.String,java.lang.String>>
iteratorAsString()
Iterator
that converts eachMap.Entry
's key and value to aString
.abstract java.util.Iterator<java.util.Map.Entry<java.lang.CharSequence,java.lang.CharSequence>>
iteratorCharSequence()
abstract java.util.Set<java.lang.String>
names()
Returns a newSet
that contains the names of all headers in this object.static java.lang.CharSequence
newEntity(java.lang.String name)
Deprecated.UseAsciiString
instead.HttpHeaders
remove(java.lang.CharSequence name)
Removes the header with the specified name.abstract HttpHeaders
remove(java.lang.String name)
static void
removeHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.Useremove(CharSequence)
instead.static void
removeHeader(HttpMessage message, java.lang.String name)
Deprecated.Useremove(CharSequence)
instead.static void
removeTransferEncodingChunked(HttpMessage m)
Deprecated.HttpHeaders
set(HttpHeaders headers)
Cleans the current header entries and copies all header entries of the specifiedheaders
.HttpHeaders
set(java.lang.CharSequence name, java.lang.Iterable<?> values)
Sets a header with the specified name and values.HttpHeaders
set(java.lang.CharSequence name, java.lang.Object value)
Sets a header with the specified name and value.abstract HttpHeaders
set(java.lang.String name, java.lang.Iterable<?> values)
abstract HttpHeaders
set(java.lang.String name, java.lang.Object value)
static void
set100ContinueExpected(HttpMessage message)
Deprecated.static void
set100ContinueExpected(HttpMessage message, boolean set)
Deprecated.HttpHeaders
setAll(HttpHeaders headers)
Retains all current headers but callsset(String, Object)
for each entry inheaders
static void
setContentLength(HttpMessage message, long length)
Deprecated.UseHttpUtil.setContentLength(HttpMessage, long)
instead.static void
setDate(HttpMessage message, java.util.Date value)
Deprecated.Useset(CharSequence, Object)
instead.static void
setDateHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Iterable<java.util.Date> values)
Deprecated.Useset(CharSequence, Iterable)
instead.static void
setDateHeader(HttpMessage message, java.lang.CharSequence name, java.util.Date value)
Deprecated.Useset(CharSequence, Object)
instead.static void
setDateHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<java.util.Date> values)
Deprecated.Useset(CharSequence, Iterable)
instead.static void
setDateHeader(HttpMessage message, java.lang.String name, java.util.Date value)
Deprecated.Useset(CharSequence, Object)
instead.static void
setHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Iterable<?> values)
Deprecated.Useset(CharSequence, Iterable)
instead.static void
setHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Object value)
Deprecated.Useset(CharSequence, Object)
instead.static void
setHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<?> values)
Deprecated.Useset(CharSequence, Iterable)
instead.static void
setHeader(HttpMessage message, java.lang.String name, java.lang.Object value)
Deprecated.Useset(CharSequence, Object)
instead.static void
setHost(HttpMessage message, java.lang.CharSequence value)
Deprecated.Useset(CharSequence, Object)
instead.static void
setHost(HttpMessage message, java.lang.String value)
Deprecated.Useset(CharSequence, Object)
instead.abstract HttpHeaders
setInt(java.lang.CharSequence name, int value)
Set thename
tovalue
.static void
setIntHeader(HttpMessage message, java.lang.CharSequence name, int value)
Deprecated.UsesetInt(CharSequence, int)
instead.static void
setIntHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Iterable<java.lang.Integer> values)
Deprecated.Useset(CharSequence, Iterable)
instead.static void
setIntHeader(HttpMessage message, java.lang.String name, int value)
Deprecated.UsesetInt(CharSequence, int)
instead.static void
setIntHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<java.lang.Integer> values)
Deprecated.Useset(CharSequence, Iterable)
instead.static void
setKeepAlive(HttpMessage message, boolean keepAlive)
Deprecated.UseHttpUtil.setKeepAlive(HttpMessage, boolean)
instead.abstract HttpHeaders
setShort(java.lang.CharSequence name, short value)
Set thename
tovalue
.static void
setTransferEncodingChunked(HttpMessage m)
Deprecated.abstract int
size()
Returns the number of headers in this object.java.lang.String
toString()
java.util.Iterator<? extends java.lang.CharSequence>
valueCharSequenceIterator(java.lang.CharSequence name)
Equivalent togetAll(String)
but it is possible that no intermediate list is generated.java.util.Iterator<java.lang.String>
valueStringIterator(java.lang.CharSequence name)
Equivalent togetAll(String)
but it is possible that no intermediate list is generated.
-
-
-
Field Detail
-
EMPTY_HEADERS
@Deprecated public static final HttpHeaders EMPTY_HEADERS
Deprecated.UseEmptyHttpHeaders.INSTANCE
.The instance is instantiated here to break the cyclic static initialization between
EmptyHttpHeaders
andHttpHeaders
. The issue is that if someone accessesEmptyHttpHeaders.INSTANCE
beforeEMPTY_HEADERS
thenEMPTY_HEADERS
will benull
.
-
-
Method Detail
-
isKeepAlive
@Deprecated public static boolean isKeepAlive(HttpMessage message)
Deprecated.UseHttpUtil.isKeepAlive(HttpMessage)
instead. Returnstrue
if and only if the connection can remain open and thus 'kept alive'. This methods respects the value of the"Connection"
header first and then the return value ofHttpVersion.isKeepAliveDefault()
.
-
setKeepAlive
@Deprecated public static void setKeepAlive(HttpMessage message, boolean keepAlive)
Deprecated.UseHttpUtil.setKeepAlive(HttpMessage, boolean)
instead. Sets the value of the"Connection"
header depending on the protocol version of the specified message. This getMethod sets or removes the"Connection"
header depending on what the default keep alive mode of the message's protocol version is, as specified byHttpVersion.isKeepAliveDefault()
.- If the connection is kept alive by default:
- set to
"close"
ifkeepAlive
isfalse
. - remove otherwise.
- set to
- If the connection is closed by default:
- set to
"keep-alive"
ifkeepAlive
istrue
. - remove otherwise.
- set to
- If the connection is kept alive by default:
-
getHeader
@Deprecated public static java.lang.String getHeader(HttpMessage message, java.lang.String name)
Deprecated.Useget(CharSequence)
instead.
-
getHeader
@Deprecated public static java.lang.String getHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.Useget(CharSequence)
instead. Returns the header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.- Returns:
- the header value or
null
if there is no such header
-
getHeader
@Deprecated public static java.lang.String getHeader(HttpMessage message, java.lang.String name, java.lang.String defaultValue)
Deprecated.Useget(CharSequence, String)
instead.
-
getHeader
@Deprecated public static java.lang.String getHeader(HttpMessage message, java.lang.CharSequence name, java.lang.String defaultValue)
Deprecated.Useget(CharSequence, String)
instead. Returns the header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.- Returns:
- the header value or the
defaultValue
if there is no such header
-
setHeader
@Deprecated public static void setHeader(HttpMessage message, java.lang.String name, java.lang.Object value)
Deprecated.Useset(CharSequence, Object)
instead.
-
setHeader
@Deprecated public static void setHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Object value)
Deprecated.Useset(CharSequence, Object)
instead. Sets a new header with the specified name and value. If there is an existing header with the same name, the existing header is removed. If the specified value is not aString
, it is converted into aString
byObject.toString()
, except forDate
andCalendar
which are formatted to the date format defined in RFC2616.
-
setHeader
@Deprecated public static void setHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<?> values)
Deprecated.Useset(CharSequence, Iterable)
instead.
-
setHeader
@Deprecated public static void setHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Iterable<?> values)
Deprecated.Useset(CharSequence, Iterable)
instead. Sets a new header with the specified name and values. If there is an existing header with the same name, the existing header is removed. This getMethod can be represented approximately as the following code:removeHeader(message, name); for (Object v: values) { if (v == null) { break; } addHeader(message, name, v); }
-
addHeader
@Deprecated public static void addHeader(HttpMessage message, java.lang.String name, java.lang.Object value)
Deprecated.Useadd(CharSequence, Object)
instead.
-
addHeader
@Deprecated public static void addHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Object value)
Deprecated.Useadd(CharSequence, Object)
instead. Adds a new header with the specified name and value. If the specified value is not aString
, it is converted into aString
byObject.toString()
, except forDate
andCalendar
which are formatted to the date format defined in RFC2616.
-
removeHeader
@Deprecated public static void removeHeader(HttpMessage message, java.lang.String name)
Deprecated.Useremove(CharSequence)
instead.- See Also:
removeHeader(HttpMessage, CharSequence)
-
removeHeader
@Deprecated public static void removeHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.Useremove(CharSequence)
instead. Removes the header with the specified name.
-
clearHeaders
@Deprecated public static void clearHeaders(HttpMessage message)
Deprecated.Useclear()
instead. Removes all headers from the specified message.
-
getIntHeader
@Deprecated public static int getIntHeader(HttpMessage message, java.lang.String name)
Deprecated.UsegetInt(CharSequence)
instead.- See Also:
getIntHeader(HttpMessage, CharSequence)
-
getIntHeader
@Deprecated public static int getIntHeader(HttpMessage message, java.lang.CharSequence name)
Deprecated.UsegetInt(CharSequence)
instead. Returns the integer header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.- Returns:
- the header value
- Throws:
java.lang.NumberFormatException
- if there is no such header or the header value is not a number
-
getIntHeader
@Deprecated public static int getIntHeader(HttpMessage message, java.lang.String name, int defaultValue)
Deprecated.UsegetInt(CharSequence, int)
instead.
-
getIntHeader
@Deprecated public static int getIntHeader(HttpMessage message, java.lang.CharSequence name, int defaultValue)
Deprecated.UsegetInt(CharSequence, int)
instead. Returns the integer header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.- Returns:
- the header value or the
defaultValue
if there is no such header or the header value is not a number
-
setIntHeader
@Deprecated public static void setIntHeader(HttpMessage message, java.lang.String name, int value)
Deprecated.UsesetInt(CharSequence, int)
instead.
-
setIntHeader
@Deprecated public static void setIntHeader(HttpMessage message, java.lang.CharSequence name, int value)
Deprecated.UsesetInt(CharSequence, int)
instead. Sets a new integer header with the specified name and value. If there is an existing header with the same name, the existing header is removed.
-
setIntHeader
@Deprecated public static void setIntHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<java.lang.Integer> values)
Deprecated.Useset(CharSequence, Iterable)
instead.
-
setIntHeader
@Deprecated public static void setIntHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Iterable<java.lang.Integer> values)
Deprecated.Useset(CharSequence, Iterable)
instead. Sets a new integer header with the specified name and values. If there is an existing header with the same name, the existing header is removed.
-
addIntHeader
@Deprecated public static void addIntHeader(HttpMessage message, java.lang.String name, int value)
Deprecated.Useadd(CharSequence, Iterable)
instead.
-
addIntHeader
@Deprecated public static void addIntHeader(HttpMessage message, java.lang.CharSequence name, int value)
Deprecated.UseaddInt(CharSequence, int)
instead. Adds a new integer header with the specified name and value.
-
getDateHeader
@Deprecated public static java.util.Date getDateHeader(HttpMessage message, java.lang.String name) throws java.text.ParseException
Deprecated.UsegetTimeMillis(CharSequence)
instead.- Throws:
java.text.ParseException
- See Also:
getDateHeader(HttpMessage, CharSequence)
-
getDateHeader
@Deprecated public static java.util.Date getDateHeader(HttpMessage message, java.lang.CharSequence name) throws java.text.ParseException
Deprecated.UsegetTimeMillis(CharSequence)
instead. Returns the date header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.- Returns:
- the header value
- Throws:
java.text.ParseException
- if there is no such header or the header value is not a formatted date
-
getDateHeader
@Deprecated public static java.util.Date getDateHeader(HttpMessage message, java.lang.String name, java.util.Date defaultValue)
Deprecated.UsegetTimeMillis(CharSequence, long)
instead.
-
getDateHeader
@Deprecated public static java.util.Date getDateHeader(HttpMessage message, java.lang.CharSequence name, java.util.Date defaultValue)
Deprecated.UsegetTimeMillis(CharSequence, long)
instead. Returns the date header value with the specified header name. If there are more than one header value for the specified header name, the first value is returned.- Returns:
- the header value or the
defaultValue
if there is no such header or the header value is not a formatted date
-
setDateHeader
@Deprecated public static void setDateHeader(HttpMessage message, java.lang.String name, java.util.Date value)
Deprecated.Useset(CharSequence, Object)
instead.
-
setDateHeader
@Deprecated public static void setDateHeader(HttpMessage message, java.lang.CharSequence name, java.util.Date value)
Deprecated.Useset(CharSequence, Object)
instead. Sets a new date header with the specified name and value. If there is an existing header with the same name, the existing header is removed. The specified value is formatted as defined in RFC2616
-
setDateHeader
@Deprecated public static void setDateHeader(HttpMessage message, java.lang.String name, java.lang.Iterable<java.util.Date> values)
Deprecated.Useset(CharSequence, Iterable)
instead.
-
setDateHeader
@Deprecated public static void setDateHeader(HttpMessage message, java.lang.CharSequence name, java.lang.Iterable<java.util.Date> values)
Deprecated.Useset(CharSequence, Iterable)
instead. Sets a new date header with the specified name and values. If there is an existing header with the same name, the existing header is removed. The specified values are formatted as defined in RFC2616
-
addDateHeader
@Deprecated public static void addDateHeader(HttpMessage message, java.lang.String name, java.util.Date value)
Deprecated.Useadd(CharSequence, Object)
instead.
-
addDateHeader
@Deprecated public static void addDateHeader(HttpMessage message, java.lang.CharSequence name, java.util.Date value)
Deprecated.Useadd(CharSequence, Object)
instead. Adds a new date header with the specified name and value. The specified value is formatted as defined in RFC2616
-
getContentLength
@Deprecated public static long getContentLength(HttpMessage message)
Deprecated.UseHttpUtil.getContentLength(HttpMessage)
instead. Returns the length of the content. Please note that this value is not retrieved fromByteBufHolder.content()
but from the"Content-Length"
header, and thus they are independent from each other.- Returns:
- the content length
- Throws:
java.lang.NumberFormatException
- if the message does not have the"Content-Length"
header or its value is not a number
-
getContentLength
@Deprecated public static long getContentLength(HttpMessage message, long defaultValue)
Deprecated.UseHttpUtil.getContentLength(HttpMessage, long)
instead. Returns the length of the content. Please note that this value is not retrieved fromByteBufHolder.content()
but from the"Content-Length"
header, and thus they are independent from each other.- Returns:
- the content length or
defaultValue
if this message does not have the"Content-Length"
header or its value is not a number
-
setContentLength
@Deprecated public static void setContentLength(HttpMessage message, long length)
Deprecated.UseHttpUtil.setContentLength(HttpMessage, long)
instead.
-
getHost
@Deprecated public static java.lang.String getHost(HttpMessage message)
Deprecated.Useget(CharSequence)
instead. Returns the value of the"Host"
header.
-
getHost
@Deprecated public static java.lang.String getHost(HttpMessage message, java.lang.String defaultValue)
Deprecated.Useget(CharSequence, String)
instead. Returns the value of the"Host"
header. If there is no such header, thedefaultValue
is returned.
-
setHost
@Deprecated public static void setHost(HttpMessage message, java.lang.String value)
Deprecated.Useset(CharSequence, Object)
instead.- See Also:
setHost(HttpMessage, CharSequence)
-
setHost
@Deprecated public static void setHost(HttpMessage message, java.lang.CharSequence value)
Deprecated.Useset(CharSequence, Object)
instead. Sets the"Host"
header.
-
getDate
@Deprecated public static java.util.Date getDate(HttpMessage message) throws java.text.ParseException
Deprecated.UsegetTimeMillis(CharSequence)
instead. Returns the value of the"Date"
header.- Throws:
java.text.ParseException
- if there is no such header or the header value is not a formatted date
-
getDate
@Deprecated public static java.util.Date getDate(HttpMessage message, java.util.Date defaultValue)
Deprecated.UsegetTimeMillis(CharSequence, long)
instead. Returns the value of the"Date"
header. If there is no such header or the header is not a formatted date, thedefaultValue
is returned.
-
setDate
@Deprecated public static void setDate(HttpMessage message, java.util.Date value)
Deprecated.Useset(CharSequence, Object)
instead. Sets the"Date"
header.
-
is100ContinueExpected
@Deprecated public static boolean is100ContinueExpected(HttpMessage message)
Deprecated.UseHttpUtil.is100ContinueExpected(HttpMessage)
instead. Returnstrue
if and only if the specified message contains the"Expect: 100-continue"
header.
-
set100ContinueExpected
@Deprecated public static void set100ContinueExpected(HttpMessage message)
Deprecated.UseHttpUtil.set100ContinueExpected(HttpMessage, boolean)
instead. Sets the"Expect: 100-continue"
header to the specified message. If there is any existing"Expect"
header, they are replaced with the new one.
-
set100ContinueExpected
@Deprecated public static void set100ContinueExpected(HttpMessage message, boolean set)
Deprecated.UseHttpUtil.set100ContinueExpected(HttpMessage, boolean)
instead. Sets or removes the"Expect: 100-continue"
header to / from the specified message. Ifset
istrue
, the"Expect: 100-continue"
header is set and all other previous"Expect"
headers are removed. Otherwise, all"Expect"
headers are removed completely.
-
isTransferEncodingChunked
@Deprecated public static boolean isTransferEncodingChunked(HttpMessage message)
Deprecated.UseHttpUtil.isTransferEncodingChunked(HttpMessage)
instead. Checks to see if the transfer encoding in a specifiedHttpMessage
is chunked- Parameters:
message
- The message to check- Returns:
- True if transfer encoding is chunked, otherwise false
-
removeTransferEncodingChunked
@Deprecated public static void removeTransferEncodingChunked(HttpMessage m)
Deprecated.
-
setTransferEncodingChunked
@Deprecated public static void setTransferEncodingChunked(HttpMessage m)
Deprecated.
-
isContentLengthSet
@Deprecated public static boolean isContentLengthSet(HttpMessage m)
Deprecated.UseHttpUtil.isContentLengthSet(HttpMessage)
instead.
-
equalsIgnoreCase
@Deprecated public static boolean equalsIgnoreCase(java.lang.CharSequence name1, java.lang.CharSequence name2)
Deprecated.
-
encodeAscii
@Deprecated public static void encodeAscii(java.lang.CharSequence seq, ByteBuf buf)
Deprecated.
-
newEntity
@Deprecated public static java.lang.CharSequence newEntity(java.lang.String name)
Deprecated.UseAsciiString
instead.Create a new
CharSequence
which is optimized for reuse asHttpHeaders
name or value. So if you have a Header name or value that you want to reuse you should make use of this.
-
get
public abstract java.lang.String get(java.lang.String name)
- See Also:
get(CharSequence)
-
get
public java.lang.String get(java.lang.CharSequence name)
Returns the value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- The name of the header to search- Returns:
- The first header value or
null
if there is no such header - See Also:
getAsString(CharSequence)
-
get
public java.lang.String get(java.lang.CharSequence name, java.lang.String defaultValue)
Returns the value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- The name of the header to search- Returns:
- The first header value or
defaultValue
if there is no such header
-
getInt
public abstract java.lang.Integer getInt(java.lang.CharSequence name)
Returns the integer value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- the name of the header to search- Returns:
- the first header value if the header is found and its value is an integer.
null
if there's no such header or its value is not an integer.
-
getInt
public abstract int getInt(java.lang.CharSequence name, int defaultValue)
Returns the integer value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- the name of the header to searchdefaultValue
- the default value- Returns:
- the first header value if the header is found and its value is an integer.
defaultValue
if there's no such header or its value is not an integer.
-
getShort
public abstract java.lang.Short getShort(java.lang.CharSequence name)
Returns the short value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- the name of the header to search- Returns:
- the first header value if the header is found and its value is a short.
null
if there's no such header or its value is not a short.
-
getShort
public abstract short getShort(java.lang.CharSequence name, short defaultValue)
Returns the short value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- the name of the header to searchdefaultValue
- the default value- Returns:
- the first header value if the header is found and its value is a short.
defaultValue
if there's no such header or its value is not a short.
-
getTimeMillis
public abstract java.lang.Long getTimeMillis(java.lang.CharSequence name)
Returns the date value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- the name of the header to search- Returns:
- the first header value if the header is found and its value is a date.
null
if there's no such header or its value is not a date.
-
getTimeMillis
public abstract long getTimeMillis(java.lang.CharSequence name, long defaultValue)
Returns the date value of a header with the specified name. If there are more than one values for the specified name, the first value is returned.- Parameters:
name
- the name of the header to searchdefaultValue
- the default value- Returns:
- the first header value if the header is found and its value is a date.
defaultValue
if there's no such header or its value is not a date.
-
getAll
public abstract java.util.List<java.lang.String> getAll(java.lang.String name)
- See Also:
getAll(CharSequence)
-
getAll
public java.util.List<java.lang.String> getAll(java.lang.CharSequence name)
Returns the values of headers with the specified name- Parameters:
name
- The name of the headers to search- Returns:
- A
List
of header values which will be empty if no values are found - See Also:
getAllAsString(CharSequence)
-
entries
public abstract java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> entries()
Returns a newList
that contains all headers in this object. Note that modifying the returnedList
will not affect the state of this object. If you intend to enumerate over the header entries only, useiterator()
instead, which has much less overhead.- See Also:
iteratorCharSequence()
-
contains
public abstract boolean contains(java.lang.String name)
- See Also:
contains(CharSequence)
-
iterator
@Deprecated public abstract java.util.Iterator<java.util.Map.Entry<java.lang.String,java.lang.String>> iterator()
Deprecated.It is preferred to useiteratorCharSequence()
unless you needString
. IfString
is required then useiteratorAsString()
.- Specified by:
iterator
in interfacejava.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>>
-
iteratorCharSequence
public abstract java.util.Iterator<java.util.Map.Entry<java.lang.CharSequence,java.lang.CharSequence>> iteratorCharSequence()
- Returns:
- Iterator over the name/value header pairs.
-
valueStringIterator
public java.util.Iterator<java.lang.String> valueStringIterator(java.lang.CharSequence name)
Equivalent togetAll(String)
but it is possible that no intermediate list is generated.- Parameters:
name
- the name of the header to retrieve- Returns:
- an
Iterator
of header values corresponding toname
.
-
valueCharSequenceIterator
public java.util.Iterator<? extends java.lang.CharSequence> valueCharSequenceIterator(java.lang.CharSequence name)
Equivalent togetAll(String)
but it is possible that no intermediate list is generated.- Parameters:
name
- the name of the header to retrieve- Returns:
- an
Iterator
of header values corresponding toname
.
-
contains
public boolean contains(java.lang.CharSequence name)
Checks to see if there is a header with the specified name- Parameters:
name
- The name of the header to search for- Returns:
- True if at least one header is found
-
isEmpty
public abstract boolean isEmpty()
Checks if no header exists.
-
size
public abstract int size()
Returns the number of headers in this object.
-
names
public abstract java.util.Set<java.lang.String> names()
Returns a newSet
that contains the names of all headers in this object. Note that modifying the returnedSet
will not affect the state of this object. If you intend to enumerate over the header entries only, useiterator()
instead, which has much less overhead.
-
add
public abstract HttpHeaders add(java.lang.String name, java.lang.Object value)
- See Also:
add(CharSequence, Object)
-
add
public HttpHeaders add(java.lang.CharSequence name, java.lang.Object value)
Adds a new header with the specified name and value. If the specified value is not aString
, it is converted into aString
byObject.toString()
, except in the cases ofDate
andCalendar
, which are formatted to the date format defined in RFC2616.- Parameters:
name
- The name of the header being addedvalue
- The value of the header being added- Returns:
this
-
add
public abstract HttpHeaders add(java.lang.String name, java.lang.Iterable<?> values)
- See Also:
add(CharSequence, Iterable)
-
add
public HttpHeaders add(java.lang.CharSequence name, java.lang.Iterable<?> values)
Adds a new header with the specified name and values. This getMethod can be represented approximately as the following code:for (Object v: values) { if (v == null) { break; } headers.add(name, v); }
- Parameters:
name
- The name of the headers being setvalues
- The values of the headers being set- Returns:
this
-
add
public HttpHeaders add(HttpHeaders headers)
Adds all header entries of the specifiedheaders
.- Returns:
this
-
addInt
public abstract HttpHeaders addInt(java.lang.CharSequence name, int value)
Add thename
tovalue
.- Parameters:
name
- The name to modifyvalue
- The value- Returns:
this
-
addShort
public abstract HttpHeaders addShort(java.lang.CharSequence name, short value)
Add thename
tovalue
.- Parameters:
name
- The name to modifyvalue
- The value- Returns:
this
-
set
public abstract HttpHeaders set(java.lang.String name, java.lang.Object value)
- See Also:
set(CharSequence, Object)
-
set
public HttpHeaders set(java.lang.CharSequence name, java.lang.Object value)
Sets a header with the specified name and value. If there is an existing header with the same name, it is removed. If the specified value is not aString
, it is converted into aString
byObject.toString()
, except forDate
andCalendar
, which are formatted to the date format defined in RFC2616.- Parameters:
name
- The name of the header being setvalue
- The value of the header being set- Returns:
this
-
set
public abstract HttpHeaders set(java.lang.String name, java.lang.Iterable<?> values)
- See Also:
set(CharSequence, Iterable)
-
set
public HttpHeaders set(java.lang.CharSequence name, java.lang.Iterable<?> values)
Sets a header with the specified name and values. If there is an existing header with the same name, it is removed. This getMethod can be represented approximately as the following code:headers.remove(name); for (Object v: values) { if (v == null) { break; } headers.add(name, v); }
- Parameters:
name
- The name of the headers being setvalues
- The values of the headers being set- Returns:
this
-
set
public HttpHeaders set(HttpHeaders headers)
Cleans the current header entries and copies all header entries of the specifiedheaders
.- Returns:
this
-
setAll
public HttpHeaders setAll(HttpHeaders headers)
Retains all current headers but callsset(String, Object)
for each entry inheaders
- Parameters:
headers
- The headers used toset(String, Object)
values in this instance- Returns:
this
-
setInt
public abstract HttpHeaders setInt(java.lang.CharSequence name, int value)
Set thename
tovalue
. This will remove all previous values associated withname
.- Parameters:
name
- The name to modifyvalue
- The value- Returns:
this
-
setShort
public abstract HttpHeaders setShort(java.lang.CharSequence name, short value)
Set thename
tovalue
. This will remove all previous values associated withname
.- Parameters:
name
- The name to modifyvalue
- The value- Returns:
this
-
remove
public abstract HttpHeaders remove(java.lang.String name)
- See Also:
remove(CharSequence)
-
remove
public HttpHeaders remove(java.lang.CharSequence name)
Removes the header with the specified name.- Parameters:
name
- The name of the header to remove- Returns:
this
-
clear
public abstract HttpHeaders clear()
Removes all headers from thisHttpMessage
.- Returns:
this
-
contains
public boolean contains(java.lang.String name, java.lang.String value, boolean ignoreCase)
-
containsValue
public boolean containsValue(java.lang.CharSequence name, java.lang.CharSequence value, boolean ignoreCase)
Returnstrue
if a header with thename
andvalue
exists,false
otherwise. This also handles multiple values that are separated with a,
.If
ignoreCase
istrue
then a case insensitive compare is done on the value.- Parameters:
name
- the name of the header to findvalue
- the value of the header to findignoreCase
-true
then a case insensitive compare is run to compare values. otherwise a case sensitive compare is run to compare values.
-
getAsString
public final java.lang.String getAsString(java.lang.CharSequence name)
Headers.get(Object)
and convert the result to aString
.- Parameters:
name
- the name of the header to retrieve- Returns:
- the first header value if the header is found.
null
if there's no such header.
-
getAllAsString
public final java.util.List<java.lang.String> getAllAsString(java.lang.CharSequence name)
- Parameters:
name
- the name of the header to retrieve- Returns:
- a
List
of header values or an emptyList
if no values are found.
-
iteratorAsString
public final java.util.Iterator<java.util.Map.Entry<java.lang.String,java.lang.String>> iteratorAsString()
Iterator
that converts eachMap.Entry
's key and value to aString
.
-
contains
public boolean contains(java.lang.CharSequence name, java.lang.CharSequence value, boolean ignoreCase)
Returnstrue
if a header with thename
andvalue
exists,false
otherwise.If
ignoreCase
istrue
then a case insensitive compare is done on the value.- Parameters:
name
- the name of the header to findvalue
- the value of the header to findignoreCase
-true
then a case insensitive compare is run to compare values. otherwise a case sensitive compare is run to compare values.
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
copy
public HttpHeaders copy()
Returns a deep copy of the passed inHttpHeaders
.
-
-