其他分享
首页 > 其他分享> > 【WSDL】JAX-WS 入门案例

【WSDL】JAX-WS 入门案例

作者:互联网

 

去年这个时候工作遇见时暂时总结的笔记:

https://www.cnblogs.com/mindzone/p/14777493.html

当时也不是很清楚,直到最近前同事又遇上了这项技术,

除了WSDL,还多另一个CXF框架,那看来还是需要再学习一下的

 

B站搜了一下,还找到了,黑马19期Java班还讲了

黑马视频参考地址:

https://www.bilibili.com/video/BV1zf4y1H7UG

 

JAX-WS 入门案例:

用IDEA创建普通Java工程,不需要Maven和任何依赖

这一套工具库是JDK官方提供的内容

 

一、编写服务端

1、首先需要提供一个接口,说明服务端需要怎样对外提供数据服务

package cn.cloud9.jax_ws.server.intf;

/**
 * 天气接口
 */
public interface WeatherInterface {
    /**
     * 根据城市名称参数,返回该城市的天气
     * @param cityName
     * @return
     */
    String queryWeather(String cityName);
}

  

2、然后实现这个接口,并且标记为这是一个WebService接口

package cn.cloud9.jax_ws.server.intf;

import javax.jws.WebService;

/**
 * @author OnCloud9
 * @description
 * @project WebService
 * @date 2022年04月23日 11:10
 *
 * 标注此接口是Web服务接口
 */
@WebService
public class WeatherInterfaceImpl implements WeatherInterface{
    @Override
    public String queryWeather(String cityName) {
        System.out.println("打印城市名称:" + cityName);
        return cityName + " 天气:晴朗";
    }
}

 

3、创建启动类,提供地址和服务接口,发布服务

地址是服务所在的主机地址,端口可以任意设置(没有占用的)

package cn.cloud9.jax_ws.server;

import cn.cloud9.jax_ws.server.intf.WeatherInterfaceImpl;

import javax.xml.ws.Endpoint;

/**
 * @author OnCloud9
 * @description
 * @project WebService
 * @date 2022年04月23日 11:12
 */
public class ServerMain {

    public static void main(String[] args) {
        /**
         * 发布服务
         * 服务访问地址:
         * http://127.0.0.1:9090/weather?wsdl
         * WSDL阅读方式,从下向上
         */
        String url = "http://127.0.0.1:9090/weather";
        Endpoint.publish(url, new WeatherInterfaceImpl());
    }
}

  

启动之后,可以使用浏览器访问服务发布定义的地址

需要添加GET参数?wsdl

http://127.0.0.1:9090/weather?wsdl

 

二、编写客户端

服务端案例开发完成,接着是客户端案例的开发

这个发布的服务,其实相当于一个调用说明书:

http://127.0.0.1:9090/weather?wsdl

使用XML记载了资源名称等等

JDK提供了一个 生成工具,wimport.exe工具

可以直接根据服务说明书,生成客户端需要的接口资源

 

命令:

wimport -s . http://127.0.0.1:9090/weather?wsdl

 

可以发现是完全按照服务端编写包位置生成的,
这里把Server包重命名成Client包

然后编写客户端启动类

package cn.cloud9.jax_ws.client;

import cn.cloud9.jax_ws.client.intf.WeatherInterfaceImpl;
import cn.cloud9.jax_ws.client.intf.WeatherInterfaceImplService;

import java.io.UnsupportedEncodingException;


/**
 * @author OnCloud9
 * @description
 * @project JAX-WS-Client
 * @date 2022年04月23日 11:31
 */
public class WeatherClient {

    public static void main(String[] args) throws UnsupportedEncodingException {
        // 创建服务视图
        final WeatherInterfaceImplService implService =
                new WeatherInterfaceImplService();

        // 获取服务实现类
        final WeatherInterfaceImpl instance =
                implService.getPort(WeatherInterfaceImpl.class);

        String city = "南昌";

        // 调用查询方法
        final String queryWeather = instance.queryWeather(new String(city.getBytes("GBK")));
        System.out.println(queryWeather);
    }
}  

 

启动之后发现报错了

两个类具有相同的 XML 类型名称 "{http://intf.server.jax_ws.cloud9.cn/}queryWeatherResponse"。
请使用 @XmlType.name 和 @XmlType.namespace 为类分配不同的名称。

Exception in thread "main" com.sun.xml.internal.ws.spi.db.DatabindingException: com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationsException: 1 counts of IllegalAnnotationExceptions
两个类具有相同的 XML 类型名称 "{http://intf.server.jax_ws.cloud9.cn/}queryWeatherResponse"。请使用 @XmlType.name 和 @XmlType.namespace 为类分配不同的名称。
    this problem is related to the following location:
        at cn.cloud9.jax_ws.client.intf.QueryWeatherResponse
        at public javax.xml.bind.JAXBElement cn.cloud9.jax_ws.client.intf.ObjectFactory.createQueryWeatherResponse(cn.cloud9.jax_ws.client.intf.QueryWeatherResponse)
        at cn.cloud9.jax_ws.client.intf.ObjectFactory
    this problem is related to the following location:
        at cn.cloud9.jax_ws.server.intf.QueryWeatherResponse

然后根据报错信息我找到了对应的资源

发现wimport生成的注解是这样的

只提供了一个name值,但是报错还要求一个namespace,

这里只要根据错误提示,名字和命名空间不一样就可以了

 

修改之后,启动客户端,调用成功

 

 

  

 

标签:intf,JAX,jax,cloud9,String,ws,WS,WSDL,cn
来源: https://www.cnblogs.com/mindzone/p/16182079.html