JAX-WS中无法将@WebParam设为必填字段的解决方案咨询

我之前也遇到过完全一样的问题——明明给@WebParam加了@XmlElement(required=true)，生成的XSD里还是minOccurs="0"，折腾了好一阵才找到根源，给你几个可行的解决方案：

1. 切换到Document/Literal样式（最关键的一步） #

JAX-WS默认的RPC样式会忽略@XmlElement这类JAXB注解，因为RPC模式是基于方法参数名直接映射，不会遵循JAXB的元素规则。你需要把服务明确设置为Document/Literal模式：

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.xml.bind.annotation.XmlElement;

@WebService(targetNamespace = "http://your-custom-namespace.com/")
@SOAPBinding(style = SOAPBinding.Style.DOCUMENT, use = SOAPBinding.Use.LITERAL)
public class BillerService {

    @WebMethod
    @WebResult(name = "Biller")
    public Biller getBiller(
            @XmlElement(required = true, nillable = false)
            @WebParam(name = "billerId") Integer billerId) {
        // 你的业务逻辑
        return null;
    }
}

添加@SOAPBinding注解指定样式和使用方式后，JAXB的注解才会被正确解析，生成的XSD里billerId元素就会变成minOccurs="1"且nillable="false"。

2. 处理参数类型的影响 #

如果你的参数是包装类（比如Integer），有些JAX-WS实现会默认认为它可以为null，即使设置了required=true也可能被覆盖。这时候可以：

• 如果业务允许，把参数改成基本类型int（但这样就完全不能传null了）
• 同时保留@XmlElement(required=true, nillable=false)，明确告诉JAXB这个元素既必须出现，也不能为null

3. 验证JAX-WS实现的配置 #

如果你用的是Apache CXF或者Metro这类第三方JAX-WS实现，要确保配置没有覆盖注解的行为：

• 对于Apache CXF：检查你的端点配置（比如cxf-servlet.xml），确保没有手动设置参数的可选性，同时确认依赖的CXF版本支持JAXB注解的解析
• 对于Metro：确保项目中引入的Metro依赖是完整的，没有缺失JAXB相关的jar包

4. 用wsgen工具重新生成WSDL #

有时候IDE自动生成的WSDL可能缓存了旧的配置，建议用JDK自带的wsgen命令手动生成，确保拿到最新的结果：

wsgen -cp ./target/classes com.yourpackage.BillerService -wsdl -d ./target/wsdl

执行以上步骤后，你应该能看到生成的XSD里billerId的minOccurs变成1了。

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