This is an automated email from the ASF dual-hosted git repository.

albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git


The following commit(s) were added to refs/heads/master by this push:
     new dc2deb06d4 [fix] 优化 webserver 协议 (#1198)
dc2deb06d4 is described below

commit dc2deb06d413086c3c8d22248bf8cffd5fd55743
Author: JIAN ZHONG <[email protected]>
AuthorDate: Thu Jul 7 11:41:43 2022 +0800

    [fix] 优化 webserver 协议 (#1198)
---
 .../reference-manual/protocol/webservice/guide.md  | 53 +++++++---------------
 1 file changed, 17 insertions(+), 36 deletions(-)

diff --git 
a/content/zh/docs3-building/java-sdk/reference-manual/protocol/webservice/guide.md
 
b/content/zh/docs3-building/java-sdk/reference-manual/protocol/webservice/guide.md
index afb1ee2e3f..c6a404d571 100644
--- 
a/content/zh/docs3-building/java-sdk/reference-manual/protocol/webservice/guide.md
+++ 
b/content/zh/docs3-building/java-sdk/reference-manual/protocol/webservice/guide.md
@@ -5,20 +5,28 @@ linkTitle: "使用说明"
 weight: 2
 ---
 
+## 特性说明
+基于 WebService 的远程调用协议,基于 [Apache CXF](http://cxf.apache.org) 的 
`frontend-simple` 和 `transports-http` 实现。`2.3.0` 以上版本支持。
 
-基于 WebService 的远程调用协议,基于 [Apache CXF](http://cxf.apache.org) [^1] 的 
`frontend-simple` 和 `transports-http` 实现。
-
-{{% alert title="提示" color="primary" %}}
-`2.3.0` 以上版本支持
-{{% /alert %}}
+CXF 是 Apache 开源的一个 RPC 框架,由 Xfire 和 Celtix 合并而来。
+* 连接个数:多连接
+* 连接方式:短连接
+* 传输协议:HTTP
+* 传输方式:同步传输
+* 序列化:SOAP 文本序列化
+* 适用场景:系统集成,跨语言调用
 
 可以和原生 WebService 服务互操作,即:
 
 * 提供者用 Dubbo 的 WebService 协议暴露服务,消费者直接用标准 WebService 接口调用,
 * 或者提供方用标准 WebService 暴露服务,消费方用 Dubbo 的 WebService 协议调用。
+#### 约束
+* 参数及返回值需实现 `Serializable` 接口
+* 参数尽量使用基本类型和 POJO
 
-## 依赖
-
+## 使用场景
+## 使用方式
+#### 依赖
 ```xml
 <dependency>
     <groupId>org.apache.cxf</groupId>
@@ -32,55 +40,33 @@ weight: 2
 </dependency>
 ```
 
-## 特性
-
-* 连接个数:多连接
-* 连接方式:短连接
-* 传输协议:HTTP
-* 传输方式:同步传输
-* 序列化:SOAP 文本序列化
-* 适用场景:系统集成,跨语言调用
-
-## 约束
-
-* 参数及返回值需实现 `Serializable` 接口
-* 参数尽量使用基本类型和 POJO
-
-## 配置
-
 配置协议:
-
 ```xml
 <dubbo:protocol name="webservice" port="8080" server="jetty" />
 ```
 
 配置默认协议:
-
 ```xml
 <dubbo:provider protocol="webservice" />
 ```
 
 配置服务协议:
-
 ```xml
 <dubbo:service protocol="webservice" />
 ```
 
 多端口:
-
 ```xml
 <dubbo:protocol id="webservice1" name="webservice" port="8080" />
 <dubbo:protocol id="webservice2" name="webservice" port="8081" />
 ```
 
 直连:
-
 ```xml
 <dubbo:reference id="helloService" interface="HelloWorld" 
url="webservice://10.20.153.10:8080/com.foo.HelloWorld" />
 ```
 
 WSDL:
-
 ```
 http://10.20.153.10:8080/com.foo.HelloWorld?wsdl
 ```
@@ -92,13 +78,11 @@ Jetty Server (默认):
 ```
 
 Servlet Bridge Server (推荐):
-
 ```xml
 <dubbo:protocol ... server="servlet" />
 ```
 
 配置 DispatcherServlet:
-
 ```xml
 <servlet>
          <servlet-name>dubbo</servlet-name>
@@ -111,9 +95,6 @@ Servlet Bridge Server (推荐):
 </servlet-mapping>
 ```
 
-注意,如果使用 servlet 派发请求:
-
-* 协议的端口 `<dubbo:protocol port="8080" />` 必须与 servlet 容器的端口相同,
+#### 注意:如果使用 servlet 派发请求:
+* 协议的端口 `<dubbo:protocol port="8080" />` 必须与 servlet 容器的端口相同。
 * 协议的上下文路径 `<dubbo:protocol contextpath="foo" />` 必须与 servlet 应用的上下文路径相同。
-
-[^1]: CXF 是 Apache 开源的一个 RPC 框架,由 Xfire 和 Celtix 合并而来  

Reply via email to