文档章节

使用JDK自带的WebService

摆渡者
 摆渡者
发布于 2015/08/24 18:22
字数 1137
阅读 1016
收藏 21

WebService是个好东西,话不多说,干净利落

服务器端

来看下服务器端的结构:

先定义一个接口,用于暴露:

package com.abc.webservice;
/**
 * 对外暴露的接口。
 */
public interface IWebService {
    public String hello(String who);
}

再定义这个接口的实现类:

package com.abc.webservice.impl;

import javax.jws.WebService;
import com.abc.webservice.IWebService;

/**
 * wsdl:portType: MyService
 * wsdl:service: MyWebService
 */
@WebService(name="MyService",
            serviceName="MyWebService",
            targetNamespace="http://www.abc.com")
public class WebServiceImpl implements IWebService {
    @Override
    public String hello(String who) {
        return "Hello " + who + "!";
    }
}

注意这里的name,它表示

The name of the Web Service. Used as the name of the wsdl:portType when mapped to WSDL 1.1.

serviceName,它表示

The service name of the Web Service. Used as the name of the wsdl:service when mapped to WSDL 1.1. 

targetNamespace,就是你为Java客户端生成的代码的包名啦,生成的包名会自动反过来写,比如上面的是www.abc.com,生成的包名则会为package com.abc.* 。

最后将WebService发布出去:

package com.abc.webservice;

import javax.xml.ws.Endpoint;
import com.abc.webservice.impl.WebServiceImpl;

/**
 * 发布WebService
 */
public class Publisher {
    public static void main(String[] args) {
        System.out.println("Start publish service");
        Endpoint.publish("http://localhost:8080/MyService", new WebServiceImpl());
        System.out.println("End publish service");
    }
}

这之后,可以打开浏览器,输入刚刚发布的URL:http://localhost:8080/MyService,去看看效果了:

点击上图中的超链接,可以看到生成的wsdl,以下是生成的wsdl:

<?xml version="1.0" encoding="UTF-8"?>
<definitions
	xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
	xmlns:wsp="http://www.w3.org/ns/ws-policy" 
	xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy"
	xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" 
	xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
	xmlns:tns="http://www.abc.com" 
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns="http://schemas.xmlsoap.org/wsdl/" 
	targetNamespace="http://www.abc.com"
	name="MyWebService">
	<types>
		<xsd:schema>
			<xsd:import namespace="http://www.abc.com"
				schemaLocation="http://localhost:8080/MyService?xsd=1" />
		</xsd:schema>
	</types>
	<message name="hello">
		<part name="parameters" element="tns:hello" />
	</message>
	<message name="helloResponse">
		<part name="parameters" element="tns:helloResponse" />
	</message>
	<portType name="MyService">
		<operation name="hello">
			<input wsam:Action="http://www.abc.com/MyService/helloRequest"
				message="tns:hello" />
			<output wsam:Action="http://www.abc.com/MyService/helloResponse"
				message="tns:helloResponse" />
		</operation>
	</portType>
	<binding name="MyServicePortBinding" type="tns:MyService">
		<soap:binding transport="http://schemas.xmlsoap.org/soap/http"
			style="document" />
		<operation name="hello">
			<soap:operation soapAction="" />
			<input>
				<soap:body use="literal" />
			</input>
			<output>
				<soap:body use="literal" />
			</output>
		</operation>
	</binding>
	<service name="MyWebService">
		<port name="MyServicePort" binding="tns:MyServicePortBinding">
			<soap:address location="http://localhost:8080/MyService" />
		</port>
	</service>
</definitions>

看不懂没关系啦,这是WSDL,属于另一个范畴了,需要了解的朋友可以去搜一搜相关的资料。这里只是想说明如何使用JDK自带的WebService啦。

Java客户端

当然,WebServices可以被Java客户端调用,也可以被非Java语言的程序调用,这里我们只看Java客户端是如何调用的。

新建一个Poject,用于模拟在另一台机器上的客户端,并打开命令行:

>cd D:\Workspace\WebServiceClient\src

使用JDK自带的wsimport命令,生成Java客户端(注意中间有个点,表示当前目录):

>wsimport -keep . http://localhost:8080/MyService?wsdl

这句话表示生成客户端代码,保存在当前文件夹下。

会生成以下结构的客户端代码(图中选中的部分,那个webservice包是自己建的),刚刚有提到生成的Java客户端代码会放在com.abc包下

至于生成的这些类里面是什么东西,你们自己去看啦。

然后编写客户端代码(com.abc.webservice.WebServiceClient.java):

package com.abc.webservice;

import com.abc.MyWebService;

public class WebServiceClient {
    public static void main(String[] args) {
        MyWebService myWebService = new MyWebService();
        // 注意下面这句
        MyService myService = myWebService.getMyServiePort();
        System.out.println(myService.hello("Alvis"));
    }
}

这里的MyWebService类就是wsimport命令根据WebService的WSDL生成的类啦。下面是WSDL中的一段:

<service name="MyWebService">
	<port name="MyServicePort" binding="tns:MyServicePortBinding">
		<soap:address location="http://localhost:8080/MyService" />
	</port>
</service>

从WSDL中可以看出,有个<service>的name为MyWebService,里面包含了一个<port>,因此代码中的

myWebService.getMyServicePort();

这句话得到的实际上是得到了MyService这个类的实例了,这个类其实是远端WebService实现类的代理对象。可以看看这个生成的MyWebService类中这个方法的定义:

@WebEndpoint(name = "MyServicePort")
public MyService getMyServicePort() {
    return super.getPort(new QName("http://www.abc.com", "MyServicePort"), MyService.class);
}

得到这个MyService的实例后,就可以使用该实例调用远程端的方法啦:

myService.hello("Alvis")

咱们再来看看MyService类中都有哪些东东:

package com.abc;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.xml.bind.annotation.XmlSeeAlso;
import javax.xml.ws.Action;
import javax.xml.ws.RequestWrapper;
import javax.xml.ws.ResponseWrapper;

/**
 * This class was generated by the JAX-WS RI.
 * JAX-WS RI 2.2.4-b01
 * Generated source version: 2.2
 */
@WebService(name = "MyService", targetNamespace = "http://www.abc.com")
@XmlSeeAlso({
    ObjectFactory.class
})
public interface MyService {
    /**
     * @param arg0
     * @return
     *     returns java.lang.String
     */
    @WebMethod
    @WebResult(targetNamespace = "")
    @RequestWrapper(localName = "hello", 
        targetNamespace = "http://www.abc.com", className = "com.abc.Hello")
    @ResponseWrapper(localName = "helloResponse", 
        targetNamespace = "http://www.abc.com", className = "com.abc.HelloResponse")
    @Action(input = "http://www.abc.com/MyService/helloRequest", 
        output = "http://www.abc.com/MyService/helloResponse")
    public String hello(
        @WebParam(name = "arg0", targetNamespace = "")
        String arg0);
}

可以看到,MyService是一个接口,因为真正的实现在远端。其实里面就一个方法,就是我们在远端定义的hello啦。

运行客户端代码即可:


这里是项目源代码,供需要的朋友参考。

© 著作权归作者所有

共有 人打赏支持
上一篇: SPI和API的区别
下一篇: RMI 相关知识
摆渡者
粉丝 333
博文 171
码字总数 205876
作品 0
浦东
程序员
私信 提问
传统webService服务端和客户端开发(第一种方法)

服务端:(作为服务端,怎么将自己的应用程序发布成一个webservice,让别人调用) 发布服务: //java jdk 提供一个自带的类可以将java 应用程序发布成webservice /** * 1,提供服务对外的访问地...

chenruibing
2015/06/09
0
0
Webservice服务器端怎么在Maven项目中发布?

我用JDK开发了一个服务,需要在Maven项目上发布,由于我没有使用其他的第三方开发,而是使用的JDK自带的类开发的,现在都是用CXF框架或者axis2进行集成,我想了解下有没有的方式可以集成,然...

Mr_Grizzly
2016/12/21
276
1
Web Services 学习笔记(二) - java 基础实践

1.服务端 首先编写曝露方法 import javax.jws.WebMethod; import javax.jws.WebService; @WebService public class HelloWebService { @WebMethod public String hello(String name) { Syst......

晨猫
01/30
0
0
使用idea和wsdl生成java代码

创建一个简单的java helloworld项目 选择next: 选择java helloworld project next 填写project name finish 2. 创建好项目后 选择项目 右键->webservice->Generate 生成代码配置,填写wsdl路...

Simeone
2015/07/22
0
1
WebService教程详解(一)

Web Services 可以将应用程序转换为网络应用程序。 通过使用 Web Services,您的应用程序可以向全世界发布信息,或提供某项功能。 Web Services 可以被其他应用程序使用。 通过 Web Services...

snowing1990
2016/06/29
13
0

没有更多内容

加载失败,请刷新页面

加载更多

经典编程书籍大全·我一本都没有看过

经典编程书籍大全 100+ 经典技术书籍,涵盖:计算机系统与网络、系统架构、算法与数据结构、前端开发、后端开发、移动开发、数据库、测试、项目与团队、程序员职业修炼、求职面试 和 编程相关...

netkiller-
34分钟前
1
0
改变自己从学习linux开始

刚刚高中毕业,进如大学的时候,总以为摆脱了束缚可以无拘无束的玩耍了。当时真的就是和众多大学生一起,像撒欢的野马,每天逃课,上网,泡吧,不把学习当一会事,学校里教授讲的各种知识也没...

linuxprobe16
37分钟前
2
0
Apache Zeppelin 中 Spark解释器

概述 Apache Spark是一种快速和通用的集群计算系统。它提供Java,Scala,Python和R中的高级API,以及支持一般执行图的优化引擎。Zeppelin支持Apache Spark,Spark解释器组由5个解释器组成。 ...

hblt-j
38分钟前
2
0
十分钟带你理解Kubernetes核心概念

http://www.dockone.io/article/932

踏破铁鞋无觅处
51分钟前
3
0
浅析微信支付:开通免充值产品功能及如何进行接口升级指引

本文是【浅析微信支付】系列文章的第十五篇,主要讲解如何开通免充值产品功能流程和其中的注意事项,对于接口升级会重要讲解,避免爬坑。 浅析微信支付系列已经更新十五篇了哟~,没有看过的...

YClimb
今天
2
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部