Java WebService入门实例

时间：2023-03-09 16:09:14
Java WebService入门实例

Web Services是由企业发布的完成其特定商务需求的在线应用服务，其他公司或应用软件能够通过Internet来访问并使用这项在线服务。

Web Service的关键技术和规则:

1.XML:描述数据的标准方法.

2.SOAP：表示信息交换的协议（简单对象访问协议）.

3.WSDL：Web服务描述语言.

4.UDDI:通用描述、发现与集成，他是一种独立于平台，基于XML语言的用于在互联网上描述商务的协议。

一、利用JDK web服务api实现，这里使用基于SOAP message的Web Service：

1.首先创建一个Web Services项目，作为Web services Endpoint.

2.创建一个HelloService.java类

  1. package com.yjpeng.hello;
  2. import javax.jws.WebService;
  3. import javax.jws.WebMethod;
  4. import javax.xml.ws.Endpoint;
  5. @WebService
  6. public class HelloService {
  7. @WebMethod
  8. public String sayHello(String message){
  9. return "Hello ," + message;
  10. }
  11. public static void main(String[] args) {
  12. //create and publish an endPoint
  13. HelloService hello = new HelloService();
  14. Endpoint endPoint = Endpoint.publish("http://localhost:8080/helloService", hello);
  15. }
  16. }
  1. package com.yjpeng.hello;
  2. import javax.jws.WebService;
  3. import javax.jws.WebMethod;
  4. import javax.xml.ws.Endpoint;
  5. @WebService
  6. public class HelloService {
  7. @WebMethod
  8. public String sayHello(String message){
  9. return "Hello ," + message;
  10. }
  11. public static void main(String[] args) {
  12. //create and publish an endPoint
  13. HelloService hello = new HelloService();
  14. Endpoint endPoint = Endpoint.publish("http://localhost:8080/helloService", hello);
  15. }
  16. }

3.使用apt编译HelloService.java(例如: apt -d bin(bin存放编译后的文件目录) scr/com/yjpeng/hello/HelloService.java)后，会生成jaxws目录。

4.使用java com.yjpeng.hello.HelloService执行HelloService.java文件，在浏览器中输入http://localhost:8080/helloService?wsdl出现如下图

Java WebService入门实例

5.使用wsimport命令生成客户端:wsimport -p com.yjpeng.webservice -keep http://localhost:8080/helloService?wsdl 这时会在当前目录中生成如下文件：

Java WebService入门实例

6.编写好客户端文件HelloClient.java

  1. package com.yjpeng.hello;
  2. import com.yjpeng.webservice.HelloServiceService;
  3. public class HelloClient {
  4. public static
    void main(String[] args) {
  5. HelloServiceService helloServiceService =
    new HelloServiceService();
  6. com.yjpeng.webservice.HelloService helloService = helloServiceService.getHelloServicePort();
  7. System.out.println(helloService.sayHello("你好"));
  8. }
  9. }
  1. package com.yjpeng.hello;
  2. import com.yjpeng.webservice.HelloServiceService;
  3. public class HelloClient {
  4. public static void main(String[] args) {
  5. HelloServiceService helloServiceService = new HelloServiceService();
  6. com.yjpeng.webservice.HelloService helloService = helloServiceService.getHelloServicePort();
  7. System.out.println(helloService.sayHello("你好"));
  8. }
  9. }

运行结果在控制台输出 hello,你好  证明利用JDK web服务API实现web service成功！

二、使用xfire框架，我这里使用的是MyEclipse集成的xfire进行测试，利用xfire开发WebService可以有三种方法：

a.一种是从JavaBean中生成。

b.一种是从wsdl文件中生成。

c.一种是自己建立webservice。

具体实现步骤如下：

1.用Myeclipse建立webService工程(注意:Web Service&J2EE Details中的Framework选XFire)，目录结构如下：

Java WebService入门实例

2.创建IHello.java接口

  1. package com.yjpeng.hello;
  2. public interface IHello {
  3. public String sayHello(String message);
  4. }
  1. package com.yjpeng.hello;
  2. public interface IHello {
  3. public String sayHello(String message);
  4. }

3.创建IHelloImpl.java实现IHello.java接口

  1. package com.yjpeng.hello;
  2. public class IHelloImpl implements IHello {
  3. public String sayHello(String message) {
  4. return message;
  5. }
  6. }
  1. package com.yjpeng.hello;
  2. public class IHelloImpl implements IHello {
  3. public String sayHello(String message) {
  4. return message;
  5. }
  6. }

4.修改Service.xml文件，加入以下代码

<service>
<!-- 为该Service起一个名字 -->
  <name>HelloService</name>
  <!-- service的接口类 -->
  <serviceClass>
  com.yjpeng.hello.IHello
  </serviceClass>
  <!-- service的接口实现类-->
  <implementationClass>
  com.yjpeng.hello.IHelloImpl
  </implementationClass>
  <!-- wsdl的样式-->
  <style>wrapped</style>
  <use>literal</use>
  <scope>application</scope>
</service>

5.把该Web Service项目部署到tomcat里面启动tomcat在浏览器地址栏输入http://localhost:8080/TestWebServices/services/Hello?wsdl 出现如下图

Java WebService入门实例

6.然后在展开HelloService后面的wsdl可以看到Java WebService入门实例

7.创建一个客户端HelloClient.java类

  1. import java.net.MalformedURLException;
  2. import java.net.URL;
  3. import org.codehaus.xfire.XFireFactory;
  4. import org.codehaus.xfire.client.Client;
  5. import org.codehaus.xfire.client.XFireProxyFactory;
  6. import org.codehaus.xfire.service.Service;
  7. import org.codehaus.xfire.service.binding.ObjectServiceFactory;
  8. import com.yjpeng.hello.IHello;
  9. public class HelloClient {
  10. public static
    void main(String[] args) {
  11. Service s = new ObjectServiceFactory().create(IHello.class);
  12. XFireProxyFactory xf = new XFireProxyFactory(XFireFactory.newInstance().getXFire());
  13. String url="http://192.168.122.128:8080/TestWebServices/services/HelloService";
  14. IHello hello;
  15. try {
  16. hello = (IHello)xf.create(s, url);
  17. System.out.println(hello.sayHello("你好"));
  18. } catch (MalformedURLException e) {
  19. e.printStackTrace();
  20. }
  21. try {
  22. //这个是在java端调用.net写的远程Web Service 如果调用本机写的只需要把URL中的地址换成本机能访问的地址即可
  23. Client c = new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl"));
  24. Object[] o = c.invoke("qqCheckOnline",
    new String[]{"271751507"});
  25. System.out.println(o.length);
  26. } catch (Exception e) {
  27. e.printStackTrace();
  28. }
  29. }
  30. }
  1. import java.net.MalformedURLException;
  2. import java.net.URL;
  3. import org.codehaus.xfire.XFireFactory;
  4. import org.codehaus.xfire.client.Client;
  5. import org.codehaus.xfire.client.XFireProxyFactory;
  6. import org.codehaus.xfire.service.Service;
  7. import org.codehaus.xfire.service.binding.ObjectServiceFactory;
  8. import com.yjpeng.hello.IHello;
  9. public class HelloClient {
  10. public static void main(String[] args) {
  11. Service s = new ObjectServiceFactory().create(IHello.class);
  12. XFireProxyFactory xf = new XFireProxyFactory(XFireFactory.newInstance().getXFire());
  13. String url="http://192.168.122.128:8080/TestWebServices/services/HelloService";
  14. IHello hello;
  15. try {
  16. hello = (IHello)xf.create(s, url);
  17. System.out.println(hello.sayHello("你好"));
  18. } catch (MalformedURLException e) {
  19. e.printStackTrace();
  20. }
  21. try {
  22. //这个是在java端调用.net写的远程Web Service 如果调用本机写的只需要把URL中的地址换成本机能访问的地址即可
  23. Client c = new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl"));
  24. Object[] o = c.invoke("qqCheckOnline", new String[]{"271751507"});
  25. System.out.println(o.length);
  26. } catch (Exception e) {
  27. e.printStackTrace();
  28. }
  29. }
  30. }

运行HelloClient.java类可以输出 你好            1.

三、使用axis1.4开发webservice方法

首先下载axis1.4包和tomcat服务器，并将解压后的axis1.4包下面的webapps下的axis目录复制到tomcat服务器的webapps文件夹中。axis支持三种Web Service的部署和开发，分别为:

a.Dynamic Invocation Interface(DII)

b.Stubs 方式

c.Dynamic Proxy方式

1.编写DII(Dynamic Invocation Interface)方式Web Service

a.编写服务程序HelloClient.java

  1. public class HelloClient
  2. {
  3. public String getName(String name){
  4. return "hello," + name;
  5. }
  6. }
  1. public class HelloClient
  2. {
  3. public String getName(String name){
  4. return "hello," + name;
  5. }
  6. }

b.将HelloClient.java文件拷贝到axis_home下，重命名为HelloClient.jws.

c.访问链接http://localhost:8080/axis/HelloClient.jws?wsdl页面显示axis自动生成的wsdl文件

d.编写访问服务的客户端TestHelloClient.java需要导入相应的axis.jar包，在下载的axis的WEB-INF/lib/目录下。

  1. package com.yjpeng.webservice;
  2. import java.net.URL;
  3. import javax.xml.namespace.QName;
  4. import org.apache.axis.client.Call;
  5. import org.apache.axis.client.Service;
  6. public class TestHelloClient {
  7. public static
    void main(String[] args){
  8. try{
  9. String endpoint = "http://localhost:8080/axis/HelloClient.jws";
  10. Service service = new Service();
  11. Call call = (Call)service.createCall();
  12. call.setOperationName(new QName(endpoint,
    "getName"));
  13. call.setTargetEndpointAddress(new URL(endpoint));
  14. String result = (String) call.invoke(new Object[]{"张三"});
  15. System.out.println(result);
  16. }catch (Exception e) {
  17. e.printStackTrace();
  18. }
  19. }
  20. }
  1. package com.yjpeng.webservice;
  2. import java.net.URL;
  3. import javax.xml.namespace.QName;
  4. import org.apache.axis.client.Call;
  5. import org.apache.axis.client.Service;
  6. public class TestHelloClient {
  7. public static void main(String[] args){
  8. try{
  9. String endpoint = "http://localhost:8080/axis/HelloClient.jws";
  10. Service service = new Service();
  11. Call call = (Call)service.createCall();
  12. call.setOperationName(new QName(endpoint, "getName"));
  13. call.setTargetEndpointAddress(new URL(endpoint));
  14. String result = (String) call.invoke(new Object[]{"张三"});
  15. System.out.println(result);
  16. }catch (Exception e) {
  17. e.printStackTrace();
  18. }
  19. }
  20. }

运行TestHelloClient.java在控制台输出hell,张三,测试成功.

2.编写Dynamci Proxy方式访问服务

a.编写部署服务端程序，用上边DII方式使用的HelloClient.java

  1. public class HelloClient
  2. {
  3. public String getName(String name){
  4. return "hello," + name;
  5. }
  6. }
  1. public class HelloClient
  2. {
  3. public String getName(String name){
  4. return "hello," + name;
  5. }
  6. }

b.编写代理接口HelloClientInterface.java需要扩展java.rmi.Remote类

  1. package com.yjpeng.dynamic.proxy;
  2. import java.rmi.Remote;
  3. import java.rmi.RemoteException;
  4. public interface HelloClientInterface extends Remote {
  5. public String getName(String name) throws RemoteException;
  6. }
  1. package com.yjpeng.dynamic.proxy;
  2. import java.rmi.Remote;
  3. import java.rmi.RemoteException;
  4. public interface HelloClientInterface extends Remote {
  5. public String getName(String name) throws RemoteException;
  6. }

c.编写访问服务的客户端TestHelloClient.java

  1. package com.yjpeng.dynamic.proxy;
  2. import java.net.URL;
  3. import javax.xml.namespace.QName;
  4. import javax.xml.rpc.Service;
  5. import javax.xml.rpc.ServiceFactory;
  6. public class TestHelloClient {
  7. public static
    void main(String[] args){
  8. try{
  9. String wsdlUrl = "http://localhost:8080/axis/HelloClient.jws?wsdl";
  10. String nameSpaceUrl = "http://localhost:8080/axis/HelloClient.jws";
  11. String serviceName = "HelloClientService";
  12. String portName = "HelloClient";
  13. ServiceFactory serviceFactory = ServiceFactory.newInstance();
  14. Service afService = serviceFactory.createService(new URL(wsdlUrl),
    new QName(nameSpaceUrl, serviceName));
  15. HelloClientInterface proxy = (HelloClientInterface)afService.getPort(new QName(nameSpaceUrl, portName),
  16. HelloClientInterface.class);
  17. System.out.println(proxy.getName("张三"));
  18. }catch (Exception e) {
  19. e.printStackTrace();
  20. }
  21. }
  22. }
  1. package com.yjpeng.dynamic.proxy;
  2. import java.net.URL;
  3. import javax.xml.namespace.QName;
  4. import javax.xml.rpc.Service;
  5. import javax.xml.rpc.ServiceFactory;
  6. public class TestHelloClient {
  7. public static void main(String[] args){
  8. try{
  9. String wsdlUrl = "http://localhost:8080/axis/HelloClient.jws?wsdl";
  10. String nameSpaceUrl = "http://localhost:8080/axis/HelloClient.jws";
  11. String serviceName = "HelloClientService";
  12. String portName = "HelloClient";
  13. ServiceFactory serviceFactory = ServiceFactory.newInstance();
  14. Service afService = serviceFactory.createService(new URL(wsdlUrl), new QName(nameSpaceUrl, serviceName));
  15. HelloClientInterface proxy = (HelloClientInterface)afService.getPort(new QName(nameSpaceUrl, portName),
  16. HelloClientInterface.class);
  17. System.out.println(proxy.getName("张三"));
  18. }catch (Exception e) {
  19. e.printStackTrace();
  20. }
  21. }
  22. }

运行TestHelloClient.java在控制台输出hell,张三,测试成功.

四、使用axis2开发webservice

研究中....

五、在java web项目中开放一个webservice接口实例

1.引入需要的jar包
Java WebService入门实例

2.创建一个接口类IAddNumbers.java

  1. package com.yjpeng.webservice;
  2. public interface IAddNumbers {
  3. public int addNumbers(int a,
    int b);
  4. }
  1. package com.yjpeng.webservice;
  2. public interface IAddNumbers {
  3. public int addNumbers(int a, int b);
  4. }

3.创建一个AddNumberImpl.java实现IAddnumbers.java接口类

  1. package com.yjpeng.webservice;
  2. import javax.jws.WebService;
  3. import com.sun.xml.ws.transport.http.servlet.WSServlet;
  4. @WebService(targetNamespace="http://webservice.yjpeng.com", serviceName="AddNumberImplService",
  5. portName="AddNumberImpl")
  6. public class AddNumberImpl implements IAddNumbers {
  7. public int addNumbers(int a,
    int b) {
  8. return a + b;
  9. }
  10. }
  1. package com.yjpeng.webservice;
  2. import javax.jws.WebService;
  3. import com.sun.xml.ws.transport.http.servlet.WSServlet;
  4. @WebService(targetNamespace="http://webservice.yjpeng.com", serviceName="AddNumberImplService",
  5. portName="AddNumberImpl")
  6. public class AddNumberImpl implements IAddNumbers {
  7. public int addNumbers(int a, int b) {
  8. return a + b;
  9. }
  10. }

4.在WEN-INF目录下创建一个sun-jaxws.xml文件

  1. <?xml version="1.0"?>
  2. <endpoints version="2.0"
  3. xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime">
  4. <endpoint name="AddNumberImpl"
  5. implementation="com.yjpeng.webservice.AddNumberImpl"
  6. url-pattern="/addNumberImpl"/>
  7. </endpoints>
  1. <?xml version="1.0"?>
  2. <endpoints version="2.0"
  3. xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime">
  4. <endpoint name="AddNumberImpl"
  5. implementation="com.yjpeng.webservice.AddNumberImpl"
  6. url-pattern="/addNumberImpl"/>
  7. </endpoints>

5.在web.xml文件中增加

  1. <servlet>
  2. <servlet-name>AddNumberService</servlet-name>
  3. <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
  4. <load-on-startup>1</load-on-startup>
  5. </servlet>
  6. <servlet-mapping>
  7. <servlet-name>AddNumberService</servlet-name>
  8. <url-pattern>/addNumberImpl</url-pattern>
  9. </servlet-mapping>
  10. <listener>
  11. <listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
  12. </listener>
  1. <servlet>
  2. <servlet-name>AddNumberService</servlet-name>
  3. <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
  4. <load-on-startup>1</load-on-startup>
  5. </servlet>
  6. <servlet-mapping>
  7. <servlet-name>AddNumberService</servlet-name>
  8. <url-pattern>/addNumberImpl</url-pattern>
  9. </servlet-mapping>
  10. <listener>
  11. <listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
  12. </listener>

6.部署web项目 启动相应部署服务器。访问http://localhost:8080/TestJaxWebService/addNumberImpl?wsdl 这样每次启动web服务器就开放了一个web service的接口。

相关：

cxf:源码：https://github.com/apache/cxf

axis1 和 axis2 的简单使用

利用AXIS开发Webservice(一) —— 如何发布自己的webservice

相关文章