WebService的wsdl详解

已于 2024-05-22 16:22:10 修改
阅读量930 收藏 24
点赞数 28
分类专栏： WebService 文章标签： java
于 2024-05-22 16:21:15 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/onePlus5T/article/details/139123100
版权

webservice服务的wsdl内容详解，以及如何根据其内容编写调用代码

wsdl示例

展示一个webservice的wsdl，及调用这个接口的Axis客户端

wsdl

This XML file does not appear to have any style information associated with it. The document tree is shown below.

<wsdl:definitions
    xmlns:apachesoap="http://xml.apache.org/xml-soap"
    xmlns:impl="http://10.10.1.190:6889/ormrpc/services/EASLogin"
    xmlns:intf="http://10.10.1.190:6889/ormrpc/services/EASLogin"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:tns1="urn:client"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://10.10.1.190:6889/ormrpc/services/EASLogin">
    <!-- WSDL created by Apache Axis version: 1.4
Built on Apr 22, 2006 (06:55:48 PDT) -->
	
	
    <wsdl:types>
        <schema
            xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="urn:client">
            <import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
            <complexType name="WSContext">
                <sequence>
                    <element name="dbType" type="xsd:int"/>
                    <element name="dcName" nillable="true" type="xsd:string"/>
                    <element name="password" nillable="true" type="xsd:string"/>
                    <element name="sessionId" nillable="true" type="xsd:string"/>
                    <element name="slnName" nillable="true" type="xsd:string"/>
                    <element name="userName" nillable="true" type="xsd:string"/>
                </sequence>
            </complexType>
        </schema>
    </wsdl:types>
	
	
    <wsdl:message name="loginByLtpaTokenResponse">
        <wsdl:part name="loginByLtpaTokenReturn" type="tns1:WSContext"></wsdl:part>
    </wsdl:message>
	
	
    <wsdl:message name="loginByLtpaTokenRequest">
        <wsdl:part name="userName" type="xsd:string"></wsdl:part>
        <wsdl:part name="ltpaToken" type="xsd:string"></wsdl:part>
        <wsdl:part name="slnName" type="xsd:string"></wsdl:part>
        <wsdl:part name="dcName" type="xsd:string"></wsdl:part>
        <wsdl:part name="language" type="xsd:string"></wsdl:part>
        <wsdl:part name="dbType" type="xsd:int"></wsdl:part>
    </wsdl:message>
	
	
    <wsdl:message name="loginResponse2">
        <wsdl:part name="loginReturn" type="tns1:WSContext"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="logoutResponse">
        <wsdl:part name="logoutReturn" type="xsd:boolean"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="logoutRequest">
        <wsdl:part name="userName" type="xsd:string"></wsdl:part>
        <wsdl:part name="slnName" type="xsd:string"></wsdl:part>
        <wsdl:part name="dcName" type="xsd:string"></wsdl:part>
        <wsdl:part name="language" type="xsd:string"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="loginResponse1">
        <wsdl:part name="loginReturn" type="tns1:WSContext"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="loginRequest2">
        <wsdl:part name="userName" type="xsd:string"></wsdl:part>
        <wsdl:part name="password" type="xsd:string"></wsdl:part>
        <wsdl:part name="slnName" type="xsd:string"></wsdl:part>
        <wsdl:part name="dcName" type="xsd:string"></wsdl:part>
        <wsdl:part name="language" type="xsd:string"></wsdl:part>
        <wsdl:part name="dbType" type="xsd:int"></wsdl:part>
        <wsdl:part name="authPattern" type="xsd:string"></wsdl:part>
        <wsdl:part name="isEncodePwd" type="xsd:int"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="loginRequest1">
        <wsdl:part name="userName" type="xsd:string"></wsdl:part>
        <wsdl:part name="password" type="xsd:string"></wsdl:part>
        <wsdl:part name="slnName" type="xsd:string"></wsdl:part>
        <wsdl:part name="dcName" type="xsd:string"></wsdl:part>
        <wsdl:part name="language" type="xsd:string"></wsdl:part>
        <wsdl:part name="dbType" type="xsd:int"></wsdl:part>
        <wsdl:part name="authPattern" type="xsd:string"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="loginResponse">
        <wsdl:part name="loginReturn" type="tns1:WSContext"></wsdl:part>
    </wsdl:message>
	
    <wsdl:message name="loginRequest">
        <wsdl:part name="userName" type="xsd:string"></wsdl:part>
        <wsdl:part name="password" type="xsd:string"></wsdl:part>
        <wsdl:part name="slnName" type="xsd:string"></wsdl:part>
        <wsdl:part name="dcName" type="xsd:string"></wsdl:part>
        <wsdl:part name="language" type="xsd:string"></wsdl:part>
        <wsdl:part name="dbType" type="xsd:int"></wsdl:part>
    </wsdl:message>
	
	
    <wsdl:portType name="EASLoginProxy">
        <wsdl:operation name="login" parameterOrder="userName password slnName dcName language dbType">
            <wsdl:input message="impl:loginRequest" name="loginRequest"></wsdl:input>
            <wsdl:output message="impl:loginResponse" name="loginResponse"></wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="login" parameterOrder="userName password slnName dcName language dbType authPattern">
            <wsdl:input message="impl:loginRequest1" name="loginRequest1"></wsdl:input>
            <wsdl:output message="impl:loginResponse1" name="loginResponse1"></wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="login" parameterOrder="userName password slnName dcName language dbType authPattern isEncodePwd">
            <wsdl:input message="impl:loginRequest2" name="loginRequest2"></wsdl:input>
            <wsdl:output message="impl:loginResponse2" name="loginResponse2"></wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="logout" parameterOrder="userName slnName dcName language">
            <wsdl:input message="impl:logoutRequest" name="logoutRequest"></wsdl:input>
            <wsdl:output message="impl:logoutResponse" name="logoutResponse"></wsdl:output>
        </wsdl:operation>
        <wsdl:operation name="loginByLtpaToken" parameterOrder="userName ltpaToken slnName dcName language dbType">
            <wsdl:input message="impl:loginByLtpaTokenRequest" name="loginByLtpaTokenRequest"></wsdl:input>
            <wsdl:output message="impl:loginByLtpaTokenResponse" name="loginByLtpaTokenResponse"></wsdl:output>
        </wsdl:operation>
    </wsdl:portType>
	
	
    <wsdl:binding name="EASLoginSoapBinding" type="impl:EASLoginProxy">
        <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
		
        <wsdl:operation name="login">
            <wsdlsoap:operation soapAction=""/>
            <wsdl:input name="loginRequest">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://login.webservice.bos.kingdee.com" use="encoded"/>
            </wsdl:input>
            <wsdl:output name="loginResponse">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://10.10.1.190:6889/ormrpc/services/EASLogin" use="encoded"/>
            </wsdl:output>
        </wsdl:operation>
		
        <wsdl:operation name="login">
            <wsdlsoap:operation soapAction=""/>
            <wsdl:input name="loginRequest1">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://login.webservice.bos.kingdee.com" use="encoded"/>
            </wsdl:input>
            <wsdl:output name="loginResponse1">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://10.10.1.190:6889/ormrpc/services/EASLogin" use="encoded"/>
            </wsdl:output>
        </wsdl:operation>
		
        <wsdl:operation name="login">
            <wsdlsoap:operation soapAction=""/>
            <wsdl:input name="loginRequest2">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://login.webservice.bos.kingdee.com" use="encoded"/>
            </wsdl:input>
            <wsdl:output name="loginResponse2">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://10.10.1.190:6889/ormrpc/services/EASLogin" use="encoded"/>
            </wsdl:output>
        </wsdl:operation>
		
        <wsdl:operation name="logout">
            <wsdlsoap:operation soapAction=""/>
            <wsdl:input name="logoutRequest">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://login.webservice.bos.kingdee.com" use="encoded"/>
            </wsdl:input>
            <wsdl:output name="logoutResponse">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://10.10.1.190:6889/ormrpc/services/EASLogin" use="encoded"/>
            </wsdl:output>
        </wsdl:operation>
		
        <wsdl:operation name="loginByLtpaToken">
            <wsdlsoap:operation soapAction=""/>
            <wsdl:input name="loginByLtpaTokenRequest">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://login.webservice.bos.kingdee.com" use="encoded"/>
            </wsdl:input>
            <wsdl:output name="loginByLtpaTokenResponse">
                <wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://10.10.1.190:6889/ormrpc/services/EASLogin" use="encoded"/>
            </wsdl:output>
        </wsdl:operation>
		
    </wsdl:binding>
	
	
	
    <wsdl:service name="EASLoginProxyService">
        <wsdl:port binding="impl:EASLoginSoapBinding" name="EASLogin">
            <wsdlsoap:address location="http://10.10.1.190:6889/ormrpc/services/EASLogin"/>
        </wsdl:port>
    </wsdl:service>
	
	
</wsdl:definitions>

Axis客户端

用于调用上面的webservice服务

<dependency>
	<groupId>org.apache.axis</groupId>
	<artifactId>axis</artifactId>
	<version>1.4</version>
</dependency>

import client.WSContext;
import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.XMLType;
import org.w3c.dom.Document;
import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;
import javax.xml.rpc.ServiceException;
import javax.xml.soap.*;
import java.net.MalformedURLException;
import java.net.URL;
import java.rmi.RemoteException;


public static void other(){

        QName returnType = new javax.xml.namespace.QName("urn:client", "WSContext");

        Object result = null;
        try {
            // 创建一个新的Service对象
            Service service = new Service();
            Call call = (Call) service.createCall();

            // 设置目标webservice地址，注意去掉 问号与wsdl
            call.setTargetEndpointAddress(new URL("http://10.10.1.190:6889/ormrpc/services/EASLogin"));

            //设置方法名
            call.setOperationName(new QName( "login"));

            // 设置传入参数的xml及类型，可以不写
            //call.addParameter("userName", XMLType.XSD_STRING, ParameterMode.IN);
            //call.addParameter("password", XMLType.XSD_STRING, ParameterMode.IN);
            //call.addParameter("slnName", XMLType.XSD_STRING, ParameterMode.IN);
            //call.addParameter("dcName", XMLType.XSD_STRING, ParameterMode.IN);
            //call.addParameter("language", XMLType.XSD_STRING, ParameterMode.IN);
            //call.addParameter("dbType", XMLType.XSD_INT, ParameterMode.IN);

            // 设置返回参数的xml及类型，设置请求参数时要写参数名，而返回值不用
            call.setReturnType(returnType);
            call.setReturnClass(WSContext.class);

            //设置返回值名字，可以不写
            //call.setReturnQName(new QName("", "loginReturn"));

            //设置axis的序列化，否则无法接受自定义类型WSContext
            Class sf = org.apache.axis.encoding.ser.BeanSerializerFactory.class;
            Class df = org.apache.axis.encoding.ser.BeanDeserializerFactory.class;
            call.registerTypeMapping(WSContext.class, returnType, sf, df, false);

            // 构造请求的参数
            String userName = "xdgt";
            String password = "123456";
            String slnName = "eas";
            String dcName = "gg01";
            String language = "L2";
            Integer dbType = 2;

            // 调用WebService方法
            WSContext ws = (WSContext) call.invoke(new Object[] {userName, password, slnName, dcName, language, dbType});

            // 处理返回的结果
            System.out.println("Response: " + ws.getSessionId());
        } catch (Exception e) {
            result = "{\"status\": \"error\",\"msg\":\"" + e.getMessage() + "\"}";
        }

        System.out.println(result);

}

返回类型WSContext代码，这个建议用axis命令生成，因为内部涉及wsdl的拼接，比较麻烦，而且实际开发中，有可能你并不了解对方的代码结构

axis命令生成参考：

https://blog.csdn.net/onePlus5T/article/details/139122866

/**
 * WSContext.java
 *
 * This file was auto-generated from WSDL
 * by the Apache Axis 1.4 Apr 22, 2006 (06:55:48 PDT) WSDL2Java emitter.
 */

package client;

public class WSContext  implements java.io.Serializable {
    private int dbType;

    private String dcName;

    private String password;

    private String sessionId;

    private String slnName;

    private String userName;

    public WSContext() {
    }

    public WSContext(
            int dbType,
            String dcName,
            String password,
            String sessionId,
            String slnName,
            String userName) {
        this.dbType = dbType;
        this.dcName = dcName;
        this.password = password;
        this.sessionId = sessionId;
        this.slnName = slnName;
        this.userName = userName;
    }


    /**
     * Gets the dbType value for this WSContext.
     *
     * @return dbType
     */
    public int getDbType() {
        return dbType;
    }


    /**
     * Sets the dbType value for this WSContext.
     *
     * @param dbType
     */
    public void setDbType(int dbType) {
        this.dbType = dbType;
    }


    /**
     * Gets the dcName value for this WSContext.
     *
     * @return dcName
     */
    public String getDcName() {
        return dcName;
    }


    /**
     * Sets the dcName value for this WSContext.
     *
     * @param dcName
     */
    public void setDcName(String dcName) {
        this.dcName = dcName;
    }


    /**
     * Gets the password value for this WSContext.
     *
     * @return password
     */
    public String getPassword() {
        return password;
    }


    /**
     * Sets the password value for this WSContext.
     *
     * @param password
     */
    public void setPassword(String password) {
        this.password = password;
    }


    /**
     * Gets the sessionId value for this WSContext.
     *
     * @return sessionId
     */
    public String getSessionId() {
        return sessionId;
    }


    /**
     * Sets the sessionId value for this WSContext.
     *
     * @param sessionId
     */
    public void setSessionId(String sessionId) {
        this.sessionId = sessionId;
    }


    /**
     * Gets the slnName value for this WSContext.
     *
     * @return slnName
     */
    public String getSlnName() {
        return slnName;
    }


    /**
     * Sets the slnName value for this WSContext.
     *
     * @param slnName
     */
    public void setSlnName(String slnName) {
        this.slnName = slnName;
    }


    /**
     * Gets the userName value for this WSContext.
     *
     * @return userName
     */
    public String getUserName() {
        return userName;
    }


    /**
     * Sets the userName value for this WSContext.
     *
     * @param userName
     */
    public void setUserName(String userName) {
        this.userName = userName;
    }

    private Object __equalsCalc = null;
    public synchronized boolean equals(Object obj) {
        if (!(obj instanceof WSContext)) return false;
        WSContext other = (WSContext) obj;
        if (obj == null) return false;
        if (this == obj) return true;
        if (__equalsCalc != null) {
            return (__equalsCalc == obj);
        }
        __equalsCalc = obj;
        boolean _equals;
        _equals = true &&
                this.dbType == other.getDbType() &&
                ((this.dcName==null && other.getDcName()==null) ||
                        (this.dcName!=null &&
                                this.dcName.equals(other.getDcName()))) &&
                ((this.password==null && other.getPassword()==null) ||
                        (this.password!=null &&
                                this.password.equals(other.getPassword()))) &&
                ((this.sessionId==null && other.getSessionId()==null) ||
                        (this.sessionId!=null &&
                                this.sessionId.equals(other.getSessionId()))) &&
                ((this.slnName==null && other.getSlnName()==null) ||
                        (this.slnName!=null &&
                                this.slnName.equals(other.getSlnName()))) &&
                ((this.userName==null && other.getUserName()==null) ||
                        (this.userName!=null &&
                                this.userName.equals(other.getUserName())));
        __equalsCalc = null;
        return _equals;
    }

    private boolean __hashCodeCalc = false;
    public synchronized int hashCode() {
        if (__hashCodeCalc) {
            return 0;
        }
        __hashCodeCalc = true;
        int _hashCode = 1;
        _hashCode += getDbType();
        if (getDcName() != null) {
            _hashCode += getDcName().hashCode();
        }
        if (getPassword() != null) {
            _hashCode += getPassword().hashCode();
        }
        if (getSessionId() != null) {
            _hashCode += getSessionId().hashCode();
        }
        if (getSlnName() != null) {
            _hashCode += getSlnName().hashCode();
        }
        if (getUserName() != null) {
            _hashCode += getUserName().hashCode();
        }
        __hashCodeCalc = false;
        return _hashCode;
    }

    // Type metadata
    private static org.apache.axis.description.TypeDesc typeDesc =
            new org.apache.axis.description.TypeDesc(WSContext.class, true);

    static {
        typeDesc.setXmlType(new javax.xml.namespace.QName("urn:client", "WSContext"));
        org.apache.axis.description.ElementDesc elemField = new org.apache.axis.description.ElementDesc();
        elemField.setFieldName("dbType");
        elemField.setXmlName(new javax.xml.namespace.QName("", "dbType"));
        elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "int"));
        elemField.setNillable(false);
        typeDesc.addFieldDesc(elemField);
        elemField = new org.apache.axis.description.ElementDesc();
        elemField.setFieldName("dcName");
        elemField.setXmlName(new javax.xml.namespace.QName("", "dcName"));
        elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
        elemField.setNillable(true);
        typeDesc.addFieldDesc(elemField);
        elemField = new org.apache.axis.description.ElementDesc();
        elemField.setFieldName("password");
        elemField.setXmlName(new javax.xml.namespace.QName("", "password"));
        elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
        elemField.setNillable(true);
        typeDesc.addFieldDesc(elemField);
        elemField = new org.apache.axis.description.ElementDesc();
        elemField.setFieldName("sessionId");
        elemField.setXmlName(new javax.xml.namespace.QName("", "sessionId"));
        elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
        elemField.setNillable(true);
        typeDesc.addFieldDesc(elemField);
        elemField = new org.apache.axis.description.ElementDesc();
        elemField.setFieldName("slnName");
        elemField.setXmlName(new javax.xml.namespace.QName("", "slnName"));
        elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
        elemField.setNillable(true);
        typeDesc.addFieldDesc(elemField);
        elemField = new org.apache.axis.description.ElementDesc();
        elemField.setFieldName("userName");
        elemField.setXmlName(new javax.xml.namespace.QName("", "userName"));
        elemField.setXmlType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
        elemField.setNillable(true);
        typeDesc.addFieldDesc(elemField);
    }


}

wsdl标签大意

♦ types元素

使用XML模式语言，声明在WSDL文档中的其他位置使用的复杂数据类型与元素，可理解为就是**定义webservice方法请求与响应参数的**

♦ import元素

类似于XML模式文档中的import元素，用于从其他WSDL文档中导入WSDL定义；

♦ message元素

使用在WSDL文档的type元素中定义或在import元素引用的外部WSDL文档中定义的XML模式的内置类型、复杂类型或元素描述了消息的有效负载；

♦ portType元素 和 operation元素

描述了Web服务的接口并定义了他的方法。portType元素和operation元素类似于java接口和接口中定义的方法声明。operation元素使用一个或者多个message类型来定义他的输入和输出的有效负载；

♦ Binding元素

将portType元素和operation元素赋给一个特殊的协议和编码样式；

♦ service元素

负责将Internet地址赋给一个具体的绑定；

具体解释

wsdl:definitions标签

xmlns:xxxx

做此wsdl的定义，里面有很多 xmlns:xxxx，其中后半部分的xxxx会在其他标签中被引用

比如，在上面wsdl文件中的 wsdl:message的Response标签 中，返回类型定义为：type=“tns1:WSContext”，则对应Axis客户端代码就要这样写：

//因为tns1在 <wsdl:definitions>标签 中定义值为 urn:client，所以要向下面这样拼
call.setReturnType(new javax.xml.namespace.QName("urn:client", "WSContext"));

//一般如果不是java中自带的类型，比如string、int等，大概率都是自定义类型，
//此处的WSContext肯定是自定义类型，所以必须在这里赋值class类型，因为Axis不知道WSContext是什么类型
call.setReturnClass(WSContext.class);

假如是 type=“xsd:string”，则对应Axis客户端代码就是：

//xsd属于xml自带标签，进入org.apache.axis.Constants.XSD_STRING的源码可以看见其值就是xsd:string
call.setReturnType(org.apache.axis.Constants.XSD_STRING);

targetNamespace

webserivce的名称空间，一般与方法名拼接一起使用，axis代码使用如下：

call.setOperationName(new QName("名称空间", "方法名"));

注意：targetNamespace不是必须与方法名拼接在一起进行axis客户端调用，要看 wsdl:message 标签的方法中是否有前缀

比如下面：方法Response 与 Request 中都有前缀ns0，而ns0的值恰好与targetNamespace一致，所以上面的：

new QName("名称空间", "方法名")

就没问题了

image-20231130142402388

但是本wsdl示例文档的 wsdl:message 标签方法无前缀，比如下图的logout方法：

image-20231130142727160

则axis代码就可以直接写一个方法名：

call.setOperationName(new QName( "logout"));

wsdl:message标签

详解

方法标签，对应发布webservice的接口方法，其中

  • xxxResponse代表接口方法的返回
  • xxxRequest或者直接xxx方法名代表接口方法的接收

比如本文的wsdl示例文档中的：

image-20231130145939604

正对应其5个方法：

image-20231130150011335

而wsdl:message标签的内容，正对应请求参数与返回值参数

image-20231130150134589

  • 请求参数对应上图request中的5个
  • 返回参数对应上图的tns1:WSContext，也就是下面wsdl:types标签中的类型定义，是5个小类型的合体

image-20231130150331758

axis调用

1.这里对应本文wsdl示例的axis代码调用如下，因为对应方法名的loginRequest、loginResponse没有前缀修饰：

call.setOperationName(new QName( "login"));

2.但如果是下面这种，就必须有前缀对应的QName拼接：

image-20231130151008337

call.setOperationName(new QName("tns在<wsdl:definitions>内定义的值","方法名emeService"));

wsdl:definitions中的tns展示，大部分tns与名称空间targetNamespace相同

image-20231130151218903


wsdl:types标签

详解1

声明在其他标签中要使用的元素和类型，比如接口方法参数类型、返回值类型

比如本文档示例的wsdl中，wsdl:types标签内容如下，其实就是定义了接口方法的参数类型：

<wsdl:types>
        <schema
            xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="urn:client">
            <import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
            <complexType name="WSContext">
                <sequence>
                    <element name="dbType" type="xsd:int"/>
                    <element name="dcName" nillable="true" type="xsd:string"/>
                    <element name="password" nillable="true" type="xsd:string"/>
                    <element name="sessionId" nillable="true" type="xsd:string"/>
                    <element name="slnName" nillable="true" type="xsd:string"/>
                    <element name="userName" nillable="true" type="xsd:string"/>
                </sequence>
            </complexType>
        </schema>
</wsdl:types>

其中，complexType为一个复合类型，它包含的具体小类型在sequence标签的element中，当我们调用

<wsdl:message name="loginRequest">

的方法时，返回的结果格式如下，其实就是返回了WSContext类，这个类包含了其他5个字符串和整数的属性

image-20231130144135318

axis调用1

结合最上面wsdl示例的message：

请求：

<wsdl:message name="loginRequest">
	<wsdl:part name="userName" type="xsd:string"> </wsdl:part>
	<wsdl:part name="password" type="xsd:string"> </wsdl:part>
	<wsdl:part name="slnName" type="xsd:string"> </wsdl:part>
	<wsdl:part name="dcName" type="xsd:string"> </wsdl:part>
	<wsdl:part name="language" type="xsd:string"> </wsdl:part>
	<wsdl:part name="dbType" type="xsd:int"> </wsdl:part>
</wsdl:message>

响应：

<wsdl:message name="loginByLtpaTokenResponse">
	<wsdl:part name="loginByLtpaTokenReturn" type="tns1:WSContext"> </wsdl:part>
</wsdl:message>

此wsdl:types标签对应的调用代码如下

注意：请求参数需要写参数名，设置返回值时不用写返回值名

请求：

call.addParameter("userName", XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter("password", XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter("slnName", XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter("dcName", XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter("language", XMLType.XSD_STRING, ParameterMode.IN);
call.addParameter("dbType", XMLType.XSD_INT, ParameterMode.IN);

响应：

//设置wsdl中返回值类型及其修饰标签
call.setReturnType(new QName("urn:client", "WSContext"));
//因为返回值类型为WSContext，不是基本类型，所以必须设置其calss类，否则报错
call.setReturnClass(WSContext.class);

这个响应的返回值类型，推荐由Axis的命令直接生成，内部构成比较复杂

image-20231130161340243


详解2

在举一个不同格式的例子

下面这种格式的wsdl:types标签，与上面大同小异，意思就是：

在wsdl:types中，定义了**emeService方法 ** 的

  • 请求参数类型是String，名称是arg0
  • 返回值类型是String，名称是return

image-20231130145235021

结果证明：

image-20231130145546259

axis调用2

上面的返回值名字为return，类型为xs:string

注意：axis设置请求参数时需要写参数名，而设置返回值时不用写返回值名

xs:string在axis中可以用代码XMLType.XSD_STRING标识，java基本类型都可以用XMLType表示

call.setReturnType(XMLType.XSD_STRING);

wsdl:portType标签

表达了发布webservice接口的代码结构

以本文wsdl文档示例为例：

  • wsdl:portType的name的值：一般对应发布webservice的接口名。
  • wsdl:operation的name的值：对应webservice接口的方法名，parameterOrder为方法参数名。
  • wsdl:input与wsdl:output：对应了输入输出，即接口方法请求与返回的message定义，可以根据其name名字去wsdl:message标签找对应的方法定义。

image-20231130152757638


wsdl:binding与wsdl:service标签

好像不涉及Axis代码调用需要编写的部分，暂时没有仔细分析

  • Binding - 特定端口类型的具体协议和数据格式规范的绑定。
  • Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
  • Service- 相关服务访问点的集合。
Mr. bigworth
关注
  • 28
    点赞
  • 踩
  • 24
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
wsdl文件 服务器地址,webservice 的wsdl文件详解
weixin_28909745的博客
08-09 2476
转WSDL(Web Service Description Language)Web服务描述语言################################################################################适用于描述WebService的文档格式下面例子是为了输入一个字符串name，返回一个SayHello的操作。targetNamespace="...
wsdl详解(webservice)
02-10
wsdl 详细介绍 WSDL (Web Services Description Language,Web服务描述语言)是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行...
WebService中的WSDL详细解析
旅程的点点滴滴
08-08 6083
WebService中的WSDL详解        有人在WebService开发的时候，特别是和第三方有接口的时候，走的是SOAP协议，然后用户（或后台）给你一个WSDL文件（或网址），说按照上面的进行适配， 这时就要对WebService的WSDL有一定的理解，本文将对WSDL（WebService描述语言）进行详细总结。      &nbs...
webservice wsdl地址
weixin_30338743的博客
03-09 554
天气预报Web服务，数据来源于中国气象局公用事业Endpoint:http://www.webxml.com.cn/WebServices/WeatherWebService.asmxDisco:http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?discoWSDL:http://www.webxml.com.cn/WebServ...
当同事问你要wsdl地址时... (WebService)(springboot)
global_coding的博客
06-28 1334
当同事问你要wsdl地址时... (WebService)(springboot)
WebService wsdl没有types的问题
KIWI的专栏
01-31 711
刚学WebService就遇到一个问题，按视屏敲的代码，它生成的wsdl页面与自己的不一样，我的没有types,结构完全不同了 This XML file does not appear to have any style information associated with it. The document tree is shown below. &lt;!-- Published b...
WebService描述语言WSDL详解.docx
09-13
WebService描述语言WSDL详解
webservice soap wsdl
10-21
webservice soap wsdl详解
WebService描述语言WSDL详解
08-01
WebService描述语言WSDL详解，包括WSDL文档结构，每个关键节点的详细解释，很实用的说明文档
解析webservice的wsdl地址
qq_35144470的博客
12-12 1791
wsimport -keep -p org.tempuri -s d:/ws  http://localhost:9001/Service/ServiceHello?wsdl
CXF or JAX-WS 生成 webservice 客户端默认使用绝对路径读取wsdl文件，改为相对路径读取
u011171619的专栏
11-16 1732
wsdl生成的service默认使用绝对路径访问wsdl文件，改为相对路径获取
Java Eclipse--第三方web service（wsdl地址）调用和XML解析
热门推荐
Appleyk的专栏
09-10 1万+
本篇将结合实例，一步步实现Java对第三方提供的web service地址的调用，实现数据（XML）返回，以及数据解析（重要），从而实现不同语种之间的数据通信。 Web Service 服务端（博主写的一个XXX体检预约服务，数据均来自于MS SQL数据库） 开发语言：Delphi wsdl地址（本地）：http://localhost:909
公开webservice WSDL测试地址
09-04 4205
腾讯QQ在线状态 WEB 服务 Endpoint:http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx Disco:http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?disco WSDL:http://www.webxml.com.cn/webservi
【开发问题】java访问webservice接口,查看wsdl文件并且填写相关参数
吃素的哈士奇de博客
07-14 2179
那么就在原有的url基础上加上?webservice的url接口。
WebService WSDL
见贤思齐焉 见不贤而内自省也
01-04 421
1、http://localhost:9001/Service/ServiceHello?wsdl 地址栏中的地址 【Service为固定的 】【ServiceHello为项目的名称】 【?wsdl为固定的页面】 进入wdsl页面，看到该XML内容则说明发布成功！
WebService的WSDL详解以及远程访问WebService
weixin_47760573的博客
08-30 7263
WebService的WSDL详解以及远程访问WebService
【WebService】wsdl配置详解以及使用注解修改wsdl配置
学无止境
11-21 7059
本文转自： https://blog.csdn.net/eson_15/article/details/52051801   （倪升武的博客）   对大佬的膜拜！   　前面分析了一下关于ws的基本知识，我们知道，wsdl是ws中很重要的文档，我们可以通过解析该wsdl文档获取ws的相关信息，其实，如果不了解该文档结构的话，问题也不大，只要会解析即可进行开发。但是如果想要生成一个符合自己项目...
Web services详解 ：入门必看 | WSDL、SOAP
蛙爸爸的博客
07-10 3433
Web Service是基于网络的、分布式的模块化组件，通过 Web 进行发布、查找和使用**。**是应用程序组件使用开放协议进行通信， 是独立的（self-contained）并可自我描述， 可通过使用UDDI来发现，可被其他应用程序使用。其实WebService就是一种跨编程语言和跨操作系统平台的远程调用技术（RPC的一种实现方式）。Web Services 都是放在Web服务器（如IIS）的。WebService服务器端首先要通过一个WSDL文件来说明自己有什么服务可以对外调用，并注册到UDDI服务器
java调用webservice wsdl
最新发布
11-04
Java调用webservice wsdl的过程如下： 1. 获取对方提供的wsdl地址。 2. 在网页上访问wsdl文档，了解webservice的接口和方法。 3. 创建客户端代理工厂，生成客户端代理类。 4. 通过客户端代理类调用webservice的方法。 具体步骤如下： 1. 使用wsimport命令生成客户端代理类。命令格式为：wsimport -s [生成代码存放路径] [wsdl地址]。 2. 在Java代码中创建客户端代理工厂，生成客户端代理类。代码如下： ``` URL url = new URL("wsdl地址"); QName qname = new QName("命名空间", "服务名称"); Service service = Service.create(url, qname); ClientProxyFactoryBean factory = new JaxWsProxyFactoryBean(); factory.setServiceClass(服务接口.class); factory.setAddress("服务地址"); 服务接口 client = (服务接口) factory.create(); ``` 3. 调用webservice的方法。代码如下： ``` String result = client.方法名(参数); ```

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值