HttpData (filter-service-metrics 1.12 1.12 API)

All Superinterfaces:

HttpObject

All Known Implementing Classes:

AbstractHttpData, ByteBufHttpData, DefaultHttpData
```
public interface HttpData
extends HttpObject
```
HTTP/2 data. Helpers in this class create HttpData objects that leave the stream open. To create an HttpData that closes the stream, directly instantiate DefaultHttpData.
Implementations should generally extend AbstractHttpData to interact with other HttpData implementations.

Field Summary

Fields
Modifier and Type Field and Description

static HttpData EMPTY_DATA
Empty HTTP/2 data.

Fields
Modifier and Type	Field and Description
`static HttpData`	`EMPTY_DATA` Empty HTTP/2 data.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`byte[]`	`array()` Returns the underlying byte array of this data.
`static HttpData`	`copyOf(byte[] data)` Creates a new instance from the specified byte array by first copying it.
`static HttpData`	`copyOf(byte[] data, int offset, int length)` Creates a new instance from the specified byte array, `offset` and `length` by first copying it.
`static HttpData`	`copyOf(io.netty.buffer.ByteBuf data)` Creates a new instance from the specified `ByteBuf` by first copying it's content.
`default boolean`	`isEmpty()` Returns whether the `length()` is 0.
`int`	`length()` Returns the length of this data.
`static HttpData`	`of(byte[] data)` Deprecated. Use `wrap(byte[])`.
`static HttpData`	`of(byte[] data, int offset, int length)` Deprecated. Use `wrap(byte[], int, int)`.
`static HttpData`	`of(io.netty.buffer.ByteBuf buf)` Deprecated. Use `copyOf(ByteBuf)`.
`static HttpData`	`of(Charset charset, CharSequence text)` Converts the specified `text` into an `HttpData`.
`static HttpData`	`of(Charset charset, String text)` Converts the specified `text` into an `HttpData`.
`static HttpData`	`of(Charset charset, String format, Object... args)` Converts the specified formatted string into an `HttpData`.
`static HttpData`	`ofAscii(CharSequence text)` Converts the specified `text` into a US-ASCII `HttpData`.
`static HttpData`	`ofAscii(String text)` Converts the specified `text` into a US-ASCII `HttpData`.
`static HttpData`	`ofAscii(String format, Object... args)` Converts the specified formatted string into a US-ASCII `HttpData`.
`default int`	`offset()` Deprecated. The offset of `HttpData` is always `0`.
`static HttpData`	`ofUtf8(CharSequence text)` Converts the specified `text` into a UTF-8 `HttpData`.
`static HttpData`	`ofUtf8(String text)` Converts the specified `text` into a UTF-8 `HttpData`.
`static HttpData`	`ofUtf8(String format, Object... args)` Converts the specified formatted string into a UTF-8 `HttpData`.
`default InputStream`	`toInputStream()` Returns a new `InputStream` that is sourced from this data.
`default Reader`	`toReader(Charset charset)` Returns a new `Reader` that is sourced from this data and decoded using the specified `Charset`.
`default Reader`	`toReaderAscii()` Returns a new `Reader` that is sourced from this data and decoded using `StandardCharsets.US_ASCII`.
`default Reader`	`toReaderUtf8()` Returns a new `Reader` that is sourced from this data and decoded using `StandardCharsets.UTF_8`.
`default String`	`toString(Charset charset)` Decodes this data into a `String`.
`default String`	`toStringAscii()` Decodes this data into a `String` using US-ASCII encoding.
`default String`	`toStringUtf8()` Decodes this data into a `String` using UTF-8 encoding.
`static HttpData`	`wrap(byte[] data)` Creates a new instance from the specified byte array.
`static HttpData`	`wrap(byte[] data, int offset, int length)` Creates a new instance from the specified byte array, `offset` and `length`.
`static HttpData`	`wrap(io.netty.buffer.ByteBuf buf)` Converts the specified Netty `ByteBuf` into an `HttpData`.

Methods inherited from interface com.linecorp.armeria.common.HttpObject
isEndOfStream

- Field Detail
  - EMPTY_DATA
```
static final HttpData EMPTY_DATA
```
    Empty HTTP/2 data.
- Method Detail
  - wrap
```
static HttpData wrap(byte[] data)
```
    Creates a new instance from the specified byte array. The array is not copied; any changes made in the array later will be visible to HttpData.
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of the specified array is 0.
  - wrap
```
static HttpData wrap(byte[] data,
                     int offset,
                     int length)
```
    Creates a new instance from the specified byte array, offset and length. The array is not copied; any changes made in the array later will be visible to HttpData.
    
    Returns:
    
    a new HttpData. EMPTY_DATA if length is 0.
    
    Throws:
    
    ArrayIndexOutOfBoundsException - if offset and length are out of bounds
  - wrap
```
static HttpData wrap(io.netty.buffer.ByteBuf buf)
```
    Converts the specified Netty ByteBuf into an HttpData. The buffer is not copied; any changes made to it will be visible to HttpData. The ownership of the buffer is transferred to the HttpData. If you still need to use it after calling this method, make sure to call ByteBuf.retain() first.
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the readable bytes of buf is 0.
  - copyOf
```
static HttpData copyOf(byte[] data)
```
    Creates a new instance from the specified byte array by first copying it.
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of the specified array is 0.
  - copyOf
```
static HttpData copyOf(byte[] data,
                       int offset,
                       int length)
```
    Creates a new instance from the specified byte array, offset and length by first copying it.
    
    Returns:
    
    a new HttpData. EMPTY_DATA if length is 0.
    
    Throws:
    
    ArrayIndexOutOfBoundsException - if offset and length are out of bounds
  - copyOf
```
static HttpData copyOf(io.netty.buffer.ByteBuf data)
```
    Creates a new instance from the specified ByteBuf by first copying it's content. The reference count of ByteBuf will not be changed.
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of the specified array is 0.
  - of
```
@Deprecated
static HttpData of(byte[] data)
```
    Deprecated. Use wrap(byte[]).
    
    Creates a new instance from the specified byte array. The array is not copied; any changes made in the array later will be visible to HttpData.
  - of
```
@Deprecated
static HttpData of(byte[] data,
                               int offset,
                               int length)
```
    Deprecated. Use wrap(byte[], int, int).
    
    Creates a new instance from the specified byte array, offset and length. The array is not copied; any changes made in the array later will be visible to HttpData.
  - of
```
static HttpData of(Charset charset,
                   CharSequence text)
```
    Converts the specified text into an HttpData.
    
    Parameters:
    
    charset - the Charset to use for encoding text
    
    text - the String to convert
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of text is 0.
  - of
```
static HttpData of(Charset charset,
                   String text)
```
    Converts the specified text into an HttpData.
    
    Parameters:
    
    charset - the Charset to use for encoding text
    
    text - the String to convert
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of text is 0.
  - of
```
@Deprecated
static HttpData of(io.netty.buffer.ByteBuf buf)
```
    Deprecated. Use copyOf(ByteBuf).
    
    Creates a new instance from the specified ByteBuf by first copying it's content. The reference count of ByteBuf will not be changed.
  - of
```
static HttpData of(Charset charset,
                   String format,
                   Object... args)
```
    Converts the specified formatted string into an HttpData. The string is formatted by String.format(Locale, String, Object...) with English locale.
    
    Parameters:
    
    charset - the Charset to use for encoding string
    
    format - the format string of the response content
    
    args - the arguments referenced by the format specifiers in the format string
    
    Returns:
    
    a new HttpData. EMPTY_DATA if format is empty.
  - ofUtf8
```
static HttpData ofUtf8(CharSequence text)
```
    Converts the specified text into a UTF-8 HttpData.
    
    Parameters:
    
    text - the String to convert
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of text is 0.
  - ofUtf8
```
static HttpData ofUtf8(String text)
```
    Converts the specified text into a UTF-8 HttpData.
    
    Parameters:
    
    text - the String to convert
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of text is 0.
  - ofUtf8
```
static HttpData ofUtf8(String format,
                       Object... args)
```
    Converts the specified formatted string into a UTF-8 HttpData. The string is formatted by String.format(Locale, String, Object...) with English locale.
    
    Parameters:
    
    format - the format string of the response content
    
    args - the arguments referenced by the format specifiers in the format string
    
    Returns:
    
    a new HttpData. EMPTY_DATA if format is empty.
  - ofAscii
```
static HttpData ofAscii(CharSequence text)
```
    Converts the specified text into a US-ASCII HttpData.
    
    Parameters:
    
    text - the String to convert
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of text is 0.
  - ofAscii
```
static HttpData ofAscii(String text)
```
    Converts the specified text into a US-ASCII HttpData.
    
    Parameters:
    
    text - the String to convert
    
    Returns:
    
    a new HttpData. EMPTY_DATA if the length of text is 0.
  - ofAscii
```
static HttpData ofAscii(String format,
                        Object... args)
```
    Converts the specified formatted string into a US-ASCII HttpData. The string is formatted by String.format(Locale, String, Object...) with English locale.
    
    Parameters:
    
    format - the format string of the response content
    
    args - the arguments referenced by the format specifiers in the format string
    
    Returns:
    
    a new HttpData. EMPTY_DATA if format is empty.
  - array
```
byte[] array()
```
    Returns the underlying byte array of this data.
  - offset
```
@Deprecated
default int offset()
```
    Deprecated. The offset of HttpData is always 0.
    
    Returns 0.
  - length
```
int length()
```
    Returns the length of this data.
  - isEmpty
```
default boolean isEmpty()
```
    Returns whether the length() is 0.
  - toString
```
default String toString(Charset charset)
```
    Decodes this data into a String.
    
    Parameters:
    
    charset - the Charset to use for decoding this data
    
    Returns:
    
    the decoded String
  - toStringUtf8
```
default String toStringUtf8()
```
    Decodes this data into a String using UTF-8 encoding.
    
    Returns:
    
    the decoded String
  - toStringAscii
```
default String toStringAscii()
```
    Decodes this data into a String using US-ASCII encoding.
    
    Returns:
    
    the decoded String
  - toInputStream
```
default InputStream toInputStream()
```
    Returns a new InputStream that is sourced from this data.
    Note, if this HttpData is pooled (e.g., it is the result of a call to HttpResponse.aggregateWithPooledObjects(ByteBufAllocator)), then this InputStream will increase the reference count of the underlying buffer. Make sure to call InputStream.close(), usually using a try-with-resources invocation, to release this extra reference. And as usual, don't forget to call ReferenceCountUtil.release(Object) on this HttpData itself too.
  - toReader
```
default Reader toReader(Charset charset)
```
    Returns a new Reader that is sourced from this data and decoded using the specified Charset.
  - toReaderUtf8
```
default Reader toReaderUtf8()
```
    Returns a new Reader that is sourced from this data and decoded using StandardCharsets.UTF_8.
  - toReaderAscii
```
default Reader toReaderAscii()
```
    Returns a new Reader that is sourced from this data and decoded using StandardCharsets.US_ASCII.

Interface HttpData

Field Summary

Method Summary

Methods inherited from interface com.linecorp.armeria.common.HttpObject

Field Detail

EMPTY_DATA

Method Detail

wrap

wrap

wrap

copyOf

copyOf

copyOf

of

of

of

of

of

of

ofUtf8

ofUtf8

ofUtf8

ofAscii

ofAscii

ofAscii

array

offset

length

isEmpty

toString

toStringUtf8

toStringAscii

toInputStream

toReader

toReaderUtf8

toReaderAscii