详解soapenv

一、soapenv概述

soapenv是SOAP消息协议的标准命名空间。SOAP（Simple Object Access Protocol）是一个由W3C定义的，用于访问Web服务对象的协议规范。它使用XML作为编码协议，HTTP或SMTP等协议作为传输协议。

在SOAP消息中，使用的各种元素和属性都要使用命名空间的形式进行声明。而soapenv就是SOAP消息协议中的一个重要的命名空间，作为SOAP消息中所包含的各种信息的中心，对SOAP消息的解析和处理具有重要意义。

二、soapenv基础元素

在soapenv中，有一些基础的元素是我们需要了解的。以下就是soapenv中最常见的一些基础元素：

• soapenv:Envelope：SOAP消息的根元素，包含一个必需的soapenv:Header和一个可选的soapenv:Body。
• soapenv:Header：可选的SOAP消息头部元素，包含与消息交互相关的可选信息。
• soapenv:Body：必需的SOAP消息主体元素，包含与所请求操作相关的信息。
• soapenv:Fault：当SOAP消息因为某些原因失败时，返回一个SOAP Fault响应。

三、soapenv实例

以下是一个使用SOAP协议的简单示例，我们可以通过这个示例来深入理解SOAP消息协议中的各个部分及其对应的功能：

  <?xml version="1.0" encoding="UTF-8"?>
  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
      <soapenv:Header/>
      <soapenv:Body>
          <getWeather xmlns="https://www.example.com/weather">
              <location>Beijing</location>
          </getWeather>
      </soapenv:Body>
  </soapenv:Envelope>

在这个示例中，soapenv:Envelope是SOAP消息的根元素，用于包含整个SOAP消息；soapenv:Header、soapenv:Body都是soapenv:Envelope的子元素。其中，soapenv:Header是可选的，而soapenv:Body是必需的。

而在soapenv:Body中，我们使用了一个名为getWeather的方法，这个方法在一个名为https://www.example.com/weather的命名空间中定义。在body中包含了请求参数location，值为北京。这样，使用SOAP协议的客户端就可以通过这个SOAP消息来请求获取北京的天气信息了。

四、使用SOAP协议开发WebService

SOAP消息协议是一个非常重要的Web服务协议，它可用于开发跨平台、跨语言、跨网络的Web服务。而想要开发一个SOAP协议的Web服务，关键的一步就是实现SOAP消息的解析和处理。下面是一个基于Java和Spring Framework的示例，用于演示如何使用SOAP协议开发Web服务：

1、定义webservice接口

首先，我们定义一个WebService接口，并使用@Endpoint注解声明它。这些接口定义会列在WSDL文档中。

    @Endpoint
    public interface WeatherService {
        @PayloadRoot(namespace = NAMESPACE_URI, localPart = "getWeather")
        @ResponsePayload
        public GetWeatherResponse getWeather(@RequestPayload GetWeather request);
    }

2、实现webservice接口

我们实现WeatherService接口，并用@Endpoint注解将其声明成Endpoint对象。在真正的实现中，我们会使用DAO或其他适合的方式来访问数据源，然后使用Java对象将数据转换为SOAP消息。

    @Endpoint
    public class WeatherServiceEndpoint {
        private static final String NAMESPACE_URI = "https://www.example.com/weather";
    
        @PayloadRoot(namespace = NAMESPACE_URI, localPart = "getWeather")
        @ResponsePayload
        public GetWeatherResponse getWeather(@RequestPayload GetWeather request) {
            //Dao访问数据库获取天气信息
            //将结果填充到GetWeatherResponse中返回
        }
    }

3、发布webservice

最后，我们使用Spring Framework的EndpointImpl和SimpleHttpServerFactory类来将Endpoint发布为Web服务。

    @Configuration
    @EnableWs
    public class WebServiceConfig extends WsConfigurerAdapter {
        @Autowired
        private ApplicationContext applicationContext;
        
        @Bean
        public ServletRegistrationBean messageDispatcherServlet(ApplicationContext applicationContext) {
            MessageDispatcherServlet servlet = new MessageDispatcherServlet();
            servlet.setApplicationContext(applicationContext);
            servlet.setTransformWsdlLocations(true);
            return new ServletRegistrationBean(servlet, "/ws/*");
        }
    
        @Bean(name = "weather")
        public DefaultWsdl11Definition defaultWsdl11Definition(XsdSchema weatherSchema) {
            DefaultWsdl11Definition wsdl11Definition = new DefaultWsdl11Definition();
            wsdl11Definition.setPortTypeName("WeatherPort");
            wsdl11Definition.setLocationUri("/ws");
            wsdl11Definition.setTargetNamespace(NAMESPACE_URI);
            wsdl11Definition.setSchema(weatherSchema);
            return wsdl11Definition;
        }
    
        @Bean
        public XsdSchema weatherSchema() {
            return new SimpleXsdSchema(new ClassPathResource("weather.xsd"));
        }
    
        @Bean
        public Endpoint weatherEndpoint() {
            EndpointImpl endpoint = new EndpointImpl(applicationContext.getBean(WeatherService.class));
            endpoint.publish("/WeatherService");
            return endpoint;
        }
    
        @Bean
        public SimpleHttpServerFactoryBean simpleHttpServerFactoryBean() {
            SimpleHttpServerFactoryBean factory = new SimpleHttpServerFactoryBean();
            factory.setPort(8080);
            return factory;
        }
    }

通过以上三个步骤，我们就成功地发布了一个使用SOAP协议的Web服务。