This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 698ed48 Automated deployment: Fri Nov 8 05:12:52 UTC 2019
7877c75f07390d543693b51c120ccb3795da81d9
698ed48 is described below
commit 698ed48d5594049e41b4030c98c1ea19803d7b37
Author: lexburner <[email protected]>
AuthorDate: Fri Nov 8 05:12:52 2019 +0000
Automated deployment: Fri Nov 8 05:12:52 UTC 2019
7877c75f07390d543693b51c120ccb3795da81d9
---
md_json/docs.json | 5 +
.../user/demos/GooglePb-generic-reference.html | 106 +++++++++++++++++++++
.../user/demos/GooglePb-generic-reference.json | 6 ++
3 files changed, 117 insertions(+)
diff --git a/md_json/docs.json b/md_json/docs.json
index ba40b8b..1cb3865 100644
--- a/md_json/docs.json
+++ b/md_json/docs.json
@@ -1594,6 +1594,11 @@
"meta": {}
},
{
+ "filename": "GooglePb-generic-reference.md",
+ "link": "/zh-cn/docs/user/demos/GooglePb-generic-reference.html",
+ "meta": {}
+ },
+ {
"filename": "accesslog.md",
"link": "/zh-cn/docs/user/demos/accesslog.html",
"meta": {}
diff --git a/zh-cn/docs/user/demos/GooglePb-generic-reference.html
b/zh-cn/docs/user/demos/GooglePb-generic-reference.html
new file mode 100644
index 0000000..e7a82e8
--- /dev/null
+++ b/zh-cn/docs/user/demos/GooglePb-generic-reference.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+ <meta charset="UTF-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0,
maximum-scale=1.0, user-scalable=no">
+ <meta name="keywords" content="GooglePb-generic-reference" />
+ <meta name="description" content="GooglePb-generic-reference" />
+ <!-- 网页标签标题 -->
+ <title>GooglePb-generic-reference</title>
+ <link rel="shortcut icon" href="/img/dubbo.ico"/>
+ <link rel="stylesheet" href="/build/documentation.css" />
+</head>
+<body>
+ <div id="root"><div class="documentation-page"
data-reactroot=""><header class="header-container header-container-normal"><div
class="header-body"><a href="/zh-cn/index.html"><img class="logo"
src="/img/dubbo_colorful.png"/></a><div class="search search-normal"><span
class="icon-search"></span></div><span class="language-switch
language-switch-normal">En</span><div class="header-menu"><img
class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item
menu-item-normal"><a [...]
+<p>泛化接口调用方式主要用于客户端没有 API 接口及模型类元的情况，参考 <a
href="http://dubbo.apache.org/zh-cn/docs/user/demos/group-merger.html";>泛化调用</a>。
+一般泛化调用只能用于生成的服务参数为POJO的情况，而GoogleProtobuf的对象是基于Builder生成的非正常POJO，可以通过protobuf-json泛化调用。<br>
+GoogleProtobuf序列化相关的Demo可以参考<a
href="https://github.com/vio-lin/dubbo-samples/tree/protobuf-demo";>protobuf-demo</a></p>
+<h1>通过Spring对Goolgle Protobuf对象泛化调用</h1>
+<p>在Spring中配置声明generic = "protobuf-json"</p>
+<pre><code><dubbo:reference id="barService"
interface="com.foo.BarService" generic="protobuf-json" />
+</code></pre>
+<p>在 Java 代码获取 barService 并开始泛化调用：</p>
+<pre><code>GenericService barService = (GenericService)
applicationContext.getBean("barService");
+Object result = barService.$invoke("sayHello",new
String[]{"org.apache.dubbo.protobuf.GooglePbBasic$CDubboGooglePBRequestType"},
new
Object[]{"{\"double\":0.0,\"float\":0.0,\"bytesType\":\"Base64String\",\"int32\":0}"});
+</code></pre>
+<h1>通过 API 方式对Goolgle Protobuf对象泛化调用</h1>
+<pre><code>ReferenceConfig<GenericService> reference = new
ReferenceConfig<GenericService>();
+// 弱类型接口名
+reference.setInterface(GenericService.class.getName());
+reference.setInterface("com.xxx.XxxService");
+// 声明为Protobuf-json
+reference.setGeneric(Constants.GENERIC_SERIALIZATION_PROTOBUF);
+
+GenericService genericService = reference.get();
+Map<String, Object> person = new HashMap<String, Object>();
+person.put("fixed64", "0");
+person.put("int64", "0");
+// 参考google官方的protobuf 3 的语法，服务的每个方法中只传输一个POJO对象
+// protobuf的泛化调用只允许传递一个类型为String的json对象来代表请求参数
+String requestString = new Gson().toJson(person);
+// 返回对象是GoolgeProtobuf响应对象的json字符串。
+Object result = genericService.$invoke("sayHello", new String[] {
+ "com.xxx.XxxService.GooglePbBasic$CDubboGooglePBRequestType"},
+ new Object[] {requestString});
+</code></pre>
+<h1>有关GoogleProtobuf对象的处理</h1>
+<p>GoogleProtobuf对象是由Protocol契约生成,相关知识请参考<a
href="https://developers.google.com/protocol-buffers/?hl=zh-CN";>ProtocolBuffers文档</a>。
+假如有如下Protobuf 契约</p>
+<pre><code>syntax = "proto3";
+package com.xxx.XxxService.GooglePbBasic.basic;
+message CDubboGooglePBRequestType {
+ double double = 1;
+ float float = 2;
+ int32 int32 = 3;
+ bool bool = 13;
+ string string = 14;
+ bytes bytesType = 15;
+}
+
+message CDubboGooglePBResponseType {
+ string msg = 1;
+}
+
+service CDubboGooglePBService {
+ rpc sayHello (CDubboGooglePBRequestType) returns
(CDubboGooglePBResponseType);
+}
+</code></pre>
+<p>则对应请求按照如下方法构造</p>
+<pre><code>Map<String, Object> person = new HashMap<>();
+person.put("double", "1.000");
+person.put("float", "1.00");
+person.put("int32","1" );
+person.put("bool","false" );
+//String 的对象需要经过base64编码
+person.put("string","someBaseString");
+person.put("bytesType","150");
+</code></pre>
+<h1>GoogleProtobuf服务元数据解析</h1>
+<p>Google Protobuf对象缺少标准的JSON格式，生成的服务元数据信息存在错误。
+请添加如下依赖元数据解析的依赖。</p>
+<pre><code><dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo-metadata-definition-protobuf</artifactId>
+ <version>${dubbo.version}</version>
+</dependency>
+</code></pre>
+<p>从服务元数据中也可以比较容易构建泛化调用对象。</p>
+</div></section><footer class="footer-container"><div class="footer-body"><img
src="/img/dubbo_gray.png"/><img class="apache" src="/img/apache_logo.png"/><div
class="cols-container"><div class="col col-12"><h3></h3><p></p></div><div
class="col col-4"><dl><dt>ASF</dt><dd><a href="http://www.apache.org";
target="_self">基金会</a></dd><dd><a href="http://www.apache.org/licenses/";
target="_self">证书</a></dd><dd><a
href="http://www.apache.org/events/current-event";
target="_self">事件</a></dd><dd><a [...]
+ <script
src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js";></script>
+ <script
src="https://f.alicdn.com/react/15.4.1/react-dom.min.js";></script>
+ <script>
+ window.rootPath = '';
+ </script>
+ <script src="/build/documentation.js"></script>
+ <!-- Global site tag (gtag.js) - Google Analytics -->
+ <script async
src="https://www.googletagmanager.com/gtag/js?id=UA-112489517-1";></script>
+ <script>
+ window.dataLayer = window.dataLayer || [];
+ function gtag(){dataLayer.push(arguments);}
+ gtag('js', new Date());
+
+ gtag('config', 'UA-112489517-1');
+ </script>
+</body>
+</html>
\ No newline at end of file
diff --git a/zh-cn/docs/user/demos/GooglePb-generic-reference.json
b/zh-cn/docs/user/demos/GooglePb-generic-reference.json
new file mode 100644
index 0000000..a64ca84
--- /dev/null
+++ b/zh-cn/docs/user/demos/GooglePb-generic-reference.json
@@ -0,0 +1,6 @@
+{
+ "filename": "GooglePb-generic-reference.md",
+ "__html": "<h1>GoogleProtobuf对象泛化调用</h1>\n<p>泛化接口调用方式主要用于客户端没有 API
接口及模型类元的情况，参考 <a
href=\"http://dubbo.apache.org/zh-cn/docs/user/demos/group-merger.html\";>泛化调用</a>。\n一般泛化调用只能用于生成的服务参数为POJO的情况，而GoogleProtobuf的对象是基于Builder生成的非正常POJO，可以通过protobuf-json泛化调用。<br>\nGoogleProtobuf序列化相关的Demo可以参考<a
href=\"https://github.com/vio-lin/dubbo-samples/tree/protobuf-demo\";>protobuf-demo</a></p>\n<h1>通过Spring对Goolgle
Protobuf对象泛化调用</h1>\n<p>在Spring中配置声明generic =
"protobuf-json"</p>\n<pre><co [...]
+ "link": "/zh-cn/docs/user/demos/GooglePb-generic-reference.html",
+ "meta": {}
+}
\ No newline at end of file
