HTTP 协议

功能描述

基于 HTTP 表单的远程调用协议，由 Spring 的 HttpInvoker 实现，支持 2.3.0 以上版本。

  • 连接数：多连接
  • 连接方式：短连接
  • 传输协议：HTTP
  • 传输方式：同步传输
  • 序列化：表单序列化
  • 适用范围：传入和传出参数数据包大小混合，提供者数量多于消费者数量，可以用浏览器查看，参数可以通过表单或 URL 传入，目前不支持文件传输。
  • 适用场景：需要同时被应用程序和浏览器 JS 使用的服务。

约束

  • 参数和返回值必须符合 Bean 规范

使用场景

HTTP 短连接，标准化且易于阅读的协议，易于连接外部系统，适用于上层业务模块。

使用方法

从 Dubbo 3 开始，Http 协议不再嵌入 Dubbo 中，需要单独引入一个独立的 模块。

<dependency>
    <groupId>org.apache.dubbo.extensions</groupId>
    <artifactId>dubbo-rpc-http</artifactId>
    <version>1.0.0</version>
</dependency>

配置协议

<dubbo:protocol name="http" port="8080" />

配置 Jetty 服务器（默认）

<dubbo:protocol ... server="jetty" />

<dubbo:protocol ... server="servlet" />

配置 DispatcherServlet

<servlet>
         <servlet-name>dubbo</servlet-name>
         <servlet-class>org.apache.dubbo.remoting.http.servlet.DispatcherServlet</servlet-class>
         <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
         <servlet-name>dubbo</servlet-name>
         <url-pattern>/*</url-pattern>
</servlet-mapping>

如果使用 servlet 来分发请求

  • 协议端口 <dubbo:protocol port="8080" /> 必须与 servlet 容器的端口相同，
  • 协议的上下文路径 <dubbo:protocol contextpath="foo" /> 必须与 servlet 应用程序的上下文路径相同。

上次修改时间：2023 年 2 月 22 日：合并重构网站 (#2293) (4517e8c1c9c)