将webservice嵌套到以完成的web项目中

一、先把webservice服务端写入项目(基于spring)

　　1、在pom.xml中引入WebService相关的jar依赖

 <!--webservice开始 -->
     <!--https://mvnrepository.com/artifact/org.apache.cxf/cxf-rt-frontend-jaxws -->
         <dependency>
             <groupId>org.apache.cxf</groupId>
         <artifactId>cxf-rt-frontend-jaxws</artifactId>
             <version>3.1.16</version>
         </dependency>
     <!--https://mvnrepository.com/artifact/org.apache.cxf/cxf-rt-transports-http -->
         <dependency>
             <groupId>org.apache.cxf</groupId>
     <artifactId>cxf-rt-transports-http</artifactId>
             <version>3.1.6</version>
         </dependency>
         <!--webservice结束 -->

　　2、在web.xml加载启动Webservice

 <!--webservice -->

 <servlet>

 <servlet-name>cxf</servlet-name>

 <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>

 <load-on-startup>1</load-on-startup>

 </servlet>

 <servlet-mapping>

 <servlet-name>cxf</servlet-name>

 <url-pattern>/GetKPIValue/*</url-pattern>

 </servlet-mapping>

　　3、创建WebService相关的Spring配置文件：applicationContext-webService.xml，内容如下：

 <?xml version="1.0" encoding="UTF-8"?>

 <beans xmlns="http://www.springframework.org/schema/beans"

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws"

 xsi:schemaLocation="http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd

 http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd">

 <bean id="userServiceImpls" class="com.unis.webService.UserServiceImpls" />

 <jaxws:endpoint id="userServiceImplServices" address="/" implementor="#userServiceImpls">

 </jaxws:endpoint>

 </beans>

　　4、把服务端代码迁移到项目的src/main/java/com.webService,如下图：

　　5、启动项目，并在浏览器中访问地址：http://localhost:8091/GetKPIValue?wsdl，如下图：

　　　　出现以上情况说明webservice服务端成功启动!

　　　　代码可参考  https://blog.csdn.net/c99463904/article/details/76018436

　　　　备注:使用注解修改WSDL内容

WebService的注解都位于javax.jws包下:

@WebService-定义服务，在类上边

targetNamespace：指定命名空间

name：portType的名称

portName：port的名称

serviceName：服务名称

endpointInterface：SEI接口地址，如果一个服务类实现了多个接口，只需要发布一个接口的方法，可通过此注解指定要发布服务的接口。

@WebMethod-定义方法，在公开方法上边

operationName：方法名

exclude：设置为true表示此方法不是webservice方法，反之则表示webservice方法，默认是false

@WebResult-定义返回值，在方法返回值前边

name：返回结果值的名称

@WebParam-定义参数，在方法参数前边

name：指定参数的名称

二、使用xml在webservice的客户端与服务端进行传递

　　1.Xml与java对象互转的工具类

 package com.unis.webService.util;
 import java.io.FileNotFoundException;
 import java.io.FileReader;
 import java.io.FileWriter;
 import java.io.IOException;
 import java.io.StringReader;
 import java.io.StringWriter;

 import javax.xml.bind.JAXBContext;
 import javax.xml.bind.JAXBException;
 import javax.xml.bind.Marshaller;
 import javax.xml.bind.Unmarshaller;

 /**
  * xml与java对象互转
  * Name:
  * Title:XmlHelper
  * @author LSK
  * @date 2019年1月5日
  */
 public class XmlHelper
 {
     //有两种情况,一种是xml字符串,一种是xml文件路径

      /**
      * 将对象直接转换成String类型的 XML输出
      *
      * @param obj
      * @return
      */
     @SuppressWarnings("rawtypes")
     public static String objectToXML(Class clazz,Object obj) {
         // 创建输出流
         StringWriter sw = new StringWriter();
         try {
             // 利用jdk中自带的转换类实现
             JAXBContext context = JAXBContext.newInstance(clazz);  

             Marshaller marshaller = context.createMarshaller();
             // 格式化xml输出的格式
             marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT,
                     Boolean.TRUE);
             marshaller.setProperty("jaxb.encoding", "gb2312");

             // 将对象转换成输出流形式的xml
             marshaller.marshal(obj, sw);
         } catch (Exception e) {
             e.printStackTrace();
         } 

         //去除xml声明中的standalone
         return sw.toString().replace("standalone=\"yes\"", "");  

     }  

       /**
      * 将String类型的xml转换成对象
      */
     @SuppressWarnings("rawtypes")
     public static Object xmlToObject(Class clazz, String xml) {
         Object xmlObject = null;
         try {
             JAXBContext context = JAXBContext.newInstance(clazz);
             // 进行将Xml转成对象的核心接口
             Unmarshaller unmarshaller = context.createUnmarshaller();
             xmlObject = unmarshaller.unmarshal(new StringReader(xml));
         } catch (JAXBException e) {
             e.printStackTrace();
         }
         return xmlObject;
     }  

     /**
      * 将对象根据路径转换成xml文件
      *
      * @param obj
      * @param path
      * @return
      */
     public static void convertToXml(Object obj, String path) {
         try {
             // 利用jdk中自带的转换类实现
             JAXBContext context = JAXBContext.newInstance(obj.getClass());  

             Marshaller marshaller = context.createMarshaller();
             // 格式化xml输出的格式
             marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT,
                     Boolean.TRUE);
             // 将对象转换成输出流形式的xml
             // 创建输出流
             FileWriter fw = null;
             try {
                 fw = new FileWriter(path);
             } catch (IOException e) {
                 e.printStackTrace();
             }
             marshaller.marshal(obj, fw);
         } catch (JAXBException e) {
             e.printStackTrace();
         }
     }  

     /**
      * 将xml的文件路径转换成对象
      */
     @SuppressWarnings("rawtypes")
     public static Object convertXmlFileToObject(Class clazz, String xmlPath) {
         Object xmlObject = null;
         try {
             JAXBContext context = JAXBContext.newInstance(clazz);
             Unmarshaller unmarshaller = context.createUnmarshaller();
             FileReader fr = null;
             try {
                 fr = new FileReader(xmlPath);
             } catch (FileNotFoundException e) {
                 e.printStackTrace();
             }
             xmlObject = unmarshaller.unmarshal(fr);
         } catch (JAXBException e) {
             e.printStackTrace();
         }
         return xmlObject;
     }
 }

　　2.JAXB的简介与常用注解详解

　　　　JAXB（Java Architecture for XML Binding)是一项可以根据XML Schema产生Java类的技术

　　　　JAXBContext类，是应用的入口，用于管理XML/Java绑定信息。

Marshaller接口，将Java对象序列化为XML数据。

　　　　Unmarshaller接口，将XML数据反序列化为Java对象。

　　　　以上这几个是JDK中JAXB相关重要的Class和Interface

　　　　JDK中JAXB相关的重要Annotation(注释)：

　　　　@XmlType，将Java类或枚举类型映射到XML模式类型

　　　　@XmlAccessorType(XmlAccessType.FIELD) ，控制字段或属性是否被默认序列化。FIELD表示JAXB将自动绑定Java类中的每个非静态的（static）、非瞬态的（由@XmlTransient标注）字段到XML。其他值有　　XmlAccessType.PROPERTY和XmlAccessType.NONE。

　　　　@XmlAccessorOrder,控制JAXB绑定类中属性和字段的排序。

　　　　@XmlJavaTypeAdapter，包、类、字段，方法、参数级别的注解。解决java日期(Date)，数字(Number)格式化问题。

　　　　自定义的DateAdapter:

 public class DateAdapter extends XmlAdapter<String, Date> {
     private static final SimpleDateFormat SDF = new SimpleDateFormat("yyyy-MM-dd");
     @Override
  public Date unmarshal(String date) throws Exception{
         return SDF.parse(date);
     }
     @Override
  public String marshal(Date date) throws Exception {
         return SDF.format(date);
     }
 }

　　　　@XmlElementWrapper ，对于数组或集合（即包含多个元素的成员变量），生成一个包装该数组或集合的XML元素（称为包装器）。

　　　　@XmlRootElement，类级别的注解，将类映射为xml全局元素，也就是根元素。

　　　　@XmlElement，字段，方法，参数级别的注解。将Java类的一个属性映射到与属性同名的一个XML元素。

　　　　　　属性:

　　　　　　　　nillable属性可以指定元素的文本值是否可以为空，默认为false

　　　　　　　　required属性可以指定该元素是否必须出现，默认为false

　　　　　　　　namespace属性可以指定该元素所属的命名空间

　　　　　　　　defaultValue属性可以指定该元素默认的文本值

　　　　@XmlAttribute，字段和方法级别的注解。将Java类的一个属性映射到与属性同名的一个XML属性。

　　　　只用到以上注解,想了解其他详细的可看:  　https://blog.csdn.net/lhzjj/article/details/11796713