文档章节

使用JDK自带的WebService

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

精选30+云产品,助力企业轻松上云!>>>

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 相关知识
摆渡者
粉丝 351
博文 175
码字总数 209530
作品 0
成都
程序员
私信 提问
加载中
请先登录后再评论。
WebService调用

1、webservice 的概念,解决什么问题? webservice 就是一个应用程序,它提供一种通过web 方式访问的api. 解决两个系统或者(应用程序)之间的远程调用..... 调用是跨语言,跨平台... webse...

Ywaken
03/31
0
0
Webservice服务器端怎么在Maven项目中发布?

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

Mr_Grizzly
2016/12/21
482
1
WebService学习记录

最近项目要使用WebService,正在学习中,做个记录。 WebService是一个平台独立的,低耦合的,自包含的、基于可编程的web的应用程序,可使用开放的XML(标准通用标记语言下的一个子集)标准来...

Soi
2015/10/20
99
0
Web Services 学习笔记(二) - java 基础实践

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

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

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

Simeone
2015/07/22
2.2W
1

没有更多内容

加载失败,请刷新页面

加载更多

CSS背景不透明度[重复] - CSS Background Opacity [duplicate]

问题: This question already has an answer here: 这个问题已经在这里有了答案: How do I give text or an image a transparent background using CSS? 如何使用CSS为文本或图像提供透明背...

fyin1314
18分钟前
15
0
node http 获取gb2312网页如何转为utf8

最初,我想当然认为是下述做法,但被证明是错误的 const http = require('http'), iconv = require('iconv-lite');const url = 'http://xxx';http.get(url, function(res) { var bo......

高延
34分钟前
24
0
我在哪里可以在线找到Android源代码? [关闭] - Where can I find Android source code online? [closed]

问题: Particularly, where can I browse the source code for any android source application(egthe contact application) ? 特别是,我在哪里可以浏览任何Android源应用程序(例如联系人......

javail
48分钟前
17
0
动态规划:LC198.打家劫舍

题目描述: 你是一个专业的小偷,计划偷窃沿街的房屋。每间房内都藏有一定的现金,影响你偷窃的唯一制约因素就是相邻的房屋装有相互连通的防盗系统,如果两间相邻的房屋在同一晚上被小偷闯入...

曦鱼violet
今天
30
0
OSChina 周一乱弹 —— 南方水到底多深

Osc乱弹歌单(2020)请戳(这里) 【今日歌曲】 @薛定谔的兄弟 :分享洛神有语创建的歌单「我喜欢的音乐」: Various Artists-用印度乐器演奏苏联国歌(洛天侬 remix) 手机党少年们想听歌,请...

小小编辑
今天
56
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部