JAX-WS方式开发和部署webservice应用

骑猪看日落 2022-01-31 02:11 185阅读 0赞

### JAX-WS方式开发和部署webservice应用 ###

*  1.创建webservice工程
 *  2.书写服务端代码
 *  3.配置文件
 *  4.启动服务，查看wsdl
 *  5.客户端调用测试
 *  其他

需要源码的可以去我的资源里下载

# 1.创建webservice工程 #

1.创建web工程  
2.导入JAX-WS RI依赖jar包，下载地址：https://jax-ws.java.net/  
![在这里插入图片描述][20190906162431915.png]

# 2.书写服务端代码 #

1.接口类

package com.origin.webservice;
    
    import java.util.List;
    import javax.jws.WebParam;
    import javax.jws.WebResult;
    import javax.jws.WebService;
    import com.origin.bean.User;
    
    @WebService
    public interface UserService {
    	@WebResult(name="UserName")String findUserNameById(@WebParam(name="UserId")String UserId);
    	
    	@WebResult(name="User")User addUser(@WebParam(name="User")User u);
    	
    	List<User> findUserList();
    }

**注意：@WebService注解是必须的，其他注解有兴趣可以研究下**  
2.实现类

package com.origin.webservice.impl;
    
    import java.util.ArrayList;
    import java.util.List;
    import javax.jws.WebService;
    import com.origin.bean.User;
    import com.origin.webservice.UserService;
    
    @WebService(endpointInterface = "com.origin.webservice.UserService") 
    public class UserServiceImpl implements UserService {
    
    	private List<User> userList = new ArrayList<User>();
    
    	public String findUserNameById(String UserId) {
    		for (User user : userList) {
    			if(user.getUserId().equals(UserId)){
    				return user.getUserName();
    			}
    		}
    		return "用户不存在!";
    	}
    
    	public User addUser(User u) {
    		userList.add(u);
    		return u;
    	}
    
    	public List<User> findUserList() {
    		return userList;
    	}
    }

**注意：@WebService(endpointInterface = “com.origin.webservice.UserService”)注解是必须的，需要指定到接口类**  
3.接口中测试的User类

package com.origin.bean;
    
    public class User {
    
    	
    	private String UserId;
    	private String UserName;
    	private int UserAge;
    	public String getUserId() {
    		return UserId;
    	}
    	public void setUserId(String userId) {
    		UserId = userId;
    	}
    	public String getUserName() {
    		return UserName;
    	}
    	public void setUserName(String userName) {
    		UserName = userName;
    	}
    	public int getUserAge() {
    		return UserAge;
    	}
    	public void setUserAge(int userAge) {
    		UserAge = userAge;
    	}
    	public User() {
    		super();
    	}
    	public User(String userId, String userName, int userAge) {
    		super();
    		UserId = userId;
    		UserName = userName;
    		UserAge = userAge;
    	}
    	@Override
    	public String toString() {
    		return "User [UserId=" + UserId + ", UserName=" + UserName + ", UserAge=" + UserAge + "]";
    	}
    }

# 3.配置文件 #

--------------------

**注意：配置文件路径都在WEB-INF下**

--------------------

1.web.xml

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
    	
    	<display-name>JAX-WS_WebService</display-name>
    	
    	<listener>
    	    <listener-class>
    	        com.sun.xml.ws.transport.http.servlet.WSServletContextListener
    	    </listener-class>
    	</listener>
    	<servlet>  
    		<servlet-name>jaxws</servlet-name>  
    		<servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
    		  
    		<load-on-startup>1</load-on-startup>  
    	</servlet>  
    	<servlet-mapping>  
    		<servlet-name>jaxws</servlet-name>  
    		<url-pattern>/services</url-pattern>  
    	</servlet-mapping>  
    </web-app>

2.sun-jaxws.xml

<?xml version="1.0" encoding="UTF-8"?>
    <endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0">
    	<endpoint name="userservice" implementation="com.origin.webservice.impl.UserServiceImpl"
    		url-pattern="/service/userservice" />
    </endpoints>

一个服务对应一个endpoint节点，implementation=“com.origin.webservice.impl.UserServiceImpl”，指定实现类

# 4.启动服务，查看wsdl #

wsdl地址：http://localhost:8080/JAX-WS\_WebService/service/userservice?wsdl  
service/userservice对应url-pattern="/service/userservice"  
JAX-WS\_WebService为项目名称

# 5.客户端调用测试 #

本例使用wsimport生成客户端代码

用法: wsimport [options] <WSDL_URI>  
          
        其中 [options] 包括:  
          -b <path>                 指定 jaxws/jaxb 绑定文件或附加模式  
                                    (每个 <path> 都必须具有自己的 -b)  
          -B<jaxbOption>            将此选项传递给 JAXB 模式编译器  
          -catalog <file>           指定用于解析外部实体引用的目录文件  
                                    支持 TR9401, XCatalog 和 OASIS XML 目录格式。  
          -d <directory>            指定放置生成的输出文件的位置  
          -encoding <encoding>      指定源文件所使用的字符编码  
          -extension                允许供应商扩展 - 不按规范  
                                    指定功能。使用扩展可能会  
                                    导致应用程序不可移植或  
                                    无法与其他实现进行互操作  
          -help                     显示帮助  
          -httpproxy:<host>:<port>  指定 HTTP 代理服务器 (端口默认为 8080)  
          -keep                     保留生成的文件  
          -p <pkg>                  指定目标程序包  
          -quiet                    隐藏 wsimport 输出  
          -s <directory>            指定放置生成的源文件的位置  
          -target <version>         按给定的 JAXWS 规范版本生成代码  
                                    默认为 2.2, 接受的值为 2.0, 2.1 和 2.2  
                                    例如, 2.0 将为 JAXWS 2.0 规范生成兼容的代码  
          -verbose                  有关编译器在执行什么操作的输出消息  
          -version                  输出版本信息  
          -wsdllocation <location>  @WebServiceClient.wsdlLocation 值  
          -clientjar <jarfile>      创建生成的 Artifact 的 jar 文件以及  
                                    调用 Web 服务所需的 WSDL 元数据。  
          -generateJWS              生成存根 JWS 实现文件  
          -implDestDir <directory>  指定生成 JWS 实现文件的位置  
          -implServiceName <name>   生成的 JWS 实现的服务名的本地部分  
          -implPortName <name>      生成的 JWS 实现的端口名的本地部分  
          
        扩展:  
          -XadditionalHeaders              映射标头不绑定到请求或响应消息不绑定到  
                                           Java 方法参数  
          -Xauthfile                       用于传送以下格式的授权信息的文件:  
                                           http://username:password@example.org/stock?wsdl  
          -Xdebug                          输出调试信息  
          -Xno-addressing-databinding      允许 W3C EndpointReferenceType 到 Java 的绑定  
          
          -Xnocompile                      不编译生成的 Java 文件  
          -XdisableAuthenticator           禁用由 JAX-WS RI 使用的验证程序,  
                                           将忽略 -Xauthfile 选项 (如果设置)  
          -XdisableSSLHostnameVerification 在提取 wsdl 时禁用 SSL 主机名  
                                           验证

1.cmd窗口输入wsimport -keep -d d:/ -p com.origin.wsimport http://localhost:8080/JAX-WS\_WebService/service/userservice?wsdl，将客户端代码生成在d盘根目录下  
命令：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2E5NzQ5ODYwNDI_size_16_color_FFFFFF_t_70]  
代码路径![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2E5NzQ5ODYwNDI_size_16_color_FFFFFF_t_70 1]  
2.将代码复制到工程中  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2E5NzQ5ODYwNDI_size_16_color_FFFFFF_t_70 2]  
3.调用服务

package com.origin.client;
    
    import java.util.List;
    import javax.xml.ws.Holder;
    import org.junit.Test;
    import com.origin.wsimport.User;
    import com.origin.wsimport.UserServiceImplService;
    
    public class UserClient {
    
    	UserServiceImplService usis= new UserServiceImplService();
    	@Test
    	public void addUserClient(){
    
    		User user = new User();
    		user.setUserId("16630");
    		user.setUserName("陈雪松");
    		user.setUserAge(18);
    		
    		Holder<User> u = new Holder<User>(user);
    		
    		usis.getUserServiceImplPort().addUser(u);
    		
    		System.out.println("添加成功!");
    	}
    	
    	@Test
    	public void findUserNameByIdClient(){
    		
    		String username = usis.getUserServiceImplPort().findUserNameById("11111");
    		
    		System.out.println("查询信息:"+username);
    	}
    	
    	@Test
    	public void findUserListClient(){
    		
    		List<User> userList = usis.getUserServiceImplPort().findUserList();
    		
    		for (User user : userList) {
    			System.out.println(user);
    		}
    	}
    }

# 其他 #

jax-ws 提供了SOAPHandler和LogicalHandler接口，是很核心的内容，起到拦截器的作用，以后有机会用到再做研究。

[20190906162431915.png]: /images/20220131/4ab151477ade48ca9d090eee0a02d2dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2E5NzQ5ODYwNDI_size_16_color_FFFFFF_t_70]: /images/20220131/d39b3386439b4f5180e8ed26baa98ef9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2E5NzQ5ODYwNDI_size_16_color_FFFFFF_t_70 1]: /images/20220131/896638f92c604c7d9b84ede688231185.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2E5NzQ5ODYwNDI_size_16_color_FFFFFF_t_70 2]: /images/20220131/e08178f6bf7249d0a40581f98c99de26.png