<ruby id="bdb3f"></ruby>

    <p id="bdb3f"><cite id="bdb3f"></cite></p>

      <p id="bdb3f"><cite id="bdb3f"><th id="bdb3f"></th></cite></p><p id="bdb3f"></p>
        <p id="bdb3f"><cite id="bdb3f"></cite></p>

          <pre id="bdb3f"></pre>
          <pre id="bdb3f"><del id="bdb3f"><thead id="bdb3f"></thead></del></pre>

          <ruby id="bdb3f"><mark id="bdb3f"></mark></ruby><ruby id="bdb3f"></ruby>
          <pre id="bdb3f"><pre id="bdb3f"><mark id="bdb3f"></mark></pre></pre><output id="bdb3f"></output><p id="bdb3f"></p><p id="bdb3f"></p>

          <pre id="bdb3f"><del id="bdb3f"><progress id="bdb3f"></progress></del></pre>

                <ruby id="bdb3f"></ruby>

                ??碼云GVP開源項目 12k star Uniapp+ElementUI 功能強大 支持多語言、二開方便! 廣告
                > 今天我們來學習Swagger龐大體系中的第一個工具:`Swagger Core`,想要學習這個,需要有`swagger-simaples`項目的幫助。`swagger-simaples`提供了很多解釋swagger-core作用的例子,以便幫助你理解`Swagger Core`中的項目,跟我一探究竟吧! ## swagger-core [swagger-core](https://github.com/swagger-api/swagger-core)含有如下子項目: ![](https://box.kancloud.cn/2016-02-23_56cbdb25dc197.jpg) 針對不同的web框架,提供了多種針對性jar包。 ## swagger-simaples [swagger-samples](https://github.com/swagger-api/swagger-samples/tree/master/java)項目是為了針對我們的swagger-core的工具,編寫的樣例,方便大家理解的。里面還有`java`和`scala`的項目,目前我們只關注`java`的。 ![](https://box.kancloud.cn/2016-02-23_56cbdb2603d14.jpg) ## 源碼編譯 我將這兩個項目的源碼都clone到本地,然后編譯,以確保正確導入到eclipse中 ![](https://box.kancloud.cn/2016-02-23_56cbdb2748e23.jpg) simaples項目源碼編譯: ![](https://box.kancloud.cn/2016-02-23_56cbdb278a6e9.jpg) ## 實例 我們找一個例子來實際看看`swagger-core`到底是做什么的? 我們來看[java-jaxrs](https://github.com/swagger-api/swagger-samples/tree/master/java/java-jaxrs)項目,按照github上的教程,啟動完服務器后,我們在本地訪問`http://localhost:8002`,打開后如下: ![](https://box.kancloud.cn/2016-02-23_56cbdb2866b69.jpg),這個時候你就可以看到利用`swagger-core`生成的api文檔,具體這個界面里面的東西,我會在下一篇`swaager-ui`的文章來講解。 那我們來看看他如何生成這個文檔的,或者說如何將代碼里的接口呈現在我們眼中的呢? ## 工作原理 `java-jaxrs`項目依賴的是`swagger-core`的`swagger-jaxrs`項目,由此可以看出`swagger-core`中的子項目是針對特定框架分開來開發的。而`swagger-jaxrs`項目針對的是[jaxrs](http://baike.baidu.com/link?url=D-yOgrIzkR4lZF50UNNqZT69yva7qRGOEi9V8Ao3eiZ4HqqeXRY8UMlCrToR-YDTthDzKjz3IksvjZ_yDnsNs_)技術開發的`web`項目。那么他是怎么通過你的項目生成`api`可視文檔的呢? 方式是注解!`swagger-jaxrs`提供了很多可供調用的注解方式,方便研發在添加代碼生成我們需要的接口信息,請看項目中的使用代碼: ![](https://box.kancloud.cn/2016-02-23_56cbdb28b24ee.jpg) 這一段代碼,生成的api信息如下: ![](https://box.kancloud.cn/2016-02-23_56cbdb29033f0.jpg) 具體的注解代表什么意思,有時間我會一一道來的。 想隨時隨地了解我的文章,請關注下面的微信公眾號,我會不定時推送新文章 ![](https://box.kancloud.cn/2016-02-23_56cbdb2957435.jpg)
                  <ruby id="bdb3f"></ruby>

                  <p id="bdb3f"><cite id="bdb3f"></cite></p>

                    <p id="bdb3f"><cite id="bdb3f"><th id="bdb3f"></th></cite></p><p id="bdb3f"></p>
                      <p id="bdb3f"><cite id="bdb3f"></cite></p>

                        <pre id="bdb3f"></pre>
                        <pre id="bdb3f"><del id="bdb3f"><thead id="bdb3f"></thead></del></pre>

                        <ruby id="bdb3f"><mark id="bdb3f"></mark></ruby><ruby id="bdb3f"></ruby>
                        <pre id="bdb3f"><pre id="bdb3f"><mark id="bdb3f"></mark></pre></pre><output id="bdb3f"></output><p id="bdb3f"></p><p id="bdb3f"></p>

                        <pre id="bdb3f"><del id="bdb3f"><progress id="bdb3f"></progress></del></pre>

                              <ruby id="bdb3f"></ruby>

                              哎呀哎呀视频在线观看