@XmlElement(required=true) 对于@WebParam 不起作用

Question

我正在使用 JAX-WS 构建 Web 服务。我有一个奇怪的问题，@WebParam 的注释 @XmlElement(required=true) 在某些 @WebService 类中有效，但不起作用在其他一些地方工作。

我在两个 @WebService 类中有非常相似的代码。什么可能导致这个问题？参数类型还是实体类？

编辑：添加示例代码

我有两个 Web 服务：

@WebService(name = "ClubMemberPortType", serviceName = "ClubMemberService", portName = "ClubMemberSoapPort", targetNamespace = "http://club.com/api/ws")
public class ClubMemberWS {
@WebMethod(operationName = "findClubMembersByClubId", action = "urn:findClubMembersByClubId")
    @WebResult(name = "club_membership")
    public List<ClubMembership> findClubMembershipsByClubId(@XmlElement(required=true)
                                                        @WebParam(name = "club_id") String clubId, 
                                                        @WebParam(name = "status") StatusEnum status){
...
}}

第二

@WebService(name = "ClubPortType", serviceName = "ClubService", portName = "ClubSoapPort", targetNamespace = "http://club.com/api/ws")
public class ClubWS {
@WebMethod(operationName = "findClubByClubId", action = "urn:findClubByClubId")
    @WebResult(name = "club")
    public Club findClubByClubId(@XmlElement(required=true)
                                @WebParam(name = "club_id") String clubId) {
...
}}

第一个 Web 方法的生成架构是：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://club.com/api/ws">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:findClubMembersByClubId>
         <club_id>?</club_id>
         <!--Optional:-->
         <status>?</status>
      </ws:findClubMembersByClubId>
   </soapenv:Body>
</soapenv:Envelope>

个 Web 方法的生成架构是：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://club.com/api/ws">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:findClubByClubId>
         <!--Optional:-->
         <club_id>?</club_id>
      </ws:findClubByClubId>
   </soapenv:Body>
</soapenv:Envelope>

所以第一个可以正常工作，第二个可以不工作。怎么可能呢？ :(

Answer 1

在 @WebParam 之后添加 @XmlElement(required=true,nillable=false) 解决了我类似的问题。使用 CXF 2.7.9。没有尝试把@XmlElement放在第一位，难道就这么简单吗？

Answer 2

我有同样的问题。我找到了使用单独的类作为服务方法参数的解决方案。

例如

@XmlType(name="SampleRequestType", propOrder={"title", "ref"})
public class SampleRequest {
    @XmlElement(name="title", required=false)
    private String title;
    @XmlElement(name="ref", required=true)
    private String ref;
    ...

网络方法

@WebMethod
public String sampleMethod(@WebParam(name = "params") SampleRequest params) {

也许这会有所帮助

Answer 3

如果您收到以下错误消息：“此位置不允许使用注释 @XmlElement”，则您可能使用了错误的导入语句。

将其更改为：

import javax.xml.bind.annotation.XmlElement;

由于 Eclipse 建议将另一个包作为第一个选项，这是一个非常常见的错误。

Answer 4

您尝试更改@WebParam和@XmlElement中的顺序吗？实际上我有一个 WS，它是这样的：

public Persona consultarPersona(@WebParam(name = "cedula") @XmlElement(required=true, nillable=false, name="cedula", namespace="cedulaParam")  String cedula) 

生成的描述是：

 <xsd:schema>
<xsd:import namespace="cedulaParam" schemaLocation="http://eniacstein-pc:8080/WSDL_Sample/GestorPersonas?xsd=2"/>
</xsd:schema>

模式定义：

    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0" targetNamespace="cedulaParam">
<xs:element name="cedula" type="xs:string"/>
</xs:schema>

就是这样！

Answer 5

也许我找到了解决方案。如果有人遇到同样的问题，只需按照这个顺序将这些注释放入您的 Web 服务合约（接口）中，就像之前所有人回答的那样。

@WebParam(name = "yourParam") @XmlElement(required = true)  YourParam param