一、在 Apache Cocoon 中获取当前请求 URI 的实现路径
1. 使用 FlowScript 的方案
FlowScript 提供直接访问请求对象的能力，通过 cocoon.request 可以获取当前请求的 URI、参数等信息，适合快速在工作流中提取当前请求的地址信息。此方法无需自己编写额外的 Java 组件，部署较为简单，且与 Cocoon 的流程控制紧密结合。关键点在于需要在 sitemap 中启用 FlowScript 环境，并在相应的生成器/转换器中执行 FlowScript 脚本。注意 FlowScript 的运行环境要与 Cocoon 版本匹配，避免导致运行时找不到对象的问题。
该方案的核心在于直接使用 cocoon.request.getRequestURI()，能够获得请求进入 Cocoon 时的相对路径部分，如 /app/list 或 /service/api/resource。可扩展为输出到页面、日志、或下游处理环节，以便后续进行路由分析、做鉴权判断，或将 URI 传递给模板/报告组件。
2. 示例代码与解释
下面给出一个简化的 FlowScript 片段，用来获取当前请求 URI，并将其存入一个变量以便后续使用。
// FlowScript 获取当前请求 URI
var currentUri = cocoon.request.getRequestURI();
// 进一步处理，例如输出到模板或日志
这段代码的要点是通过 cocoon.request 访问 HttpServletRequest，并调用 getRequestURI() 提取路径部分。在实际输出时，请确保输出目标与下游组件的编码/格式兼容，避免编码错误或路径解析歧义。
二、在 Apache Cocoon 中通过自定义 Java 组件暴露当前请求 URI
1. 实现思路
如果需要在整个 sitemap 中复用获取 URI 的逻辑，或者需要在非 FlowScript 场景中读取 URI，可以编写一个自定义 Java 组件，通过 Spring/ Avalon 容器注入到 sitemap 中，暴露一个方法用于返回当前请求的 URI。此方案的优点是可测试性强、可复用性高，且能够在复杂的流水线里统一管理对 URI 的获取。关键的实现点在于正确获取当前 HttpServletRequest，再从中提取 getRequestURI()，并将结果暴露给 sitemap。
需要注意：在多线程环境中请确保对请求级别数据的访问是线程安全的，通常直接从当前线程绑定的环境对象中读取即可，不要将请求对象长期缓存。
2. 代码示例
下面给出一个简化的 Java 组件示例，展示如何从 HttpServletRequest 获取 URI，并提供一个静态方法供 sitemap 调用。实际整合时，请按所在项目的组件扫描/注入方式进行配置。
package com.example.cocoon;import javax.servlet.http.HttpServletRequest;
import org.apache.cocoon.environment.http.HttpEnvironment;
import org.apache.cocoon.environment.http.HttpRequest;public class UriProvider {// 通过当前请求环境获取 URI（示意性实现，具体获取方式以项目环境而定）public static String getCurrentRequestURI() {HttpRequest request =(HttpRequest) HttpEnvironment.getCurrentEnvironment().getRequest();// 取得请求的 URIreturn request.getRequestURI();}
}
将该组件接入到 sitemap 的要点是在运行时能够通过某种调用方式获取到 UriProvider.getCurrentRequestURI() 的返回值，例如在一个模块输入（Module Input）或自定义处理器中调用，并将结果传递给后续的输出阶段。确保导入的包和环境对象名称与实际框架版本匹配，避免类加载失败。
三、注意事项与兼容性
1. 版本与环境的兼容性
不同版本的 Cocoon 对环境对象的命名和获取方式可能有所差异，在 FlowScript 中访问 cocoon.request 的能力在大多数 2.x 版本中都可用，但具体对象路径和可用方法要以当前版本的文档为准。在升级或迁移时务必测试相关脚本的运行效果，避免因 API 改动导致的运行时错误。
对于自定义 Java 组件，请确保与项目的容器配置（如 Avalon、Spring）兼容，且组件的依赖能够在构建阶段正确打包。多线程环境中的请求对象应避免被跨请求共享，以防数据污染或并发安全问题。
2. 性能与安全考量
获取当前请求 URI 的操作通常是极低成本的，但在高并发场景下仍需注意序列化输出带来的 I/O 影响，尽量将 URI 的提取控制在必要的链路中。若将 URI 暴露给外部端点（如日志系统、外部模板引擎、下游服务）时，请对内容进行必要的清洗与校验，避免暴露敏感信息。
在 FlowScript 场景中，如果要将 URI 写入输出或日志，请确保输出目标具备正确的编码和路径处理能力，避免跨站点脚本（XSS）风险或路径注入问题。必要时对输出进行 HTML 转义或路径归一化处理。
3. 部署与调试要点
启用 FlowScript 时，确认 sitemap 配置中相应的生成器/转换器类型正确，以确保 FlowScript 脚本可以在请求阶段正确执行。在调试阶段，开启详细日志以追踪 cocoon.request 对象及 getRequestURI 的返回值，有助于快速定位问题。
对于自定义 Java 组件，在打包阶段务必进行单元测试和集成测试，确保组件在不同请求上下文中都能返回正确的 URI。尽量提供回退逻辑，当无法获取 URI 时返回一个安全的占位字符串，以避免流水线中断。
