| <!doctype html> |
| <!-- |
| Minimal Mistakes Jekyll Theme 4.4.1 by Michael Rose |
| Copyright 2017 Michael Rose - mademistakes.com | @mmistakes |
| Free for personal and commercial use under the MIT license |
| https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE.txt |
| --> |
| <html lang="cn" class="no-js"> |
| <head> |
| <meta charset="utf-8"> |
| |
| <!-- begin SEO --> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <title>通信协议 - Apache ServiceComb</title> |
| |
| |
| |
| |
| <meta name="description" content="通信协议"> |
| |
| |
| |
| |
| <meta name="author" content=""> |
| |
| <meta property="og:locale" content="cn"> |
| <meta property="og:site_name" content="Apache ServiceComb"> |
| <meta property="og:title" content="通信协议"> |
| |
| |
| <link rel="canonical" href="https://github.com/pages/apache/incubator-servicecomb-website/cn/docs/users/communicate-protocol/"> |
| <meta property="og:url" content="https://github.com/pages/apache/incubator-servicecomb-website/cn/docs/users/communicate-protocol/"> |
| |
| |
| |
| <meta property="og:description" content="通信协议"> |
| |
| |
| |
| <meta name="twitter:site" content="@ServiceComb"> |
| <meta name="twitter:title" content="通信协议"> |
| <meta name="twitter:description" content="通信协议"> |
| <meta name="twitter:url" content=""> |
| |
| |
| <meta name="twitter:card" content="summary"> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <script type="application/ld+json"> |
| { |
| "@context" : "http://schema.org", |
| "@type" : "Person", |
| "name" : "Apache ServiceComb", |
| "url" : "https://github.com/pages/apache/incubator-servicecomb-website", |
| "sameAs" : null |
| } |
| </script> |
| |
| |
| |
| <meta name="google-site-verification" content="HvJjNd7vvJ-yjSTHlBiIWEYxp_Hrz-PYEY5Idz9LRcA" /> |
| |
| |
| |
| |
| <!-- end SEO --> |
| |
| |
| <link href="/feed.xml" type="application/atom+xml" rel="alternate" title="Apache ServiceComb Feed"> |
| |
| <!-- http://t.co/dKP3o1e --> |
| <meta name="HandheldFriendly" content="True"> |
| <meta name="MobileOptimized" content="320"> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| |
| <script> |
| document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js '; |
| </script> |
| <script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/1.7.1/clipboard.min.js"></script> |
| <script src="/assets/vendor/prism/prism.js"></script> |
| |
| <script type="text/javascript" async |
| src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"> |
| </script> |
| |
| <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/css/bootstrap.min.css" integrity="sha384-/Y6pD6FV/Vv2HJnA6t+vslU6fwYXjCFtcEpHbNJ0lyAFsXTsjBbfaDjzALeQsN6M" crossorigin="anonymous"> |
| |
| <script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script> |
| <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script> |
| <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/js/bootstrap.min.js" integrity="sha384-h0AbiXch4ZDo7tp9hKZ4TsHbi047NrKGLO3SEJAg45jXxnGIfYzk4Si90RDIqNm1" crossorigin="anonymous"></script> |
| <!-- For all browsers --> |
| <link rel="stylesheet" href="/assets/css/main.css?v=1"> |
| <link rel="stylesheet" href="/assets/vendor/prism/prism.css?v=1"> |
| |
| <!--[if lte IE 9]> |
| <style> |
| /* old IE unsupported flexbox fixes */ |
| .greedy-nav .site-title { |
| padding-right: 3em; |
| } |
| .greedy-nav button { |
| position: absolute; |
| top: 0; |
| right: 0; |
| height: 100%; |
| } |
| </style> |
| <![endif]--> |
| |
| <meta http-equiv="cleartype" content="on"> |
| |
| <!-- start custom head snippets --> |
| |
| <!-- insert favicons. use http://realfavicongenerator.net/ --> |
| <link href="https://fonts.loli.net/css?family=Roboto:400,500,700|Source+Code+Pro" rel="stylesheet"> |
| <script src="/assets/js/custom.js"></script> |
| <!-- end custom head snippets --> |
| |
| </head> |
| |
| <body class="layout--single"> |
| |
| <!--[if lt IE 9]> |
| <div class="notice--danger align-center" style="margin: 0;">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</div> |
| <![endif]--> |
| <div class="masthead" onmouseleave="$('#childrenShow').css('display', 'none')"> |
| <div class="masthead__inner-wrap"> |
| <div class="masthead__menu"> |
| <nav id="site-nav" class="greedy-nav"> |
| |
| <a class="site-title active" href="/cn"><img src="https://www.apache.org/img/servicecomb.png"></a> |
| |
| <ul class="visible-links"> |
| |
| |
| |
| |
| |
| <li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')"> |
| |
| <a href="/cn/">首页</a> |
| |
| </li> |
| |
| |
| |
| |
| |
| |
| <li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')"> |
| |
| <a href="/cn/developers/">项目</a> |
| |
| </li> |
| |
| |
| |
| |
| |
| |
| <li class="def-nav-li" onmouseenter="$('#childrenShow').css('display', 'block')"> |
| |
| |
| |
| |
| |
| <a class="active" href="/cn/docs/users/">文档</a> |
| |
| |
| <ul id="childrenShow" class="def-children-show-cn" onmouseleave="$('#childrenShow').css('display', 'none')"> |
| |
| <li><a href="/cn/docs/getting-started/" class="">入门指南</a></li> |
| |
| <li><a href="/cn/docs/users/" class="">用户手册</a></li> |
| |
| <li><a href="/cn/slides/" class="">大咖视频</a></li> |
| |
| <li><a href="/cn/faqs/" class="">常见问题</a></li> |
| |
| </ul> |
| </li> |
| |
| |
| |
| |
| |
| |
| <li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')"> |
| |
| <a href="/cn/developers/contributing">社区</a> |
| |
| </li> |
| |
| |
| |
| |
| |
| |
| <li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')"> |
| |
| <a href="/cn/year-archive/">博文</a> |
| |
| </li> |
| |
| |
| |
| |
| |
| |
| <li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')"> |
| |
| <a href="/cn/release/">下载</a> |
| |
| </li> |
| |
| |
| </ul> |
| <button><div class="navicon"></div></button> |
| <ul class="hidden-links hidden"></ul> |
| <div class="nav-lang"> |
| |
| |
| |
| <a href=/docs/users/communicate-protocol/>English</a> |
| |
| </div> |
| </nav> |
| </div> |
| </div> |
| </div> |
| |
| |
| |
| |
| |
| |
| <div id="main" role="main"> |
| |
| <div class="sidebar sticky"> |
| |
| <div class="back-to-home"><a href="/cn/">首页</a> > 通信协议</div> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <nav class="nav__list"> |
| |
| <input id="ac-toc" name="accordion-toc" type="checkbox" /> |
| <label for="ac-toc">切换菜单</label> |
| <ul class="nav__items"> |
| |
| <li> |
| |
| <span class="nav__sub-title">Java-chassis用户手册</span> |
| |
| |
| |
| <ul> |
| |
| |
| |
| |
| |
| |
| |
| <li><a href="https://docs.servicecomb.io/java-chassis/zh_CN/index.html" class="">1.2.1</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| <li> |
| |
| <span class="nav__sub-title">Saga用户手册</span> |
| |
| |
| |
| <ul> |
| |
| |
| |
| |
| |
| |
| |
| <li><a href="https://docs.servicecomb.io/saga/zh_CN/index.html" class="">0.5.0</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| <li> |
| |
| <span class="nav__sub-title">ServiceCenter用户手册</span> |
| |
| |
| |
| <ul> |
| |
| |
| |
| |
| |
| |
| |
| <li><a href="https://docs.servicecomb.io/service-center/zh_CN/index.html" class="">1.2.0</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| <li> |
| |
| <span class="nav__sub-title">Kie 用户手册</span> |
| |
| |
| |
| <ul> |
| |
| |
| |
| |
| |
| |
| |
| <li><a href="/docs/kie/0.1.0/index.html" class="">0.1.0(英文版)</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| <li> |
| |
| <span class="nav__sub-title">Mesher 用户手册</span> |
| |
| |
| |
| <ul> |
| |
| |
| |
| |
| |
| |
| |
| <li><a href="/docs/mesher/1.6.3/index.html" class="">1.6.3(英文版)</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| </ul> |
| </nav> |
| |
| |
| |
| </div> |
| |
| |
| |
| <article class="page" itemscope itemtype="http://schema.org/CreativeWork"> |
| <meta itemprop="headline" content="通信协议"> |
| <meta itemprop="description" content="通信协议"> |
| |
| <meta itemprop="dateModified" content="August 15, 2017"> |
| |
| <div class="page__inner-wrap"> |
| |
| |
| <header> |
| <h1 class="page__title" itemprop="headline">通信协议 |
| </h1> |
| |
| </header> |
| |
| |
| |
| <section class="page__content" itemprop="text"> |
| <aside class="sidebar__right"> |
| <nav class="toc"> |
| <!-- <header><h4 class="nav__title"><i class="fa fa-file-text"></i> 在本页上</h4></header> --> |
| <ul class="toc__menu" id="markdown-toc"> |
| <li><a href="#通信协议" id="markdown-toc-通信协议">通信协议</a> <ul> |
| <li><a href="#概念阐述" id="markdown-toc-概念阐述">概念阐述</a></li> |
| <li><a href="#注意事项" id="markdown-toc-注意事项">注意事项</a></li> |
| </ul> |
| </li> |
| <li><a href="#线程模型" id="markdown-toc-线程模型">线程模型</a> <ul> |
| <li><a href="#概念阐述-1" id="markdown-toc-概念阐述-1">概念阐述</a></li> |
| <li><a href="#完整线程" id="markdown-toc-完整线程">完整线程</a></li> |
| </ul> |
| </li> |
| <li><a href="#rest-over-servlet" id="markdown-toc-rest-over-servlet">REST over Servlet</a> <ul> |
| <li><a href="#配置说明" id="markdown-toc-配置说明">配置说明</a></li> |
| <li><a href="#示例代码" id="markdown-toc-示例代码">示例代码</a></li> |
| </ul> |
| </li> |
| <li><a href="#rest-over-vertx" id="markdown-toc-rest-over-vertx">REST over Vertx</a> <ul> |
| <li><a href="#配置说明-1" id="markdown-toc-配置说明-1">配置说明</a></li> |
| <li><a href="#示例代码-1" id="markdown-toc-示例代码-1">示例代码</a></li> |
| </ul> |
| </li> |
| <li><a href="#highway-rpc协议" id="markdown-toc-highway-rpc协议">Highway RPC协议</a> <ul> |
| <li><a href="#概念阐述-2" id="markdown-toc-概念阐述-2">概念阐述</a></li> |
| <li><a href="#配置说明-2" id="markdown-toc-配置说明-2">配置说明</a></li> |
| <li><a href="#示例代码-2" id="markdown-toc-示例代码-2">示例代码</a></li> |
| </ul> |
| </li> |
| </ul> |
| |
| </nav> |
| </aside> |
| |
| <h2 id="通信协议">通信协议</h2> |
| <h3 id="概念阐述">概念阐述</h3> |
| |
| <p>ServiceComb实现了两种网络通道,包括REST和Highway,均支持TLS加密传输。其中,REST网络通道将服务以标准RESTful形式发布,调用端兼容直接使用http client使用标准RESTful形式进行调用。</p> |
| |
| <h3 id="注意事项">注意事项</h3> |
| |
| <p>参数和返回值的序列化:</p> |
| |
| <p>当前REST通道的body参数只支持application/json序列化方式,如果要向服务端发送form类型的参数,那么需要在调用端构造好application/json格式的body,不能直接以multipart/form-data格式传递form类型参数。</p> |
| |
| <p>当前REST通道返回值支持application/json和text/plain两种格式,服务提供者通过produces声明可提供序列化能力,服务消费者通过请求的Accept头指明返回值序列化方式,默认返回application/json格式的数据。</p> |
| |
| <h2 id="线程模型">线程模型</h2> |
| <h3 id="概念阐述-1">概念阐述</h3> |
| |
| <p>本小节主要介绍ServiceComb微服务的完整线程模型,介绍IO线程和业务线程之间的关系</p> |
| |
| <h3 id="完整线程">完整线程</h3> |
| |
| <p>ServiceComb微服务的完整线程模型如下图所示:</p> |
| |
| <p><img src="/assets/images/thread-model.png" alt="" /></p> |
| |
| <blockquote> |
| <ol> |
| <li>业务线程在第一次调用时会绑定某一个网络线程,避免在不同网络线程之间切换,无谓地增加线程冲突的概率</li> |
| <li>业务线程绑定网络线程后,会再绑定该网络线程内部的某个连接,同样是为了避免线程冲突</li> |
| </ol> |
| </blockquote> |
| |
| <ul> |
| <li>客户端和服务器都可以配置多个网络线程(eventloop),默认为CPU核数的两倍,每个网络线程可以配置多个连接,默认为1,支持Rest和Highway两种网络通道,具体配置请查看如下章节: |
| <ul> |
| <li><a href="/cn/users/communicate-protocol#rest-over-servlet">REST over Servlet</a></li> |
| <li><a href="/cn/users/communicate-protocol/#rest-over-vertx">REST over Vertx</a></li> |
| <li><a href="/cn/users/communicate-protocol/#highway-rpc协议">Highway RPC协议</a></li> |
| </ul> |
| </li> |
| <li>客户端可配置业务线程池executor,线程粒度可细化至schemaId:operation,配置如下:</li> |
| </ul> |
| |
| <p>在microservice.yaml中添加executors配置,为schemaId:operation配置单独的业务线程池:</p> |
| |
| <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">servicecomb</span><span class="pi">:</span> |
| <span class="na">executors</span><span class="pi">:</span> |
| <span class="na">Provider</span><span class="pi">:</span> |
| <span class="pi">[</span><span class="nv">schemaId</span><span class="pi">]</span><span class="s">.[operation]</span> |
| </code></pre></div></div> |
| |
| <h2 id="rest-over-servlet">REST over Servlet</h2> |
| <h3 id="配置说明">配置说明</h3> |
| |
| <p> REST over Servlet对应使用web容器模式部署运行,需要新建一个servlet工程将微服务包装起来,加载到web容器中启动运行,包装微服务的方法有两种,一种完全使用web.xml配置文件配置,另一种仅在web.xml文件中配置listener,在microservice.yaml文件中配置urlPattern,两种方式如下所示:</p> |
| |
| <ul> |
| <li> |
| <p>在web.xml文件中完成全部配置</p> |
| |
| <p>web.xml文件配置在项目的src/main/webapp/WEB_INF目录,配置内容如下:</p> |
| |
| <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt"><web-app</span> <span class="na">xmlns=</span><span class="s">"http://java.sun.com/xml/ns/javaee"</span> <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span> <span class="na">xsi:schemaLocation=</span><span class="s">"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"</span> <span class="na">version=</span><span class="s">"3.0"</span><span class="nt">></span> |
| <span class="nt"><context-param></span> |
| <span class="nt"><param-name></span>contextConfigLocation<span class="nt"></param-name></span> |
| <span class="nt"><param-value></span>classpath*:META-INF/spring/*.bean.xml classpath*:app-config.xml<span class="nt"></param-value></span> |
| <span class="nt"></context-param></span> |
| <span class="nt"><listener></span> |
| <span class="nt"><listener-class></span>org.apache.servicecomb.transport.rest.servlet.RestServletContextListener<span class="nt"></listener-class></span> |
| <span class="nt"></listener></span> |
| <span class="nt"><servlet></span> |
| <span class="nt"><servlet-name></span>RestServlet<span class="nt"></servlet-name></span> |
| <span class="nt"><servlet-class></span>org.apache.servicecomb.transport.rest.servlet.RestServlet<span class="nt"></servlet-class></span> |
| <span class="nt"><load-on-startup></span>1<span class="nt"></load-on-startup></span> |
| <span class="nt"><async-supported></span>true<span class="nt"></async-supported></span> |
| <span class="nt"></servlet></span> |
| <span class="nt"><servlet-mapping></span> |
| <span class="nt"><servlet-name></span>RestServlet<span class="nt"></servlet-name></span> |
| <span class="nt"><url-pattern></span>/rest/*<span class="nt"></url-pattern></span> |
| <span class="nt"></servlet-mapping></span> |
| <span class="nt"></web-app></span> |
| </code></pre></div> </div> |
| </li> |
| <li> |
| <p>在web.xml文件中仅配置listener,在microservice.yaml文件中配置urlPattern</p> |
| |
| <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="nt"><web-app</span> <span class="na">xmlns=</span><span class="s">"http://java.sun.com/xml/ns/javaee"</span> <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span> <span class="na">xsi:schemaLocation=</span><span class="s">"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"</span> <span class="na">version=</span><span class="s">"3.0"</span><span class="nt">></span> |
| <span class="nt"><context-param></span> |
| <span class="nt"><param-name></span>contextConfigLocation<span class="nt"></param-name></span> |
| <span class="nt"><param-value></span>classpath*:META-INF/spring/*.bean.xml classpath*:app-config.xml<span class="nt"></param-value></span> |
| <span class="nt"></context-param></span> |
| <span class="nt"><listener></span> |
| <span class="nt"><listener-class></span>org.apache.servicecomb.transport.rest.servlet.RestServletContextListener<span class="nt"></listener-class></span> |
| <span class="nt"></listener></span> |
| <span class="nt"></web-app></span> |
| </code></pre></div> </div> |
| |
| <p>在microservice.yaml文件中需要增加一行配置来指定urlPattern:</p> |
| |
| <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="s">servicecomb.rest.servlet.urlPattern</span><span class="pi">:</span> <span class="s">/rest/*</span> |
| </code></pre></div> </div> |
| </li> |
| </ul> |
| |
| <p>以上两种方式是等效的,两种方式都需要在maven pom文件中添加如下依赖:</p> |
| |
| <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><dependency></span> |
| <span class="nt"><groupId></span>org.apache.servicecomb<span class="nt"></groupId></span> |
| <span class="nt"><artifactId></span>transport-rest-servlet<span class="nt"></artifactId></span> |
| <span class="nt"></dependency></span> |
| </code></pre></div></div> |
| |
| <p>REST over Servlet在microservice.yaml文件中的配置项见下表:</p> |
| |
| <p>表1 REST over Servlet配置项说明</p> |
| |
| <table> |
| <thead> |
| <tr> |
| <th style="text-align: left">配置项</th> |
| <th style="text-align: left">默认值</th> |
| <th style="text-align: left">取值范围</th> |
| <th style="text-align: left">是否必选</th> |
| <th style="text-align: left">含义</th> |
| <th style="text-align: left">注意</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td style="text-align: left">servicecomb.rest.address</td> |
| <td style="text-align: left">0.0.0.0:8080</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">服务监听地址</td> |
| <td style="text-align: left">-</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.rest.timeout</td> |
| <td style="text-align: left">3000</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">超时时间</td> |
| <td style="text-align: left">单位为毫秒</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.request.timeout</td> |
| <td style="text-align: left">30000</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">请求超时时间</td> |
| <td style="text-align: left">同REST over Vertx的配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.references.[服务名].transport</td> |
| <td style="text-align: left">rest</td> |
| <td style="text-align: left"> </td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">访问的transport类型</td> |
| <td style="text-align: left">同REST over Vertx的配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.references.[服务名].version-rule</td> |
| <td style="text-align: left">latest</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">访问实例的版本号</td> |
| <td style="text-align: left">同REST over Vertx的配置</td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <h3 id="示例代码">示例代码</h3> |
| |
| <p>microservice.yaml文件中的配置示例如下:</p> |
| |
| <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">servicecomb</span><span class="pi">:</span> |
| <span class="na">rest</span><span class="pi">:</span> |
| <span class="na">address</span><span class="pi">:</span> <span class="s">0.0.0.0:8080</span> |
| <span class="na">timeout</span><span class="pi">:</span> <span class="m">3000</span> |
| </code></pre></div></div> |
| |
| <h2 id="rest-over-vertx">REST over Vertx</h2> |
| <h3 id="配置说明-1">配置说明</h3> |
| |
| <p>REST over Vertx通信通道对应使用standalone部署运行模式,可直接通过main函数拉起。main函数中需要初始化日志和加载服务配置,代码如下:</p> |
| |
| <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">org.apache.servicecomb.foundation.common.utils.BeanUtils</span><span class="o">;</span> |
| <span class="kn">import</span> <span class="nn">org.apache.servicecomb.foundation.common.utils.Log4jUtils</span><span class="o">;</span> |
| |
| <span class="kd">public</span> <span class="kd">class</span> <span class="nc">MainServer</span> <span class="o">{</span> |
| <span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="nc">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="nc">Exception</span> <span class="o">{</span> |
| <span class="err"> </span><span class="nc">Log4jUtils</span><span class="o">.</span><span class="na">init</span><span class="o">();</span><span class="c1">//日志初始化</span> |
| <span class="err"> </span><span class="nc">BeanUtils</span><span class="o">.</span><span class="na">init</span><span class="o">();</span> <span class="c1">// Spring bean初始化</span> |
| <span class="o">}</span> |
| <span class="o">}</span> |
| </code></pre></div></div> |
| |
| <p>使用REST over Vertx网络通道需要在maven pom文件中添加如下依赖:</p> |
| |
| <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><dependency></span> |
| <span class="nt"><groupId></span>org.apache.servicecomb<span class="nt"></groupId></span> |
| <span class="nt"><artifactId></span>transport-rest-vertx<span class="nt"></artifactId></span> |
| <span class="nt"></dependency></span> |
| </code></pre></div></div> |
| |
| <p>REST over Vertx通道在microservice.yaml文件中有以下配置项:</p> |
| |
| <p>表2 REST over Vertx配置项说明</p> |
| |
| <table> |
| <thead> |
| <tr> |
| <th style="text-align: left">配置项</th> |
| <th style="text-align: left">默认值</th> |
| <th style="text-align: left">取值范围</th> |
| <th style="text-align: left">是否必选</th> |
| <th style="text-align: left">含义</th> |
| <th style="text-align: left">注意</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td style="text-align: left">servicecomb.rest.address</td> |
| <td style="text-align: left">0.0.0.0:8080</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">服务监听地址</td> |
| <td style="text-align: left">仅服务提供者需要配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.rest.server.thread-count</td> |
| <td style="text-align: left">1</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">服务端线程数</td> |
| <td style="text-align: left">仅服务提供者需要配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.rest.client.thread-count</td> |
| <td style="text-align: left">1</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">客户端网络线程数</td> |
| <td style="text-align: left">仅服务消费者需要配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.rest.client.connection-pool-per-thread</td> |
| <td style="text-align: left">1</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">客户端每个网络线程中的连接池的个数</td> |
| <td style="text-align: left">仅服务消费者需要配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.request.timeout</td> |
| <td style="text-align: left">30000</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">请求超时时间</td> |
| <td style="text-align: left"> </td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.references.[服务名].transport</td> |
| <td style="text-align: left">rest</td> |
| <td style="text-align: left"> </td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">访问的transport类型</td> |
| <td style="text-align: left">仅服务消费者需要配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.references.[服务名].version-rule</td> |
| <td style="text-align: left">latest</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">访问实例的版本号</td> |
| <td style="text-align: left">仅服务消费者需要配置支持latest,1.0.0+,1.0.0-2.0.2,精确版本。详细参考服务中心的接口描述。</td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <h3 id="示例代码-1">示例代码</h3> |
| |
| <p>microservice.yaml文件中的配置示例:</p> |
| |
| <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">servicecomb</span><span class="pi">:</span> |
| <span class="na">rest</span><span class="pi">:</span> |
| <span class="na">address</span><span class="pi">:</span> <span class="s">0.0.0.0:8080</span> |
| <span class="na">thread-count</span><span class="pi">:</span> <span class="m">1</span> |
| <span class="na">references</span><span class="pi">:</span> |
| <span class="na">hello</span><span class="pi">:</span> |
| <span class="na">transport</span><span class="pi">:</span> <span class="s">rest</span> |
| <span class="na">version-rule</span><span class="pi">:</span> <span class="s">0.0.1</span> |
| </code></pre></div></div> |
| |
| <h2 id="highway-rpc协议">Highway RPC协议</h2> |
| <h3 id="概念阐述-2">概念阐述</h3> |
| |
| <p>Highway是ServiceComb的高性能私有协议,用户可在有特殊性能需求的场景下选用。</p> |
| |
| <h3 id="配置说明-2">配置说明</h3> |
| |
| <p>使用Highway网络通道需要在maven pom文件中添加如下依赖:</p> |
| |
| <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><dependency></span> |
| <span class="nt"><groupId></span>org.apache.servicecomb<span class="nt"></groupId></span> |
| <span class="nt"><artifactId></span>transport-highway<span class="nt"></artifactId></span> |
| <span class="nt"></dependency></span> |
| </code></pre></div></div> |
| |
| <p>Highway通道在microservice.yaml文件中的配置项如下表所示:</p> |
| |
| <p>表3 Highway配置项说明</p> |
| |
| <table> |
| <thead> |
| <tr> |
| <th style="text-align: left">配置项</th> |
| <th style="text-align: left">默认值</th> |
| <th style="text-align: left">取值范围</th> |
| <th style="text-align: left">是否必选</th> |
| <th style="text-align: left">含义</th> |
| <th style="text-align: left">注意</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td style="text-align: left">servicecomb.highway.address</td> |
| <td style="text-align: left">0.0.0.0:7070</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">服务监听地址</td> |
| <td style="text-align: left">-</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.highway.server.thread-count</td> |
| <td style="text-align: left">1</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">服务端网络线程个数</td> |
| <td style="text-align: left">-</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.highway.client.thread-count</td> |
| <td style="text-align: left">1</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">客户端网络线程个数</td> |
| <td style="text-align: left">-</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.highway.client.connection-pool-per-thread</td> |
| <td style="text-align: left">1</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">客户端每个网络线程的连接池个数</td> |
| <td style="text-align: left">-</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.request.timeout</td> |
| <td style="text-align: left">30000</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">请求超时时间</td> |
| <td style="text-align: left">同REST over Vertx的配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.references.[服务名].transport</td> |
| <td style="text-align: left">rest</td> |
| <td style="text-align: left"> </td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">访问的transport类型</td> |
| <td style="text-align: left">同REST over Vertx的配置</td> |
| </tr> |
| <tr> |
| <td style="text-align: left">servicecomb.references.[服务名].version-rule</td> |
| <td style="text-align: left">latest</td> |
| <td style="text-align: left">-</td> |
| <td style="text-align: left">否</td> |
| <td style="text-align: left">访问实例的版本号</td> |
| <td style="text-align: left">同REST over Vertx的配置</td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <h3 id="示例代码-2">示例代码</h3> |
| |
| <p>microservice.yaml文件中的配置示例:</p> |
| |
| <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">servicecomb</span><span class="pi">:</span> |
| <span class="na">highway</span><span class="pi">:</span> |
| <span class="na">address</span><span class="pi">:</span> <span class="s">0.0.0.0:7070</span> |
| </code></pre></div></div> |
| |
| |
| </section> |
| |
| <footer class="page__meta"> |
| |
| |
| |
| |
| |
| </footer> |
| |
| |
| |
| |
| |
| </div> |
| |
| |
| </article> |
| |
| |
| |
| </div> |
| |
| |
| <script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script> |
| <div align="center" style="margin: 0 0;"> |
| <ins class="adsbygoogle" |
| style="display:block; border-bottom: initial;" |
| data-ad-client="ca-pub-7328585512091257" |
| data-ad-slot="3049671934" |
| data-ad-format="auto"></ins> |
| </div> |
| |
| <div class="page__footer"> |
| <footer> |
| <!-- start custom footer snippets --> |
| |
| <!-- end custom footer snippets --> |
| |
| <div class="container"> |
| <div class="row justify-content-md-center"> |
| |
| <div class="col"> |
| <ul> |
| <p class="header">资源</p> |
| <li><a href="/cn/docs/getting-started/">入门指南</a></li> |
| <li><a href="/cn/docs/users/">用户指南</a></li> |
| <li><a href="/cn/slides/">资料</a></li> |
| <li><a href="/cn/users/faq/">常见问题</a></li> |
| </ul> |
| </div> |
| <div class="col"> |
| <ul> |
| <p class="header">ASF</p> |
| <li><a href="http://www.apache.org">基金会</a></li> |
| <li><a href="http://www.apache.org/licenses/">许可证</a></li> |
| <li><a href="http://www.apache.org/events/current-event">活动</a></li> |
| <li><a href="http://www.apache.org/foundation/sponsorship.html">赞助</a></li> |
| <li><a href="http://www.apache.org/foundation/thanks.html">鸣谢</a></li> |
| </ul> |
| </div> |
| <div class="col"> |
| <ul> |
| <p class="header">贡献</p> |
| <li><a href="http://issues.apache.org/jira/browse/SCB">报告本网页问题</a></li> |
| <li><a href="https://github.com/apache/servicecomb-website/edit/master/_users/cn/communicate-protocol.md">在Github上编辑此页</a></li> |
| <li><a href="/cn/developers/submit-codes/">代码提交指南</a></li> |
| <li><a href="/cn/security">安全</a></li> |
| </ul> |
| </div> |
| <div class="col"> |
| <ul class="social-icons"> |
| <p class="header">社区</p> |
| <li> |
| <a href="mailto:dev-subscribe@servicecomb.incubator.apache.org" rel="nofollow"><span class="mail">邮件列表</span></a> |
| </li> |
| <li> |
| <a href="https://github.com/apache?q=ServiceComb" target="_blank"><span class="github">Github</span></a> |
| </li> |
| <li> |
| <a href="https://twitter.com/ServiceComb" target="_blank"><span class="twitter">Twitter</span></a> |
| </li> |
| <li> |
| <a href="/feed.xml" target="_blank"><span class="rss">Feed</span></a> |
| </li> |
| </ul> |
| </div> |
| </div> |
| </div> |
| <div class="page__footer-bottom"> |
| <div>© 2020 Apache ServiceComb. 技术来自于 <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> & <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div> |
| <div>All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> |
| </div> |
| |
| </footer> |
| </div> |
| |
| <script src="/assets/js/main.min.js"></script> |
| |
| |
| |
| |
| <script> |
| (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ |
| (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), |
| m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) |
| })(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); |
| |
| ga('create', 'UA-101622733-1', 'auto'); |
| ga('send', 'pageview'); |
| </script> |
| |
| |
| |
| |
| |
| |
| |
| </body> |
| </html> |