Ratpack
简单、精简且强大的 HTTP 应用程序
本手册尚未完善,正在不断更新中。
如果您想帮助改进它,我们希望您这样做,请参阅
README
。
版本: 2.0.0-rc-1
多页
单页
API 参考
1
简介
1.1
目标
2.1
关于本手册
1.2.1
代码示例
1.1.2.1
Java 8 风格
2
快速入门
1.2
使用 Groovy 脚本
2.2
使用 Gradle 插件
1.2.2
使用 Gradle Java 插件
2.2.2
使用 Gradle Groovy 插件
3
架构
1.3
强类型
2.3
非阻塞
3.3
各部分
4.3
插件和通过注册表扩展
5.3
服务和业务逻辑
4
启动
1.4
RatpackServer
1.1.4
服务器配置
1.1.1.4
基本目录
2.1.1.4
端口
3.1.1.4
SSL
2.1.4
注册表
3.1.4
处理器
4.1.4
启动和停止操作
5
处理器
1.5
什么是处理器?
2.5
处理器委托
3.5
构建处理器链
1.3.5
添加处理器和链
2.3.5
注册表
3.3.5
路径绑定
4.3.5
路径和方法绑定
6
上下文
1.6
上下文对象
1.1.6
分区
7
基础 HTTP
1.7
请求和响应
2.7
重定向
3.7
读取请求
1.3.7
解析器
1.1.3.7
JSON
2.1.3.7
表单
2.3.7
字节和文本
3.3.7
字节块流
4.7
发送响应
1.4.7
设置响应状态
2.4.7
发送响应
3.4.7
使用渲染器的另一种方法
4.4.7
发送 JSON
5.4.7
发送文件
6.4.7
发送前
5.7
头信息
1.5.7
请求头信息
2.5.7
响应头信息
6.7
Cookie
1.6.7
来自入站请求的 Cookie
2.6.7
为出站响应设置 Cookie
7.7
内容协商
8.7
会话
1.8.7
准备
2.8.7
使用会话
3.8.7
限制
4.8.7
`ratpack-session-redis` 模块
5.8.7
评论和有用链接
6.8.7
使用默认会话存储(内存中)时的最后说明:
8
异步和非阻塞
1.8
与阻塞框架和容器的比较
2.8
执行阻塞操作(例如 IO)
3.8
执行异步操作
4.8
异步组合和避免回调地狱
9
流
1.9
响应式流 API
1.1.9
背压
2.9
分块传输编码
3.9
服务器发送事件
4.9
WebSocket
10
测试 Ratpack 应用程序
1.10
单元测试
1.1.10
RequestFixture
2.1.10
ExecHarness
2.10
集成测试
3.10
功能测试
1.3.10
强加
2.3.10
浏览器测试
11
HTTP 客户端
1.11
基本 GET 请求
12
静态资产
1.12
从目录
2.12
临时文件
3.12
使用“资产管道”的先进资产服务
13
Google Guice 集成
1.13
模块
2.13
依赖注入处理器
3.13
Guice 和上下文注册表
14
Groovy
1.14
先决条件
2.14
Ratpack Groovy API
1.2.14
@DelegatesTo
3.14
ratpack.groovy 脚本
4.14
handlers {} DSL
5.14
测试
1.5.14
断言能力
2.5.14
JUnit 3 支持
3.5.14
JUnit 4 支持
4.5.14
Spock
1.4.5.14
第一步
2.4.5.14
更多关于 Spock
15
RxJava
1.15
初始化
2.15
观察 Ratpack
3.15
隐式错误处理
16
Jackson
1.16
编写 JSON 响应
2.16
读取 JSON 请求
3.16
配置 Jackson
17
Resilience4j
1.17
演示应用程序
18
配置
1.18
快速入门
2.18
配置源
1.2.18
扁平化配置源
1.1.2.18
环境变量
2.1.2.18
属性/映射
3.18
用法
1.3.18
排序
2.3.18
错误处理
3.3.18
对象映射器
4.3.18
绑定
19
Spring Boot
1.19
Spring 辅助类
2.19
在 Spring Boot 应用程序中嵌入 Ratpack
1.2.19
重新使用现有的 Guice 模块
20
pac4j
1.20
会话使用
2.20
演示应用程序
21
Retrofit 类型安全客户端
1.21
用法
2.21
在 Retrofit API 中使用 Ratpack Promise
3.21
创建多个 API 实现
4.21
使用 Retrofit 转换器
22
Dropwizard 指标
1.22
内置指标
2.22
自定义指标
3.22
报告指标
23
使用 Gradle 构建
1.23
设置
2.23
Ratpack 依赖项
3.23
'application' 插件
4.23
'shadow' 插件
5.23
基本目录
1.5.23
'ratpack.groovy' 脚本
6.23
运行应用程序
1.6.23
开发时重新加载
2.6.23
使用“shadow”插件运行
24
部署到 Heroku
1.24
基于 Gradle 的构建
1.1.24
构建
1.1.1.24
设置项目名称
2.1.24
运行 (Procfile)
3.1.24
配置
2.24
其他构建工具和二进制部署
3.24
一般注意事项
1.3.24
端口
25
日志记录
1.25
Java
2.25
Groovy
3.25
请求日志记录
26
Java 9 支持
1.26
已知库注意事项
2.26
已知问题
3.26
已知的 Java 9 错误/警告信息
27
相关项目
1.27
示例应用程序
2.27
替代语言实现
3.27
第三方模块
28
Ratpack 项目
1.28
致谢
1.1.28
活跃项目成员
2.1.28
贡献者
3.1.28
过去项目成员
2.28
关于本手册
1.2.28
资源
1.1.2.28
库
2.1.2.28
字体
3.1.2.28
图像