You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicecomb.apache.org by ni...@apache.org on 2017/12/12 09:18:04 UTC
[07/57] [partial] incubator-servicecomb-website git commit: Generated
the static pages for asf-site
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/08e1b43f/content/users/develop-with-rest-template/index.html
----------------------------------------------------------------------
diff --git a/content/users/develop-with-rest-template/index.html b/content/users/develop-with-rest-template/index.html
new file mode 100644
index 0000000..03067df
--- /dev/null
+++ b/content/users/develop-with-rest-template/index.html
@@ -0,0 +1,735 @@
+<!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="en" class="no-js">
+ <head>
+ <meta charset="utf-8">
+
+<!-- begin SEO -->
+
+
+
+
+
+
+
+
+
+<title>使用Rest Template方式开发 - Apache incubator ServiceComb</title>
+
+
+
+
+<meta name="description" content="使用Rest Template方式开发">
+
+
+
+
+<meta name="author" content="">
+
+<meta property="og:locale" content="en">
+<meta property="og:site_name" content="Apache incubator ServiceComb">
+<meta property="og:title" content="使用Rest Template方式开发">
+
+
+ <link rel="canonical" href="http://github.com/pages/ServiceComb/servicesomb.github.io/users/develop-with-rest-template/">
+ <meta property="og:url" content="http://github.com/pages/ServiceComb/servicesomb.github.io/users/develop-with-rest-template/">
+
+
+
+ <meta property="og:description" content="使用Rest Template方式开发">
+
+
+
+ <meta name="twitter:site" content="@ServiceComb">
+ <meta name="twitter:title" content="使用Rest Template方式开发">
+ <meta name="twitter:description" content="使用Rest Template方式开发">
+ <meta name="twitter:url" content="">
+
+
+ <meta name="twitter:card" content="summary">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <script type="application/ld+json">
+ {
+ "@context" : "http://schema.org",
+ "@type" : "Person",
+ "name" : "Apache incubator ServiceComb",
+ "url" : "http://github.com/pages/ServiceComb/servicesomb.github.io",
+ "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 incubator 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/js/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">
+<link rel="stylesheet" href="/assets/css/prism.css">
+
+<!--[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.cat.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">
+ <div class="masthead__inner-wrap">
+ <div class="masthead__menu">
+ <nav id="site-nav" class="greedy-nav">
+
+ <a class="site-title active" href="/"><img src="//assets/images/ServiceComb-logo-1.png"></a>
+
+ <ul class="visible-links">
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/docs/quick-start/">Quick Start</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a class="active" href="/users/">Users</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/developers/">Developers</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/year-archive/">Blogs</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/faqs/">FAQ</a>
+
+ </li>
+
+ </ul>
+ <button><div class="navicon"></div></button>
+ <ul class="hidden-links hidden"></ul>
+ <div class="nav-lang">
+
+
+ <a href=/cn/users/develop-with-rest-template/>中文</a>
+
+ </div>
+ </nav>
+ </div>
+ </div>
+</div>
+
+
+
+
+
+
+<div id="main" role="main">
+
+ <div class="sidebar sticky">
+
+ <div class="back-to-home">Home > <a href="/">ServiceComb</a></div>
+
+
+
+
+
+
+
+
+
+
+
+<nav class="nav__list">
+
+ <input id="ac-toc" name="accordion-toc" type="checkbox" />
+ <label for="ac-toc">Toggle Menu</label>
+ <ul class="nav__items">
+
+ <li>
+
+ <span class="nav__sub-title">User Guide</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/" class="">Java Chassis Architecture</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/setup-environment/" class="">Setup Environment</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Develop Service Provider</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/service-definition/" class="">Service Definition</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-contract/" class="">Service Contract</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-springmvc/" class="">Develop Microservice with SpringMVC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-jax-rs/" class="">Develop Microservice with JAX-RS</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-transparent-rpc/" class="">Develop Microservice with Transparent RPC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-interface-constraints/" class="">Service Interface Constraints</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-configurations/" class="">Service Configurations</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/communicate-protocol/" class="">Communicate Protocol</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/application-boot-process/" class="">Application Boot Up Process</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-heartbeat/" class="">Service Heartbeat</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Develop Service Consumer</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-rest-template/" class="active">Develop with Rest Template</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-rpc/" class="">Develop with Transparent RPC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/use-service-contract/" class="">Use Service Contract</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/invoke-control/" class="">Invoke Control</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">General Development</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/local-develop-test/" class="">Develop and Test in Local Environment</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/use-servicecomb-in-spring-boot/" class="">Use ServiceComb in Spring Boot</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/distributed-tracing/" class="">Distributed Tracing</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/customized-tracing/" class="">Customized Tracing</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Edging Service</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/edging-service/nginx/" class="">confd and Nginx</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/edging-service/zuul/" class="">Zuul</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
+
+ <a href="/users/metrics/"><span class="nav__sub-title nav__sub-title-with-url">Metrics</span></a>
+
+
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Deployment</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/run-mode/" class="">Run Mode</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Security</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/use-tls/" class="">Use TLS</a></li>
+
+ </ul>
+
+ </li>
+
+ </ul>
+</nav>
+
+
+
+ </div>
+
+
+
+ <article class="page" itemscope itemtype="http://schema.org/CreativeWork">
+ <meta itemprop="headline" content="使用Rest Template方式开发">
+ <meta itemprop="description" content="使用Rest Template方式开发">
+
+ <meta itemprop="dateModified" content="August 15, 2017">
+
+ <div class="page__inner-wrap">
+
+
+ <header>
+ <h1 class="page__title" itemprop="headline">使用Rest Template方式开发
+</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> On This Page</h4></header> -->
+<ul class="toc__menu" id="markdown-toc">
+ <li><a href="#概念阐述" id="markdown-toc-概念阐述">概念阐述</a></li>
+ <li><a href="#场景描述" id="markdown-toc-场景描述">场景描述</a></li>
+ <li><a href="#示例代码" id="markdown-toc-示例代码">示例代码</a></li>
+</ul>
+
+ </nav>
+</aside>
+
+<h2 id="概念阐述">概念阐述</h2>
+
+<p> Rest Template是Spring提供的RESTful访问接口，ServiceComb提供该接口的实现类用于服务的调用。</p>
+
+<h2 id="场景描述">场景描述</h2>
+
+<p> 用户使用ServiceComb提供的Rest Template实例，可以使用自定义的URL进行服务调用，而不用关心服务的具体地址。</p>
+
+<h2 id="示例代码">示例代码</h2>
+
+<p> Rest Template实例通过调用<code class="highlighter-rouge">RestTemplateBuilder.create()</code>方法获取，再使用该实例通过自定义的URL进行服务调用，代码如下：</p>
+
+<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">org.springframework.stereotype.Component</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">org.springframework.web.client.RestTemplate</span><span class="o">;</span>
+
+<span class="kn">import</span> <span class="nn">io.servicecomb.foundation.common.utils.BeanUtils</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.foundation.common.utils.Log4jUtils</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.provider.springmvc.reference.RestTemplateBuilder</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.samples.common.schema.models.Person</span><span class="o">;</span>
+
+<span class="nd">@Component</span>
+<span class="kd">public</span> <span class="kd">class</span> <span class="nc">SpringmvcConsumerMain</span> <span class="o">{</span>
+ <span class="kd">private</span> <span class="kd">static</span> <span class="n">RestTemplate</span> <span class="n">restTemplate</span> <span class="o">=</span> <span class="n">RestTemplateBuilder</span><span class="o">.</span><span class="na">create</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="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
+ <span class="n">init</span><span class="o">();</span>
+ <span class="n">Person</span> <span class="n">person</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span><span class="o">();</span>
+ <span class="n">person</span><span class="o">.</span><span class="na">setName</span><span class="o">(</span><span class="s">"ServiceComb/Java Chassis"</span><span class="o">);</span>
+ <span class="n">String</span> <span class="n">sayHiResult</span> <span class="o">=</span> <span class="n">restTemplate</span>
+ <span class="o">.</span><span class="na">postForObject</span><span class="o">(</span><span class="s">"cse://springmvc/springmvchello/sayhi?name=Java Chassis"</span><span class="o">,</span> <span class="kc">null</span><span class="o">,</span> <span class="n">String</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
+ <span class="n">String</span> <span class="n">sayHelloResult</span> <span class="o">=</span> <span class="n">restTemplate</span>
+ <span class="o">.</span><span class="na">postForObject</span><span class="o">(</span><span class="s">"cse://springmvc/springmvchello/sayhello"</span><span class="o">,</span> <span class="n">person</span><span class="o">,</span> <span class="n">String</span><span class="o">.</span><span class="na">class</span><span class="o">);</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"RestTemplate consumer sayhi services: "</span> <span class="o">+</span> <span class="n">sayHiResult</span><span class="o">);</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"RestTemplate consumer sayhello services: "</span> <span class="o">+</span> <span class="n">sayHelloResult</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">init</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
+ <span class="n">Log4jUtils</span><span class="o">.</span><span class="na">init</span><span class="o">();</span>
+ <span class="n">BeanUtils</span><span class="o">.</span><span class="na">init</span><span class="o">();</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre>
+</div>
+
+<blockquote>
+ <p>说明：</p>
+ <ul>
+ <li>URL格式为：<code class="highlighter-rouge">cse://microserviceName/path?querystring</code>。以<a href="/users/develop-with-springmvc/">用SpringMVC开发微服务</a>中定义的服务提供者为例，其微服务名称是<code class="highlighter-rouge">springmvc</code>，basePath是<code class="highlighter-rouge">/springmvchello</code>，那么URL中的microserviceName是<code class="highlighter-rouge">springmvc</code>，请求sayhi时的path是<code class="highlighter-rouge">springmvchello/sayhi</code>，所以示例代码中请求sayhi的URL是<code class="highlighter-rouge">cse://springmvc/springmvchello/sayhi?name=Java Chassis</code>。</li>
+ <li>使用这种URL格式，ServiceComb框架会在内部进行服务发现、熔断容错等处理并最终将请求发送到服务提供者。</li>
+ </ul>
+</blockquote>
+
+
+ </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">Resources</p>
+ <li><a href="/docs/quick-start/">Quick Start</a></li>
+ <li><a href="/users/user-guide/">User Guide</a></li>
+ <li><a href="/slides/">Slides</a></li>
+ <li><a href="/users/faq/">Common Questions</a></li>
+ </ul>
+ </div>
+ <div class="col">
+ <ul>
+ <p class="header">Contribute</p>
+ <li><a href="https://github.com/ServiceComb/ServiceComb.github.io/issues/new?title=Issue with _users/develop-with-rest-template.md">Report a Doc Issue</a></li>
+ <li><a href="https://github.com/ServiceComb/ServiceComb.github.io/edit/master/_users/develop-with-rest-template.md">Edit This Page on Github</a></li>
+ <li><a href="/developers/submit-codes/">Code Submit Guide</a></li>
+ </ul>
+ </div>
+ <div class="col">
+ <ul class="social-icons">
+ <p class="header">Community</p>
+ <li>
+ <a href="https://groups.google.com/forum/#!forum/servicecomb-developers" target="_blank"><span class="group">Dev</span></a> |
+ <a href="https://groups.google.com/forum/#!forum/servicecomb-users" target="_blank">User</span></a>
+ </li>
+ <li>
+ <a href="http://github.com/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>© 2017 Apache incubator ServiceComb. Powered by <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>
+
+ </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>
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/08e1b43f/content/users/develop-with-rpc/index.html
----------------------------------------------------------------------
diff --git a/content/users/develop-with-rpc/index.html b/content/users/develop-with-rpc/index.html
new file mode 100644
index 0000000..d3de2aa
--- /dev/null
+++ b/content/users/develop-with-rpc/index.html
@@ -0,0 +1,721 @@
+<!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="en" class="no-js">
+ <head>
+ <meta charset="utf-8">
+
+<!-- begin SEO -->
+
+
+
+
+
+
+
+
+
+<title>使用RPC方式开发 - Apache incubator ServiceComb</title>
+
+
+
+
+<meta name="description" content="使用RPC方式开发">
+
+
+
+
+<meta name="author" content="">
+
+<meta property="og:locale" content="en">
+<meta property="og:site_name" content="Apache incubator ServiceComb">
+<meta property="og:title" content="使用RPC方式开发">
+
+
+ <link rel="canonical" href="http://github.com/pages/ServiceComb/servicesomb.github.io/users/develop-with-rpc/">
+ <meta property="og:url" content="http://github.com/pages/ServiceComb/servicesomb.github.io/users/develop-with-rpc/">
+
+
+
+ <meta property="og:description" content="使用RPC方式开发">
+
+
+
+ <meta name="twitter:site" content="@ServiceComb">
+ <meta name="twitter:title" content="使用RPC方式开发">
+ <meta name="twitter:description" content="使用RPC方式开发">
+ <meta name="twitter:url" content="">
+
+
+ <meta name="twitter:card" content="summary">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <script type="application/ld+json">
+ {
+ "@context" : "http://schema.org",
+ "@type" : "Person",
+ "name" : "Apache incubator ServiceComb",
+ "url" : "http://github.com/pages/ServiceComb/servicesomb.github.io",
+ "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 incubator 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/js/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">
+<link rel="stylesheet" href="/assets/css/prism.css">
+
+<!--[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.cat.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">
+ <div class="masthead__inner-wrap">
+ <div class="masthead__menu">
+ <nav id="site-nav" class="greedy-nav">
+
+ <a class="site-title active" href="/"><img src="//assets/images/ServiceComb-logo-1.png"></a>
+
+ <ul class="visible-links">
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/docs/quick-start/">Quick Start</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a class="active" href="/users/">Users</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/developers/">Developers</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/year-archive/">Blogs</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/faqs/">FAQ</a>
+
+ </li>
+
+ </ul>
+ <button><div class="navicon"></div></button>
+ <ul class="hidden-links hidden"></ul>
+ <div class="nav-lang">
+
+
+ <a href=/cn/users/develop-with-rpc/>中文</a>
+
+ </div>
+ </nav>
+ </div>
+ </div>
+</div>
+
+
+
+
+
+
+<div id="main" role="main">
+
+ <div class="sidebar sticky">
+
+ <div class="back-to-home">Home > <a href="/">ServiceComb</a></div>
+
+
+
+
+
+
+
+
+
+
+
+<nav class="nav__list">
+
+ <input id="ac-toc" name="accordion-toc" type="checkbox" />
+ <label for="ac-toc">Toggle Menu</label>
+ <ul class="nav__items">
+
+ <li>
+
+ <span class="nav__sub-title">User Guide</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/" class="">Java Chassis Architecture</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/setup-environment/" class="">Setup Environment</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Develop Service Provider</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/service-definition/" class="">Service Definition</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-contract/" class="">Service Contract</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-springmvc/" class="">Develop Microservice with SpringMVC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-jax-rs/" class="">Develop Microservice with JAX-RS</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-transparent-rpc/" class="">Develop Microservice with Transparent RPC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-interface-constraints/" class="">Service Interface Constraints</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-configurations/" class="">Service Configurations</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/communicate-protocol/" class="">Communicate Protocol</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/application-boot-process/" class="">Application Boot Up Process</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-heartbeat/" class="">Service Heartbeat</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Develop Service Consumer</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-rest-template/" class="">Develop with Rest Template</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-rpc/" class="active">Develop with Transparent RPC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/use-service-contract/" class="">Use Service Contract</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/invoke-control/" class="">Invoke Control</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">General Development</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/local-develop-test/" class="">Develop and Test in Local Environment</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/use-servicecomb-in-spring-boot/" class="">Use ServiceComb in Spring Boot</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/distributed-tracing/" class="">Distributed Tracing</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/customized-tracing/" class="">Customized Tracing</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Edging Service</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/edging-service/nginx/" class="">confd and Nginx</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/edging-service/zuul/" class="">Zuul</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
+
+ <a href="/users/metrics/"><span class="nav__sub-title nav__sub-title-with-url">Metrics</span></a>
+
+
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Deployment</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/run-mode/" class="">Run Mode</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Security</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/use-tls/" class="">Use TLS</a></li>
+
+ </ul>
+
+ </li>
+
+ </ul>
+</nav>
+
+
+
+ </div>
+
+
+
+ <article class="page" itemscope itemtype="http://schema.org/CreativeWork">
+ <meta itemprop="headline" content="使用RPC方式开发">
+ <meta itemprop="description" content="使用RPC方式开发">
+
+ <meta itemprop="dateModified" content="August 15, 2017">
+
+ <div class="page__inner-wrap">
+
+
+ <header>
+ <h1 class="page__title" itemprop="headline">使用RPC方式开发
+</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> On This Page</h4></header> -->
+<ul class="toc__menu" id="markdown-toc">
+ <li><a href="#概念阐述" id="markdown-toc-概念阐述">概念阐述</a></li>
+ <li><a href="#示例代码" id="markdown-toc-示例代码">示例代码</a></li>
+</ul>
+
+ </nav>
+</aside>
+
+<h2 id="概念阐述">概念阐述</h2>
+
+<p>RPC开发方式允许用户通过在服务接口上标注注解来生成服务提供者代理，从而进行服务的调用。</p>
+
+<h2 id="示例代码">示例代码</h2>
+
+<p>只需要声明一个服务接口类型的成员，并且使用<code class="highlighter-rouge">@RpcReference</code>标注该成员，声明依赖的微服务及schemaId，即可进行服务调用，示例代码如下：</p>
+
+<div class="language-java highlighter-rouge"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">org.springframework.stereotype.Component</span><span class="o">;</span>
+
+<span class="kn">import</span> <span class="nn">io.servicecomb.foundation.common.utils.BeanUtils</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.foundation.common.utils.Log4jUtils</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.provider.pojo.RpcReference</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.samples.common.schema.Hello</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">io.servicecomb.samples.common.schema.models.Person</span><span class="o">;</span>
+
+<span class="nd">@Component</span>
+<span class="kd">public</span> <span class="kd">class</span> <span class="nc">CodeFirstConsumerMain</span> <span class="o">{</span>
+ <span class="nd">@RpcReference</span><span class="o">(</span><span class="n">microserviceName</span> <span class="o">=</span> <span class="s">"codefirst"</span><span class="o">,</span> <span class="n">schemaId</span> <span class="o">=</span> <span class="s">"codeFirstHello"</span><span class="o">)</span>
+ <span class="kd">private</span> <span class="kd">static</span> <span class="n">Hello</span> <span class="n">hello</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="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
+ <span class="n">init</span><span class="o">();</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="n">hello</span><span class="o">.</span><span class="na">sayHi</span><span class="o">(</span><span class="s">"Java Chassis"</span><span class="o">));</span>
+ <span class="n">Person</span> <span class="n">person</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Person</span><span class="o">();</span>
+ <span class="n">person</span><span class="o">.</span><span class="na">setName</span><span class="o">(</span><span class="s">"ServiceComb/Java Chassis"</span><span class="o">);</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="n">hello</span><span class="o">.</span><span class="na">sayHello</span><span class="o">(</span><span class="n">person</span><span class="o">));</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">init</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
+ <span class="n">Log4jUtils</span><span class="o">.</span><span class="na">init</span><span class="o">();</span>
+ <span class="n">BeanUtils</span><span class="o">.</span><span class="na">init</span><span class="o">();</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre>
+</div>
+
+<p>在以上代码中，服务消费者已经取得了服务提供者的服务接口<code class="highlighter-rouge">Hello</code>，并在代码中声明一个<code class="highlighter-rouge">Hello</code>类型的成员。通过在<code class="highlighter-rouge">hello</code>上使用<code class="highlighter-rouge">@RPCReference</code>注解指明微服务名称和schemaId，ServiceComb框架可以在程序启动时从服务中心获取到对应的服务提供者实例信息，并且生成一个代理注入到hello中，用户可以像调用本地类一样调用远程服务。</p>
+
+
+ </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">Resources</p>
+ <li><a href="/docs/quick-start/">Quick Start</a></li>
+ <li><a href="/users/user-guide/">User Guide</a></li>
+ <li><a href="/slides/">Slides</a></li>
+ <li><a href="/users/faq/">Common Questions</a></li>
+ </ul>
+ </div>
+ <div class="col">
+ <ul>
+ <p class="header">Contribute</p>
+ <li><a href="https://github.com/ServiceComb/ServiceComb.github.io/issues/new?title=Issue with _users/develop-with-rpc.md">Report a Doc Issue</a></li>
+ <li><a href="https://github.com/ServiceComb/ServiceComb.github.io/edit/master/_users/develop-with-rpc.md">Edit This Page on Github</a></li>
+ <li><a href="/developers/submit-codes/">Code Submit Guide</a></li>
+ </ul>
+ </div>
+ <div class="col">
+ <ul class="social-icons">
+ <p class="header">Community</p>
+ <li>
+ <a href="https://groups.google.com/forum/#!forum/servicecomb-developers" target="_blank"><span class="group">Dev</span></a> |
+ <a href="https://groups.google.com/forum/#!forum/servicecomb-users" target="_blank">User</span></a>
+ </li>
+ <li>
+ <a href="http://github.com/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>© 2017 Apache incubator ServiceComb. Powered by <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>
+
+ </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>
http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/08e1b43f/content/users/develop-with-springmvc/index.html
----------------------------------------------------------------------
diff --git a/content/users/develop-with-springmvc/index.html b/content/users/develop-with-springmvc/index.html
new file mode 100644
index 0000000..1b06848
--- /dev/null
+++ b/content/users/develop-with-springmvc/index.html
@@ -0,0 +1,831 @@
+<!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="en" class="no-js">
+ <head>
+ <meta charset="utf-8">
+
+<!-- begin SEO -->
+
+
+
+
+
+
+
+
+
+<title>用SpringMVC开发微服务 - Apache incubator ServiceComb</title>
+
+
+
+
+<meta name="description" content="用SpringMVC开发微服务">
+
+
+
+
+<meta name="author" content="">
+
+<meta property="og:locale" content="en">
+<meta property="og:site_name" content="Apache incubator ServiceComb">
+<meta property="og:title" content="用SpringMVC开发微服务">
+
+
+ <link rel="canonical" href="http://github.com/pages/ServiceComb/servicesomb.github.io/users/develop-with-springmvc/">
+ <meta property="og:url" content="http://github.com/pages/ServiceComb/servicesomb.github.io/users/develop-with-springmvc/">
+
+
+
+ <meta property="og:description" content="用SpringMVC开发微服务">
+
+
+
+ <meta name="twitter:site" content="@ServiceComb">
+ <meta name="twitter:title" content="用SpringMVC开发微服务">
+ <meta name="twitter:description" content="用SpringMVC开发微服务">
+ <meta name="twitter:url" content="">
+
+
+ <meta name="twitter:card" content="summary">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <script type="application/ld+json">
+ {
+ "@context" : "http://schema.org",
+ "@type" : "Person",
+ "name" : "Apache incubator ServiceComb",
+ "url" : "http://github.com/pages/ServiceComb/servicesomb.github.io",
+ "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 incubator 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/js/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">
+<link rel="stylesheet" href="/assets/css/prism.css">
+
+<!--[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.cat.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">
+ <div class="masthead__inner-wrap">
+ <div class="masthead__menu">
+ <nav id="site-nav" class="greedy-nav">
+
+ <a class="site-title active" href="/"><img src="//assets/images/ServiceComb-logo-1.png"></a>
+
+ <ul class="visible-links">
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/docs/quick-start/">Quick Start</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a class="active" href="/users/">Users</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/developers/">Developers</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/year-archive/">Blogs</a>
+
+ </li>
+
+
+ <li class="masthead__menu-item">
+
+
+
+ <a href="/faqs/">FAQ</a>
+
+ </li>
+
+ </ul>
+ <button><div class="navicon"></div></button>
+ <ul class="hidden-links hidden"></ul>
+ <div class="nav-lang">
+
+
+ <a href=/cn/users/develop-with-springmvc/>中文</a>
+
+ </div>
+ </nav>
+ </div>
+ </div>
+</div>
+
+
+
+
+
+
+<div id="main" role="main">
+
+ <div class="sidebar sticky">
+
+ <div class="back-to-home">Home > <a href="/">ServiceComb</a></div>
+
+
+
+
+
+
+
+
+
+
+
+<nav class="nav__list">
+
+ <input id="ac-toc" name="accordion-toc" type="checkbox" />
+ <label for="ac-toc">Toggle Menu</label>
+ <ul class="nav__items">
+
+ <li>
+
+ <span class="nav__sub-title">User Guide</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/" class="">Java Chassis Architecture</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/setup-environment/" class="">Setup Environment</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Develop Service Provider</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/service-definition/" class="">Service Definition</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-contract/" class="">Service Contract</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-springmvc/" class="active">Develop Microservice with SpringMVC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-jax-rs/" class="">Develop Microservice with JAX-RS</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-transparent-rpc/" class="">Develop Microservice with Transparent RPC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-interface-constraints/" class="">Service Interface Constraints</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-configurations/" class="">Service Configurations</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/communicate-protocol/" class="">Communicate Protocol</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/application-boot-process/" class="">Application Boot Up Process</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/service-heartbeat/" class="">Service Heartbeat</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Develop Service Consumer</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-rest-template/" class="">Develop with Rest Template</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/develop-with-rpc/" class="">Develop with Transparent RPC</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/use-service-contract/" class="">Use Service Contract</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/invoke-control/" class="">Invoke Control</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">General Development</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/local-develop-test/" class="">Develop and Test in Local Environment</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/use-servicecomb-in-spring-boot/" class="">Use ServiceComb in Spring Boot</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/distributed-tracing/" class="">Distributed Tracing</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/customized-tracing/" class="">Customized Tracing</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Edging Service</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/edging-service/nginx/" class="">confd and Nginx</a></li>
+
+
+
+
+
+
+
+ <li><a href="/users/edging-service/zuul/" class="">Zuul</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
+
+ <a href="/users/metrics/"><span class="nav__sub-title nav__sub-title-with-url">Metrics</span></a>
+
+
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Deployment</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/run-mode/" class="">Run Mode</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Security</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/users/use-tls/" class="">Use TLS</a></li>
+
+ </ul>
+
+ </li>
+
+ </ul>
+</nav>
+
+
+
+ </div>
+
+
+
+ <article class="page" itemscope itemtype="http://schema.org/CreativeWork">
+ <meta itemprop="headline" content="用SpringMVC开发微服务">
+ <meta itemprop="description" content="用SpringMVC开发微服务">
+
+ <meta itemprop="dateModified" content="August 15, 2017">
+
+ <div class="page__inner-wrap">
+
+
+ <header>
+ <h1 class="page__title" itemprop="headline">用SpringMVC开发微服务
+</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> On This Page</h4></header> -->
+<ul class="toc__menu" id="markdown-toc">
+ <li><a href="#概念阐述" id="markdown-toc-概念阐述">概念阐述</a></li>
+ <li><a href="#开发示例" id="markdown-toc-开发示例">开发示例</a></li>
+ <li><a href="#涉及api" id="markdown-toc-涉及api">涉及API</a></li>
+</ul>
+
+ </nav>
+</aside>
+
+<h2 id="概念阐述">概念阐述</h2>
+
+<p>ServiceComb支持SpringMVC注解，允许使用SpringMVC风格开发微服务。</p>
+
+<h2 id="开发示例">开发示例</h2>
+
+<ul>
+ <li>
+ <p><strong>步骤 1</strong> 定义服务接口。</p>
+
+ <p>根据开发之前定义好的契约，编写Java业务接口，代码如下：</p>
+
+ <div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kd">public</span> <span class="kd">interface</span> <span class="nc">Hello</span> <span class="o">{</span>
+ <span class="n">String</span> <span class="nf">sayHi</span><span class="o">(</span><span class="n">String</span> <span class="n">name</span><span class="o">);</span>
+ <span class="n">String</span> <span class="nf">sayHello</span><span class="o">(</span><span class="n">Person</span> <span class="n">person</span><span class="o">);</span>
+ <span class="o">}</span>
+</code></pre>
+ </div>
+
+ <p>该接口的位置需要与契约中x-java-interface所指定的路径一致。</p>
+ </li>
+ <li>
+ <p><strong>步骤 2</strong> 实现服务。</p>
+
+ <p>使用Spring MVC注解开发业务代码，Hello的服务实现如下：</p>
+
+ <div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kn">import</span> <span class="nn">javax.ws.rs.core.MediaType</span><span class="o">;</span>
+ <span class="kn">import</span> <span class="nn">org.springframework.web.bind.annotation.RequestBody</span><span class="o">;</span>
+ <span class="kn">import</span> <span class="nn">org.springframework.web.bind.annotation.RequestMapping</span><span class="o">;</span>
+ <span class="kn">import</span> <span class="nn">org.springframework.web.bind.annotation.RequestMethod</span><span class="o">;</span>
+ <span class="kn">import</span> <span class="nn">org.springframework.web.bind.annotation.RequestParam</span><span class="o">;</span>
+ <span class="kn">import</span> <span class="nn">io.servicecomb.samples.common.schema.Hello</span><span class="o">;</span>
+ <span class="kn">import</span> <span class="nn">io.servicecomb.samples.common.schema.models.Person</span><span class="o">;</span>
+
+ <span class="nd">@RequestMapping</span><span class="o">(</span><span class="n">path</span> <span class="o">=</span> <span class="s">"/springmvchello"</span><span class="o">,</span> <span class="n">produces</span> <span class="o">=</span> <span class="n">MediaType</span><span class="o">.</span><span class="na">APPLICATION_JSON</span><span class="o">)</span>
+ <span class="kd">public</span> <span class="kd">class</span> <span class="nc">SpringmvcHelloImpl</span> <span class="kd">implements</span> <span class="n">Hello</span> <span class="o">{</span>
+ <span class="nd">@Override</span>
+ <span class="nd">@RequestMapping</span><span class="o">(</span><span class="n">path</span> <span class="o">=</span> <span class="s">"/sayhi"</span><span class="o">,</span> <span class="n">method</span> <span class="o">=</span> <span class="n">RequestMethod</span><span class="o">.</span><span class="na">POST</span><span class="o">)</span>
+ <span class="kd">public</span> <span class="n">String</span> <span class="nf">sayHi</span><span class="o">(</span><span class="nd">@RequestParam</span><span class="o">(</span><span class="n">name</span> <span class="o">=</span> <span class="s">"name"</span><span class="o">)</span> <span class="n">String</span> <span class="n">name</span><span class="o">)</span> <span class="o">{</span>
+ <span class="err"> </span> <span class="k">return</span> <span class="s">"Hello "</span> <span class="o">+</span> <span class="n">name</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="nd">@Override</span>
+ <span class="nd">@RequestMapping</span><span class="o">(</span><span class="n">path</span> <span class="o">=</span> <span class="s">"/sayhello"</span><span class="o">,</span> <span class="n">method</span> <span class="o">=</span> <span class="n">RequestMethod</span><span class="o">.</span><span class="na">POST</span><span class="o">)</span>
+ <span class="kd">public</span> <span class="n">String</span> <span class="nf">sayHello</span><span class="o">(</span><span class="nd">@RequestBody</span> <span class="n">Person</span> <span class="n">person</span><span class="o">)</span> <span class="o">{</span>
+ <span class="err"> </span> <span class="k">return</span> <span class="s">"Hello person "</span> <span class="o">+</span> <span class="n">person</span><span class="o">.</span><span class="na">getName</span><span class="o">();</span>
+ <span class="err"> </span><span class="o">}</span>
+ <span class="o">}</span>
+</code></pre>
+ </div>
+ </li>
+ <li>
+ <p><strong>步骤 3</strong> 发布服务</p>
+
+ <p>在服务的实现类上打上注解@RestSchema，指定schemaId，表示该实现作为当前微服务的一个schema发布，代码如下：</p>
+
+ <div class="language-java highlighter-rouge"><pre class="highlight"><code> <span class="kn">import</span> <span class="nn">io.servicecomb.provider.rest.common.RestSchema</span><span class="o">;</span>
+ <span class="c1">// other code omitted</span>
+ <span class="nd">@RestSchema</span><span class="o">(</span><span class="n">schemaId</span> <span class="o">=</span> <span class="s">"springmvcHello"</span><span class="o">)</span>
+ <span class="kd">public</span> <span class="kd">class</span> <span class="nc">SpringmvcHelloImpl</span> <span class="kd">implements</span> <span class="n">Hello</span> <span class="o">{</span>
+ <span class="c1">// other code omitted</span>
+ <span class="o">}</span>
+</code></pre>
+ </div>
+
+ <p>然后在<code class="highlighter-rouge">resources/META-INF/spring</code>目录下创建<code class="highlighter-rouge">springmvcHello.bean.xml</code>文件，命名规则为<code class="highlighter-rouge">\*.bean.xml</code>，配置spring进行服务扫描的base-package，文件内容如下：</p>
+
+ <div class="language-xml highlighter-rouge"><pre class="highlight"><code> <span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
+
+ <span class="nt"><beans</span> <span class="na">xmlns=</span><span class="s">"http://www.springframework.org/schema/beans"</span>
+ <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span>
+ <span class="na">xmlns:context=</span><span class="s">"http://www.springframework.org/schema/context"</span>
+ <span class="na">xsi:schemaLocation=</span><span class="s">"http://www.springframework.org/schema/beans</span> <span class="err">classpath:org/springframework/beans/factory/xml/spring-beans-3.0.xsd</span>
+ <span class="err">http://www.springframework.org/schema/context</span> <span class="err">http://www.springframework.org/schema/context/spring-context-3.0.xsd"</span><span class="nt">></span>
+
+ <span class="nt"><context:component-scan</span> <span class="na">base-package=</span><span class="s">"io.servicecomb.samples.springmvc.povider"</span><span class="nt">/></span>
+ <span class="nt"></beans></span>
+</code></pre>
+ </div>
+ </li>
+</ul>
+
+<h2 id="涉及api">涉及API</h2>
+
+<p>Spring MVC开发模式当前支持org.springframework.web.bind.annotation包下的如下注解，所有注解的使用方法参考<a href="https://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html">Spring MVC官方文档</a>。</p>
+
+<table>
+ <thead>
+ <tr>
+ <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">RequestMapping</td>
+ <td style="text-align: left">schema/operation</td>
+ <td style="text-align: left">支持标注path/method/produces三种数据，operation默认继承schema上的produces</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">GetMapping</td>
+ <td style="text-align: left">schema/operation</td>
+ <td style="text-align: left">支持标注path/produces两种数据，operation默认继承schema上的produces</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">PutMapping</td>
+ <td style="text-align: left">schema/operation</td>
+ <td style="text-align: left">支持标注path/produces两种数据，operation默认继承schema上的produces</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">PostMapping</td>
+ <td style="text-align: left">schema/operation</td>
+ <td style="text-align: left">支持标注path/produces两种数据，operation默认继承schema上的produces</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">DeleteMapping</td>
+ <td style="text-align: left">schema/operation</td>
+ <td style="text-align: left">支持标注path/produces两种数据，operation默认继承schema上的produces</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">PatchMapping</td>
+ <td style="text-align: left">schema/operation</td>
+ <td style="text-align: left">支持标注path/produces两种数据，operation默认继承schema上的produces</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">PathVariable</td>
+ <td style="text-align: left">parameter</td>
+ <td style="text-align: left">从path中获取参数</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">RequestParam</td>
+ <td style="text-align: left">parameter</td>
+ <td style="text-align: left">从query中获取参数</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">RequestHeader</td>
+ <td style="text-align: left">parameter</td>
+ <td style="text-align: left">从header中获取参数</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">RequestBody</td>
+ <td style="text-align: left">parameter</td>
+ <td style="text-align: left">从body中获取参数，每个operation只能有一个body参数</td>
+ </tr>
+ </tbody>
+</table>
+
+
+ </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">Resources</p>
+ <li><a href="/docs/quick-start/">Quick Start</a></li>
+ <li><a href="/users/user-guide/">User Guide</a></li>
+ <li><a href="/slides/">Slides</a></li>
+ <li><a href="/users/faq/">Common Questions</a></li>
+ </ul>
+ </div>
+ <div class="col">
+ <ul>
+ <p class="header">Contribute</p>
+ <li><a href="https://github.com/ServiceComb/ServiceComb.github.io/issues/new?title=Issue with _users/develop-with-springmvc.md">Report a Doc Issue</a></li>
+ <li><a href="https://github.com/ServiceComb/ServiceComb.github.io/edit/master/_users/develop-with-springmvc.md">Edit This Page on Github</a></li>
+ <li><a href="/developers/submit-codes/">Code Submit Guide</a></li>
+ </ul>
+ </div>
+ <div class="col">
+ <ul class="social-icons">
+ <p class="header">Community</p>
+ <li>
+ <a href="https://groups.google.com/forum/#!forum/servicecomb-developers" target="_blank"><span class="group">Dev</span></a> |
+ <a href="https://groups.google.com/forum/#!forum/servicecomb-users" target="_blank">User</span></a>
+ </li>
+ <li>
+ <a href="http://github.com/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>© 2017 Apache incubator ServiceComb. Powered by <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>
+
+ </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>