Oracle APEX如何获取外部应用发来的HTTP POST请求体

问题核心 #

供应商完成选购后，以application/x-www-form-urlencoded格式的POST请求将cXML payload发送至APEX页面，但APEX预渲染事件中无法通过apex_application.g_x01或owa_util.print_cgi_env获取到该数据，本质是APEX默认仅解析符合自身提交规范的参数，对外部非标准POST参数不会自动映射到全局变量。

解决方案 #

方法一：PL/SQL直接读取RAW请求体 #

在页面**预处理（Before Header）**或独立处理流程中，直接读取HTTP请求体并解析URL编码的参数，适合所有POST场景：

DECLARE
    l_raw_body RAW(32767);
    l_clob_body CLOB;
    l_cxml_payload VARCHAR2(32767);
BEGIN
    -- 读取原始请求体
    l_raw_body := owa_util.get_cgi_env('HTTP_REQUEST_BODY');
    -- RAW转CLOB（处理大体积payload可调整为更大容量）
    dbms_lob.createtemporary(l_clob_body, TRUE);
    dbms_lob.converttoblob(l_clob_body, utl_raw.cast_to_raw(l_raw_body), length(l_raw_body));
    -- 解析URL编码内容，替换'cxml'为实际参数名（需对照浏览器开发者工具中的参数键）
    l_cxml_payload := apex_util.url_decode(apex_string.get_item(p_string => l_clob_body, p_name => 'cxml'));
    
    -- 后续处理：存入数据库或业务逻辑
    INSERT INTO punchout_responses (response_payload, created_date)
    VALUES (l_cxml_payload, SYSDATE);
    
    dbms_lob.freetemporary(l_clob_body);
END;

方法二：前端动态动作捕获并提交 #

若PL/SQL层面读取存在限制，可通过页面加载时的JavaScript读取请求体，再提交至APEX AJAX流程：

1. 创建隐藏页面项（如PXX_CXML_PAYLOAD，XX为页面编号）
2. 添加页面加载触发的动态动作，执行以下JavaScript：

fetch(window.location.href, { method: 'POST', credentials: 'include' })
.then(res => res.text())
.then(body => {
    const params = new URLSearchParams(body);
    const cxml = params.get('cxml'); // 替换为实际参数名
    if (cxml) {
        // 赋值给隐藏项
        apex.item('PXX_CXML_PAYLOAD').setValue(decodeURIComponent(cxml));
        // 调用AJAX流程保存数据
        apex.server.process('SAVE_CXML_PAYLOAD', { x01: decodeURIComponent(cxml) }, {
            success: () => apex.navigation.redirect('f?p=&APP_ID.:&APP_PAGE_ID.:&SESSION.')
        });
    }
});

3. 创建AJAX流程SAVE_CXML_PAYLOAD，处理传入的参数：

DECLARE
    l_cxml_payload VARCHAR2(32767);
BEGIN
    l_cxml_payload := apex_application.g_x01;
    INSERT INTO punchout_responses (response_payload, created_date)
    VALUES (l_cxml_payload, SYSDATE);
END;

额外排查点 #

• 检查页面属性安全性区域，确保「允许访问方式」设为POST，开启请求体解析
• 用owa_util.print_cgi_env输出CONTENT_TYPE和CONTENT_LENGTH，确认请求是否被正确接收
• 若供应商直接POST XML格式body（非URL编码表单），需将读取的RAW内容转换为XML类型处理：

  DECLARE
      l_xml XMLTYPE;
      l_raw_body RAW(32767);
  BEGIN
      l_raw_body := owa_util.get_cgi_env('HTTP_REQUEST_BODY');
      l_xml := XMLTYPE.createXML(utl_raw.cast_to_varchar2(l_raw_body));
      -- XML处理逻辑
  END;
  

内容的提问来源于stack exchange，提问作者Matthew Martinez