| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – 高级使用</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/</link><description>Recent content in 高级使用 on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><atom:link href="https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs: Dubbo-go 3.0 自定义filter</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/custom-filter/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/custom-filter/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/governance/features/custom-filter/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-30-自定义filter组件">Dubbo-go 3.0 自定义Filter组件</h1> |
| <p>参考samples <a href="https://github.com/apache/dubbo-go-samples/tree/master/filter">dubbo-go-samples/filter</a></p> |
| <h2 id="1-filter-概念">1. Filter 概念</h2> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#586e75">// Filter interface defines the functions of a filter |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// Extension - Filter |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">type</span> Filter <span style="color:#268bd2">interface</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// Invoke is the core function of a filter, it determines the process of the filter |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#268bd2">Invoke</span>(context.Context, protocol.Invoker, protocol.Invocation) protocol.Result |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// OnResponse updates the results from Invoke and then returns the modified results. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#268bd2">OnResponse</span>(context.Context, protocol.Result, protocol.Invoker, protocol.Invocation) protocol.Result |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>Filter 可以加载在 Consumer 端或者 Provider端。当加载在 Consumer 端,其Invoke函数调用的下游为网络层,OnResponse 为请求结束从网络层获取到返回结果后被调用。当加载在 Provider 端,其 Invoke 函数调用的下游为用户代码,OnResponse 为用户代码执行结束后向下传递至网络层前被调用。</p> |
| <p>Filter 采用面向切面设计的思路,通过对 Filter 的合理扩展,可以记录日志、设置数据打点,记录 invoker 所对应服务端性能,限流等等工作。</p> |
| <h2 id="2-框架预定义-filter">2. 框架预定义 Filter</h2> |
| <p>框架预定义了一系列filter,可以在配置中直接使用,其代码实现位于<a href="https://github.com/apache/dubbo-go/tree/release-3.0/filter">filter</a></p> |
| <ul> |
| <li>accesslog</li> |
| <li>active</li> |
| <li>sign: AuthConsumerFilter</li> |
| <li>auth: AuthProviderFilter</li> |
| <li>echo</li> |
| <li>execute: ExecuteLimitFilter</li> |
| <li>generic: GenericFilter</li> |
| <li>generic_service: GenericServiceFilter</li> |
| <li>pshutdown: GracefulShutdownProviderFilter</li> |
| <li>cshutdown: GracefulShutdownConsumerFilter</li> |
| <li>hystrix_consumer: HystrixConsumerFilter</li> |
| <li>hystrix_provider: HystrixProviderFilter</li> |
| <li>metrics</li> |
| <li>seata</li> |
| <li>sentinel-provider</li> |
| <li>sentinel-consumer</li> |
| <li>token</li> |
| <li>tps</li> |
| <li>tracing</li> |
| </ul> |
| <h2 id="3-默认加载filter">3. 默认加载Filter</h2> |
| <p>用户在配置文件中配置了将要使用的 Filter 时,框架使用用户配置的 Filter,否则则加载默认Filter:</p> |
| <ul> |
| <li> |
| <p>Consumer:</p> |
| <p>cshutdown</p> |
| </li> |
| <li> |
| <p>Provider:</p> |
| <p>echo, metrics, token, accesslog, tps, generic_service, executivete, pshutdown</p> |
| </li> |
| </ul> |
| <h2 id="4-用户指定-filter">4. 用户指定 Filter</h2> |
| <p>指定filter时可用&rsquo;,&lsquo;分隔</p> |
| <ul> |
| <li> |
| <p>Consumer 端</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">filter</span>: echo,token,tps,myCustomFilter <span style="color:#586e75"># 可指定自定义filter</span> |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Provider 端</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">filter</span>: myCustomFilter,echo,tps |
| </span></span></code></pre></div></li> |
| </ul> |
| <h2 id="5-自定义filter">5. 自定义Filter</h2> |
| <p>用户可在代码中自定义 Filter,注册到框架上,并在配置中选择使用。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">init</span>() { |
| </span></span><span style="display:flex;"><span> extension.<span style="color:#268bd2">SetFilter</span>(<span style="color:#2aa198">&#34;myCustomFilter&#34;</span>, NewMyClientFilter) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">NewMyClientFilter</span>() filter.Filter { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>MyClientFilter{} |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">type</span> MyClientFilter <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (f <span style="color:#719e07">*</span>MyClientFilter) <span style="color:#268bd2">Invoke</span>(ctx context.Context, invoker protocol.Invoker, invocation protocol.Invocation) protocol.Result { |
| </span></span><span style="display:flex;"><span> fmt.<span style="color:#268bd2">Println</span>(<span style="color:#2aa198">&#34;MyClientFilter Invoke is called, method Name = &#34;</span>, invocation.<span style="color:#268bd2">MethodName</span>()) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> invoker.<span style="color:#268bd2">Invoke</span>(ctx, invocation) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (f <span style="color:#719e07">*</span>MyClientFilter) <span style="color:#268bd2">OnResponse</span>(ctx context.Context, result protocol.Result, invoker protocol.Invoker, protocol protocol.Invocation) protocol.Result { |
| </span></span><span style="display:flex;"><span> fmt.<span style="color:#268bd2">Println</span>(<span style="color:#2aa198">&#34;MyClientFilter OnResponse is called&#34;</span>) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> result |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div></description></item><item><title>Docs: go-java 3.0 互通示例</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/go_java_interactive/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/go_java_interactive/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/interflow/call_java/">最新版本</a>。</p> |
| </div> |
| <h1 id="go-java-互通示例">Go-Java 互通示例</h1> |
| <h2 id="准备工作">准备工作</h2> |
| <h3 id="环境">环境</h3> |
| <p>JDK 8,Golang &gt;= 1.15,Dubbo 3.0.2,zookeeper 启动,</p> |
| <h3 id="go--java-互通前提">Go- Java 互通前提</h3> |
| <ul> |
| <li> |
| <p>Go/Java 定义的传输结构一致</p> |
| <ul> |
| <li>PB 序列化</li> |
| </ul> |
| <p>proto for Go</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-protobuf" data-lang="protobuf"><span style="display:flex;"><span><span style="color:#586e75">// The response message containing the greetings |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">message</span> <span style="color:#268bd2">User</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> name <span style="color:#719e07">=</span> <span style="color:#2aa198">1</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> id <span style="color:#719e07">=</span> <span style="color:#2aa198">2</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">int32</span> age <span style="color:#719e07">=</span> <span style="color:#2aa198">3</span>; |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>proto for Java</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-protobuf" data-lang="protobuf"><span style="display:flex;"><span><span style="color:#586e75">// The response message containing the greetings |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">message</span> <span style="color:#268bd2">User</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> name <span style="color:#719e07">=</span> <span style="color:#2aa198">1</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> id <span style="color:#719e07">=</span> <span style="color:#2aa198">2</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">int32</span> age <span style="color:#719e07">=</span> <span style="color:#2aa198">3</span>; |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ul> |
| <li>Hessian 序列化</li> |
| </ul> |
| <p>POJO for Go,需参考 <a href="https://www.yuque.com/docs/share/c698bd6e-e4d6-47db-bc1c-c757cc9b4f3e?">Dubbo-go Hessian 序列化支持文档</a></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">type</span> User <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> ID <span style="color:#dc322f">string</span> |
| </span></span><span style="display:flex;"><span> Name <span style="color:#dc322f">string</span> |
| </span></span><span style="display:flex;"><span> Age <span style="color:#dc322f">int32</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (u <span style="color:#719e07">*</span>User) <span style="color:#268bd2">JavaClassName</span>() <span style="color:#dc322f">string</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#2aa198">&#34;org.apache.dubbo.User&#34;</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">init</span>(){ |
| </span></span><span style="display:flex;"><span> hessian.<span style="color:#268bd2">RegisterPOJO</span>(<span style="color:#719e07">&amp;</span>User{}) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>POJO for Java</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">User</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> String id<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> String name<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> <span style="color:#dc322f">int</span> age<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div></li> |
| <li> |
| <p>Java 需要互通的方法签名与 Go 一致</p> |
| <p>例如:</p> |
| <p>Java Interface</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">interface</span> <span style="color:#268bd2">IGreeter</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">/** |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> * &lt;pre&gt; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> * Sends a greeting |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> * &lt;/pre&gt; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> */</span> |
| </span></span><span style="display:flex;"><span> User <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span>HelloRequest request<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><p>Go client (由protoc-gen-go-triple 根据 proto 文件自动生成)</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">type</span> GreeterClientImpl <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// Sends a greeting |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> SayHello <span style="color:#268bd2">func</span>(ctx context.Context, in <span style="color:#719e07">*</span>HelloRequest) (<span style="color:#719e07">*</span>User, <span style="color:#dc322f">error</span>) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>Go server (由开发者定义)</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">type</span> GreeterProvider <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> api.GreeterProviderBase |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>GreeterProvider) <span style="color:#268bd2">SayHello</span>(ctx context.Context, in <span style="color:#719e07">*</span>api.HelloRequest) (<span style="color:#719e07">*</span>api.User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;Dubbo3 GreeterProvider get user name = %s\n&#34;</span>, in.Name) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>api.User{Name: <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> in.Name, Id: <span style="color:#2aa198">&#34;12345&#34;</span>, Age: <span style="color:#2aa198">21</span>}, <span style="color:#cb4b16">nil</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>Go 方法需要遵守 <a href="https://www.yuque.com/docs/share/eff9c51f-a7f4-47d6-87ff-11a2152bdffe?">Dubbo-go 3.0 用户服务接口定义规范</a></p> |
| </li> |
| <li> |
| <p>Java 的三元组与Go service/reference 配置的 interface 一致</p> |
| <p>三元组,即为接口级别配置的:interface, group, version。<strong>其中需要注意,group 和 version 的概念为 dubbo 接口的 group 和vesion,在启动 dubbo-java 服务时配置于 spring cloud 的 properties 文件中,并非pom.xml 中 mvn 依赖的version。</strong> group 和version 默认为空,在 dubbo-go 框架中,可以在service/reference 的对应位置指定 group 和 version。</p> |
| <p>例如:</p> |
| <p>Java 的接口全名:com.apache.dubbo.sample.basic.IGreeter,接口 version 为v1.0.1, group 为</p> |
| <p>Go-client:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">references</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterClientImpl</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter <span style="color:#586e75"># must be compatible with grpc or dubbo-java</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: dubbogo <span style="color:#586e75"># 需要与服务端对应 默认为空</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">version</span>: v1.0.1 <span style="color:#586e75"># 需要与服务端对应 默认为空</span> |
| </span></span></code></pre></div><p>Go-server:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol-ids</span>: tripleProtocol |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter <span style="color:#586e75"># must be compatible with grpc or dubbo-java</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: dubbogo <span style="color:#586e75"># 需要与服务端对应 默认为空</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">version</span>: v1.0.1 <span style="color:#586e75"># 需要与服务端对应 默认为空</span> |
| </span></span></code></pre></div></li> |
| </ul> |
| <h2 id="1-基于-triple-协议互通-pb序列化">1. 基于 Triple 协议互通 (PB序列化)</h2> |
| <p>参考 <a href="https://github.com/apache/dubbo-go-samples/tree/master/helloworld">dubbo-go-samples/helloworld</a></p> |
| <h3 id="11-go-client---java-server">1.1 Go-Client -&gt; Java-Server</h3> |
| <h4 id="java-server-启动">Java-Server 启动</h4> |
| <ol> |
| <li>定义 Java 的 PB 文件,可参考 <a href="https://dubbo.apache.org/zh-cn/docs/quick-start/">Dubbo 快速开始</a></li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-protobuf" data-lang="protobuf"><span style="display:flex;"><span>syntax <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;proto3&#34;</span>; |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">option</span> java_package <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;org.apache.dubbo.sample.hello&#34;</span>; |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">package</span> helloworld; |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// The request message containing the user&#39;s name. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">message</span> <span style="color:#268bd2">HelloRequest</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> name <span style="color:#719e07">=</span> <span style="color:#2aa198">1</span>; |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// The response message containing the greetings |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">message</span> <span style="color:#268bd2">User</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> name <span style="color:#719e07">=</span> <span style="color:#2aa198">1</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> id <span style="color:#719e07">=</span> <span style="color:#2aa198">2</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">int32</span> age <span style="color:#719e07">=</span> <span style="color:#2aa198">3</span>; |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>该接口描述文件定义了将会生成的 Java 类 org.apache.dubbo.sample.hello.Helloworld,以及类中包含的传输结构 HelloRequest 和 User 类。</p> |
| <ol start="2"> |
| <li> |
| <p>定义服务接口:</p> |
| <p>com.apache.dubbo.sample.basic.IGreeter</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.apache.dubbo.sample.basic<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 引入根据 PB 生成的类 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#719e07">import</span> org.apache.dubbo.sample.hello.Helloworld.User<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.sample.hello.Helloworld.HelloRequest<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">interface</span> <span style="color:#268bd2">IGreeter</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">/** |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> * &lt;pre&gt; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> * Sends a greeting |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> * &lt;/pre&gt; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> */</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 定义接口 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> User <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span>HelloRequest request<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="3"> |
| <li> |
| <p>实现服务接口:</p> |
| <p>IGreeter1Impl.java</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.apache.dubbo.sample.basic<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.sample.hello.Helloworld.User<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.sample.hello.Helloworld.HelloRequest<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">IGreeter1Impl</span> <span style="color:#268bd2">implements</span> IGreeter <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">@Override</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> User <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span>HelloRequest request<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>out<span style="color:#719e07">.</span>println<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;receiv: &#34;</span> <span style="color:#719e07">+</span> request<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> User usr <span style="color:#719e07">=</span> User<span style="color:#719e07">.</span>newBuilder<span style="color:#719e07">()</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">.</span>setName<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;hello &#34;</span> <span style="color:#719e07">+</span> request<span style="color:#719e07">.</span>getName<span style="color:#719e07">())</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">.</span>setAge<span style="color:#719e07">(</span>18<span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">.</span>setId<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;12345&#34;</span><span style="color:#719e07">).</span>build<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> usr<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="4"> |
| <li> |
| <p>使用 Dubbo3 框架启动服务</p> |
| <p>ApiProvider.java</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.apache.dubbo.sample.basic<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.common.constants.CommonConstants<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.config.ApplicationConfig<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.config.ProtocolConfig<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.config.RegistryConfig<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.config.ServiceConfig<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> java.util.concurrent.CountDownLatch<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">ApiProvider</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">main</span><span style="color:#719e07">(</span>String<span style="color:#719e07">[]</span> args<span style="color:#719e07">)</span> <span style="color:#268bd2">throws</span> InterruptedException <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> ServiceConfig<span style="color:#719e07">&lt;</span>IGreeter<span style="color:#719e07">&gt;</span> service <span style="color:#719e07">=</span> <span style="color:#719e07">new</span> ServiceConfig<span style="color:#719e07">&lt;&gt;();</span> |
| </span></span><span style="display:flex;"><span> service<span style="color:#719e07">.</span>setInterface<span style="color:#719e07">(</span>IGreeter<span style="color:#719e07">.</span>class<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> service<span style="color:#719e07">.</span>setRef<span style="color:#719e07">(</span><span style="color:#719e07">new</span> IGreeter1Impl<span style="color:#719e07">());</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 使用 Triple 协议 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> service<span style="color:#719e07">.</span>setProtocol<span style="color:#719e07">(</span><span style="color:#719e07">new</span> ProtocolConfig<span style="color:#719e07">(</span>CommonConstants<span style="color:#719e07">.</span>TRIPLE<span style="color:#719e07">,</span> 50051<span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> service<span style="color:#719e07">.</span>setApplication<span style="color:#719e07">(</span><span style="color:#719e07">new</span> ApplicationConfig<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;demo-provider&#34;</span><span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 使用 ZK 作为注册中心 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> service<span style="color:#719e07">.</span>setRegistry<span style="color:#719e07">(</span><span style="color:#719e07">new</span> RegistryConfig<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;zookeeper://127.0.0.1:2181&#34;</span><span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> service<span style="color:#719e07">.</span>export<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>out<span style="color:#719e07">.</span>println<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;dubbo service started&#34;</span><span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">new</span> CountDownLatch<span style="color:#719e07">(</span>1<span style="color:#719e07">).</span>await<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><p>启动服务,可看到输出如下日志,代表 Java Triple Server 启动成功</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>main INFO bootstrap.DubboBootstrap: [DUBBO] DubboBootstrap has started., dubbo version: 3.0.2, current host: 192.168.0.108 |
| </span></span><span style="display:flex;"><span>dubbo service started |
| </span></span></code></pre></div><h4 id="go-client-启动">Go-Client 启动</h4> |
| <p>对于已经启动的Dubbo服务,如需要开发与其对应的Go-client,需要进行如下步骤:</p> |
| <ol> |
| <li> |
| <p>编写与 Java 适配的 proto文件</p> |
| <p>samples_api.proto</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-protobuf" data-lang="protobuf"><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>syntax <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;proto3&#34;</span>; |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">package</span> api; <span style="color:#586e75">// pacakge 名随意指定 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// necessary |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#719e07">option</span> go_package <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;./;api&#34;</span>; |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// The greeting service definition. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">service</span> Greeter { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// Sends a greeting |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#719e07">rpc</span> SayHello (HelloRequest) <span style="color:#719e07">returns</span> (User) {} |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// The request message containing the user&#39;s name. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">message</span> <span style="color:#268bd2">HelloRequest</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> name <span style="color:#719e07">=</span> <span style="color:#2aa198">1</span>; |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// The response message containing the greetings |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">message</span> <span style="color:#268bd2">User</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> name <span style="color:#719e07">=</span> <span style="color:#2aa198">1</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">string</span> id <span style="color:#719e07">=</span> <span style="color:#2aa198">2</span>; |
| </span></span><span style="display:flex;"><span> <span style="color:#dc322f">int32</span> age <span style="color:#719e07">=</span> <span style="color:#2aa198">3</span>; |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ol start="2"> |
| <li>使用 protoc-gen-triple 生成接口文件</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>protoc -I . samples_api.proto --triple_out<span style="color:#719e07">=</span><span style="color:#268bd2">plugins</span><span style="color:#719e07">=</span>triple:. |
| </span></span></code></pre></div><ol start="3"> |
| <li>撰写配置文件: dubbogo.yml</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">references</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterClientImpl</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter <span style="color:#586e75"># must be compatible with grpc or dubbo-java</span> |
| </span></span></code></pre></div><ol start="4"> |
| <li>撰写 main.go 文件,发起调用</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#586e75">// 引入生成的接口结构 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">var</span> grpcGreeterImpl = <span style="color:#b58900">new</span>(api.GreeterClientImpl) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// export DUBBO_GO_CONFIG_PATH=dubbogo.yml |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span> config.<span style="color:#268bd2">SetConsumerService</span>(grpcGreeterImpl) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">Load</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> time.<span style="color:#268bd2">Sleep</span>(<span style="color:#2aa198">3</span> <span style="color:#719e07">*</span> time.Second) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Info</span>(<span style="color:#2aa198">&#34;start to test dubbo&#34;</span>) |
| </span></span><span style="display:flex;"><span> req <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>api.HelloRequest{ |
| </span></span><span style="display:flex;"><span> Name: <span style="color:#2aa198">&#34;laurence&#34;</span>, |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> reply, err <span style="color:#719e07">:=</span> grpcGreeterImpl.<span style="color:#268bd2">SayHello</span>(context.<span style="color:#268bd2">Background</span>(), req) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Error</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;client response result: %v\n&#34;</span>, reply) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ol start="5"> |
| <li>可查看到调用成功的日志</li> |
| </ol> |
| <ul> |
| <li>go-client</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>cmd/client.go:53 client response result: name:&#34;hello laurence&#34; id:&#34;12345&#34; age:18 |
| </span></span></code></pre></div><ul> |
| <li>java-server</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>receiv: name: &#34;laurence&#34; |
| </span></span></code></pre></div><h3 id="12-java-client---go-server">1.2 Java-Client -&gt; Go-Server</h3> |
| <h4 id="go-server-启动">Go-Server 启动</h4> |
| <ol> |
| <li>定义配置文件</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter <span style="color:#586e75"># must be compatible with grpc or dubbo-java</span> |
| </span></span></code></pre></div><ol start="2"> |
| <li>引入传输结构,定义服务</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">type</span> GreeterProvider <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> api.GreeterProviderBase |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>GreeterProvider) <span style="color:#268bd2">SayHello</span>(ctx context.Context, in <span style="color:#719e07">*</span>api.HelloRequest) (<span style="color:#719e07">*</span>api.User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;Dubbo3 GreeterProvider get user name = %s\n&#34;</span>, in.Name) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>api.User{Name: <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> in.Name, Id: <span style="color:#2aa198">&#34;12345&#34;</span>, Age: <span style="color:#2aa198">21</span>}, <span style="color:#cb4b16">nil</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ol start="3"> |
| <li>启动服务</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#586e75">// export DUBBO_GO_CONFIG_PATH=dubbogo.yml |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span> config.<span style="color:#268bd2">SetProviderService</span>(<span style="color:#719e07">&amp;</span>GreeterProvider{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">Load</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">select</span> {} |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><h4 id="java-client-启动">Java-Client 启动</h4> |
| <ol> |
| <li> |
| <p>proto 文件编写和接口生成参考上述 java-server 介绍</p> |
| </li> |
| <li> |
| <p>启动Consumer</p> |
| <p>ApiCnosumer.java</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">ApiConsumer</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">main</span><span style="color:#719e07">(</span>String<span style="color:#719e07">[]</span> args<span style="color:#719e07">)</span> <span style="color:#268bd2">throws</span> InterruptedException<span style="color:#719e07">,</span> IOException <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> ReferenceConfig<span style="color:#719e07">&lt;</span>IGreeter<span style="color:#719e07">&gt;</span> ref <span style="color:#719e07">=</span> <span style="color:#719e07">new</span> ReferenceConfig<span style="color:#719e07">&lt;&gt;();</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setInterface<span style="color:#719e07">(</span>IGreeter<span style="color:#719e07">.</span>class<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setCheck<span style="color:#719e07">(</span><span style="color:#cb4b16">false</span><span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setProtocol<span style="color:#719e07">(</span>CommonConstants<span style="color:#719e07">.</span>TRIPLE<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setLazy<span style="color:#719e07">(</span><span style="color:#cb4b16">true</span><span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setTimeout<span style="color:#719e07">(</span>100000<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setApplication<span style="color:#719e07">(</span><span style="color:#719e07">new</span> ApplicationConfig<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;demo-consumer&#34;</span><span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> ref<span style="color:#719e07">.</span>setRegistry<span style="color:#719e07">(</span><span style="color:#719e07">new</span> RegistryConfig<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;zookeeper://127.0.0.1:2181&#34;</span><span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">final</span> IGreeter iGreeter <span style="color:#719e07">=</span> ref<span style="color:#719e07">.</span>get<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>out<span style="color:#719e07">.</span>println<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;dubbo ref started&#34;</span><span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> Helloworld<span style="color:#719e07">.</span>HelloRequest req <span style="color:#719e07">=</span> Helloworld<span style="color:#719e07">.</span>HelloRequest<span style="color:#719e07">.</span>newBuilder<span style="color:#719e07">().</span>setName<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;laurence&#34;</span><span style="color:#719e07">).</span>build<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">try</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">final</span> Helloworld<span style="color:#719e07">.</span>User reply <span style="color:#719e07">=</span> iGreeter<span style="color:#719e07">.</span>sayHello<span style="color:#719e07">(</span>req<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> TimeUnit<span style="color:#719e07">.</span>SECONDS<span style="color:#719e07">.</span>sleep<span style="color:#719e07">(</span>1<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>out<span style="color:#719e07">.</span>println<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;Reply:&#34;</span> <span style="color:#719e07">+</span> reply<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> <span style="color:#719e07">catch</span> <span style="color:#719e07">(</span>Throwable t<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> t<span style="color:#719e07">.</span>printStackTrace<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>in<span style="color:#719e07">.</span>read<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><h2 id="2-基于-dubbo-协议互通-hessian2序列化">2. 基于 Dubbo 协议互通 (Hessian2序列化)</h2> |
| <p>参考 <a href="https://github.com/apache/dubbo-go-samples/tree/master/rpc/dubbo">dubbo-go-samples/rpc/dubbo</a></p> |
| <h3 id="21-go-client---java-server">2.1 Go-Client -&gt; Java-Server</h3> |
| <h4 id="java-server-启动-1">Java-Server 启动</h4> |
| <ol> |
| <li>定义 Java 接口、参数和返回值,可参考 <a href="https://dubbo.apache.org/zh-cn/docs/quick-start/">Dubbo 快速开始</a></li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 需要暴露的服务接口 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">public</span> <span style="color:#268bd2">interface</span> <span style="color:#268bd2">UserProvider</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> User <span style="color:#268bd2">getUser</span><span style="color:#719e07">(</span><span style="color:#dc322f">int</span> usercode<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">User</span> <span style="color:#268bd2">implements</span> Serializable <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> String id<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> String name<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> <span style="color:#dc322f">int</span> age<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> Date time <span style="color:#719e07">=</span> <span style="color:#719e07">new</span> Date<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">/* ... */</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="2"> |
| <li>实现服务接口:</li> |
| </ol> |
| <p>UserProviderImpl.java</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">UserProviderImpl</span> <span style="color:#268bd2">implements</span> UserProvider <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> User <span style="color:#268bd2">getUser</span><span style="color:#719e07">(</span><span style="color:#dc322f">int</span> userCode<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#719e07">new</span> User<span style="color:#719e07">(</span>String<span style="color:#719e07">.</span>valueOf<span style="color:#719e07">(</span>userCode<span style="color:#719e07">),</span> <span style="color:#2aa198">&#34;userCode get&#34;</span><span style="color:#719e07">,</span> 48<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="3"> |
| <li>使用SpringBoot 启动</li> |
| </ol> |
| <p>Provider.java</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// use when config by API |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#586e75">/* |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">import java.util.concurrent.CountDownLatch; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">import org.apache.dubbo.common.constants.CommonConstants; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">import org.apache.dubbo.config.ApplicationConfig; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">import org.apache.dubbo.config.ProtocolConfig; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">import org.apache.dubbo.config.RegistryConfig; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">import org.apache.dubbo.config.ServiceConfig; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">*/</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.context.support.ClassPathXmlApplicationContext<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">Provider</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// main function, config from spring boot |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#268bd2">public</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">main</span><span style="color:#719e07">(</span>String<span style="color:#719e07">[]</span> args<span style="color:#719e07">)</span> <span style="color:#268bd2">throws</span> Exception <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> ClassPathXmlApplicationContext context <span style="color:#719e07">=</span> <span style="color:#719e07">new</span> ClassPathXmlApplicationContext<span style="color:#719e07">(</span><span style="color:#719e07">new</span> String<span style="color:#719e07">[]{</span><span style="color:#2aa198">&#34;META-INF/spring/dubbo.provider.xml&#34;</span><span style="color:#719e07">});</span> |
| </span></span><span style="display:flex;"><span> context<span style="color:#719e07">.</span>start<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>in<span style="color:#719e07">.</span>read<span style="color:#719e07">();</span> <span style="color:#586e75">// press any key to exit |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// config by API |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// public static void startComplexService() throws InterruptedException { |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// ServiceConfig&lt;ComplexProvider&gt; service = new ServiceConfig&lt;&gt;(); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// service.setInterface(ComplexProvider.class); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// service.setRef(new ComplexProviderImpl()); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// service.setProtocol(new ProtocolConfig(CommonConstants.DUBBO_PROTOCOL, 20001)); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// service.setApplication(new ApplicationConfig(&#34;demo-provider&#34;)); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// service.setRegistry(new RegistryConfig(&#34;zookeeper://127.0.0.1:2181&#34;)); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// service.export(); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// System.out.println(&#34;dubbo service started&#34;); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// new CountDownLatch(1).await(); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">// } |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="4"> |
| <li> |
| <p>通过Spring 配置 Dubbo 参数</p> |
| <p>Resources/META-INF.spring/dubbo.provider.xml</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#719e07">&lt;?xml version=&#34;1.0&#34; encoding=&#34;UTF-8&#34;?&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">&lt;!-- |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Licensed under the Apache License, Version 2.0 (the &#34;License&#34;); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> you may not use this file except in compliance with the License. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> You may obtain a copy of the License at |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> http://www.apache.org/licenses/LICENSE-2.0 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Unless required by applicable law or agreed to in writing, software |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> distributed under the License is distributed on an &#34;AS IS&#34; BASIS, |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> See the License for the specific language governing permissions and |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> limitations under the License. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">--&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;beans</span> xmlns=<span style="color:#2aa198">&#34;http://www.springframework.org/schema/beans&#34;</span> |
| </span></span><span style="display:flex;"><span> xmlns:xsi=<span style="color:#2aa198">&#34;http://www.w3.org/2001/XMLSchema-instance&#34;</span> |
| </span></span><span style="display:flex;"><span> xmlns:dubbo=<span style="color:#2aa198">&#34;http://code.alibabatech.com/schema/dubbo&#34;</span> |
| </span></span><span style="display:flex;"><span> xsi:schemaLocation=<span style="color:#2aa198">&#34;http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 应用名 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:application</span> name=<span style="color:#2aa198">&#34;user-info-server&#34;</span><span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 连接到哪个本地注册中心 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:registry</span> id=<span style="color:#2aa198">&#34;dubbogo&#34;</span> address=<span style="color:#2aa198">&#34;zookeeper://127.0.0.1:2181&#34;</span> <span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 用dubbo协议在20880端口暴露服务 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:protocol</span> id=<span style="color:#2aa198">&#34;dubbo&#34;</span> name=<span style="color:#2aa198">&#34;dubbo&#34;</span> host=<span style="color:#2aa198">&#34;127.0.0.1&#34;</span> port=<span style="color:#2aa198">&#34;20010&#34;</span> <span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 声明需要暴露的服务接口 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:service</span> id=<span style="color:#2aa198">&#34;aaa&#34;</span> registry=<span style="color:#2aa198">&#34;dubbogo&#34;</span> timeout=<span style="color:#2aa198">&#34;3000&#34;</span> interface=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span> ref=<span style="color:#2aa198">&#34;demoService&#34;</span><span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:service</span> id=<span style="color:#2aa198">&#34;bbb&#34;</span> registry=<span style="color:#2aa198">&#34;dubbogo&#34;</span> timeout=<span style="color:#2aa198">&#34;3000&#34;</span> interface=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span> ref=<span style="color:#2aa198">&#34;otherService&#34;</span> version=<span style="color:#2aa198">&#34;2.0&#34;</span><span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:service</span> id=<span style="color:#2aa198">&#34;ccc&#34;</span> registry=<span style="color:#2aa198">&#34;dubbogo&#34;</span> timeout=<span style="color:#2aa198">&#34;3000&#34;</span> interface=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span> ref=<span style="color:#2aa198">&#34;otherService&#34;</span> group=<span style="color:#2aa198">&#34;as&#34;</span> version=<span style="color:#2aa198">&#34;2.0&#34;</span><span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;bean</span> id=<span style="color:#2aa198">&#34;demoService&#34;</span> class=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProviderImpl&#34;</span> <span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;bean</span> id=<span style="color:#2aa198">&#34;otherService&#34;</span> class=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProviderAnotherImpl&#34;</span><span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;/beans&gt;</span> |
| </span></span></code></pre></div><p>启动Provider类,可看到输出如下日志,代表 Dubbo Server 启动成功</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>[DUBBO] DubboBootstrap is ready., dubbo version: 2.7.7, current host: 127.0.0.1 |
| </span></span><span style="display:flex;"><span>[DUBBO] DubboBootstrap has started., dubbo version: 2.7.7, current host: 127.0.0.1 |
| </span></span></code></pre></div><h4 id="go-client-启动-1">Go-Client 启动</h4> |
| <p>对于已经启动的Dubbo服务,如需要开发与其对应的Go-client,需要进行如下步骤:</p> |
| <ol> |
| <li>编写与 Java 适配的 POJO 类 User</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#719e07">import</span>( |
| </span></span><span style="display:flex;"><span> hessian <span style="color:#2aa198">&#34;github.com/apache/dubbo-go-hessian2&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 字段需要与 Java 侧对应,首字母大写 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">type</span> User <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> ID <span style="color:#dc322f">string</span> |
| </span></span><span style="display:flex;"><span> Name <span style="color:#dc322f">string</span> |
| </span></span><span style="display:flex;"><span> Age <span style="color:#dc322f">int32</span> |
| </span></span><span style="display:flex;"><span> Time time.Time |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (u <span style="color:#719e07">*</span>User) <span style="color:#268bd2">JavaClassName</span>() <span style="color:#dc322f">string</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#2aa198">&#34;org.apache.dubbo.User&#34;</span> <span style="color:#586e75">// 需要与 Java 侧 User 类名对应 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">init</span>(){ |
| </span></span><span style="display:flex;"><span> hessian.<span style="color:#268bd2">RegisterPOJO</span>(<span style="color:#719e07">&amp;</span>pkg.User{}) <span style="color:#586e75">// 注册 POJO |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>} |
| </span></span></code></pre></div><ol start="2"> |
| <li> |
| <p>编写与 Java 侧一致的客户端存根类,其接口方法需要与Java侧对应</p> |
| <p>规定第一个参数必须为 context.Context,最后一个返回值必须为 error</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span>( |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/config&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">var</span> ( |
| </span></span><span style="display:flex;"><span> userProvider = <span style="color:#719e07">&amp;</span>pkg.UserProvider{} |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// UserProvider 客户端存根类 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">type</span> UserProvider <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// dubbo标签,用于适配go侧客户端大写方法名 -&gt; java侧小写方法名,只有 dubbo 协议客户端才需要使用 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> GetUser <span style="color:#268bd2">func</span>(ctx context.Context, req <span style="color:#dc322f">int32</span>) (<span style="color:#719e07">*</span>User, <span style="color:#dc322f">error</span>) <span style="color:#2aa198">`dubbo:&#34;getUser&#34;`</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">init</span>(){ |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 注册客户端存根类到框架,实例化客户端接口指针 userProvider |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> config.<span style="color:#268bd2">SetConsumerService</span>(userProvider) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ol start="3"> |
| <li>撰写配置文件: dubbogo.yml</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: <span style="color:#586e75"># 定义注册中心ID</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeout</span>: 3s |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">references</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">UserProvider</span>: <span style="color:#586e75"># 存根类名</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: dubbo <span style="color:#586e75"># dubbo 协议,默认 hessian2 序列化方式</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: org.apache.dubbo.UserProvider <span style="color:#586e75"># 接口需要与Java侧对应</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">logger</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">zap-config</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">level</span>: info <span style="color:#586e75"># 日志级别</span> |
| </span></span></code></pre></div><p>或者使用Triple + Hessian2 序列化请求Server。本例子如果跟Java Server互通则不能用Triple。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeout</span>: 3s |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">references</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">UserProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: tri <span style="color:#586e75"># triple 协议</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">serialization</span>: hessian2 <span style="color:#586e75"># 序列化方式 hessian2,triple 协议默认为 pb 序列化,不配置会报错</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: org.apache.dubbo.UserProvider |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">logger</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">zap-config</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">level</span>: info |
| </span></span></code></pre></div><ol start="4"> |
| <li>撰写 main.go 文件,发起调用</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>(){ |
| </span></span><span style="display:flex;"><span> config.<span style="color:#268bd2">Load</span>() |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">var</span> i <span style="color:#dc322f">int32</span> = <span style="color:#2aa198">1</span> |
| </span></span><span style="display:flex;"><span> user, err <span style="color:#719e07">:=</span> userProvider.<span style="color:#268bd2">GetUser2</span>(context.<span style="color:#268bd2">TODO</span>(), i) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;response result: %v&#34;</span>, user) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ol start="5"> |
| <li>可查看到调用成功的日志,符合预期</li> |
| </ol> |
| <ul> |
| <li>go-client</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>response result: User<span style="color:#719e07">{</span>ID:1, Name:userCode get, Age:48, Time:2021-10-21 20:25:26.009 +0800 CST<span style="color:#719e07">}</span> |
| </span></span></code></pre></div><h3 id="22-java-client---go-server">2.2 Java-Client -&gt; Go-Server</h3> |
| <h4 id="go-server-启动-1">Go-Server 启动</h4> |
| <ol> |
| <li>定义配置文件</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">UserProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: org.apache.dubbo.UserProvider |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">logger</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">zap-config</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">level</span>: info |
| </span></span></code></pre></div><ol start="2"> |
| <li>引入传输结构,定义服务以及方法名映射</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">type</span> UserProvider <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (u <span style="color:#719e07">*</span>UserProvider) <span style="color:#268bd2">GetUser</span>(ctx context.Context, req <span style="color:#dc322f">int32</span>) (<span style="color:#719e07">*</span>User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">var</span> err <span style="color:#dc322f">error</span> |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;req:%#v&#34;</span>, req) |
| </span></span><span style="display:flex;"><span> user <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>User{} |
| </span></span><span style="display:flex;"><span> user.ID = strconv.<span style="color:#268bd2">Itoa</span>(<span style="color:#b58900">int</span>(req)) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> user, err |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// MethodMapper 定义方法名映射,从 Go 的方法名映射到 Java 小写方法名,只有 dubbo 协议服务接口才需要使用 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>UserProvider) <span style="color:#268bd2">MethodMapper</span>() <span style="color:#268bd2">map</span>[<span style="color:#dc322f">string</span>]<span style="color:#dc322f">string</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#268bd2">map</span>[<span style="color:#dc322f">string</span>]<span style="color:#dc322f">string</span>{ |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;GetUser&#34;</span>: <span style="color:#2aa198">&#34;getUser&#34;</span>, |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">init</span>(){ |
| </span></span><span style="display:flex;"><span> config.<span style="color:#268bd2">SetProviderService</span>(<span style="color:#719e07">&amp;</span>pkg.UserProvider{}) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ol start="3"> |
| <li>启动服务</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#586e75">// export DUBBO_GO_CONFIG_PATH=dubbogo.yml |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">Load</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">select</span> {} |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><h4 id="java-client-启动-1">Java-Client 启动</h4> |
| <ol> |
| <li> |
| <p>Java 客户端 Spring 配置</p> |
| <p>resources/META-INF.spring/dubbo.consumer.xml</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#719e07">&lt;?xml version=&#34;1.0&#34; encoding=&#34;UTF-8&#34;?&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">&lt;!-- |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Licensed under the Apache License, Version 2.0 (the &#34;License&#34;); |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> you may not use this file except in compliance with the License. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> You may obtain a copy of the License at |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> http://www.apache.org/licenses/LICENSE-2.0 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> Unless required by applicable law or agreed to in writing, software |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> distributed under the License is distributed on an &#34;AS IS&#34; BASIS, |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> See the License for the specific language governing permissions and |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"> limitations under the License. |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75">--&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;beans</span> xmlns=<span style="color:#2aa198">&#34;http://www.springframework.org/schema/beans&#34;</span> |
| </span></span><span style="display:flex;"><span> xmlns:xsi=<span style="color:#2aa198">&#34;http://www.w3.org/2001/XMLSchema-instance&#34;</span> |
| </span></span><span style="display:flex;"><span> xmlns:dubbo=<span style="color:#2aa198">&#34;http://code.alibabatech.com/schema/dubbo&#34;</span> |
| </span></span><span style="display:flex;"><span> xsi:schemaLocation=<span style="color:#2aa198">&#34;http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 消费方应用名,用于计算依赖关系,不是匹配条件,不要与提供方一样 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:application</span> name=<span style="color:#2aa198">&#34;user-info-client&#34;</span> <span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 连接到哪个本地注册中心 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:registry</span> id=<span style="color:#2aa198">&#34;dubbogo&#34;</span> address=<span style="color:#2aa198">&#34;zookeeper://127.0.0.1:2181&#34;</span> <span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- dubbo.registry.address from dubbo.properties --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- dubbo:registry address=&#34;${dubbo.registry.address}&#34; / --&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 用dubbo协议在20880端口暴露服务 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:protocol</span> id=<span style="color:#2aa198">&#34;dubbo&#34;</span> name=<span style="color:#2aa198">&#34;dubbo&#34;</span> <span style="color:#268bd2">/&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!-- 声明需要使用的服务接口 --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:reference</span> registry=<span style="color:#2aa198">&#34;dubbogo&#34;</span> check=<span style="color:#2aa198">&#34;false&#34;</span> id=<span style="color:#2aa198">&#34;userProvider&#34;</span> protocol=<span style="color:#2aa198">&#34;dubbo&#34;</span> interface=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">&lt;!--&lt;dubbo:parameter key=&#34;heartbeat&#34; value=&#34;10000&#34;/ --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dubbo:reference&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:reference</span> registry=<span style="color:#2aa198">&#34;dubbogo&#34;</span> check=<span style="color:#2aa198">&#34;false&#34;</span> id=<span style="color:#2aa198">&#34;userProvider1&#34;</span> protocol=<span style="color:#2aa198">&#34;dubbo&#34;</span> version=<span style="color:#2aa198">&#34;2.0&#34;</span> interface=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dubbo:reference&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dubbo:reference</span> registry=<span style="color:#2aa198">&#34;dubbogo&#34;</span> check=<span style="color:#2aa198">&#34;false&#34;</span> id=<span style="color:#2aa198">&#34;userProvider2&#34;</span> protocol=<span style="color:#2aa198">&#34;dubbo&#34;</span> version=<span style="color:#2aa198">&#34;2.0&#34;</span> group=<span style="color:#2aa198">&#34;as&#34;</span> interface=<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dubbo:reference&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;/beans&gt;</span> |
| </span></span></code></pre></div></li> |
| <li> |
| <p>发起调用</p> |
| </li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">Consumer</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// Define a private variable (Required in Spring) |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#268bd2">private</span> <span style="color:#268bd2">static</span> UserProvider userProvider<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">main</span><span style="color:#719e07">(</span>String<span style="color:#719e07">[]</span> args<span style="color:#719e07">)</span> <span style="color:#268bd2">throws</span> Exception <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> ClassPathXmlApplicationContext context <span style="color:#719e07">=</span> <span style="color:#719e07">new</span> ClassPathXmlApplicationContext<span style="color:#719e07">(</span><span style="color:#719e07">new</span> String<span style="color:#719e07">[]{</span><span style="color:#2aa198">&#34;META-INF/spring/dubbo.consumer.xml&#34;</span><span style="color:#719e07">});</span> |
| </span></span><span style="display:flex;"><span> userProvider <span style="color:#719e07">=</span> <span style="color:#719e07">(</span>UserProvider<span style="color:#719e07">)</span>context<span style="color:#719e07">.</span>getBean<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;userProvider&#34;</span><span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> testGetUser<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">testGetUser</span><span style="color:#719e07">()</span> <span style="color:#268bd2">throws</span> Exception <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> User user <span style="color:#719e07">=</span> userProvider<span style="color:#719e07">.</span>getUser<span style="color:#719e07">(</span>1<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#719e07">.</span>out<span style="color:#719e07">.</span>println<span style="color:#719e07">(</span>user<span style="color:#719e07">.</span>getId<span style="color:#719e07">());</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div></description></item><item><title>Docs: Dubbo-go 数据上报</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/metrics/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/metrics/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/governance/monitor/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-30-数据上报">Dubbo-go 3.0 数据上报</h1> |
| <p>参考Samples: <a href="https://github.com/apache/dubbo-go-samples/tree/master/metrics">dubbo-go-samples/metrics</a></p> |
| <h2 id="1-数据上报配置">1. 数据上报配置</h2> |
| <p>在不指定 metrics: 字段的时候,默认开启拉模式 prometheus 数据上报,端口默认为9090,监听path默认为/metrics。可参考如下服务端配置例子来定制化。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">application</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">version</span>: <span style="color:#2aa198">3.0.0</span>-rc3 <span style="color:#586e75"># 版本号</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">metrics</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">enable</span>: <span style="color:#cb4b16">true</span> <span style="color:#586e75"># default is true</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">path</span>: /custom-metrics-path <span style="color:#586e75"># default is /metrics</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">9091</span> <span style="color:#586e75"># default is 9090</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">namespace</span>: dubbo <span style="color:#586e75"># default is dubbo 作为数据上报 metrics 的前缀</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">myzk</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: localhost:2181 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: dubbo-go <span style="color:#586e75"># 所属 group,需要与客户端一致</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.HelloService <span style="color:#586e75"># 接口名</span> |
| </span></span></code></pre></div><h2 id="2-默认数据上报指标">2. 默认数据上报指标</h2> |
| <p>本地启动上述服务端后,可于 localhost:9091/custom-metrics-path 收集到默认数据指标,包含gc、goroutine数目,内存占用情况等。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#586e75"># HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_gc_duration_seconds summary</span> |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds{quantile=&#34;0&#34;} 3.0916e-05 |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds{quantile=&#34;0.25&#34;} 3.0916e-05 |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds{quantile=&#34;0.5&#34;} 3.1167e-05 |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds{quantile=&#34;0.75&#34;} 0.000164084 |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds{quantile=&#34;1&#34;} 0.000164084 |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds_sum 0.000226167 |
| </span></span><span style="display:flex;"><span>go_gc_duration_seconds_count 3 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_goroutines Number of goroutines that currently exist.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_goroutines gauge</span> |
| </span></span><span style="display:flex;"><span>go_goroutines 25 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_info Information about the Go environment.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_info gauge</span> |
| </span></span><span style="display:flex;"><span>go_info{version=&#34;go1.17.2&#34;} 1 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_alloc_bytes Number of bytes allocated and still in use.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_alloc_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_alloc_bytes 6.195808e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_alloc_bytes_total counter</span> |
| </span></span><span style="display:flex;"><span>go_memstats_alloc_bytes_total 9.482768e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_buck_hash_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_buck_hash_sys_bytes 1.449179e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_frees_total Total number of frees.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_frees_total counter</span> |
| </span></span><span style="display:flex;"><span>go_memstats_frees_total 29419 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_gc_cpu_fraction The fraction of this program&#39;s available CPU time used by the GC since the program started.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_gc_cpu_fraction gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_gc_cpu_fraction 0.022937924367975027 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_gc_sys_bytes Number of bytes used for garbage collection system metadata.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_gc_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_gc_sys_bytes 5.235864e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_heap_alloc_bytes Number of heap bytes allocated and still in use.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_heap_alloc_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_heap_alloc_bytes 6.195808e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_heap_idle_bytes Number of heap bytes waiting to be used.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_heap_idle_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_heap_idle_bytes 3.792896e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_heap_inuse_bytes Number of heap bytes that are in use.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_heap_inuse_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_heap_inuse_bytes 8.036352e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_heap_objects Number of allocated objects.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_heap_objects gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_heap_objects 16489 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_heap_released_bytes Number of heap bytes released to OS.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_heap_released_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_heap_released_bytes 3.416064e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_heap_sys_bytes Number of heap bytes obtained from system.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_heap_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_heap_sys_bytes 1.1829248e+07 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_last_gc_time_seconds Number of seconds since 1970 of last garbage collection.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_last_gc_time_seconds gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_last_gc_time_seconds 1.635778234064745e+09 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_lookups_total Total number of pointer lookups.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_lookups_total counter</span> |
| </span></span><span style="display:flex;"><span>go_memstats_lookups_total 0 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_mallocs_total Total number of mallocs.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_mallocs_total counter</span> |
| </span></span><span style="display:flex;"><span>go_memstats_mallocs_total 45908 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_mcache_inuse_bytes Number of bytes in use by mcache structures.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_mcache_inuse_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_mcache_inuse_bytes 9600 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_mcache_sys_bytes Number of bytes used for mcache structures obtained from system.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_mcache_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_mcache_sys_bytes 16384 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_mspan_inuse_bytes Number of bytes in use by mspan structures.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_mspan_inuse_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_mspan_inuse_bytes 116144 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_mspan_sys_bytes Number of bytes used for mspan structures obtained from system.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_mspan_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_mspan_sys_bytes 131072 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_next_gc_bytes Number of heap bytes when next garbage collection will take place.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_next_gc_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_next_gc_bytes 7.935184e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_other_sys_bytes Number of bytes used for other system allocations.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_other_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_other_sys_bytes 1.426069e+06 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_stack_inuse_bytes Number of bytes in use by the stack allocator.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_stack_inuse_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_stack_inuse_bytes 753664 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_stack_sys_bytes Number of bytes obtained from system for stack allocator.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_stack_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_stack_sys_bytes 753664 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_memstats_sys_bytes Number of bytes obtained from system.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_memstats_sys_bytes gauge</span> |
| </span></span><span style="display:flex;"><span>go_memstats_sys_bytes 2.084148e+07 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP go_threads Number of OS threads created.</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE go_threads gauge</span> |
| </span></span><span style="display:flex;"><span>go_threads 12 |
| </span></span></code></pre></div><h2 id="3-调用指标-rt">3. 调用指标 RT</h2> |
| <p>启动例子中的客户端,经过几次调用后,会发现增加了对应的数据指标,以默认namespace dubbo 为前缀。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_provider_service_rt </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_provider_service_rt gauge</span> |
| </span></span><span style="display:flex;"><span>dubbo_provider_service_rt{group=&#34;dubbo-go&#34;,method=&#34;SayHello&#34;,service=&#34;com.apache.dubbo.HelloService&#34;,timeout=&#34;&#34;,version=&#34;3.0.0-rc3&#34;} 127542 |
| </span></span></code></pre></div><p>可看到对应接口名、方法名的请求rt时间。该部分调用指标待后续完善。</p> |
| <h2 id="4-手动数据上报">4. 手动数据上报</h2> |
| <p>可在业务代码中调用API进行手动数据上报。支持Counter、Summary、Gauge 类型,并支持多个标签。上报后即可收集。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#719e07">import</span> <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/metrics/prometheus&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">for</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// metrics refresh per second |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> time.<span style="color:#268bd2">Sleep</span>(time.Second) |
| </span></span><span style="display:flex;"><span> prometheus.<span style="color:#268bd2">IncSummary</span>(<span style="color:#2aa198">&#34;test_summary&#34;</span>, rand.<span style="color:#268bd2">Float64</span>()) |
| </span></span><span style="display:flex;"><span> prometheus.<span style="color:#268bd2">IncSummaryWithLabel</span>(<span style="color:#2aa198">&#34;test_summary_with_label&#34;</span>, rand.<span style="color:#268bd2">Float64</span>(), <span style="color:#268bd2">map</span>[<span style="color:#dc322f">string</span>]<span style="color:#dc322f">string</span>{ |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;summarylabel1&#34;</span>: <span style="color:#2aa198">&#34;value1&#34;</span>, <span style="color:#586e75">// label and value for this summary |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#2aa198">&#34;summarylabel2&#34;</span>: <span style="color:#2aa198">&#34;value2&#34;</span>, |
| </span></span><span style="display:flex;"><span> }) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> prometheus.<span style="color:#268bd2">IncCounter</span>(<span style="color:#2aa198">&#34;test_counter&#34;</span>) |
| </span></span><span style="display:flex;"><span> prometheus.<span style="color:#268bd2">IncCounterWithLabel</span>(<span style="color:#2aa198">&#34;test_counter_with_label&#34;</span>, <span style="color:#268bd2">map</span>[<span style="color:#dc322f">string</span>]<span style="color:#dc322f">string</span>{ |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;counterlabel1&#34;</span>: <span style="color:#2aa198">&#34;value1&#34;</span>, <span style="color:#586e75">// label and value for this counter |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#2aa198">&#34;counterlabel2&#34;</span>: <span style="color:#2aa198">&#34;value2&#34;</span>, |
| </span></span><span style="display:flex;"><span> }) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> prometheus.<span style="color:#268bd2">SetGauge</span>(<span style="color:#2aa198">&#34;test_gauge&#34;</span>, rand.<span style="color:#268bd2">Float64</span>()) |
| </span></span><span style="display:flex;"><span> prometheus.<span style="color:#268bd2">SetGaugeWithLabel</span>(<span style="color:#2aa198">&#34;test_gauge_with_label&#34;</span>, rand.<span style="color:#268bd2">Float64</span>(), <span style="color:#268bd2">map</span>[<span style="color:#dc322f">string</span>]<span style="color:#dc322f">string</span>{ |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;gaugelabel1&#34;</span>: <span style="color:#2aa198">&#34;value1&#34;</span>, |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;gaugelabel2&#34;</span>: <span style="color:#2aa198">&#34;value2&#34;</span>, |
| </span></span><span style="display:flex;"><span> }) |
| </span></span><span style="display:flex;"><span> } |
| </span></span></code></pre></div><p>运行一段时间后,可以收集到如下用户定义指标</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_test_counter </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_test_counter counter</span> |
| </span></span><span style="display:flex;"><span>dubbo_test_counter 463 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_test_counter_with_label </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_test_counter_with_label counter</span> |
| </span></span><span style="display:flex;"><span>dubbo_test_counter_with_label{counterlabel1=&#34;value1&#34;,counterlabel2=&#34;value2&#34;} 463 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_test_gauge </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_test_gauge gauge</span> |
| </span></span><span style="display:flex;"><span>dubbo_test_gauge 0.7402836247772934 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_test_gauge_with_label </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_test_gauge_with_label gauge</span> |
| </span></span><span style="display:flex;"><span>dubbo_test_gauge_with_label{gaugelabel1=&#34;value1&#34;,gaugelabel2=&#34;value2&#34;} 0.8360973807546456 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_test_summary </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_test_summary summary</span> |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_sum 228.1800106582441 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_count 463 |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># HELP dubbo_test_summary_with_label </span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># TYPE dubbo_test_summary_with_label summary</span> |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;,quantile=&#34;0.5&#34;} 0.5174757569778469 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;,quantile=&#34;0.75&#34;} 0.734268575017709 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;,quantile=&#34;0.9&#34;} 0.9059918694279894 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;,quantile=&#34;0.98&#34;} 0.9761803018478838 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;,quantile=&#34;0.99&#34;} 0.9820270046489341 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;,quantile=&#34;0.999&#34;} 0.9986025122460248 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label_sum{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;} 233.609026131067 |
| </span></span><span style="display:flex;"><span>dubbo_test_summary_with_label_count{summarylabel1=&#34;value1&#34;,summarylabel2=&#34;value2&#34;} 463 |
| </span></span></code></pre></div></description></item><item><title>Docs: dubbo-go 3.0 示例仓库</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/samples_repo/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/samples_repo/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/preface/samples/">最新版本</a>。</p> |
| </div> |
| <p>为了方便 Dubbo-go 框架用户的使用,我们提供了 Samples 仓库以供用户参考:</p> |
| <p><a href="https://github.com/apache/dubbo-go-samples">【Dubbo-go-samples 仓库地址】</a></p> |
| <h2 id="1-samples-仓库包含的例子">1. Samples 仓库包含的例子</h2> |
| <ul> |
| <li>config-api: 使用 API 进行配置初始化</li> |
| <li>configcenter: 使用不同的配置中心,目前支持三种:zookeeper、apollo、和 nacos</li> |
| <li>context: 如何使用上下文传递 attachment</li> |
| <li>direct: 直连模式</li> |
| <li>game: 游戏服务例子</li> |
| <li>generic: 泛化调用</li> |
| <li>rpc: RPC 调用例子, 包含 Triple、Dubbo等协议以及跨语言/gRPC互通示例</li> |
| <li>helloworld: RPC调用入门例子</li> |
| <li>logger: 日志例子</li> |
| <li>registry: 展示与不同注册中心的对接,包含了 zk、nacos、etcd</li> |
| <li>metrics: 数据上报</li> |
| <li>filter: 使用提供filter和自定义filter的例子</li> |
| <li>registry/servicediscovery:应用级服务发现例子</li> |
| <li>router: 路由例子</li> |
| <li>tracing: 链路追踪例子</li> |
| </ul> |
| <h2 id="2-如何运行">2. 如何运行</h2> |
| <p>目前有三种方式来运行 dubbo-go 的示例:</p> |
| <ol> |
| <li>通过 bash 命令快速开始: 通过简单的命令行启动样例以及进行单元测试</li> |
| <li>在 IDE 中快速开始,这也是<strong>推荐</strong>的方式: 在工程 &ldquo;.run&rdquo; 子目录下,提供了所有示例的 GoLand 运行配置文件,因此用户可以简单在 IDE 中单击运行所有的示例。</li> |
| <li>在 IDE 中手工配置并运行: 为了完整性的目的,也为了万一您不使用 GoLand 而使用其他的 IDE,这里也提供了如何一步一步的配置的指南,帮助用户理解如何在 IDE 中配置,运行或者调试 dubbo-go 的示例。</li> |
| </ol> |
| <h3 id="21-通过-命令行-快速开始">2.1 通过 命令行 快速开始</h3> |
| <p><em>前置条件:需要 docker 环境就绪</em></p> |
| <p>下面我们将使用 &ldquo;helloworld&rdquo; 作为示例:</p> |
| <ol> |
| <li> |
| <p><strong>启动注册中心(比如 zookeeper)</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>make -f build/Makefile docker-up |
| </span></span></code></pre></div><p>当看到类似下面的输出信息时,就表明 zookeeper server 启动就绪了。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>&gt; Starting dependency services with ./integrate_test/dockercompose/docker-compose.yml |
| </span></span><span style="display:flex;"><span>Docker Compose is now in the Docker CLI, try <span style="color:#586e75">`</span>docker compose up<span style="color:#586e75">`</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>Creating network <span style="color:#2aa198">&#34;dockercompose_default&#34;</span> with the default driver |
| </span></span><span style="display:flex;"><span>Creating dockercompose_zookeeper_1 ... <span style="color:#719e07">done</span> |
| </span></span><span style="display:flex;"><span>Creating etcd ... <span style="color:#719e07">done</span> |
| </span></span><span style="display:flex;"><span>Creating nacos-standalone ... <span style="color:#719e07">done</span> |
| </span></span></code></pre></div><p>如果要停掉注册中心,可以通过运行以下的命令完成:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>make -f build/Makefile docker-down |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>启动服务提供方</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> helloworld/go-server/cmd |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go run . |
| </span></span></code></pre></div><p>当看到类似下面的输出信息时,就表明服务提供方启动就绪了。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>2021/10/27 00:33:10 Connected to 127.0.0.1:2181 |
| </span></span><span style="display:flex;"><span>2021/10/27 00:33:10 Authenticated: <span style="color:#268bd2">id</span><span style="color:#719e07">=</span>72057926938066944, <span style="color:#268bd2">timeout</span><span style="color:#719e07">=</span><span style="color:#2aa198">10000</span> |
| </span></span><span style="display:flex;"><span>2021/10/27 00:33:10 Re-submitting <span style="color:#586e75">`</span>0<span style="color:#586e75">`</span> credentials after reconnect |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>运行服务调用方</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> helloworld/go-client/cmd |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go run . |
| </span></span></code></pre></div><p>当以下的信息输出时,说明 <code>go-client</code> 调用 <code>go-server</code> 成功。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>2021-10-27T00:40:44.879+0800 DEBUG triple/dubbo3_client.go:106 TripleClient.Invoke: get <span style="color:#268bd2">reply</span> <span style="color:#719e07">=</span> name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;12345&#34;</span> age:21 |
| </span></span><span style="display:flex;"><span>2021-10-27T00:40:44.879+0800 DEBUG proxy/proxy.go:218 <span style="color:#719e07">[</span>makeDubboCallProxy<span style="color:#719e07">]</span> result: name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;12345&#34;</span> age:21 , err: &lt;nil&gt; |
| </span></span><span style="display:flex;"><span>2021-10-27T00:40:44.879+0800 INFO cmd/client.go:51 client response result: name:<span style="color:#2aa198">&#34;Hello laurence&#34;</span> id:<span style="color:#2aa198">&#34;12345&#34;</span> age:21 |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>集成测试</strong> |
| 本项目 dubbo-go-samples 除了用来展示如何使用 dubbo-go 中的功能和特性之外,还被用于 apache/dubbo-go 的集成测试。可以按照以下的步骤来运行针对 <code>go-server</code> 设计的集成测试:</p> |
| <p>首先启动服务方</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> helloworld/go-server/cmd |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go run . |
| </span></span></code></pre></div><p>然后切换到单测目录, 设置环境变量,然后执行单测</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#b58900">cd</span> integrate_test/helloworld/tests/integration |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">export</span> <span style="color:#268bd2">DUBBO_GO_CONFIG_PATH</span><span style="color:#719e07">=</span><span style="color:#2aa198">&#34;../../../../helloworld/go-client/conf/dubbogo.yml&#34;</span> |
| </span></span><span style="display:flex;"><span>go <span style="color:#b58900">test</span> -v |
| </span></span></code></pre></div><p>当以下信息输出时,说明集成测试通过。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>&gt; Running integration <span style="color:#b58900">test</span> <span style="color:#719e07">for</span> application go-server |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span>--- PASS: TestSayHello <span style="color:#719e07">(</span>0.01s<span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span>PASS |
| </span></span><span style="display:flex;"><span>ok github.com/apache/dubbo-go-samples/integrate_test/helloworld/tests/integration 0.119s |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>关闭并清理</strong></p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>make -f build/Makefile clean docker-down |
| </span></span></code></pre></div></li> |
| </ol> |
| <p><em>以下的两种运行方式都与 IDE 有关。这里我们以 Intellij GoLand 为例来讨论。</em></p> |
| <h3 id="22-在-ide-中快速开始">2.2 在 IDE 中快速开始</h3> |
| <p>一旦在 GoLand 中打开本项目,可以发现,在 &ldquo;Run Configuration&rdquo; 弹出菜单中已经存在了一系列事先配置好了的用来运行相关服务提供方和调用方的选项,例如:&ldquo;helloworld-go-server&rdquo; 和 &ldquo;helloworld-go-client&rdquo;。</p> |
| <p>可以选择其中的任意一个快速启动相关示例。当然在运行之前,假设需要的注册中心已经事先启动了,不然用例将会失败。您可以选择手动自行启动的方式,也可以利用工程中提供的 &ldquo;docker-compose.yml&rdquo; 在启动注册中心的 docker 实例。</p> |
| <h3 id="23在-ide-中手工运行">2.3.在 IDE 中手工运行</h3> |
| <p>这里以 <em>Intellij GoLand</em> 为例。在 GoLand 中打开 dubbo-go-samples 工程之后,按照以下的步骤来运行/调试本示例:</p> |
| <ol> |
| <li> |
| <p><strong>启动 zookeeper 服务器</strong></p> |
| <p>打开 &ldquo;integrate_test/dockercompose/docker-compose.yml&rdquo; 这个文件,然后点击位于编辑器左边 gutter 栏位中的 ▶︎▶︎ 图标运行,&ldquo;Service&rdquo; Tab 应当会弹出并输出类似下面的文本信息:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>Deploying &#39;Compose: docker&#39;... |
| </span></span><span style="display:flex;"><span>/usr/local/bin/docker-compose -f ...integrate_test/dockercompose/docker-compose.yml up -d |
| </span></span><span style="display:flex;"><span>Creating network &#34;docker_default&#34; with the default driver |
| </span></span><span style="display:flex;"><span>Creating docker_zookeeper_1 ... |
| </span></span><span style="display:flex;"><span>&#39;Compose: docker&#39; has been deployed successfully. |
| </span></span></code></pre></div></li> |
| <li> |
| <p><strong>启动服务提供方</strong></p> |
| <p>打开 &ldquo;helloworld/go-server/cmd/server.go&rdquo; 文件,然后点击左边 gutter 栏位中紧挨着 &ldquo;main&rdquo; 函数的 ▶︎ 图标,并从弹出的菜单中选择 &ldquo;Modify Run Configuration&hellip;&quot;,并确保以下配置的准确:</p> |
| <ul> |
| <li>Working Directory: &ldquo;helloworld/go-server&rdquo; 目录的绝对路径,比如: <em>/home/dubbo-go-samples/helloworld/go-server</em></li> |
| <li>Environment: DUBBO_GO_CONFIG_PATH=&rdquo;../conf/dubbogo.yml&quot;</li> |
| </ul> |
| <p>这样示例中的服务端就准备就绪,随时可以运行了。</p> |
| </li> |
| <li> |
| <p><strong>运行服务消费方</strong></p> |
| <p>打开 &ldquo;helloworld/go-client/cmd/client.go&rdquo; 这个文件,然后从左边 gutter 栏位中点击紧挨着 &ldquo;main&rdquo; 函数的 ▶︎ 图标,然后从弹出的菜单中选择 &ldquo;Modify Run Configuration&hellip;&quot;,并确保以下配置的准确:</p> |
| <ul> |
| <li>Working Directory: &ldquo;helloworld/go-client&rdquo; 目录的绝对路径,比如: <em>/home/dubbo-go-samples/helloworld/go-client</em></li> |
| <li>Environment: DUBBO_GO_CONFIG_PATH=&rdquo;../conf/dubbogo.yml&quot;</li> |
| </ul> |
| <p>然后就可以运行并调用远端的服务了,如果调用成功,将会有以下的输出:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>[2021-02-03/16:19:30 main.main: client.go: 66] response result: &amp;{A001 Alex Stocks 18 2020-02-04 16:19:30.422 +0800 CST} |
| </span></span></code></pre></div></li> |
| </ol> |
| <p>如果需要调试该示例或者 dubbo-go 框架,可以在 IDE 中从 &ldquo;Run&rdquo; 切换到 &ldquo;Debug&rdquo;。如果要结束的话,直接点击 ◼︎ 就好了。</p></description></item><item><title>Docs: Dubbo-go 3.0 异常回传</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/exception_response/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/exception_response/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/protocol/exception_response/">最新版本</a>。</p> |
| </div> |
| <h1 id="triple-协议异常回传">Triple 协议异常回传</h1> |
| <p>参考samples <a href="https://github.com/apache/dubbo-go-samples/tree/master/error">dubbo-go-samples/error</a></p> |
| <h2 id="用户异常回传介绍">用户异常回传介绍</h2> |
| <p>用户可以在 provider 端生成用户定义的异常信息,可以记录异常产生堆栈,triple 协议可保证将用户在客户端获取到异常 message ,并可以查看报错堆栈,便于定位问题。</p> |
| <p>注意返回 error 非 nil 时,框架不负责其他返回值的传递。</p> |
| <ul> |
| <li>在Triple provider 端返回异常,以 pb 序列化为例:</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#719e07">package</span> main |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> ( |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;context&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> ( |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/common/logger&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 使用可以记录对战信息的异常库,此处以 &#34;github.com/pkg/errors&#34; 为例 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#2aa198">&#34;github.com/pkg/errors&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> ( |
| </span></span><span style="display:flex;"><span> triplepb <span style="color:#2aa198">&#34;github.com/apache/dubbo-go-samples/api&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 一个实现了 pb 接口的服务提供结构 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">type</span> ErrorResponseProvider <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> triplepb.UnimplementedGreeterServer |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 回传错误的接口 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>ErrorResponseProvider) <span style="color:#268bd2">SayHello</span>(ctx context.Context, in <span style="color:#719e07">*</span>triplepb.HelloRequest) (<span style="color:#719e07">*</span>triplepb.User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;Dubbo3 GreeterProvider get user name = %s\n&#34;</span> <span style="color:#719e07">+</span> in.Name) |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 返回用户自定义异常 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>triplepb.User{Name: <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> in.Name, Id: <span style="color:#2aa198">&#34;12345&#34;</span>, Age: <span style="color:#2aa198">21</span>}, errors.<span style="color:#268bd2">New</span>(<span style="color:#2aa198">&#34;user defined error&#34;</span>) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><ul> |
| <li>客户端打印异常和堆栈</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#719e07">package</span> main |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> ( |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;context&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> ( |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/common/logger&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/config&#34;</span> |
| </span></span><span style="display:flex;"><span> _ <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/imports&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> tripleCommon <span style="color:#2aa198">&#34;github.com/dubbogo/triple/pkg/common&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> ( |
| </span></span><span style="display:flex;"><span> triplepb <span style="color:#2aa198">&#34;github.com/apache/dubbo-go-samples/api&#34;</span> |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">var</span> greeterProvider = <span style="color:#b58900">new</span>(triplepb.GreeterClientImpl) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">init</span>() { |
| </span></span><span style="display:flex;"><span> config.<span style="color:#268bd2">SetConsumerService</span>(greeterProvider) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">Load</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> req <span style="color:#719e07">:=</span> triplepb.HelloRequest{ |
| </span></span><span style="display:flex;"><span> Name: <span style="color:#2aa198">&#34;laurence&#34;</span>, |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 发起调用 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#719e07">if</span> user, err <span style="color:#719e07">:=</span> greeterProvider.<span style="color:#268bd2">SayHello</span>(context.<span style="color:#268bd2">TODO</span>(), <span style="color:#719e07">&amp;</span>req); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 打印异常信息,err.Error() 将返回用户定义的 message,即 user defined error |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;response result: %v, error = %s&#34;</span>, user, err) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 打印异常堆栈,需断言为 tripleCommon.TripleError |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;error details = %+v&#34;</span>, err.(tripleCommon.TripleError).<span style="color:#268bd2">Stacks</span>()) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>2021-11-12T18:36:33.730+0800 INFO cmd/client.go:53 response result: , error = user defined error |
| </span></span><span style="display:flex;"><span>2021-11-12T18:36:33.730+0800 INFO cmd/client.go:54 error details = [type.googleapis.com/google.rpc.DebugInfo]:{stack_entries:&#34;user defined error |
| </span></span><span style="display:flex;"><span>main.(*ErrorResponseProvider).SayHello |
| </span></span><span style="display:flex;"><span> /dubbo-go-samples/error/triple/pb/go-server/cmd/error_reponse.go:40 |
| </span></span><span style="display:flex;"><span>reflect.Value.call |
| </span></span><span style="display:flex;"><span> /usr/local/go/src/reflect/value.go:543 |
| </span></span><span style="display:flex;"><span>reflect.Value.Call |
| </span></span><span style="display:flex;"><span> /usr/local/go/src/reflect/value.go:339 |
| </span></span><span style="display:flex;"><span>dubbo.apache.org/dubbo-go/v3/common/proxy/proxy_factory.(*ProxyInvoker).Invoke |
| </span></span><span style="display:flex;"><span> /Users/laurence/go/pkg/mod/dubbo.apache.org/dubbo-go/v3@v3.0.0-rc4-1/common/proxy/proxy_factory/default.go:145 |
| </span></span><span style="display:flex;"><span> ... |
| </span></span></code></pre></div><p>可看到报错信息和堆栈</p></description></item><item><title>Docs: Dubbo-go 泛化调用</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/generic/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/generic/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/features/generic/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-泛化调用">Dubbo-go 泛化调用</h1> |
| <h2 id="1-dubbo-go-泛化调用-java-server">1. Dubbo-go 泛化调用 Java Server</h2> |
| <p>使用 Triple 协议 + hessian2 序列化方案</p> |
| <p>可参考Dubbo-go 3.0 <a href="https://www.yuque.com/docs/share/f4e72670-74ab-45b9-bc0c-4b42249ed953?#">泛化调用文档</a></p> |
| <h3 id="11-java-server启动">1.1 Java-Server启动</h3> |
| <ol> |
| <li>传输结构定义</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> java.io.Serializable<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> java.util.Date<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">User</span> <span style="color:#268bd2">implements</span> Serializable <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> String id<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> String name<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> <span style="color:#dc322f">int</span> age<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> Date time <span style="color:#719e07">=</span> <span style="color:#719e07">new</span> Date<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="2"> |
| <li>接口定义</li> |
| </ol> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.dubbo<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> java.util.ArrayList<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> java.util.List<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> java.util.Map<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">//import org.apache.dubbo.rpc.filter.GenericFilter; |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">interface</span> <span style="color:#268bd2">UserProvider</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> User <span style="color:#268bd2">GetUser1</span><span style="color:#719e07">(</span>String userId<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><h3 id="12-go-client-泛化调用">1.2 Go-Client 泛化调用</h3> |
| <p>此处展示以 API 的形式构造泛化接口引用</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#586e75">// 初始化 Reference 配置 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>refConf <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">NewReferenceConfigBuilder</span>(). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetInterface</span>(<span style="color:#2aa198">&#34;org.apache.dubbo.UserProvider&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetRegistryIDs</span>(<span style="color:#2aa198">&#34;zk&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetProtocol</span>(tripleConst.TRIPLE). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetGeneric</span>(<span style="color:#cb4b16">true</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetSerialization</span>(<span style="color:#2aa198">&#34;hessian2&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Build</span>() |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 构造 Root 配置,引入注册中心模块 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>rootConfig <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">NewRootConfigBuilder</span>(). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">AddRegistry</span>(<span style="color:#2aa198">&#34;zk&#34;</span>, config.<span style="color:#268bd2">NewRegistryConfigWithProtocolDefaultPort</span>(<span style="color:#2aa198">&#34;zookeeper&#34;</span>)). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Build</span>() |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// Reference 配置初始化,因为需要使用注册中心进行服务发现,需要传入经过配置的 rootConfig |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> refConf.<span style="color:#268bd2">Init</span>(rootConfig); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span>{ |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 泛化调用加载、服务发现 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>refConf.<span style="color:#268bd2">GenericLoad</span>(appName) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>time.<span style="color:#268bd2">Sleep</span>(time.Second) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// 发起泛化调用 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>resp, err <span style="color:#719e07">:=</span> refConf.<span style="color:#268bd2">GetRPCService</span>().(<span style="color:#719e07">*</span>generic.GenericService).<span style="color:#268bd2">Invoke</span>( |
| </span></span><span style="display:flex;"><span> context.<span style="color:#268bd2">TODO</span>(), |
| </span></span><span style="display:flex;"><span> <span style="color:#2aa198">&#34;getUser1&#34;</span>, |
| </span></span><span style="display:flex;"><span> []<span style="color:#dc322f">string</span>{<span style="color:#2aa198">&#34;java.lang.String&#34;</span>}, |
| </span></span><span style="display:flex;"><span> []hessian.Object{<span style="color:#2aa198">&#34;A003&#34;</span>}, |
| </span></span><span style="display:flex;"><span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span>logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;GetUser1(userId string) res: %+v&#34;</span>, resp) |
| </span></span></code></pre></div><p>GenericService 的 Invoke 方法包括三个参数:context.Context, []string, []hessian.Object,</p> |
| <p>其中第二个参数为对应参数的 Java 类名,例如java.lang.String、org.apache.dubbo.User,第三个参数为参数列表,hessian.Object 即为 interface。第二、第三个参数应与方法签名一致,按顺序对应。</p> |
| <p>获得map结构的返回结果</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>INFO cmd/client.go:89 GetUser1(userId string) res: map[age:48 class:org.apache.dubbo.User id:A003 name:Joe sex:MAN time:2021-10-04 14:03:03.37 +0800 CST] |
| </span></span></code></pre></div></description></item><item><title>Docs: Dubbo-go v3 统一路由规则</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/mesh_router/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/mesh_router/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/governance/traffic/mesh_router/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-v3-mesh路由规则">Dubbo-go v3 Mesh路由规则</h1> |
| <h2 id="路由规则介绍">路由规则介绍</h2> |
| <p><a href="https://www.yuque.com/docs/share/c132d5db-0dcb-487f-8833-7c7732964bd4?#">《微服务Mesh路由方案草案V2》</a></p> |
| <h2 id="简介">简介</h2> |
| <p>路由规则,简单来说就是根据<strong>特定的条件</strong>,将<strong>特定的请求</strong>流量发送到<strong>特定的服务提供者</strong>。从而实现流量的分配。</p> |
| <p>在 Dubbo3 统一路由规则的定义中,需要提供两个yaml格式的资源:virtual service 和 destination rule。其格式和 service mesh 定义的路由规则非常相似。</p> |
| <ul> |
| <li>virtual service</li> |
| </ul> |
| <p>定义host,用于和destination rule建立联系。<br> |
| 定义 service 匹配规则<br> |
| 定义 match 匹配规则<br> |
| 匹配到特定请求后,进行目标集群的查找和验证,对于为空情况,使用 fallback 机制。</p> |
| <ul> |
| <li>destination rule</li> |
| </ul> |
| <p>定义特定集群子集,以及子集所适配的标签,标签从 provider 端暴露的 url 中获取,并尝试匹配。</p> |
| <h2 id="提供能力">提供能力</h2> |
| <h3 id="基于配置中心的路由配置">基于配置中心的路由配置</h3> |
| <p>sample示例参见<a href="https://github.com/apache/dubbo-go-samples/tree/master/route/meshroute">Mesh Router</a></p> |
| <h4 id="1-路由规则文件注解">1. 路由规则文件注解</h4> |
| <p>路由规则只针对客户端,对于服务端,只需要在服务提供时打好特定的参数标签即可。</p> |
| <h5 id="11-virtual-service">1.1 virtual-service</h5> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: service.dubbo.apache.org/v1alpha1 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">kind</span>: VirtualService |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">metadata</span>: {<span style="color:#268bd2">name</span>: demo-route} |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">spec</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 使用正则表达式匹配service名,只有个满足该service名的请求才能路由。</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 就此例子来说,不满足service名的请求会直接找不到provider</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># - services:</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># - { regex: org.apache.dubbo.UserProvider* }</span> |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">routedetail</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">match</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 匹配规则,如果(sourceLabel)客户端url满足存在参数 `trafficLabel: xxx` 的才能匹配成功</span> |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">sourceLabels</span>: {<span style="color:#268bd2">trafficLabel</span>: xxx} |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: xxx-project |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">route</span>: <span style="color:#586e75"># 一旦匹配上述match规则,将选择 dest_rule 里定义的名为 isolation 的子集</span> |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">destination</span>: {<span style="color:#268bd2">host: demo, subset</span>: isolation} |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">match</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">sourceLabels</span>: {<span style="color:#268bd2">trafficLabel</span>: testing-trunk} |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: testing-trunk |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">route</span>: <span style="color:#586e75"># 一旦匹配上述match规则,将选择 dest_rule 里定义的名为 testing-trunk 的子集</span> |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">destination</span>: {<span style="color:#268bd2">host: demo, subset</span>: testing-trunk} |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">name</span>: testing <span style="color:#586e75"># 没有match,兜底逻辑,上述不满足后一定会被匹配到。</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">route</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">destination</span>: {<span style="color:#268bd2">host: demo, subset</span>: testing} |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> - {<span style="color:#268bd2">exact</span>: com.apache.dubbo.sample.basic.IGreeter} |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">hosts</span>: [demo] <span style="color:#586e75"># 匹配dest_rule.yml里面的 host 为demo</span> |
| </span></span></code></pre></div><h5 id="12-destination-rule">1.2 destination-rule</h5> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">apiVersion</span>: service.dubbo.apache.org/v1alpha1 |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">kind</span>: DestinationRule |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">metadata</span>: { <span style="color:#268bd2">name</span>: demo-route } |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">spec</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">host</span>: demo |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">subsets</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">labels</span>: { <span style="color:#268bd2">env-sign: xxx, tag1</span>: hello } |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: isolation |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">labels</span>: { <span style="color:#268bd2">env-sign</span>: yyy } |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: testing-trunk |
| </span></span><span style="display:flex;"><span> - <span style="color:#268bd2">labels</span>: { <span style="color:#268bd2">env-sign</span>: zzz } |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: testing |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">trafficPolicy</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">loadBalancer</span>: { <span style="color:#268bd2">simple</span>: ROUND_ROBIN } |
| </span></span></code></pre></div><h4 id="2-clientserver-路由参数设置">2. client、server 路由参数设置</h4> |
| <ul> |
| <li> |
| <p>client 端</p> |
| <p>dubbogo.yml</p> |
| <p>定义配置中心</p> |
| </li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span> <span style="color:#268bd2">config-center</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">data-id</span>: <span style="color:#2aa198">&#34;dubbo-go-samples-configcenter-zookeeper-client&#34;</span> |
| </span></span></code></pre></div><p>在代码中通过 API 将配置发布至配置中心,也可预先手动配置。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span>dynamicConfiguration, err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">GetRootConfig</span>().ConfigCenter.<span style="color:#268bd2">GetDynamicConfiguration</span>() |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// publish mesh route config |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>err = dynamicConfiguration.<span style="color:#268bd2">PublishConfig</span>(<span style="color:#2aa198">&#34;dubbo.io.MESHAPPRULE&#34;</span>, <span style="color:#2aa198">&#34;dubbo&#34;</span>, MeshRouteConf) |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>server 端</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeout</span>: 3s |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter <span style="color:#586e75"># must be compatible with grpc or dubbo-java</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">params</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">env-sign</span>: zzz <span style="color:#586e75"># server label, 对应 destination Rule中的testing,即兜底逻辑</span> |
| </span></span></code></pre></div><h4 id="3-运行方法">3. 运行方法</h4> |
| <p>直接使用goland运行本示例</p> |
| <p>运行后,可观测到所有客户端流量都路由至 server,根据source label,没有命中的virtualService,因此路由至兜底testing。</p></description></item><item><title>Docs: Dubbo-go 3.0 动态配置</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/config-center-dynamic/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/config-center-dynamic/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/config-center/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbogo-30-配置中心和配置监听">Dubbogo 3.0 配置中心和配置监听</h1> |
| <h2 id="1-配置中心概念">1. 配置中心概念</h2> |
| <p>配置中心即为在分布式场景下,无法将最新的框架配置文件和应用程序绑定在一起,可以指定好配置中心的信息,例如配置中心类型和地址,并在框架启动时从配置中心拉取相应配置进行启动。</p> |
| <h2 id="2-配置中心的配置">2. 配置中心的配置</h2> |
| <p>参考仓库:<a href="https://github.com/apache/dubbo-go-samples/tree/master/configcenter">dubbo-go-samples/configcenter</a></p> |
| <p>dubbogo.yml</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">config-center</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: nacos |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">8848</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">data-id</span>: dubbo-go-samples-configcenter-nacos-server |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">namespace</span>: myNamespaceID <span style="color:#586e75"># 可选配置 nacos namespace ID, 默认是 public</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: mygroup <span style="color:#586e75"># 可选配置 nacos group, 默认是 DEFAULT_GROUP</span> |
| </span></span></code></pre></div><p>配置中心 nacos 内</p> |
| <p>group 默认为 <code>dubbo</code></p> |
| <p>dataID 为指定的id:<code>dubbo-go-samples-configcenter-nacos-server</code></p> |
| <p>写入框架配置例如下面,即可正常启动。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeout</span>: 3s |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter |
| </span></span></code></pre></div><h2 id="3-dubbogo-动态配置-api">3. Dubbogo 动态配置 API</h2> |
| <p>Config API 为 dubbogo 3.0 用来操作配置结构的 API。可使用框架提供的 Config API 进行配置结构的初始化,获取组件实例并使用。一个例子如下,包含了动态配置实例的初始化、发布配置、读取配置、订阅配置操作。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">const</span> configCenterNacosServerConfig = <span style="color:#2aa198">`# set in config center, group is &#39;dubbo&#39;, dataid is &#39;dubbo-go-samples-configcenter-nacos-server&#39;, namespace is default &#39;public&#39; |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198">dubbo: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> registries: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> demoZK: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> protocol: zookeeper |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> address: 127.0.0.1:2181 |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> protocols: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> triple: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> name: tri |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> port: 20000 |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> provider: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> services: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> GreeterProvider: |
| </span></span></span><span style="display:flex;"><span><span style="color:#2aa198"> interface: com.apache.dubbo.sample.basic.IGreeter # must be compatible with grpc or dubbo-java`</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">type</span> GreeterProvider <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> api.GreeterProviderBase |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (s <span style="color:#719e07">*</span>GreeterProvider) <span style="color:#268bd2">SayHello</span>(ctx context.Context, in <span style="color:#719e07">*</span>api.HelloRequest) (<span style="color:#719e07">*</span>api.User, <span style="color:#dc322f">error</span>) { |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;Dubbo3 GreeterProvider get user name = %s\n&#34;</span>, in.Name) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#719e07">&amp;</span>api.User{Name: <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> in.Name, Id: <span style="color:#2aa198">&#34;12345&#34;</span>, Age: <span style="color:#2aa198">21</span>}, <span style="color:#cb4b16">nil</span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">// There is no need to export DUBBO_GO_CONFIG_PATH, as you are using config api to set config |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span><span style="color:#268bd2">func</span> <span style="color:#268bd2">main</span>() { |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 获取动态配置实例 dynamicConfig |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> dynamicConfig, err <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">NewConfigCenterConfigBuilder</span>(). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetProtocol</span>(<span style="color:#2aa198">&#34;nacos&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetAddress</span>(<span style="color:#2aa198">&#34;127.0.0.1:8848&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetGroup</span>(<span style="color:#2aa198">&#34;dubbo&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Build</span>().<span style="color:#268bd2">GetDynamicConfiguration</span>() |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 使用 dynamicConfig 结构来发布配置 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> dynamicConfig.<span style="color:#268bd2">PublishConfig</span>(<span style="color:#2aa198">&#34;dubbo-go-samples-configcenter-nacos-server&#34;</span>, <span style="color:#2aa198">&#34;dubbo&#34;</span>, configCenterNacosServerConfig); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 使用 dynamicConfig 结构来读取配置 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> data, err <span style="color:#719e07">:=</span> dynamicConfig.<span style="color:#268bd2">GetRule</span>(<span style="color:#2aa198">&#34;dubbo-go-samples-configcenter-nacos-server&#34;</span>, config_center.<span style="color:#268bd2">WithGroup</span>(<span style="color:#2aa198">&#34;dubbo&#34;</span>)) |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span>{ |
| </span></span><span style="display:flex;"><span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;get config = %s&#34;</span>, data) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 使用 dynamicConfig 结构, 通过自定义listener来订阅配置更新事件 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> l <span style="color:#719e07">:=</span> <span style="color:#719e07">&amp;</span>listener{} |
| </span></span><span style="display:flex;"><span> dynamicConfig.<span style="color:#268bd2">AddListener</span>(<span style="color:#2aa198">&#34;dubbo-go-samples-configcenter-nacos-server&#34;</span>, l) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> time.<span style="color:#268bd2">Sleep</span>(time.Second <span style="color:#719e07">*</span> <span style="color:#2aa198">10</span>) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> config.<span style="color:#268bd2">SetProviderService</span>(<span style="color:#719e07">&amp;</span>GreeterProvider{}) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75">// 以 API 的形式来启动框架 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> rootConfig <span style="color:#719e07">:=</span> config.<span style="color:#268bd2">NewRootConfigBuilder</span>(). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetConfigCenter</span>(config.<span style="color:#268bd2">NewConfigCenterConfigBuilder</span>(). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">SetProtocol</span>(<span style="color:#2aa198">&#34;nacos&#34;</span>).<span style="color:#268bd2">SetAddress</span>(<span style="color:#2aa198">&#34;127.0.0.1:8848&#34;</span>). <span style="color:#586e75">// 根据配置结构,设置配置中心 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#268bd2">SetDataID</span>(<span style="color:#2aa198">&#34;dubbo-go-samples-configcenter-nacos-server&#34;</span>). <span style="color:#586e75">// 设置配置ID |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#268bd2">SetGroup</span>(<span style="color:#2aa198">&#34;dubbo&#34;</span>). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Build</span>()). |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Build</span>() |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> err <span style="color:#719e07">:=</span> rootConfig.<span style="color:#268bd2">Init</span>(); err <span style="color:#719e07">!=</span> <span style="color:#cb4b16">nil</span> { <span style="color:#586e75">// 框架启动 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span> <span style="color:#b58900">panic</span>(err) |
| </span></span><span style="display:flex;"><span> } |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">select</span> {} |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">type</span> listener <span style="color:#268bd2">struct</span> { |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>} |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">func</span> (l listener) <span style="color:#268bd2">Process</span>(event <span style="color:#719e07">*</span>config_center.ConfigChangeEvent) { |
| </span></span><span style="display:flex;"><span> logger.<span style="color:#268bd2">Infof</span>(<span style="color:#2aa198">&#34;listener get config = %s&#34;</span>, event.Value) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>当然,以 API 的形式来启动框架时,可以直接以API的形式来启动框架。参考基本概念模块的 <a href="../../concept/configuration/">Dubbogo 框架配置</a></p> |
| <h2 id="4-dubbogo-配置热更新">4. Dubbogo 配置热更新</h2> |
| <p>// todo</p> |
| <p>正在开发中ing</p></description></item><item><title>Docs: Dubbo-go 3.0 启动时检查</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/start-check/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/start-check/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/governance/health/start-check/">最新版本</a>。</p> |
| </div> |
| <h1 id="启动时检查">启动时检查</h1> |
| <p>在启动时检查依赖的服务是否可用</p> |
| <p>Dubbo-go 缺省会在启动时检查依赖的服务是否可用,不可用时会抛出异常,阻止应用初始化完成,以便上线时,能及早发现问题,默认 check=&ldquo;true&rdquo;,并等待3s。</p> |
| <p>可以通过 check=&ldquo;false&rdquo; 关闭检查,比如,测试时,有些服务不关心,或者出现了循环依赖,必须有一方先启动。</p> |
| <p>关闭 check 后,请注意 provider数量比较多时, consumer 订阅 provider 生成服务字典可能会有一定延迟,如果 consumer 一启动就对外提供服务, |
| 可能会造成&quot;冷启动&quot;。所以在这个时候,请对服务进行预热。</p> |
| <p>示例:</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">check </span>: <span style="color:#cb4b16">false</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">reference</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">myserivce</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">check</span>: <span style="color:#cb4b16">true</span> |
| </span></span></code></pre></div></description></item><item><title>Docs: Dubbo-go 3.0 自定义日志</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/custom-logger/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/custom-logger/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/features/custom-logger/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-30-自定义日志组件">Dubbo-go 3.0 自定义日志组件</h1> |
| <p>参考samples <a href="https://github.com/apache/dubbo-go-samples/tree/master/logger">dubbo-go-samples/logger</a></p> |
| <h2 id="1-日志配置">1. 日志配置</h2> |
| <p>Dubbo-go 3.0 默认采用 zap 日志库,在配置文件中不添加 logger 配置,日志将会打印到控制默认级别为debug。您也可在配置文件中配置日志级别、, 可参照如下方式来配置zap-config和lumberjack-config,从而定制化日志输出。</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">logger</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">zap-config</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">level</span>: debug <span style="color:#586e75"># 日志级别</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">development</span>: <span style="color:#cb4b16">false</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">disableCaller</span>: <span style="color:#cb4b16">false</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">disableStacktrace</span>: <span style="color:#cb4b16">false</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">encoding</span>: <span style="color:#2aa198">&#34;console&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># zap encoder 配置</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">encoderConfig</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">messageKey</span>: <span style="color:#2aa198">&#34;message&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">levelKey</span>: <span style="color:#2aa198">&#34;level&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeKey</span>: <span style="color:#2aa198">&#34;time&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">nameKey</span>: <span style="color:#2aa198">&#34;logger&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">callerKey</span>: <span style="color:#2aa198">&#34;caller&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">stacktraceKey</span>: <span style="color:#2aa198">&#34;stacktrace&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">lineEnding</span>: <span style="color:#2aa198">&#34;&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">levelEncoder</span>: <span style="color:#2aa198">&#34;capitalColor&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeEncoder</span>: <span style="color:#2aa198">&#34;iso8601&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">durationEncoder</span>: <span style="color:#2aa198">&#34;seconds&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">callerEncoder</span>: <span style="color:#2aa198">&#34;short&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">nameEncoder</span>: <span style="color:#2aa198">&#34;&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">outputPaths</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#2aa198">&#34;stderr&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">errorOutputPaths</span>: |
| </span></span><span style="display:flex;"><span> - <span style="color:#2aa198">&#34;stderr&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">lumberjack-config</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 写日志的文件名称</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">filename</span>: <span style="color:#2aa198">&#34;logs.log&#34;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 每个日志文件长度的最大大小,单位是 MiB。默认 100MiB</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">maxSize</span>: <span style="color:#2aa198">1</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 日志保留的最大天数(只保留最近多少天的日志)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">maxAge</span>: <span style="color:#2aa198">3</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 只保留最近多少个日志文件,用于控制程序总日志的大小</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">maxBackups</span>: <span style="color:#2aa198">5</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 是否使用本地时间,默认使用 UTC 时间</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">localTime</span>: <span style="color:#cb4b16">true</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># 是否压缩日志文件,压缩方法 gzip</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">compress</span>: <span style="color:#cb4b16">false</span> |
| </span></span></code></pre></div><h2 id="2-日志api-和-自定义日志">2. 日志API 和 自定义日志</h2> |
| <p>日志Interface</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#268bd2">type</span> Logger <span style="color:#268bd2">interface</span> { |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Info</span>(args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Warn</span>(args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Error</span>(args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Debug</span>(args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Fatal</span>(args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Infof</span>(fmt <span style="color:#dc322f">string</span>, args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Warnf</span>(fmt <span style="color:#dc322f">string</span>, args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Errorf</span>(fmt <span style="color:#dc322f">string</span>, args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Debugf</span>(fmt <span style="color:#dc322f">string</span>, args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">Fatalf</span>(fmt <span style="color:#dc322f">string</span>, args <span style="color:#719e07">...</span><span style="color:#268bd2">interface</span>{}) |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><p>日志API</p> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-go" data-lang="go"><span style="display:flex;"><span><span style="color:#719e07">import</span> <span style="color:#2aa198">&#34;dubbo.apache.org/dubbo-go/v3/common/logger&#34;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>logger.<span style="color:#268bd2">SetLoggerLevel</span>(warn) <span style="color:#586e75">// 在 main 函数中设置日志级别 |
| </span></span></span><span style="display:flex;"><span><span style="color:#586e75"></span>logger.<span style="color:#268bd2">SetLogger</span>(myLogger) <span style="color:#586e75">// 在 main 函数中设置自定义logger |
| </span></span></span></code></pre></div><ul> |
| <li>日志API不可以在Init 阶段使用,否则可能会发生意料之外的问题。</li> |
| </ul></description></item><item><title>Docs: Dubbo-go 3.0 应用级服务发现</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/service-discovery/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/service-discovery/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/registry/service-discovery/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-30-应用级服务发现">Dubbo-go 3.0 应用级服务发现</h1> |
| <p>参考文章<a href="https://baijiahao.baidu.com/s?id=1669266413887039723&amp;wfr=spider&amp;for=pc"><strong>《Dubbo 迈出云原生重要一步 应用级服务发现解析》</strong></a></p> |
| <p>参考仓库:<a href="https://github.com/apache/dubbo-go-samples/tree/master/registry/servicediscovery">dubbo-go-samples/registry/serivcediscovery</a></p> |
| <h2 id="配置方案">配置方案</h2> |
| <ul> |
| <li>Consumer 端</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: nacos |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">8848</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registry-type</span>: service <span style="color:#586e75"># 指定该注册中心为应用级服务发现,不填默认为接口级</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">metadata-report</span>: <span style="color:#586e75"># 定义元数据中心</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: nacos <span style="color:#586e75"># 元数据中心可选nacos/zk</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">8848</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">consumer</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">references</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterClientImpl</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter |
| </span></span></code></pre></div><ul> |
| <li>Provider 端</li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: nacos |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">8848</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registry-type</span>: service <span style="color:#586e75"># 指定该注册中心为应用级服务发现,不填默认为接口级</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">metadata-report</span>: <span style="color:#586e75"># 定义元数据中心</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: nacos <span style="color:#586e75"># 元数据中心可选nacos/zk</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">8848</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter |
| </span></span></code></pre></div><p>相比于常规配置,定义好registry-type: service, 并且定义好元数据中心后,将会使用应用级服务注册/服务发现。</p></description></item><item><title>Docs: Dubbo-go 3.0 注册中心</title><link>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/registry/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/docs/languages/golang/dubbo-go-3.0/samples/registry/</guid><description> |
| <div class="pageinfo pageinfo-primary"> |
| <p>此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档,请参阅<a href="https://dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/develop/registry/">最新版本</a>。</p> |
| </div> |
| <h1 id="dubbo-go-30-注册中心配置">Dubbo-go 3.0 注册中心配置</h1> |
| <p>参考samples <a href="https://github.com/apache/dubbo-go-samples/tree/master/registry">dubbo-go-samples/registry</a></p> |
| <h2 id="registry-注册中心配置">Registry 注册中心配置</h2> |
| <ul> |
| <li><strong>Nacos 注册中心</strong></li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">application</span>: <span style="color:#586e75"># 应用信息,服务启动后会将相关信息注册到注册中心,可被客户端从 url 中识别</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: myApp <span style="color:#586e75"># application=myApp; name=myApp</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">module</span>: opensource <span style="color:#586e75"># module=opensource</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">organization</span>: dubbo <span style="color:#586e75"># organization=dubbo</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">owner</span>: laurence <span style="color:#586e75"># owner=laurence</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">version</span>: myversion <span style="color:#586e75"># app.version=myversion</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">environment</span>: pro <span style="color:#586e75"># environment=pro</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">nacosWithCustomGroup</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: nacos <span style="color:#586e75"># 注册中心选择 nacos </span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">8848</span> <span style="color:#586e75"># nacos ip</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: myGroup <span style="color:#586e75"># nacos group, 默认 DEFAULT_GROUP</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">namespace</span>: 9fb00abb-278d-42fc-96bf-e0151601e4a1 <span style="color:#586e75"># nacos namespaceID, should be created before. 默认public</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">username</span>: abc |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">password</span>: abc |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">UserProviderWithCustomGroupAndVersion</span>: <span style="color:#586e75"># 接口三元组:接口名、版本号、分组。client 和 server 需要保持一致。</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: org.apache.dubbo.UserProvider.Test <span style="color:#586e75"># 接口名必填</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">version</span>: myInterfaceVersion <span style="color:#586e75"># 默认为空</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: myInterfaceGroup <span style="color:#586e75"># 默认为空</span> |
| </span></span></code></pre></div><p>Dubbo-go 的注册中心配置的 group、namespace、username、password,均与 nacos 相关概念对应。</p> |
| <ul> |
| <li><strong>Zookeeper 注册中心</strong></li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#586e75"># application: 与nacos 一致,不再赘述</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper <span style="color:#586e75"># 注册中心选择 nacos </span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> <span style="color:#586e75"># zookeeper ip</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: myGroup <span style="color:#586e75"># nacos group, 默认 dubbo</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">UserProviderWithCustomGroupAndVersion</span>: <span style="color:#586e75"># 接口三元组:接口名、版本号、分组。client 和 server 需要保持一致。</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter <span style="color:#586e75"># 接口名必填</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">version</span>: myInterfaceVersion <span style="color:#586e75"># 默认为空</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">group</span>: myInterfaceGroup <span style="color:#586e75"># 默认为空</span> |
| </span></span></code></pre></div><p>zookeeper 注册时,provider 端将接口信息注册在<code> /$(group)/$(interface)/providers</code> 节点,以上面配置为例,注册的 zk path 为 <code>/myGroup/com.apache.dubbo.sample.basic.IGreeter/providers/</code></p> |
| <p>consumer 端注册在 /$(group)/$(interface)/consumers 作统计用。</p> |
| <ul> |
| <li><strong>ETCD 注册中心</strong></li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">etcd</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: etcdv3 |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">timeout</span>: 3s |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2379</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: dubbo |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">UserProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: org.apache.dubbo.UserProvider |
| </span></span></code></pre></div><ul> |
| <li><strong>应用级服务注册发现</strong></li> |
| </ul> |
| <div class="highlight"><pre tabindex="0" style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#268bd2">dubbo</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registries</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">demoZK</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper <span style="color:#586e75"># nacos/zookeeper</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">registry-type</span>: service <span style="color:#586e75"># 使用应用级服务发现</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">metadata-report</span>: <span style="color:#586e75"># 配置元数据中心</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocol</span>: zookeeper |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">address</span>: <span style="color:#2aa198">127.0.0.1</span>:<span style="color:#2aa198">2181</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">protocols</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">triple</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">name</span>: tri |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">port</span>: <span style="color:#2aa198">20000</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">provider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">services</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">GreeterProvider</span>: |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">interface</span>: com.apache.dubbo.sample.basic.IGreeter |
| </span></span></code></pre></div></description></item></channel></rss> |