http 协议

http:// 协议参考手册

基于 HTTP 表单的远程调用协议，采用 Spring 的 HttpInvoker 实现

提示

2.3.0 以上版本支持

特性

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

约束

  • 参数及返回值需符合 Bean 规范

配置

配置协议：

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

配置 Jetty Server (默认)：

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

配置 Servlet Bridge Server (推荐使用)：

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

配置 DispatcherServlet：

  1. <servlet>
  2.          <servlet-name>dubbo</servlet-name>
  3.          <servlet-class>org.apache.dubbo.remoting.http.servlet.DispatcherServlet</servlet-class>
  4.          <load-on-startup>1</load-on-startup>
  5. </servlet>
  6. <servlet-mapping>
  7.          <servlet-name>dubbo</servlet-name>
  8.          <url-pattern>/*</url-pattern>
  9. </servlet-mapping>

注意，如果使用 servlet 派发请求：

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

最后修改 September 21, 2021: Bug fix miss mialbox (#953) (57cf51b)