HttpResponse (Redkale 1.9.6 API)

java.lang.Object
- org.redkale.net.Response<HttpContext,HttpRequest>
- - org.redkale.net.http.HttpResponse

```
public class HttpResponse
extends Response<HttpContext,HttpRequest>
```
Http响应包与javax.servlet.http.HttpServletResponse 基本类似。
同时提供发送json的系列接口: public void finishJson(Type type, Object obj)
Redkale提倡http+json的接口风格，所以主要输出的数据格式为json，同时提供异步接口。

详情见: https://redkale.org

作者:

zhangjx

嵌套类概要

嵌套类
限定符和类型类和说明

static class HttpResponse.HttpResponseConfig

protected class HttpResponse.TransferFileHandler

嵌套类
限定符和类型	类和说明
`static class`	`HttpResponse.HttpResponseConfig`
`protected class`	`HttpResponse.TransferFileHandler`

字段概要

字段
限定符和类型	字段和说明
`protected static byte[]`	`connectAliveBytes`
`protected static byte[]`	`connectCloseBytes`
`protected static byte[]`	`LINE`
`protected static byte[]`	`serverNameBytes`
`protected static byte[]`	`status200Bytes`

从类继承的字段 org.redkale.net.Response
channel, context, filter, output, recycleListener, request, servlet, writeBodyBuffer, writeHeadBuffer

构造器概要

构造器
构造器和说明

HttpResponse(HttpContext context, HttpRequest request, HttpResponse.HttpResponseConfig config)

构造器
构造器和说明
`HttpResponse(HttpContext context, HttpRequest request, HttpResponse.HttpResponseConfig config)`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`HttpResponse`	`addCookie(Collection<HttpCookie> cookies)` 增加Cookie值
`HttpResponse`	`addCookie(HttpCookie... cookies)` 增加Cookie值
`HttpResponse`	`addHeader(Map<String,?> map)` 添加Header值
`HttpResponse`	`addHeader(String name, Object value)` 添加Header值
`CompletionHandler`	`createAsyncHandler()` 创建CompletionHandler实例
`<H extends CompletionHandler> H`	`createAsyncHandler(Class<H> handlerClass)` 创建CompletionHandler子类的实例传入的CompletionHandler子类必须是public，且保证其子类可被继承且completed、failed可被重载且包含空参数的构造函数。
`protected ByteBuffer`	`createHeader()`
`static ObjectPool<Response>`	`createPool(AtomicLong creatCounter, AtomicLong cycleCounter, int max, Creator<Response> creator)`
`protected AnyValue.DefaultAnyValue`	`duplicateHeader()`
`void`	`finish(boolean kill, ByteBuffer... buffers)` 将指定ByteBuffer数组按响应结果输出
`void`	`finish(boolean kill, ByteBuffer buffer)` 将指定ByteBuffer按响应结果输出
`void`	`finish(byte[] bs)` 将指定byte[]按响应结果输出
`void`	`finish(ByteBuffer... buffers)` 将指定ByteBuffer数组按响应结果输出
`void`	`finish(ByteBuffer buffer)` 将指定ByteBuffer按响应结果输出
`void`	`finish(Convert convert, Object obj)` 将结果对象输出
`void`	`finish(Convert convert, Type type, Object obj)` 将结果对象输出
`void`	`finish(File file)` 将指定文件按响应结果输出
`void`	`finish(int status, String message)` 以指定响应码附带内容输出
`void`	`finish(Object obj)` 将结果对象输出
`void`	`finish(String obj)` 将指定字符串以响应结果输出
`void`	`finish(String contentType, byte[] bs)` 将指定byte[]按响应结果输出
`void`	`finish(String filename, File file)` 将文件按指定文件名输出
`void`	`finish304()` 以304状态码输出
`void`	`finish404()` 以404状态码输出
`protected void`	`finishFile(File file, ByteBuffer fileBody)` 将指定文件句柄或文件内容按响应结果输出，若fileBody不为null则只输出fileBody内容
`protected void`	`finishFile(String filename, File file, ByteBuffer fileBody)` 将指定文件句柄或文件内容按指定文件名输出，若fileBody不为null则只输出fileBody内容 file 与 fileBody 不能同时为空 file 与 filename 也不能同时为空
`void`	`finishJson(CompletableFuture future)` 将CompletableFuture的结果对象以JSON格式输出
`void`	`finishJson(JsonConvert convert, CompletableFuture future)` 将CompletableFuture的结果对象以JSON格式输出
`void`	`finishJson(JsonConvert convert, Object obj)` 将对象以JSON格式输出
`void`	`finishJson(JsonConvert convert, RetResult ret)` 将RetResult对象以JSON格式输出
`void`	`finishJson(JsonConvert convert, Type type, CompletableFuture future)` 将CompletableFuture的结果对象以JSON格式输出
`void`	`finishJson(JsonConvert convert, Type type, Object obj)` 将对象以JSON格式输出
`void`	`finishJson(Object... objs)` 将对象以JSON格式输出
`void`	`finishJson(Object obj)` 将对象以JSON格式输出
`void`	`finishJson(RetResult ret)` 将RetResult对象以JSON格式输出
`void`	`finishJson(Type type, Object obj)` 将对象以JSON格式输出
`void`	`finishMapJson(JsonConvert convert, Object... objs)` 将对象数组用Map的形式以JSON格式输出例如: finishMap("a",2,"b",3) 输出结果为 {"a":2,"b":3}
`void`	`finishMapJson(Object... objs)` 将对象数组用Map的形式以JSON格式输出例如: finishMap("a",2,"b",3) 输出结果为 {"a":2,"b":3}
`protected BiFunction<HttpResponse,ByteBuffer[],ByteBuffer[]>`	`getBufferHandler()` 获取输出时的拦截器
`Supplier<ByteBuffer>`	`getBufferSupplier()` 获取ByteBuffer生成器
`protected AsyncConnection`	`getChannel()`
`long`	`getContentLength()` 获取内容长度
`String`	`getContentType()` 获取 ContentType
`protected String`	`getHttpCode(int status)` 获取状态码对应的状态描述
`protected String`	`getHttpCode(int status, String defValue)`
`protected HttpRequest`	`getRequest()`
`int`	`getStatus()` 获取状态码
`protected void`	`init(AsyncConnection channel)`
`protected boolean`	`isAutoOptions()`
`protected void`	`offerBuffer(ByteBuffer... buffers)`
`protected boolean`	`recycle()`
`protected AsyncConnection`	`removeChannel()`
`<A> void`	`sendBody(ByteBuffer[] buffers, A attachment, CompletionHandler<Integer,A> handler)` 异步输出指定内容
`<A> void`	`sendBody(ByteBuffer buffer, A attachment, CompletionHandler<Integer,A> handler)` 异步输出指定内容
`protected void`	`setBufferHandler(BiFunction<HttpResponse,ByteBuffer[],ByteBuffer[]> bufferHandler)` 设置输出时的拦截器
`HttpResponse`	`setContentLength(long contentLength)` 设置内容长度
`HttpResponse`	`setContentType(String contentType)` 设置 ContentType
`HttpResponse`	`setHeader(String name, Object value)` 设置Header值
`HttpResponse`	`setStatus(int status)` 设置状态码
`HttpResponse`	`skipHeader()` 跳过header的输出通常应用场景是，调用者的输出内容里已经包含了HTTP的响应头信息，因此需要调用此方法避免重复输出HTTP响应头信息。
`protected void`	`thenEvent(Servlet servlet)`

从类继承的方法 org.redkale.net.Response
finish, finish, getBodyBufferSupplier, getContext, getOutput, isClosed, nextEvent, pollWriteBodyBuffer, pollWriteReadBuffer, prepare, recycleListener, refuseAlive, send, send, setFilter

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - status200Bytes
```
protected static final byte[] status200Bytes
```
  - LINE
```
protected static final byte[] LINE
```
  - serverNameBytes
```
protected static final byte[] serverNameBytes
```
  - connectCloseBytes
```
protected static final byte[] connectCloseBytes
```
  - connectAliveBytes
```
protected static final byte[] connectAliveBytes
```
- 构造器详细资料
  - HttpResponse
```
public HttpResponse(HttpContext context,
                    HttpRequest request,
                    HttpResponse.HttpResponseConfig config)
```
- 方法详细资料
  - createPool
```
public static ObjectPool<Response> createPool(AtomicLong creatCounter,
                                              AtomicLong cycleCounter,
                                              int max,
                                              Creator<Response> creator)
```
  - removeChannel
```
protected AsyncConnection removeChannel()
```
    覆盖:
    
    removeChannel 在类中 Response<HttpContext,HttpRequest>
  - getChannel
```
protected AsyncConnection getChannel()
```
  - recycle
```
protected boolean recycle()
```
    覆盖:
    
    recycle 在类中 Response<HttpContext,HttpRequest>
  - init
```
protected void init(AsyncConnection channel)
```
    覆盖:
    
    init 在类中 Response<HttpContext,HttpRequest>
  - getHttpCode
```
protected String getHttpCode(int status)
```
    获取状态码对应的状态描述
    
    参数:
    
    status - 状态码
    
    返回:
    
    状态描述
  - getRequest
```
protected HttpRequest getRequest()
```
  - getHttpCode
```
protected String getHttpCode(int status,
                             String defValue)
```
  - thenEvent
```
protected void thenEvent(Servlet servlet)
```
    覆盖:
    
    thenEvent 在类中 Response<HttpContext,HttpRequest>
  - isAutoOptions
```
protected boolean isAutoOptions()
```
  - offerBuffer
```
protected void offerBuffer(ByteBuffer... buffers)
```
    覆盖:
    
    offerBuffer 在类中 Response<HttpContext,HttpRequest>
  - addCookie
```
public HttpResponse addCookie(HttpCookie... cookies)
```
    增加Cookie值
    
    参数:
    
    cookies - cookie
    
    返回:
    
    HttpResponse
  - addCookie
```
public HttpResponse addCookie(Collection<HttpCookie> cookies)
```
    增加Cookie值
    
    参数:
    
    cookies - cookie
    
    返回:
    
    HttpResponse
  - createAsyncHandler
```
public CompletionHandler createAsyncHandler()
```
    创建CompletionHandler实例
    
    返回:
    
    CompletionHandler
  - createAsyncHandler
```
public <H extends CompletionHandler> H createAsyncHandler(Class<H> handlerClass)
```
    创建CompletionHandler子类的实例
    传入的CompletionHandler子类必须是public，且保证其子类可被继承且completed、failed可被重载且包含空参数的构造函数。
    
    类型参数:
    
    H - 泛型
    
    参数:
    
    handlerClass - CompletionHandler子类
    
    返回:
    
    CompletionHandler
  - getBufferSupplier
```
public Supplier<ByteBuffer> getBufferSupplier()
```
    获取ByteBuffer生成器
    
    返回:
    
    ByteBuffer生成器
  - finishJson
```
public void finishJson(Object obj)
```
    将对象以JSON格式输出
    
    参数:
    
    obj - 输出对象
  - finishMapJson
```
public void finishMapJson(Object... objs)
```
    将对象数组用Map的形式以JSON格式输出
    例如: finishMap("a",2,"b",3) 输出结果为 {"a":2,"b":3}
    
    参数:
    
    objs - 输出对象
  - finishJson
```
public void finishJson(JsonConvert convert,
                       Object obj)
```
    将对象以JSON格式输出
    
    参数:
    
    convert - 指定的JsonConvert
    
    obj - 输出对象
  - finishMapJson
```
public void finishMapJson(JsonConvert convert,
                          Object... objs)
```
    将对象数组用Map的形式以JSON格式输出
    例如: finishMap("a",2,"b",3) 输出结果为 {"a":2,"b":3}
    
    参数:
    
    convert - 指定的JsonConvert
    
    objs - 输出对象
  - finishJson
```
public void finishJson(Type type,
                       Object obj)
```
    将对象以JSON格式输出
    
    参数:
    
    type - 指定的类型
    
    obj - 输出对象
  - finishJson
```
public void finishJson(JsonConvert convert,
                       Type type,
                       Object obj)
```
    将对象以JSON格式输出
    
    参数:
    
    convert - 指定的JsonConvert
    
    type - 指定的类型
    
    obj - 输出对象
  - finishJson
```
public void finishJson(Object... objs)
```
    将对象以JSON格式输出
    
    参数:
    
    objs - 输出对象
  - finishJson
```
public void finishJson(RetResult ret)
```
    将RetResult对象以JSON格式输出
    
    参数:
    
    ret - RetResult输出对象
  - finishJson
```
public void finishJson(JsonConvert convert,
                       RetResult ret)
```
    将RetResult对象以JSON格式输出
    
    参数:
    
    convert - 指定的JsonConvert
    
    ret - RetResult输出对象
  - finishJson
```
public void finishJson(CompletableFuture future)
```
    将CompletableFuture的结果对象以JSON格式输出
    
    参数:
    
    future - 输出对象的句柄
  - finishJson
```
public void finishJson(JsonConvert convert,
                       CompletableFuture future)
```
    将CompletableFuture的结果对象以JSON格式输出
    
    参数:
    
    convert - 指定的JsonConvert
    
    future - 输出对象的句柄
  - finishJson
```
public void finishJson(JsonConvert convert,
                       Type type,
                       CompletableFuture future)
```
    将CompletableFuture的结果对象以JSON格式输出
    
    参数:
    
    convert - 指定的JsonConvert
    
    type - 指定的类型
    
    future - 输出对象的句柄
  - finish
```
public void finish(Object obj)
```
    将结果对象输出
    
    参数:
    
    obj - 输出对象
  - finish
```
public void finish(Convert convert,
                   Object obj)
```
    将结果对象输出
    
    参数:
    
    convert - 指定的Convert
    
    obj - 输出对象
  - finish
```
public void finish(Convert convert,
                   Type type,
                   Object obj)
```
    将结果对象输出
    
    参数:
    
    convert - 指定的Convert
    
    type - 指定的类型
    
    obj - 输出对象
  - finish
```
public void finish(String obj)
```
    将指定字符串以响应结果输出
    
    参数:
    
    obj - 输出内容
  - finish
```
public void finish(int status,
                   String message)
```
    以指定响应码附带内容输出
    
    参数:
    
    status - 响应码
    
    message - 输出内容
  - finish304
```
public void finish304()
```
    以304状态码输出
  - finish404
```
public void finish404()
```
    以404状态码输出
  - finish
```
public void finish(byte[] bs)
```
    将指定byte[]按响应结果输出
    
    覆盖:
    
    finish 在类中 Response<HttpContext,HttpRequest>
    
    参数:
    
    bs - 输出内容
  - finish
```
public void finish(String contentType,
                   byte[] bs)
```
    将指定byte[]按响应结果输出
    
    参数:
    
    contentType - ContentType
    
    bs - 输出内容
  - finish
```
public void finish(ByteBuffer buffer)
```
    将指定ByteBuffer按响应结果输出
    
    覆盖:
    
    finish 在类中 Response<HttpContext,HttpRequest>
    
    参数:
    
    buffer - 输出内容
  - finish
```
public void finish(boolean kill,
                   ByteBuffer buffer)
```
    将指定ByteBuffer按响应结果输出
    
    覆盖:
    
    finish 在类中 Response<HttpContext,HttpRequest>
    
    参数:
    
    kill - 输出后是否强制关闭连接
    
    buffer - 输出内容
  - finish
```
public void finish(ByteBuffer... buffers)
```
    将指定ByteBuffer数组按响应结果输出
    
    覆盖:
    
    finish 在类中 Response<HttpContext,HttpRequest>
    
    参数:
    
    buffers - 输出内容
  - finish
```
public void finish(boolean kill,
                   ByteBuffer... buffers)
```
    将指定ByteBuffer数组按响应结果输出
    
    覆盖:
    
    finish 在类中 Response<HttpContext,HttpRequest>
    
    参数:
    
    kill - 输出后是否强制关闭连接
    
    buffers - 输出内容
  - sendBody
```
public <A> void sendBody(ByteBuffer buffer,
                         A attachment,
                         CompletionHandler<Integer,A> handler)
```
    异步输出指定内容
    
    类型参数:
    
    A - 泛型
    
    参数:
    
    buffer - 输出内容
    
    attachment - 异步回调参数
    
    handler - 异步回调函数
  - sendBody
```
public <A> void sendBody(ByteBuffer[] buffers,
                         A attachment,
                         CompletionHandler<Integer,A> handler)
```
    异步输出指定内容
    
    类型参数:
    
    A - 泛型
    
    参数:
    
    buffers - 输出内容
    
    attachment - 异步回调参数
    
    handler - 异步回调函数
  - finish
```
public void finish(File file)
            throws IOException
```
    将指定文件按响应结果输出
    
    参数:
    
    file - 输出文件
    
    抛出:
    
    IOException - IO异常
  - finish
```
public void finish(String filename,
                   File file)
            throws IOException
```
    将文件按指定文件名输出
    
    参数:
    
    filename - 输出文件名
    
    file - 输出文件
    
    抛出:
    
    IOException - IO异常
  - finishFile
```
protected void finishFile(File file,
                          ByteBuffer fileBody)
                   throws IOException
```
    将指定文件句柄或文件内容按响应结果输出，若fileBody不为null则只输出fileBody内容
    
    参数:
    
    file - 输出文件
    
    fileBody - 文件内容，没有则输出file
    
    抛出:
    
    IOException - IO异常
  - finishFile
```
protected void finishFile(String filename,
                          File file,
                          ByteBuffer fileBody)
                   throws IOException
```
    将指定文件句柄或文件内容按指定文件名输出，若fileBody不为null则只输出fileBody内容 file 与 fileBody 不能同时为空 file 与 filename 也不能同时为空
    
    参数:
    
    filename - 输出文件名
    
    file - 输出文件
    
    fileBody - 文件内容，没有则输出file
    
    抛出:
    
    IOException - IO异常
  - createHeader
```
protected ByteBuffer createHeader()
```
  - skipHeader
```
public HttpResponse skipHeader()
```
    跳过header的输出通常应用场景是，调用者的输出内容里已经包含了HTTP的响应头信息，因此需要调用此方法避免重复输出HTTP响应头信息。
    
    返回:
    
    HttpResponse
  - duplicateHeader
```
protected AnyValue.DefaultAnyValue duplicateHeader()
```
  - setHeader
```
public HttpResponse setHeader(String name,
                              Object value)
```
    设置Header值
    
    参数:
    
    name - header名
    
    value - header值
    
    返回:
    
    HttpResponse
  - addHeader
```
public HttpResponse addHeader(String name,
                              Object value)
```
    添加Header值
    
    参数:
    
    name - header名
    
    value - header值
    
    返回:
    
    HttpResponse
  - addHeader
```
public HttpResponse addHeader(Map<String,?> map)
```
    添加Header值
    
    参数:
    
    map - header值
    
    返回:
    
    HttpResponse
  - setStatus
```
public HttpResponse setStatus(int status)
```
    设置状态码
    
    参数:
    
    status - 状态码
    
    返回:
    
    HttpResponse
  - getStatus
```
public int getStatus()
```
    获取状态码
    
    返回:
    
    状态码
  - getContentType
```
public String getContentType()
```
    获取 ContentType
    
    返回:
    
    ContentType
  - setContentType
```
public HttpResponse setContentType(String contentType)
```
    设置 ContentType
    
    参数:
    
    contentType - ContentType
    
    返回:
    
    HttpResponse
  - getContentLength
```
public long getContentLength()
```
    获取内容长度
    
    返回:
    
    内容长度
  - setContentLength
```
public HttpResponse setContentLength(long contentLength)
```
    设置内容长度
    
    参数:
    
    contentLength - 内容长度
    
    返回:
    
    HttpResponse
  - getBufferHandler
```
protected BiFunction<HttpResponse,ByteBuffer[],ByteBuffer[]> getBufferHandler()
```
    获取输出时的拦截器
    
    返回:
    
    拦截器
  - setBufferHandler
```
protected void setBufferHandler(BiFunction<HttpResponse,ByteBuffer[],ByteBuffer[]> bufferHandler)
```
    设置输出时的拦截器
    
    参数:
    
    bufferHandler - 拦截器

类 HttpResponse

嵌套类概要

字段概要

从类继承的字段 org.redkale.net.Response

构造器概要

方法概要

从类继承的方法 org.redkale.net.Response

从类继承的方法 java.lang.Object

字段详细资料

status200Bytes

LINE

serverNameBytes

connectCloseBytes

connectAliveBytes

构造器详细资料

HttpResponse

方法详细资料

createPool

removeChannel

getChannel

recycle

init

getHttpCode

getRequest

getHttpCode

thenEvent

isAutoOptions

offerBuffer

addCookie

addCookie

createAsyncHandler

createAsyncHandler

getBufferSupplier

finishJson

finishMapJson

finishJson

finishMapJson

finishJson

finishJson

finishJson

finishJson

finishJson

finishJson

finishJson

finishJson

finish

finish

finish

finish

finish

finish304

finish404

finish

finish

finish

finish

finish

finish

sendBody

sendBody

finish

finish

finishFile

finishFile

createHeader

skipHeader

duplicateHeader

setHeader

addHeader

addHeader

setStatus

getStatus

getContentType

setContentType

getContentLength

setContentLength

getBufferHandler

setBufferHandler