content/references/java-chassis/en_US/question-and-answer/question_answer/index.html - servicecomb-website - Git at Google


 <!doctype html>
 <html lang="en" class="no-js">
   <head>

       <meta charset="utf-8">
       <meta name="viewport" content="width=device-width,initial-scale=1">


         <link rel="prev" href="../../references-handlers/publickey/">


         <link rel="next" href="../faq/">


       <link rel="icon" href="../../assets/images/favicon.png">
       <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.19">


         <title>Q & A - ServiceComb Java Chassis Developers Guide</title>


       <link rel="stylesheet" href="../../assets/stylesheets/main.66ac8b77.min.css">


         <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
         <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
         <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>


     <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>


   </head>


     <body dir="ltr">


     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
     <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
     <label class="md-overlay" for="__drawer"></label>
     <div data-md-component="skip">


         <a href="#problem-how-to-customize-the-http-status-code-in-the-rest-interface-corresponding-to-a-java-method" class="md-skip">
           Skip to content
         </a>

     </div>
     <div data-md-component="announce">

     </div>


 <header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="ServiceComb Java Chassis Developers Guide" class="md-header__button md-logo" aria-label="ServiceComb Java Chassis Developers Guide" data-md-component="logo">


   <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>

     </a>
     <label class="md-header__button md-icon" for="__drawer">

       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
     </label>
     <div class="md-header__title" data-md-component="header-title">
       <div class="md-header__ellipsis">
         <div class="md-header__topic">
           <span class="md-ellipsis">
             ServiceComb Java Chassis Developers Guide
           </span>
         </div>
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">

               Q & A

           </span>
         </div>
       </div>
     </div>


       <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>


       <label class="md-header__button md-icon" for="__search">

         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
       </label>
       <div class="md-search" data-md-component="search" role="dialog">
   <label class="md-search__overlay" for="__search"></label>
   <div class="md-search__inner" role="search">
     <form class="md-search__form" name="search">
       <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
       <label class="md-search__icon md-icon" for="__search">

         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>

         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
       </label>
       <nav class="md-search__options" aria-label="Search">

         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">

           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
         </button>
       </nav>

     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
           </div>
           <ol class="md-search-result__list" role="presentation"></ol>
         </div>
       </div>
     </div>
   </div>
 </div>


   </nav>

 </header>

     <div class="md-container" data-md-component="container">


       <main class="md-main" data-md-component="main">
         <div class="md-main__inner md-grid">


               <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
                 <div class="md-sidebar__scrollwrap">
                   <div class="md-sidebar__inner">


 <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="ServiceComb Java Chassis Developers Guide" class="md-nav__button md-logo" aria-label="ServiceComb Java Chassis Developers Guide" data-md-component="logo">


   <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>

     </a>
     ServiceComb Java Chassis Developers Guide
   </label>

   <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../.." class="md-nav__link">


   <span class="md-ellipsis">
     Introduction
   </span>


       </a>
     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >


           <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">


   <span class="md-ellipsis">
     Getting Started
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
             <span class="md-nav__icon md-icon"></span>
             Getting Started
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../start/terminology/" class="md-nav__link">


   <span class="md-ellipsis">
     Glossary
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../start/architecture/" class="md-nav__link">


   <span class="md-ellipsis">
     Architecture
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../start/development-environment/" class="md-nav__link">


   <span class="md-ellipsis">
     Development environment
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../start/first-sample/" class="md-nav__link">


   <span class="md-ellipsis">
     Develop the first microservice
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >


           <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">


   <span class="md-ellipsis">
     Development Service Provider
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
             <span class="md-nav__icon md-icon"></span>
             Development Service Provider
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../build-provider/definition/service-definition/" class="md-nav__link">


   <span class="md-ellipsis">
     Service definition
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/define-contract/" class="md-nav__link">


   <span class="md-ellipsis">
     Service contract definition
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/code-first/" class="md-nav__link">


   <span class="md-ellipsis">
     Implicit API definition
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/swagger-annotation/" class="md-nav__link">


   <span class="md-ellipsis">
     Use Swagger annotations
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/springmvc/" class="md-nav__link">


   <span class="md-ellipsis">
     Develop with SpringMVC
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/jaxrs/" class="md-nav__link">


   <span class="md-ellipsis">
     Develop with JAX-RS
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/transparent-rpc/" class="md-nav__link">


   <span class="md-ellipsis">
     Develop with Transparent RPC
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/interface-constraints/" class="md-nav__link">


   <span class="md-ellipsis">
     Interface definition and data type
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/listen-address-and-publish-address/" class="md-nav__link">


   <span class="md-ellipsis">
     Service listening address and publishing address
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/thread-pool/" class="md-nav__link">


   <span class="md-ellipsis">
     Thread pool
   </span>


       </a>
     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_11" >


           <label class="md-nav__link" for="__nav_3_11" id="__nav_3_11_label" tabindex="0">


   <span class="md-ellipsis">
     Service Configuration
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_11_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3_11">
             <span class="md-nav__icon md-icon"></span>
             Service Configuration
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../build-provider/configuration/ratelimite-strategy/" class="md-nav__link">


   <span class="md-ellipsis">
     Rate Limiting Policy
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/configuration/parameter-validator/" class="md-nav__link">


   <span class="md-ellipsis">
     Parameter Validator
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/bootup/" class="md-nav__link">


   <span class="md-ellipsis">
     Boot-up Process
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-provider/access-log-configuration/" class="md-nav__link">


   <span class="md-ellipsis">
     Access Log Configuration
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >


           <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">


   <span class="md-ellipsis">
     Writing Service Consumer
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
             <span class="md-nav__icon md-icon"></span>
             Writing Service Consumer
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../build-consumer/common-configuration/" class="md-nav__link">


   <span class="md-ellipsis">
     Consumer common configuration
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-consumer/using-resttemplate/" class="md-nav__link">


   <span class="md-ellipsis">
     Using Rest Template
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-consumer/using-AsyncRestTemplate/" class="md-nav__link">


   <span class="md-ellipsis">
     Using AsyncRestTemplate
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-consumer/develop-consumer-using-rpc/" class="md-nav__link">


   <span class="md-ellipsis">
     Using with RPC
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-consumer/with-contract/" class="md-nav__link">


   <span class="md-ellipsis">
     Contract
   </span>


       </a>
     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_6" >


           <label class="md-nav__link" for="__nav_4_6" id="__nav_4_6_label" tabindex="0">


   <span class="md-ellipsis">
     Invoke control
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4_6">
             <span class="md-nav__icon md-icon"></span>
             Invoke control
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../build-consumer/flow-control/" class="md-nav__link">


   <span class="md-ellipsis">
     Flow Control
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../build-consumer/fault-injection/" class="md-nav__link">


   <span class="md-ellipsis">
     Fault Injection
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item">
       <a href="../../build-consumer/3rd-party-service-invoke/" class="md-nav__link">


   <span class="md-ellipsis">
     Invoke 3rd-party REST services
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >


           <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">


   <span class="md-ellipsis">
     Transports
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
             <span class="md-nav__icon md-icon"></span>
             Transports
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../transports/rest-over-servlet/" class="md-nav__link">


   <span class="md-ellipsis">
     REST over Servlet
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../transports/rest-over-vertx/" class="md-nav__link">


   <span class="md-ellipsis">
     REST over Vertx
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../transports/highway-rpc/" class="md-nav__link">


   <span class="md-ellipsis">
     Highway
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../transports/http2/" class="md-nav__link">


   <span class="md-ellipsis">
     HTTP2
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >


           <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">


   <span class="md-ellipsis">
     General Development
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
             <span class="md-nav__icon md-icon"></span>
             General Development
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../general-development/visit-sc/" class="md-nav__link">


   <span class="md-ellipsis">
     Access Service Center
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/metrics/" class="md-nav__link">


   <span class="md-ellipsis">
     Metrics
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/microservice-invocation-chain/" class="md-nav__link">


   <span class="md-ellipsis">
     Microservice invocation chain
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/customized-tracing/" class="md-nav__link">


   <span class="md-ellipsis">
     Customized-Tracing
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/local-develop-test/" class="md-nav__link">


   <span class="md-ellipsis">
     Local development and testing
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/http-filter/" class="md-nav__link">


   <span class="md-ellipsis">
     Http Filter
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/file-upload/" class="md-nav__link">


   <span class="md-ellipsis">
     File Uploading
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/file-download/" class="md-nav__link">


   <span class="md-ellipsis">
     File Downloading
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/reactive/" class="md-nav__link">


   <span class="md-ellipsis">
     Reactive Programing
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/dnsconfig/" class="md-nav__link">


   <span class="md-ellipsis">
     DNS Custom Configuration
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/dai-li-she-zhi/" class="md-nav__link">


   <span class="md-ellipsis">
     Proxy Settings
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/report-framework-version/" class="md-nav__link">


   <span class="md-ellipsis">
     Report framework version
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/cross-app-invocation/" class="md-nav__link">


   <span class="md-ellipsis">
     Cross-application invocation
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/secret-field/" class="md-nav__link">


   <span class="md-ellipsis">
     Customized serialization and deserialization
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/context/" class="md-nav__link">


   <span class="md-ellipsis">
     Using Context to pass control messages
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/produceprocess/" class="md-nav__link">


   <span class="md-ellipsis">
     Return value serialization extension
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/CORS/" class="md-nav__link">


   <span class="md-ellipsis">
     CORS mechanism
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/AlarmEvent/" class="md-nav__link">


   <span class="md-ellipsis">
     Get fuse and instance isolation alarm event information
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/shutdown/" class="md-nav__link">


   <span class="md-ellipsis">
     Shutdown gracefully
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/error-handling/" class="md-nav__link">


   <span class="md-ellipsis">
     Handling exceptions
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/multienvironment/" class="md-nav__link">


   <span class="md-ellipsis">
     Multi-environment isolation between microservice instances
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../general-development/thread-model/" class="md-nav__link">


   <span class="md-ellipsis">
     Thread Model
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >


           <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">


   <span class="md-ellipsis">
     Configuration
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_7">
             <span class="md-nav__icon md-icon"></span>
             Configuration
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../config/general-config/" class="md-nav__link">


   <span class="md-ellipsis">
     General config
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../config/inject-config/" class="md-nav__link">


   <span class="md-ellipsis">
     Configuration injection
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >


           <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">


   <span class="md-ellipsis">
     Service Capability Open
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_8">
             <span class="md-nav__icon md-icon"></span>
             Service Capability Open
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../edge/open-service/" class="md-nav__link">


   <span class="md-ellipsis">
     Intruductions
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../edge/by-servicecomb-sdk/" class="md-nav__link">


   <span class="md-ellipsis">
     Using Edge Service
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../edge/nginx/" class="md-nav__link">


   <span class="md-ellipsis">
     Using confd and Nginx as edge services
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../edge/zuul/" class="md-nav__link">


   <span class="md-ellipsis">
     Use zuul as edge services
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >


           <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">


   <span class="md-ellipsis">
     Service Packing and Running
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Service Packing and Running
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../packaging/standalone/" class="md-nav__link">


   <span class="md-ellipsis">
     Standalone mode
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../packaging/web-container/" class="md-nav__link">


   <span class="md-ellipsis">
     WEB container mode
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_10" >


           <label class="md-nav__link" for="__nav_10" id="__nav_10_label" tabindex="0">


   <span class="md-ellipsis">
     Micro Service Security
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_10_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_10">
             <span class="md-nav__icon md-icon"></span>
             Micro Service Security
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../security/tls/" class="md-nav__link">


   <span class="md-ellipsis">
     Using TLS
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../security/rsa/" class="md-nav__link">


   <span class="md-ellipsis">
     Using RSA certification
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_11" >


           <label class="md-nav__link" for="__nav_11" id="__nav_11_label" tabindex="0">


   <span class="md-ellipsis">
     Using java chassis in Spring Boot
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_11_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_11">
             <span class="md-nav__icon md-icon"></span>
             Using java chassis in Spring Boot
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../using-java-chassis-in-spring-boot/using-java-chassis-in-spring-boot/" class="md-nav__link">


   <span class="md-ellipsis">
     Intruductions
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../using-java-chassis-in-spring-boot/components-for-spring-boot/" class="md-nav__link">


   <span class="md-ellipsis">
     spring boot starter for java-chassis
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../using-java-chassis-in-spring-boot/java-application/" class="md-nav__link">


   <span class="md-ellipsis">
     JAVA application development
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../using-java-chassis-in-spring-boot/web-application/" class="md-nav__link">


   <span class="md-ellipsis">
     Web development method development
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../using-java-chassis-in-spring-boot/diff-between-java-web/" class="md-nav__link">


   <span class="md-ellipsis">
     The difference between JAVA application method and Web development method
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../using-java-chassis-in-spring-boot/diff-spring-mvc/" class="md-nav__link">


   <span class="md-ellipsis">
     The difference in Spring MVC mode
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_12" >


           <label class="md-nav__link" for="__nav_12" id="__nav_12_label" tabindex="0">


   <span class="md-ellipsis">
     Handlers reference
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_12_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_12">
             <span class="md-nav__icon md-icon"></span>
             Handlers reference
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item">
       <a href="../../references-handlers/intruduction/" class="md-nav__link">


   <span class="md-ellipsis">
     Intruductions
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../references-handlers/loadbalance/" class="md-nav__link">


   <span class="md-ellipsis">
     Load Balancing
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../../references-handlers/publickey/" class="md-nav__link">


   <span class="md-ellipsis">
     Public key authentication
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


     <li class="md-nav__item md-nav__item--active md-nav__item--nested">


         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_13" checked>


           <label class="md-nav__link" for="__nav_13" id="__nav_13_label" tabindex="0">


   <span class="md-ellipsis">
     FAQ
   </span>


             <span class="md-nav__icon md-icon"></span>
           </label>

         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_13_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_13">
             <span class="md-nav__icon md-icon"></span>
             FAQ
           </label>
           <ul class="md-nav__list" data-md-scrollfix>


     <li class="md-nav__item md-nav__item--active">

       <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">


       <a href="./" class="md-nav__link md-nav__link--active">


   <span class="md-ellipsis">
     Q & A
   </span>


       </a>

     </li>


     <li class="md-nav__item">
       <a href="../faq/" class="md-nav__link">


   <span class="md-ellipsis">
     FAQ
   </span>


       </a>
     </li>


     <li class="md-nav__item">
       <a href="../interface-compatibility/" class="md-nav__link">


   <span class="md-ellipsis">
     Micro Service Interface Compatibility FAQ
   </span>


       </a>
     </li>


           </ul>
         </nav>

     </li>


   </ul>
 </nav>
                   </div>
                 </div>
               </div>


               <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
                 <div class="md-sidebar__scrollwrap">
                   <div class="md-sidebar__inner">


 <nav class="md-nav md-nav--secondary" aria-label="Table of contents">


 </nav>
                   </div>
                 </div>
               </div>


             <div class="md-content" data-md-component="content">
               <article class="md-content__inner md-typeset">


 <h1 id="problem-how-to-customize-the-http-status-code-in-the-rest-interface-corresponding-to-a-java-method">Problem: How to customize the HTTP status code in the REST interface corresponding to a Java method?</h1>
 <p><strong>Solution:</strong></p>
 <p>For normal return values, this can be done with SwaggerAnnotation, for example:</p>
 <pre><code class="language-java">@ApiResponse(code = 300, response = String.class, message = &quot;&quot;)
 public int test(int x) {
   return 100;
 }
 </code></pre>
 <p>For the return value of the exception, you can do this by throwing a custom InvocationException, for example:</p>
 <pre><code class="language-java">    public String testException(int code) {
         String strCode = String.valueOf(code);
         switch (code) {
             case 200:
                 return strCode;
             case 456:
                 throw new InvocationException(code, strCode, strCode + &quot; error&quot;);
             case 556:
                 throw new InvocationException(code, strCode, Arrays.asList(strCode + &quot; error&quot;));
             case 557:
                 throw new InvocationException(code, strCode, Arrays.asList(Arrays.asList(strCode + &quot; error&quot;)));
             default:
                 break;
         }

         return &quot;not expected&quot;;
     }
 </code></pre>
 <h1 id="problem-how-to-customize-the-log-configuration-of-your-own-microservice">Problem: How to customize the log configuration of your own microservice</h1>
 <p>** Solution:**
 ServiceComb does not bind the logger, use slf4j, users can freely choose log4j/log4j2/logback and so on.
 ServiceComb provides a log4j extension that supports incremental configuration of log4j's properties files on a standard log4j basis.</p>
 <ul>
 <li>By default, the configuration file is loaded from the path: "classpath*:config/log4j.properties"</li>
 <li>It will actually search all the <code>config/log4j.properties and config/log4j.*.properties</code> in the classpath, cut out the <code>\*</code> part from the searched file, sort the alpha, then load it in order, and finally compose The file is used as the log4j configuration file.</li>
 <li>If you want to use ServiceComb's log4j extension, you need to call Log4jUtils.init, otherwise it will be used according to the rules of the standard logger.</li>
 </ul>
 <h1 id="problem-when-the-service-is-configured-with-multiple-types-of-transport-what-are-the-mechanisms-for-servicecomb-choose-which-transport-to-use-at-runtime">Problem: When the service is configured with multiple types of transport, What are the mechanisms for ServiceComb choose which transport to use at runtime?</h1>
 <p>** Solution:**</p>
 <ul>
 <li>
 <p>ServiceComb's consumer, transport, handler, and producer are decoupled. The functions work together through contract definitions, that is, whether the consumer uses transparent rpc, or springmvc develops and uses a highway, or RESTful does not transmit on the network. Relationships and producers use transparent rpc, or jaxrs, or springmvc development, and there is no relationship between the receiver and the perception, business development methods and transmission methods.</p>
 </li>
 <li>
 <p>Consumer access producer, in the runtime transport selection, the general rule is: the consumer's transport and producer's endpoint intersection, if there are multiple transports after the intersection, then use in turn</p>
 </li>
 </ul>
 <p>Decomposed, there are the following scenarios:</p>
 <ul>
 <li>When a microservice producer provided both the highway and the RESTful endpoint</li>
 <li>Only the highway transport jar is deployed in the consumer process, only the producer's highway endpoint is accessed.
   * Only the RESTful transport jar is deployed in the consumer process, only the RESTful endpoint of the producer is accessed.
   * The consumer process, while deploying the highway and RESTful transport jar, will take turns accessing the producer's highway, RESTful endpoint</li>
 </ul>
 <p>If at this time, the consumer wants to use a transport to access the producer, it can be configured in the microservice.yaml of the consumer process, specifying the name of the transport:</p>
 <pre><code>servicecomb:
   references:
     transport:
       &lt;service_name&gt;: highway
 </code></pre>
 <ul>
 <li>When a microservice producer only provided the endpoint of the highway</li>
 </ul>
 <p>* The consumer process only deploys the highway transport jar, and normally uses higway endpoint.
   * The consumer process can only be accessed if only the RESTful transport jar is deployed
   * The consumer process deploys both the highway and the RESTful transport jar, and the highway access is normally used.</p>
 <ul>
 <li>When a microservice producer only provided RESTful endpoints</li>
 </ul>
 <p>* The consumer process only deploys the highway transport jar and cannot access it.
   * The consumer process only deploys RESTful transport jars, which normally use RESTful access
   * The consumer process deploys both the highway and the RESTful transport jar, and the RESTful access is normally used.</p>
 <h1 id="problem-the-swagger-body-parameter-type-is-incorrectly-defined-resulting-in-no-content-information-for-the-content-registered-by-the-service-center">Problem: The swagger body parameter type is incorrectly defined, resulting in no content information for the content registered by the service center.</h1>
 <p><strong>Symptom:</strong></p>
 <p>Define the following interface, put the parameters into the body to pass</p>
 <pre><code>/testInherate:
     post:
       operationId: &quot;testInherate&quot;
       parameters:
       - in: &quot;body&quot;
         name: &quot;xxxxx&quot;
         required: false
         type: string
       responses:
         200:
           description: &quot;response of 200&quot;
           schema:
             $ref: &quot;#/definitions/ReponseImpl&quot;
 </code></pre>
 <p>Define the interface in the above way. After the service is registered, the interface type: a string that is queried from the service center is lost and becomes:</p>
 <pre><code>/testInherate:
     post:
       operationId: &quot;testInherate&quot;
       parameters:
       - in: &quot;body&quot;
         name: &quot;xxxxx&quot;
         required: false
       responses:
         200:
           description: &quot;response of 200&quot;
           schema:
             $ref: &quot;#/definitions/ReponseImpl&quot;
 </code></pre>
 <p>If the client does not place a swagger, the following exception is also reported:</p>
 <p>Caused by: java.lang.ClassFormatError: Method "testInherate" in class ? has illegal signature. "</p>
 <p><strong>Solution:</strong></p>
 <p>When defining the type of the body parameter, you can't use type directly instead use the schema.</p>
 <pre><code>/testInherate:
     post:
       operationId: &quot;testInherate&quot;
       parameters:
       - in: &quot;body&quot;
         name: &quot;request&quot;
         required: false
         schema:
           type: string
       responses:
         200:
           description: &quot;response of 200&quot;
           schema:
             $ref: &quot;#/definitions/ReponseImpl&quot;
 </code></pre>
 <h1 id="problem-does-the-microservices-framework-service-call-use-long-live-connection">Problem: Does the microservices framework service call use long live connection?</h1>
 <p>** Solution:**</p>
 <p>Http uses a long connection (with a timeout), and the highway mode uses a long connection (always on).</p>
 <h1 id="problem-when-the-service-is-disconnected-from-the-service-center-will-the-registration-information-be-deleted-automatically">Problem: When the service is disconnected from the service center, will the registration information be deleted automatically?</h1>
 <p>** Solution:**</p>
 <p>The service center heartbeat detects that the service instance is unavailable, only the service instance information is removed, and the static data of the service is not removed.</p>
 <h1 id="problem-how-does-the-microservices-framework-achieve-transparent-transmission-of-data-between-multiple-microservices">Problem: How does the microservices framework achieve transparent transmission of data between multiple microservices?</h1>
 <p>** Solution:**</p>
 <p>Transmitting data into:</p>
 <pre><code class="language-java">CseHttpEntity&lt;xxxx.class&gt; httpEntity = new CseHttpEntity&lt;&gt;(xxx);
 //Transmission content
 httpEntity.addContext(&quot;contextKey&quot;,&quot;contextValue&quot;);
 ResponseEntity&lt;String&gt; responseEntity = RestTemplateBuilder.create().exchange(&quot;cse://springmvc/springmvchello/sayhello&quot;,HttpMethod.POST,httpEntity,String.class);
 </code></pre>
 <p>Transparent data acquisition:</p>
 <pre><code class="language-java">@Override
 @RequestMapping(path=&quot;/sayhello&quot;,method = RequestMethod.POST)
 public String sayHello(@RequestBody Person person,InvocationContext context){
     //Transparent data acquisition
     context.getContext();
     return &quot;Hello person &quot; + person.getName();
 }
 </code></pre>
 <h1 id="problem-how-the-microservices-framework-service-customizes-the-return-status-code">Problem: How the microservices framework service customizes the return status code</h1>
 <p>** Solution:**</p>
 <pre><code class="language-java">@Override
 @RequestMapping(path = &quot;/sayhello&quot;,method = RequestMethod.POST)
 public String sayHello(@RequestBody Person person){
     InvocationContext context = ContextUtils.getInvocationContext();
     //自定义状态码
     context.setStatus(Status.CREATED);
     return &quot;Hello person &quot;+person.getName();
 }
 </code></pre>
 <h1 id="problem-partial-exposure-of-body-model">Problem: Partial exposure of body Model</h1>
 <p>** Solution:**</p>
 <p>In the body object corresponding to an interface, there may be some attributes that are internal. Do not want to open it. Do not bring it out when generating the schema. Use:</p>
 <pre><code class="language-java">@ApiModelProperty(hidden = true)
 </code></pre>
 <h1 id="problem-the-framework-obtains-the-address-of-the-remote-consumer">Problem: The framework obtains the address of the remote consumer</h1>
 <p>** Solution:**</p>
 <p>If you use the http rest method (using the transport-rest-vertx dependency) you can get it in the following way:</p>
 <pre><code class="language-java">HttpServletRequest request = (HttpServletRequest) invocation.getHandlerContext().get(RestConst.REST_REQUEST);
 String host = request.getRemoteHost();
 </code></pre>
 <p>The actual scene is to take the external address, so it should be LB passed to edgeservice, and edgeService is then passed to the context and passed.</p>
 <h1 id="problem-description-of-the-handler">Problem: Description of the handler</h1>
 <p>** Solution:**</p>
 <p>Consumer default handler is simpleLB, and the handler chain will use this when there is no configuration, if the handler is configured, it must contain the lb handler. Otherwise the call error, need to be described in the document.</p>
 <h1 id="problem-netty-version-problem">Problem: Netty version problem</h1>
 <p>** Solution:**</p>
 <p>Netty3 and netty4 are completely different tripartites because the coordinates are not the same as the package, so they can coexist, but pay attention to the minor version problem, the version that the small version must use.</p>
 <h1 id="problem-service-timeout-settings">Problem: Service Timeout Settings</h1>
 <p>** Solution:**</p>
 <p>Add the following configuration to the microservice description file (microservice.yaml):</p>
 <pre><code>servicecomb:
   request:
     timeout: 30000
 </code></pre>
 <h1 id="problem-is-there-a-required-for-the-processing-chains-sequence-of-service-governance">Problem: Is there a required for the processing chain's sequence of service governance?</h1>
 <p><strong>Solution:</strong></p>
 <p>The order of the processing chains is different, and the system works differently. List the common questions below.</p>
 <p>1, loadbalance and bizkeeper-consumer</p>
 <p>These two sequences can be combined randomly. But the behavior is different.</p>
 <p>When loadbalance is in the front, the retry function provided by loadbalance will occur when bizkeeper-consumer throws an exception, such as timeout. But if you have done a fallback policy configuration, such as return null, then loadbalance will not retry.</p>
 <p>If loadbalance is behind, the retry will extend the timeout. Even if the retry is successful, if the timeout period set by bizkeeper-consumer is not enough, the final call result will also fail.</p>
 <p>2, tracing-consumer, sla-consumer, tracing-provider, sla-provider</p>
 <p>These processing chains are recommended to be placed at the very beginning of the processing chain to ensure that the success and failure of the log can be recorded (because the log requires IP and other information, for consumers, can only be placed behind the loadbalance).</p>
 <p>If you do not need to record the exception returned by the client, you can put it to the end and only pay attention to the error returned by the network layer. However, if the bizkeeper-consumer timeout returns earlier, the log may not be logged.</p>
 <ol>
 <li>Suggested order</li>
 </ol>
 <p>Consumer: loadbalance, tracing-consumer, sla-consumer, bizkeeper-consumer</p>
 <p>Provider: tracing-provider, sla-provider, bizkeeper-provider</p>
 <p>This order is sufficient for most scenarios and is not easy to cause errors.</p>
 <h1 id="problem-the-meaning-of-config-item-servicecombuploadsmaxsize-in-file-uploading">Problem: the meaning of config item servicecomb.uploads.maxSize in file uploading</h1>
 <p>config item: servicecomb.uploads.maxSize</p>
 <p>meaning: The maximum allowable size of http body in bytes, the default value of -1 means unlimited.</p>


               </article>
             </div>


 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>

       </main>

         <footer class="md-footer">

   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
       <div class="md-copyright">


     Made with
     <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
       Material for MkDocs
     </a>

 </div>

     </div>
   </div>
 </footer>

     </div>
     <div class="md-dialog" data-md-component="dialog">
       <div class="md-dialog__inner md-typeset"></div>
     </div>


     <script id="__config" type="application/json">{"base": "../..", "features": [], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>


       <script src="../../assets/javascripts/bundle.dd8806f2.min.js"></script>


   </body>
 </html>