Repository: incubator-servicecomb-website
Updated Branches:
  refs/heads/asf-site d18d3e627 -> dd9482e3c


http://git-wip-us.apache.org/repos/asf/incubator-servicecomb-website/blob/08e1b43f/content/users/use-servicecomb-in-spring-boot/index.html
----------------------------------------------------------------------
diff --git a/content/users/use-servicecomb-in-spring-boot/index.html 
b/content/users/use-servicecomb-in-spring-boot/index.html
new file mode 100644
index 0000000..a75192a
--- /dev/null
+++ b/content/users/use-servicecomb-in-spring-boot/index.html
@@ -0,0 +1,940 @@
+<!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>在Spring Boot中使用ServiceComb - Apache incubator 
ServiceComb</title>
+
+
+
+
+<meta name="description" content="在Spring Boot中使用ServiceComb">
+
+
+
+
+<meta name="author" content="">
+
+<meta property="og:locale" content="en">
+<meta property="og:site_name" content="Apache incubator ServiceComb">
+<meta property="og:title" content="在Spring Boot中使用ServiceComb">
+
+
+  <link rel="canonical" 
href="http://github.com/pages/ServiceComb/servicesomb.github.io/users/use-servicecomb-in-spring-boot/";>
+  <meta property="og:url" 
content="http://github.com/pages/ServiceComb/servicesomb.github.io/users/use-servicecomb-in-spring-boot/";>
+
+
+
+  <meta property="og:description" content="在Spring Boot中使用ServiceComb">
+
+
+
+  <meta name="twitter:site" content="@ServiceComb">
+  <meta name="twitter:title" content="在Spring Boot中使用ServiceComb">
+  <meta name="twitter:description" content="在Spring 
Boot中使用ServiceComb">
+  <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/use-servicecomb-in-spring-boot/>中文</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="">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="active">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="在Spring Boot中使用ServiceComb">
+    <meta itemprop="description" content="在Spring Boot中使用ServiceComb">
+    
+    <meta itemprop="dateModified" content="August 15, 2017">
+
+    <div class="page__inner-wrap">
+      
+        
+          <header>
+            <h1 class="page__title" itemprop="headline">在Spring 
Boot中使用ServiceComb
+</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="#使用service-center和治理中心管理spring-cloud应用" 
id="markdown-toc-使用service-center和治理中心管理spring-cloud应用">使用Service
 Center和治理中心管理Spring Cloud应用</a>    <ul>
+      <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>
+  </li>
+  <li><a href="#在servicecomb框架中集成spring-boot框架" 
id="markdown-toc-在servicecomb框架中集成spring-boot框架">在ServiceComb框架中集成Spring
 Boot框架</a>    <ul>
+      <li><a href="#概念阐述-1" 
id="markdown-toc-概念阐述-1">概念阐述</a></li>
+      <li><a href="#场景描述-1" 
id="markdown-toc-场景描述-1">场景描述</a></li>
+      <li><a href="#servicecomb集成springboot" 
id="markdown-toc-servicecomb集成springboot">ServiceComb集成SpringBoot</a></li>
+    </ul>
+  </li>
+</ul>
+
+  </nav>
+</aside>
+
+<h2 
id="使用service-center和治理中心管理spring-cloud应用">使用Service 
Center和治理中心管理Spring Cloud应用</h2>
+<h3 id="概念阐述">概念阐述</h3>
+
+<p>本小节介绍在SpringCloud原生应用中,通过改变相关é…
ç½®ï¼Œè®©SpringCloud应用使用ServiceComb微服务框架中的Service 
Center和治理中心。</p>
+
+<h3 id="场景描述">场景描述</h3>
+
+<ul>
+  <li>
+    <p>SpringCloud应用默认情况下由Spring Cloud 
Eureka提供在分布式环境下的服务发现和服务注册的功能。</p>
+
+    <p><img 
src="/assets/images/manage_springcloud_application_using_sc_and_gs.png" alt="" 
/></p>
+  </li>
+  <li>
+    <p>ServiceComb微服务框架中的Service Center用于服务å…
ƒæ•°æ®ä»¥åŠæœåŠ¡å®žä¾‹å…
ƒæ•°æ®çš„管理和处理注册、发现,同时还支持以下功能:</p>
+  </li>
+</ul>
+
+<blockquote>
+  <ul>
+    <li>
+      <p>支持pull/push两种模式监控实例变化</p>
+    </li>
+    <li>
+      <p>实例动态扩容,海量的长连接或者短连接</p>
+    </li>
+    <li>
+      <p>支持灰度发布、服务分组等高级管理特性</p>
+    </li>
+  </ul>
+</blockquote>
+
+<p>使用SpringBoot/Cloud开发应用,并让服务运行于ServiceComb微服务SDK容器中,使用å
…¶é«˜æ€§èƒ½é€šä¿¡ã€æœåŠ¡æ²»ç†ã€åˆ†å¸ƒå¼äº‹åŠ¡ç®¡ç†ç­‰åŠŸèƒ½ã€‚</p>
+
+<h3 id="配置说明">配置说明</h3>
+
+<p>使用SpringBoot/Cloud开发应用,在原有应用的基础上按ç…
§ä»¥ä¸‹æ­¥éª¤è¿›è¡Œæ“ä½œï¼Œå³å¯å¯¹æŽ¥ServiceComb的SDK各组件:</p>
+
+<ul>
+  <li>
+    <p><strong>步骤 1</strong> 在pom中添加
依赖管理dependencyManagement:</p>
+
+    <div class="language-xml highlighter-rouge"><pre class="highlight"><code> 
<span class="nt">&lt;dependencyManagement&gt;</span>
+   <span class="nt">&lt;dependencies&gt;</span>
+     <span class="nt">&lt;dependency&gt;</span>
+       <span class="nt">&lt;groupId&gt;</span>io.servicecomb<span 
class="nt">&lt;/groupId&gt;</span>
+       <span 
class="nt">&lt;artifactId&gt;</span>java-chassis-dependencies<span 
class="nt">&lt;/artifactId&gt;</span>
+       <span class="nt">&lt;version&gt;</span>0.1.0<span 
class="nt">&lt;/version&gt;</span>
+       <span class="nt">&lt;type&gt;</span>pom<span 
class="nt">&lt;/type&gt;</span>
+       <span class="nt">&lt;scope&gt;</span>import<span 
class="nt">&lt;/scope&gt;</span>
+     <span class="nt">&lt;/dependency&gt;</span>
+   <span class="nt">&lt;/dependencies&gt;</span>
+ <span class="nt">&lt;/dependencyManagement&gt;</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 2</strong> 在pom中添加依赖:</p>
+
+    <div class="language-xml highlighter-rouge"><pre class="highlight"><code> 
<span class="nt">&lt;dependency&gt;</span>
+   <span class="c">&lt;!--让服务运行于微服务sdk容器中--&gt;</span>
+   <span class="nt">&lt;group&gt;</span>io.servicecomb<span 
class="nt">&lt;/group&gt;</span>
+   <span class="nt">&lt;artifactId&gt;</span>spring-boot-starter-provider<span 
class="nt">&lt;/artifactId&gt;</span>
+ <span class="nt">&lt;/dependency&gt;</span>
+ <span class="nt">&lt;dependency&gt;</span>
+   <span class="c">&lt;!--使用服务中心--&gt;</span>
+   <span class="nt">&lt;group&gt;</span>io.servicecomb<span 
class="nt">&lt;/group&gt;</span>
+   <span 
class="nt">&lt;artifactId&gt;</span>spring-boot-starter-discovery<span 
class="nt">&lt;/artifactId&gt;</span>
+ <span class="nt">&lt;/dependency&gt;</span>
+ <span class="nt">&lt;dependency&gt;</span>
+   <span class="c">&lt;!--让服务运行于Spring boot embeded 
tomat中--&gt;</span>
+   <span class="nt">&lt;group&gt;</span>io.servicecomb<span 
class="nt">&lt;/group&gt;</span>
+   <span 
class="nt">&lt;artifactId&gt;</span>spring-boot-starter-transport<span 
class="nt">&lt;/artifactId&gt;</span>
+ <span class="nt">&lt;/dependency&gt;</span>
+ <span class="nt">&lt;dependency&gt;</span>
+   <span class="nt">&lt;groupId&gt;</span>org.springframework.boot<span 
class="nt">&lt;/groupId&gt;</span>
+   <span class="nt">&lt;artifactId&gt;</span>spring-boot-starter-web<span 
class="nt">&lt;/artifactId&gt;</span>
+ <span class="nt">&lt;/dependency&gt;&lt;dependency&gt;</span>
+   <span class="nt">&lt;groupId&gt;</span>org.springframework.boot<span 
class="nt">&lt;/groupId&gt;</span>
+   <span class="nt">&lt;artifactId&gt;</span>spring-boot-starter-actuator<span 
class="nt">&lt;/artifactId&gt;</span>
+ <span class="nt">&lt;/dependency&gt;</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 3</strong> 配置处理链和协议:</p>
+
+    
<p>在resources目录下新建microservice.yaml文件,对服务进行定义,详细定义规则请参考<a
 href="/users/service-definition/">服务定义章节</a>,示例如下:</p>
+
+    <div class="language-yaml highlighter-rouge"><pre class="highlight"><code> 
<span class="s">APPLICATION_ID</span><span class="pi">:</span> <span 
class="s">discoverytest</span>
+ <span class="s">service_description</span><span class="pi">:</span>
+   <span class="s">name</span><span class="pi">:</span> <span 
class="s">discoveryServer</span>
+   <span class="s">version</span><span class="pi">:</span> <span 
class="s">0.0.2</span>
+ <span class="s">cse</span><span class="pi">:</span>
+   <span class="s">service</span><span class="pi">:</span>
+     <span class="s">registry</span><span class="pi">:</span>
+       <span class="s">address</span><span class="pi">:</span>  <span 
class="s">http://127.0.0.1:30100</span> <span 
class="c1">#服务注册中心地址</span>
+   <span class="err"> </span><span class="s">rest</span><span 
class="pi">:</span>
+      <span class="s">address</span><span class="pi">:</span> <span 
class="s">0.0.0.0:8080</span> <span class="c1">#服务发布的端口</span>
+    <span class="s">handler</span><span class="pi">:</span>
+      <span class="s">chain</span><span class="pi">:</span>
+        <span class="s">Provider</span><span class="pi">:</span>
+          <span class="s">default</span><span class="pi">:</span> <span 
class="s">bizkeeper-provider</span> <span class="c1">#调用的处理链</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤4</strong> 若要使用ServiceComb的服务中心:</p>
+
+    <p>在pom中添加依赖:</p>
+
+    <div class="language-java highlighter-rouge"><pre class="highlight"><code> 
<span class="o">&lt;</span><span class="n">dependency</span><span 
class="o">&gt;</span>
+   <span class="o">&lt;!--</span><span 
class="err">使用服务中心</span><span class="o">--&gt;</span>
+   <span class="o">&lt;</span><span class="n">group</span><span 
class="o">&gt;</span><span class="n">io</span><span class="o">.</span><span 
class="na">servicecomb</span><span class="o">&lt;/</span><span 
class="n">group</span><span class="o">&gt;</span>
+   <span class="o">&lt;</span><span class="n">artifactId</span><span 
class="o">&gt;</span><span class="n">spring</span><span class="o">-</span><span 
class="n">boot</span><span class="o">-</span><span 
class="n">starter</span><span class="o">-</span><span 
class="n">discovery</span><span class="o">&lt;/</span><span 
class="n">artifactId</span><span class="o">&gt;</span>
+ <span class="o">&lt;/</span><span class="n">dependency</span><span 
class="o">&gt;</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 5</strong> 在启动类添加
注解@EnableServiceComb:</p>
+
+    <div class="language-java highlighter-rouge"><pre class="highlight"><code> 
<span class="nd">@EnableDiscoveryClient</span>
+ <span class="nd">@SpringBootApplication</span>
+ <span class="nd">@EnableServiceComb</span> <span 
class="c1">//新增注解</span>
+ <span class="kd">public</span> <span class="kd">class</span> <span 
class="nc">xxxServer</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="o">{</span>
+     <span class="n">SpringApplication</span><span class="o">.</span><span 
class="na">run</span><span class="o">(</span><span 
class="n">xxxServer</span><span class="o">.</span><span 
class="na">class</span><span class="o">,</span> <span 
class="n">args</span><span class="o">);</span>
+   <span class="o">}</span>
+ <span class="o">}</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 6</strong> 定义服务契约,具体请参考<a 
href="/users/service-contract/">服务契约</a>,示例如下:</p>
+
+    <div class="language-java highlighter-rouge"><pre class="highlight"><code> 
<span class="c1">// ControllerImpl.class:</span>
+ <span class="nd">@RestSchema</span><span class="o">(</span><span 
class="n">schemaId</span> <span class="o">=</span> <span 
class="s">"test"</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">"/compute"</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">TEXT_PLAIN</span><span class="o">)</span>
+ <span class="kd">public</span> <span class="kd">class</span> <span 
class="nc">ControllerImpl</span> <span class="o">{</span>
+   <span class="nd">@ResponseBody</span>
+   <span class="nd">@RequestMapping</span><span class="o">(</span><span 
class="n">path</span> <span class="o">=</span> <span 
class="s">"/hello/{name}"</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">GET</span><span class="o">)</span>
+   <span class="kd">public</span> <span class="n">String</span> <span 
class="nf">add</span><span class="o">(</span><span 
class="nd">@PathVariable</span> <span class="n">String</span> <span 
class="n">name</span><span class="o">)</span> <span class="o">{</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="o">}</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 7</strong> 
启动xxxServer,该服务便可注册到ServieComb的Service Center。</p>
+  </li>
+</ul>
+
+<h2 
id="在servicecomb框架中集成spring-boot框架">在ServiceComb框架中集成Spring
 Boot框架</h2>
+<h3 id="概念阐述-1">概念阐述</h3>
+
+<p>本小节介绍了在ServiceComb框架中集成SpringBoot框架的好处和操作步骤。</p>
+
+<h3 id="场景描述-1">场景描述</h3>
+
+<h4 id="springboot框架"><strong>SpringBoot框架</strong></h4>
+
+<p>  Spring Boot是由Pivotal团队提供的全新框架,å…
¶è®¾è®¡ç›®çš„是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行é
…ç½®ï¼Œä»Žè€Œä½¿å¼€å‘人员不再需要定义样板化的配置。从最æ 
¹æœ¬ä¸Šæ¥è®²ï¼ŒSpring 
Boot就是一些库的集合,它能够被任意项目的构建系统所使用。Boot的功能是模块化的,通过导å
…¥Boot所谓的”starter”模块,可以将许多的依赖添加
到工程中。</p>
+
+<h4 
id="在servicecomb中集成springboot"><strong>在ServiceComb中集成SpringBoot</strong></h4>
+
+<p>  使用原生的ServiceComb框架开发微服务应用,如若需要使用ServiceComb框架提供的各项功能服务,需要在微服务项目工程pom文件中添åŠ
 ç›¸åº”的依赖包
,例如需要使用ServiceComb框架提供的负载均衡服务,需要添加
handler-loadbalance包依赖。这æ 
·å¯ä»¥æŠŠServiceComb提供的能力以starter的方式插入Spring 
Boot中,同时使用Spring Boot中提供的å…
¶ä»–开箱即用的starter(例如SpringCloud)一起构建微服务。</p>
+
+<h3 id="servicecomb集成springboot">ServiceComb集成SpringBoot</h3>
+
+<p>  首å…
ˆä½¿ç”¨ServiceComb框架开发微服务应用,详细步骤请参考<a 
href="/users/service-definition/">开发服务提供者</a>与<a 
href="/users/develop-with-rest-template/">开发服务消费者
</a>。然后在这个基础上集成SpringBoot框架。</p>
+
+<p>  在对应用进行SpringBoot框架适é…
å‰ï¼Œè¯·ç¡®ä¿åº”用能够正常运行,并且能够从中央的maven库下载依赖的资源。</p>
+
+<ul>
+  <li>
+    <p><strong>步骤 1</strong> 在工程pom文件添加
&lt;dependencyManagement&gt;节点:</p>
+
+    <div class="language-xml highlighter-rouge"><pre class="highlight"><code> 
<span class="nt">&lt;dependencyManagement&gt;</span> 
+   <span class="nt">&lt;dependencies&gt;</span> 
+     <span class="nt">&lt;dependency&gt;</span> 
+       <span class="nt">&lt;groupId&gt;</span>io.servicecomb<span 
class="nt">&lt;/groupId&gt;</span>
+       <span 
class="nt">&lt;artifactId&gt;</span>java-chassis-dependencies<span 
class="nt">&lt;/artifactId&gt;</span>
+       <span class="nt">&lt;version&gt;</span>0.1.0<span 
class="nt">&lt;/version&gt;</span>
+       <span class="nt">&lt;type&gt;</span>pom<span 
class="nt">&lt;/type&gt;</span>
+       <span class="nt">&lt;scope&gt;</span>import<span 
class="nt">&lt;/scope&gt;</span>
+     <span class="nt">&lt;/dependency&gt;</span>
+   <span class="nt">&lt;/dependencies&gt;</span>
+ <span class="nt">&lt;/dependencyManagement&gt;</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 2</strong> 添加如下依赖:</p>
+
+    <p>引入ServiceComb提供的Spring Boot依赖</p>
+
+    <div class="language-xml highlighter-rouge"><pre class="highlight"><code> 
<span class="nt">&lt;dependency&gt;</span> 
+   <span class="nt">&lt;groupId&gt;</span>io.servicecomb<span 
class="nt">&lt;/groupId&gt;</span>
+   <span class="nt">&lt;artifactId&gt;</span>spring-boot-starter-provider<span 
class="nt">&lt;/artifactId&gt;</span> 
+ <span class="nt">&lt;/dependency&gt;</span>
+</code></pre>
+    </div>
+
+    <p>引入Spring Boot依赖</p>
+
+    <div class="language-xml highlighter-rouge"><pre class="highlight"><code> 
<span class="nt">&lt;dependency&gt;</span> 
+   <span class="nt">&lt;groupId&gt;</span>org.springframework.boot<span 
class="nt">&lt;/groupId&gt;</span>
+   <span class="nt">&lt;artifactId&gt;</span>spring-boot-starter-web<span 
class="nt">&lt;/artifactId&gt;</span> 
+ <span class="nt">&lt;/dependency&gt;</span>
+ <span class="nt">&lt;dependency&gt;</span> 
+   <span class="nt">&lt;groupId&gt;</span>org.springframework.boot<span 
class="nt">&lt;/groupId&gt;</span>
+   <span class="nt">&lt;artifactId&gt;</span>spring-boot-starter-actuator<span 
class="nt">&lt;/artifactId&gt;</span> 
+ <span class="nt">&lt;/dependency&gt;</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 3</strong> 
在resources目录下新建application.yml文件,文件内容如下:</p>
+
+    <div class="language-yaml highlighter-rouge"><pre class="highlight"><code> 
<span class="s">server</span><span class="pi">:</span>
+   <span class="s">port</span><span class="pi">:</span> <span 
class="s">7999</span> <span 
class="c1">#此处的端口为springboot服务端口</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 4</strong> 为微服务启动类添加注解:</p>
+
+    <div class="language-java highlighter-rouge"><pre class="highlight"><code> 
<span class="kn">package</span> <span class="n">xxx</span>
+ <span class="kn">import</span> <span class="nn">xxx</span>
+ <span class="nd">@SpringBootApplication</span> <span 
class="c1">//新增注解</span>
+ <span class="nd">@EnableServiceComb</span> <span 
class="c1">//新增注解</span>
+ <span class="kd">public</span> <span class="kd">class</span> <span 
class="nc">xxxServer</span><span class="o">/</span><span 
class="n">Client</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="kd">final</span> <span 
class="n">String</span><span class="o">[]</span> <span 
class="n">args</span><span class="o">)</span> <span class="o">{</span>
+   <span class="err"> </span> <span class="n">Log4jUtils</span><span 
class="o">.</span><span class="na">init</span><span class="o">();</span>
+   <span class="err"> </span><span class="c1">//BeanUtils.init();</span>
+   <span class="err"> </span><span class="n">SpringApplication</span><span 
class="o">.</span><span class="na">run</span><span class="o">(</span><span 
class="n">xxxServerOrClient</span><span class="o">.</span><span 
class="na">class</span><span class="o">,</span> <span 
class="n">args</span><span class="o">)</span>
+   <span class="o">}</span>
+ <span class="o">}</span>
+</code></pre>
+    </div>
+  </li>
+  <li>
+    <p><strong>步骤 5</strong> 运行/调试应用。</p>
+  </li>
+</ul>
+
+        
+      </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/use-servicecomb-in-spring-boot.md">Report a Doc Issue</a></li>
+        <li><a 
href="https://github.com/ServiceComb/ServiceComb.github.io/edit/master/_users/use-servicecomb-in-spring-boot.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>&copy; 2017 Apache incubator ServiceComb. Powered by <a 
href="http://jekyllrb.com"; rel="nofollow">Jekyll</a> &amp; <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>

Reply via email to