HttpResponse

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

嵌套类概要

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

protected class HttpResponse.TransferFileHandler

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

字段概要

字段
限定符和类型	字段和说明
`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, java.lang.String plainContentType, java.lang.String jsonContentType, java.lang.String[][] defaultAddHeaders, java.lang.String[][] defaultSetHeaders, java.net.HttpCookie defcookie, boolean autoOptions, boolean autoDate, java.util.List<HttpRender> renders)`

方法概要

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

构造器详细资料

HttpResponse

public HttpResponse(HttpContext context,
                    HttpRequest request,
                    java.lang.String plainContentType,
                    java.lang.String jsonContentType,
                    java.lang.String[][] defaultAddHeaders,
                    java.lang.String[][] defaultSetHeaders,
                    java.net.HttpCookie defcookie,
                    boolean autoOptions,
                    boolean autoDate,
                    java.util.List<HttpRender> renders)

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

类 HttpResponse

嵌套类概要

字段概要

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

构造器概要

方法概要

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

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

字段详细资料

status200Bytes

LINE

serverNameBytes

connectCloseBytes

构造器详细资料

HttpResponse

方法详细资料

createPool

removeChannel

getChannel

recycle

init

getHttpCode

getRequest

getHttpCode

thenEvent

isAutoOptions

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

sendBody

sendBody

finish

finish

finishFile

finishFile

createHeader

skipHeader

duplicateHeader

setHeader

addHeader

addHeader

setStatus

getStatus

getContentType

setContentType

getContentLength

setContentLength

getBufferHandler

setBufferHandler