AEM Forms自定义提交：如何动态获取所有表单字段

我之前也碰到过一模一样的需求——内容作者总爱调整表单字段，每次改后端硬编码的参数名实在太折腾人了。下面是我实践过的可行方案，能让你的OSGI服务自动适配表单的任何变更，再也不用跟着表单改代码：

1. 编写支持动态参数的OSGI服务 #

先定义一个服务接口，方便JSP那边调用：

package com.yourcompany.aem.services;

import javax.servlet.http.HttpServletRequest;
import java.util.Map;

public interface DynamicFormProcessor {
    // 直接处理请求对象的方法
    String processForm(HttpServletRequest request);
    
    // 可选：接收参数Map的方法（适合不想让服务依赖HttpServletRequest的场景）
    String processFormParams(Map<String, String[]> formParams);
}

然后是服务实现类，核心逻辑就是遍历请求里的所有参数，不管表单加什么字段都能自动捕获：

package com.yourcompany.aem.services.impl;

import com.yourcompany.aem.services.DynamicFormProcessor;
import org.osgi.service.component.annotations.Component;

import javax.servlet.http.HttpServletRequest;
import java.util.Enumeration;
import java.util.HashMap;
import java.util.Map;

@Component(service = DynamicFormProcessor.class, immediate = true)
public class DynamicFormProcessorImpl implements DynamicFormProcessor {

    @Override
    public String processForm(HttpServletRequest request) {
        // 提取所有表单参数
        Map<String, String[]> formParams = extractAllParams(request);
        
        // 这里替换成你的业务逻辑，比如存数据库、调用外部接口等
        StringBuilder result = new StringBuilder("处理的表单参数:\n");
        for (Map.Entry<String, String[]> entry : formParams.entrySet()) {
            String paramName = entry.getKey();
            String[] paramValues = entry.getValue();
            
            result.append(paramName).append(": ");
            // 处理多选框这类多值参数
            result.append(paramValues.length > 1 ? String.join(", ", paramValues) : paramValues[0]);
            result.append("\n");
        }
        
        return result.toString();
    }

    // 工具方法：从request中提取所有参数
    private Map<String, String[]> extractAllParams(HttpServletRequest request) {
        Map<String, String[]> paramsMap = new HashMap<>();
        Enumeration<String> paramNames = request.getParameterNames();
        
        while (paramNames.hasMoreElements()) {
            String paramName = paramNames.nextElement();
            String[] paramValues = request.getParameterValues(paramName);
            paramsMap.put(paramName, paramValues);
        }
        
        return paramsMap;
    }

    @Override
    public String processFormParams(Map<String, String[]> formParams) {
        // 和上面processForm逻辑一致，只是参数来源不同
        StringBuilder result = new StringBuilder("处理的表单参数:\n");
        for (Map.Entry<String, String[]> entry : formParams.entrySet()) {
            String paramName = entry.getKey();
            String[] paramValues = entry.getValue();
            
            result.append(paramName).append(": ");
            result.append(paramValues.length > 1 ? String.join(", ", paramValues) : paramValues[0]);
            result.append("\n");
        }
        
        return result.toString();
    }
}

2. 修改JSP调用服务 #

原来的JSP是逐个拿参数，现在改成直接把请求对象传给服务，或者先把参数转成Map再传：

方式一：直接传递HttpServletRequest（推荐，更简洁） #

<%@ page import="com.yourcompany.aem.services.DynamicFormProcessor" %>
<%@ page import="org.osgi.framework.FrameworkUtil" %>
<%@ page import="org.osgi.framework.BundleContext" %>
<%@ page import="org.osgi.util.tracker.ServiceTracker" %>

<%
    // 获取OSGI服务实例
    BundleContext bundleContext = FrameworkUtil.getBundle(getClass()).getBundleContext();
    ServiceTracker<DynamicFormProcessor, DynamicFormProcessor> tracker = 
        new ServiceTracker<>(bundleContext, DynamicFormProcessor.class, null);
    tracker.open();
    DynamicFormProcessor formProcessor = tracker.getService();
    
    if (formProcessor != null) {
        // 直接把request丢给服务处理
        String processingResult = formProcessor.processForm(request);
        out.println("服务处理结果: " + processingResult);
    } else {
        out.println("无法获取表单处理服务");
    }
    
    tracker.close();
%>

方式二：JSP先提取参数Map再传递 #

如果不想让OSGI服务依赖HttpServletRequest，保持服务的独立性，可以在JSP里先处理参数：

<%@ page import="com.yourcompany.aem.services.DynamicFormProcessor" %>
<%@ page import="org.osgi.framework.FrameworkUtil" %>
<%@ page import="org.osgi.framework.BundleContext" %>
<%@ page import="org.osgi.util.tracker.ServiceTracker" %>
<%@ page import="java.util.Map" %>
<%@ page import="java.util.HashMap" %>
<%@ page import="java.util.Enumeration" %>

<%
    // JSP层面先提取所有表单参数
    Map<String, String[]> formParams = new HashMap<>();
    Enumeration<String> paramNames = request.getParameterNames();
    while (paramNames.hasMoreElements()) {
        String paramName = paramNames.nextElement();
        String[] paramValues = request.getParameterValues(paramName);
        formParams.put(paramName, paramValues);
    }

    // 获取OSGI服务实例
    BundleContext bundleContext = FrameworkUtil.getBundle(getClass()).getBundleContext();
    ServiceTracker<DynamicFormProcessor, DynamicFormProcessor> tracker = 
        new ServiceTracker<>(bundleContext, DynamicFormProcessor.class, null);
    tracker.open();
    DynamicFormProcessor formProcessor = tracker.getService();
    
    if (formProcessor != null) {
        String processingResult = formProcessor.processFormParams(formParams);
        out.println("服务处理结果: " + processingResult);
    } else {
        out.println("无法获取表单处理服务");
    }
    
    tracker.close();
%>

3. 核心优势 #

• 完全动态适配：内容作者随便改表单字段，后端服务不用动一行代码，自动捕获所有参数。
• 兼容多值参数：完美处理复选框这类一个参数对应多个值的场景，不会丢失数据。
• 灵活可选：两种调用方式，既可以简洁地直接传请求对象，也可以保持服务的独立性。

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