? ? ? ? 因为做的项目中用到了webservice,所以在此总结一下。
????????Web Service也叫XML Web Service, WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是通过SOAP在Web上提供的软件服务,使用WSDL文件进行说明,并通过UDDI进行注册。WebService是一种跨编程语言和跨操作系统平台的远程调用技术。
????????还可以从多个角度来理解WebService,从表面看,WebService就是一个应用程序向外界暴露出一个能通过Web进行调用的API,也就是说能用编程的方法通过Web来调用这个应用程序。我们把调用这个WebService的应用程序叫做客户端,而把提供这个WebService的应用程序叫做服务端。从深层次看,WebService是建立可互操作的分布式应用程序的新平台,是一个平台,是一套标准。它定义了应用程序如何在Web上实现互操作性,你可以用任何你喜欢的语言,在任何你喜欢的平台上写Web service ,只要我们可以通过Web service标准对这些服务进行查询和访问。
????????SOAP、WSDL、UDDI(UniversalDescriptionDiscovery andIntegration)三者构成了WebService的三要素。下面详细阐述这三大技术:
SOAP:
WebService通过HTTP协议发送请求和接收结果时,发送的请求内容和结果内容都采用XML格式封装,并增加了一些特定的HTTP消息头,以说明HTTP消息的内容格式,这些特定的HTTP消息头和XML内容格式就是SOAP协议。SOAP提供了标准的RPC(远程调用技术)方法来调用Web Service。
SOAP协议组成:
SOAP协议 = HTTP协议 + XML数据格式
SOAP协议定义了SOAP消息的格式,SOAP协议是基于HTTP协议的,SOAP也是基于XML的,XML是SOAP的数据编码方式。
WSDL
好比我们去商店买东西,首先要知道商店里有什么东西可买,然后再来购买,商家的做法就是张贴广告海报。 WebService也一样,WebService客户端要调用一个WebService服务,首先要有知道这个服务的地址在哪,以及这个服务里有什么方法可以调用,所以,WebService务器端首先要通过一个WSDL文件来说明自己家里有啥服务可以对外调用,服务是什么(服务中有哪些方法,方法接受的参数是什么,返回值是什么),服务的网络地址用哪个url地址表示,服务通过什么方式来调用。
WSDL(Web Services Description Language)就是这样一个基于XML的语言,用于描述Web Service及其函数、参数和返回值。它是WebService客户端和服务器端都能理解的标准格式。因为是基于XML的,所以WSDL既是机器可阅读的,又是人可阅读的,这将是一个很大的好处。一些最新的开发工具既能根据你的Web service生成WSDL文档,又能导入WSDL文档,生成调用相应WebService的代理类代码。
UDDI
uddi是一个跨产业,跨平台的开放性架构,可以帮助 Web 服务提供商在互联网上发布 Web 服务的信息。UDDI 是一种目录服务,企业可以通过 UDDI 来注册和搜索 Web 服务。简单来说,UDDI 就是一个目录,只不过在这个目录中存放的是一些关于 Web 服务的信息而已。
也就是说:
????????soap:就是在与webservice通信时规定好的协议
? ? ? ? wsdl:就是webservice中的食谱,你可以找到webservice中有哪些材料(方法),怎去做这道菜(入参、方法、返回值)等
? ? ? ? uddi:wsdl是食谱的话,uddi就是菜单,可以用来注册和搜索web服务。
<!-- CXF webservice -->
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-spring-boot-starter-jaxws</artifactId>
<version>3.4.5</version>
</dependency>
@Data
@Builder
public class UserDto {
private Long id;
private String name;
private Integer age;
private String address;
}
public interface IUserServer {
UserDto getUser(Long str);
}
@Service
@WebService
public class UserServerImpl implements IUserServer {
@Override
public UserDto getUser(Long id) {
return UserDto.builder()
.id(id)
.address("上海市浦东新区")
.age(25)
.name("laJi").build();
}
}
?
这里用到了注解@WebService,我这就只在实现类上使用了。这里介绍一下,先来看下它的定义:
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE})
public @interface WebService {
? ? String name() default "";
? ? String targetNamespace() default "";
? ? String serviceName() default "";
? ? String portName() default "";
? ? String wsdlLocation() default "";
? ? String endpointInterface() default "";
}
name: 对应wsdl:portType标签,默认值为Java类或接口的名称;
targetNamespace: 命名空间,一般写为接口的包名倒序,默认值也是接口的包名倒序。对应wsd:definitions:targetNamespace 标签;
serviceName: WebService的服务名称,对应wsdl:service,默认值为WebService接口实现类的名称+“Service”,示例:UserServiceImplServicce
portName: 对应wsdl:port标签,默认值为:WebService接口实现类的名称+“Port”,示例:UserServiceImplPort
wsdlLocation: 指定用于定义WebService的WSDL文档的地址
endpoointInterfacce: WebService接口全路径
@Configuration
@RequiredArgsConstructor
public class CxfConfig {
private final IUserServer userServer;
/**
* 注入Servlet,注意beanName不能为dispatcherServlet
* @author Fang Ruichuan
* @date 2022/11/14 19:16
*/
@Bean
public ServletRegistrationBean cxfServlet() {
return new ServletRegistrationBean(new CXFServlet(), "/webservice/*");
}
@Bean(name = Bus.DEFAULT_BUS_ID)
public SpringBus springBus() {
return new SpringBus();
}
@Bean
public Endpoint endpoint() {
EndpointImpl endpoint = new EndpointImpl(springBus(), userServer);
endpoint.publish("/api");
return endpoint;
}
}
进行访问:http://localhost:8080/webservice
然后点击url
客户端:
public class WebserviceClient {
? ? public static void main(String[] args) {
? ? ? ? JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
? ? ? ? Client client = dcf.createClient("http://localhost:8080/webservice/api?wsdl");
? ? ? ? final ObjectMapper mapper = new ObjectMapper();
? ? ? ? try {
? ? ? ? ? ? Object[] objects = client.invoke("getUser", 99L);
? ? ? ? ? ? System.out.println(mapper.writeValueAsString(objects[0]));
? ? ? ? } catch (Exception e) {
? ? ? ? ? ? e.printStackTrace();;
? ? ? ? }
? ? }
}
显示:
{"address":"上海市浦东新区","age":25,"id":99,"name":"laJi"}
?
? ? ? ? webservice的服务端是以远程接口为主的,在java实现的webService主要是依靠的是CXF开发框架,而这个CXF框架可以直接将接口发布成webservice,同时还要考虑到整个项目之中的安全性问题。