Forest Forest
首页
  • 当前版本

    • v1.6.x
  • 历史版本

    • v1.5.36
    • v1.5.35
    • v1.5.33
    • v1.5.30 ~ v1.5.32
    • v1.5.0 ~ v1.5.28
  • 插件

    • ForestX
  • 问答

    • 常见问题
    • 更新记录
案例
  • 加入群聊
  • 赞助我们
  • 参与贡献
  • 贡献者们
  • 项目介绍
  • 开发团队
  • 关于作者
  • MaxKey - 业界领先的身份管理和认证产品 (opens new window)
  • Snowy - 国内首个国密前后端分离快速开发平台 (opens new window)
  • Eoapi - 一个开源、可拓展的 API 工具平台 (opens new window)
  • Fast Request - IDEA版Postman,为简化API调试而生 (opens new window)
  • Bean Searcher - 专注高级查询的只读 ORM (opens new window)
  • zyplayer-doc - 可私有化部署的文档与知识库管理平台 (opens new window)
  • frSimple - 中后台脚手架/小程序商城 (opens new window)
  • Gitee (opens new window)
  • Github (opens new window)
  • GitCode (opens new window)
首页
  • 当前版本

    • v1.6.x
  • 历史版本

    • v1.5.36
    • v1.5.35
    • v1.5.33
    • v1.5.30 ~ v1.5.32
    • v1.5.0 ~ v1.5.28
  • 插件

    • ForestX
  • 问答

    • 常见问题
    • 更新记录
案例
  • 加入群聊
  • 赞助我们
  • 参与贡献
  • 贡献者们
  • 项目介绍
  • 开发团队
  • 关于作者
  • MaxKey - 业界领先的身份管理和认证产品 (opens new window)
  • Snowy - 国内首个国密前后端分离快速开发平台 (opens new window)
  • Eoapi - 一个开源、可拓展的 API 工具平台 (opens new window)
  • Fast Request - IDEA版Postman,为简化API调试而生 (opens new window)
  • Bean Searcher - 专注高级查询的只读 ORM (opens new window)
  • zyplayer-doc - 可私有化部署的文档与知识库管理平台 (opens new window)
  • frSimple - 中后台脚手架/小程序商城 (opens new window)
  • Gitee (opens new window)
  • Github (opens new window)
  • GitCode (opens new window)
  • 入门

    • 🎬 安装配置说明
    • 🏹 Springboot环境安装
    • 📐 Springboot环境配置
    • 🎯 Springboot环境使用
    • 🏹 Springboot3环境安装
    • 📐 Springboot3环境配置
    • 🎯 Springboot3环境使用
    • 🏹 Spring环境安装
    • 📐 Spring环境配置
    • 🎯 Spring环境使用
    • 🏹 Solon环境安装
    • 📐 Solon环境配置
    • 🎯 Solon环境使用
    • 🏹 原生Java环境安装
    • 📐 原生Java环境配置
    • 🎯 原生Java环境使用
    • 🧬 编程式接口
  • 配置项

    • 👜 Springboot环境配置项
    • 👝 Spring环境配置项
    • 👜 Solon环境配置项
    • 🎒 原生Java环境配置项
    • 📚 配置优先级/作用域
  • 声明式接口

    • 🧱 构建接口
    • 🍀 请求方法
    • 🚚 请求地址
    • 🎈 URL 参数
    • 🍭 请求头
    • 👔 请求体
    • 🍮 后端框架
    • 🧁 接口注解
    • 📬 接收数据
    • 🍛 数据转换
    • 🎀 对象字段
    • 🍓 成功/失败条件
    • 🍌 重试机制
    • 🥂 重定向
    • 🍔 Gzip解压
    • 🎂 日志管理
    • ⚽ 回调函数
    • 🍟 异步请求
    • 🛡️ HTTPS
    • 🍪 使用Cookie
    • 🛸 使用代理
    • 🍉 上传下载
    • 🚑 异常处理
  • 编程式接口

    • 请求API

      • 🚀 请求对象
      • 🚢 请求属性
      • ✨ 执行请求
      • 🎊 后端框架
      • 🎪 请求类型
      • 🔮 请求地址
      • 🧀 URL 参数
      • 🚅 请求头
      • 🚋 请求体
      • ⚓ 回调函数
      • 🚁 异步请求
      • 🥯 Cookie
        • 加载 Cookie
        • 保存 Cookie
        • 严格匹配模式 (v1.5.25)
      • 🍜 成功/失败条件
      • 🌶️ 重试机制
      • ⛵ 重定向
      • 🛰️ 请求代理
    • 响应API

      • 🌠 响应对象
      • ✒️ 读取数据
      • 🦋 响应状态码
      • 🏥 响应错误处理
      • 🎧 响应头
      • 🥞 Cookie
  • 模板表达式

    • 🍬 Hello World
    • 🍹 配置属性引用
    • 🍖 变量引用
    • 🥃 动态变量绑定
    • 🥗 参数序号引用
    • 🍍 引用对象属性
    • 🥝 调用对象方法
  • 高级特性

    • 🥪 拦截器
    • 🍏 自定义注解
    • 🍇 组合注解
    • 🥑 自定义转换器
  • v1.5.36文档
  • 编程式接口
  • 请求API
公子骏
2022-07-14
目录

🥯 Cookie

# 加载 Cookie

onLoadCookie(OnLoadCookie onLoadCookie) 设置加载Cookie回调函数: 加载Cookie时调用

  • 参数onLoadCookie: OnLoadCookie 接口实例
Forest.post("/")
     // onLoadCookie回调函数: 加载Cookie时调用
    .onLoadCookie(((req, cookies) -> {
        // req 为Forest请求对象,即 ForestRequest 类实例
        // cookies 为Cookie集合, 需要通过请求发送的Cookie都添加到该集合
    }));
1
2
3
4
5
6

# 保存 Cookie

onSaveCookie(OnSaveCookie onSaveCookie) 设置保存Cookie回调函数: 需要保存Cookie时调用

  • 参数onSaveCookie: OnSaveCookie 接口实例
Forest.post("/")
     // onSaveCookie回调函数: 需要保存Cookie时调用
    .onSaveCookie(((req, cookies) -> {
        // req 为Forest请求对象,即 ForestRequest 类实例
        // cookies 为Cookie集合, 需要通过请求发送的Cookie都添加到该集合
    }));
1
2
3
4
5
6

# 严格匹配模式 (v1.5.25)

默认情况下,只有符合条件 (和请求同域名、同URL路径、未过期) 的 Cookie 才能被添加到请求中

这是因为 Forest 的 Cookie 集合默认为严格匹配模式,如果想添加符合匹配要求的 Cookie,只需修改严格匹配为false即可




 






Forest.post("/")
    // onLoadCookie回调函数: 加载Cookie时调用
    .onLoadCookie(((req, cookies) -> {
        cookies.strict(false) // 设置为非严格匹配模式
        .addCookie(new ForestCookie("attr1", "foo")) // 不设域名,默认情况下也能添加
        .addCookie(new ForestCookie("attr2", "bar")) // 不设域名,默认情况下也能添加
        // 不设域名,只有在非严格匹配模式下可以添加到请求中
        .addCookie(new ForestCookie("attr3", "foobar").setDomain("xxx.com"));
    }));
1
2
3
4
5
6
7
8
9
帮助我们改善此文档 (opens new window)
上次更新: 2024/12/26, 12:59:11
🚁 异步请求
🍜 成功/失败条件

← 🚁 异步请求 🍜 成功/失败条件→

Theme by Vdoing | Copyright © 2016-2025 公子骏 | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式