駱駝開箱即用。 Swagger集成就是其中之一。 不幸的是，大多數已經存在的功能都嚴重依賴于Spring。 但這并不能阻止我們在普通的Java EE 7應用程序中使用它們，因為有時它只是服務器的輕量級變體。 但我不想再對此進行討論。 相反，我認為在所有情況下都有一種技術選擇，如果您運行一個項目，而只是想將Camel與Java EE 7一起使用，并且需要REST服務并希望通過Swagger將它們記錄下來，那么這是適合您的文章。

在EE 7中引導駱駝

您需要做的第一件事是在單例啟動bean中引導Camel。 我已經寫了一篇有關如何執行此操作的文章 。 另一個選擇是實際使用wildfly-camel子系統 ，該子系統也可用，但這要求您使用JBoss WildFly8.x。

昂首闊步和駱駝休息依賴

到今天為止，Camel中的Swagger集成僅受Spring應用程序支持。 因此，要使此工作正常進行，我們必須比平時執行一些配置。 但是我保證，它不會太復雜，只需一分鐘即可完成。 開始吧：

添加到基本Camel EE 7示例的第一件事是駱駝的其他依賴項：

<dependency><groupId>org.apache.camel</groupId><artifactId>camel-servlet</artifactId></dependency><dependency><groupId>org.apache.camel</groupId><artifactId>camel-metrics</artifactId></dependency><dependency><groupId>org.apache.camel</groupId><artifactId>camel-swagger</artifactId></dependency><dependency><groupId>org.apache.camel</groupId><artifactId>camel-jackson</artifactId></dependency>

返回駝峰語境

如果無法使用其中的內容，則需要實現自己的CdiRestSwagger-Camel上下文查找。 即將推出的Camel版本有一些烹調方法，但是現在我們必須自己做。 這非常簡單，因為我們需要覆蓋RestSwaggerApiDeclarationServlet的一種方法。 除了簡單地返回注入的CdiCamelContext外，這沒有任何其他作用。

public class CdiRestSwaggerApiDeclarationServlet extends RestSwaggerApiDeclarationServlet {@InjectCdiCamelContext context;@Overridepublic CamelContext lookupCamelContext(ServletConfig config) {return context;} }

一些進一步的配置

我們還沒有完成。 您還有更多配置要做。 由于Camel設計為可在許多不同的環境中運行，并且沒有特定的Java EE 7版本，因此它仍然依賴于web.xml配置來映射映射servlet。 請特別注意CdiRestSwaggerApiDeclarationServlet初始化參數。 在這個簡單的示例中，我不必費心找出它們，但仍然依靠它們。 因此，根據您在Maven構建中設置的應用程序的最終名稱，需要對其進行調整。

<context-param><param-name>contextConfigLocation</param-name><!-- to use Java DSL --><param-value>classpath:camel-config.xml</param-value></context-param><!-- to setup Camel Servlet --><servlet><display-name>Camel Http Transport Servlet</display-name><servlet-name>CamelServlet</servlet-name><servlet-class>org.apache.camel.component.servlet.CamelHttpTransportServlet<load-on-startup>1</load-on-startup></servlet><!-- to setup Camel Swagger api servlet --><servlet><!-- we are using our own swagger-cdi binding servlet --><servlet-class>org.apache.camel.component.swagger.CdiRestSwaggerApiDeclarationServlet<init-param><param-name>base.path</param-name><param-value>http://localhost:8080/camel/rest</param-value></init-param><init-param><param-name>api.path</param-name><param-value> http://localhost:8080/camel/api-docs </param-value></init-param><init-param><param-name>api.version</param-name><param-value>1.2.3</param-value></init-param><init-param><param-name>api.title</param-name><param-value>User Services</param-value></init-param><init-param><param-name>api.description</param-name><param-value>Camel Rest Example with Swagger that provides an User REST service</param-value></init-param><load-on-startup>2</load-on-startup></servlet><!-- swagger api declaration --><servlet-mapping><servlet-name>ApiDeclarationServlet</servlet-name><url-pattern>/api-docs/*</url-pattern></servlet-mapping><!-- define that url path for the Camel Servlet to use --><servlet-mapping><servlet-name>CamelServlet</servlet-name><url-pattern>/rest/*</url-pattern></servlet-mapping><!-- enable CORS filter so people can use swagger ui to browse and test the apis --><filter><filter-name>RestSwaggerCorsFilter</filter-name><filter-class>org.apache.camel.component.swagger.RestSwaggerCorsFilter</filter-class></filter><filter-mapping><filter-name>RestSwaggerCorsFilter</filter-name><url-pattern>/api-docs/*</url-pattern><url-pattern>/rest/*</url-pattern></filter-mapping>

足夠的配置–符合邏輯！

完成后，您需要一些邏輯。 我在這里使用的示例摘自Camel的官方示例，稱為camel-example-servlet-rest-tomcat 。 請注意，該示例同時包含了基于XML DSL的定義和基于Java DSL的其余服務的定義。 我只使用了Java DSL，特別是UserRouteBuilder類中定義的路由。

確保為用戶服務和用戶添加@Named批注，并添加從UserRouteBuilder到啟動bean的路由。

context.addRoutes(new UserRouteBuilder());

這就對了。 現在，您可以通過訪問http：// localhost：8080 / camel / api-docs瀏覽瀏覽您的API。 如果要使用Swagger UI，則必須將其添加到應用程序中。 該示例應用程序包含構建部分中的所有內容，這是執行此操作所需的。 因此，請查看完整的GitHub項目，以了解如何使用Swagger UI瀏覽API。

翻譯自: https://www.javacodegeeks.com/2014/12/riding-camel-on-java-ee-7-rest-services-with-swagger-documentation.html

總結

以上是生活随笔為你收集整理的在Java EE 7上骑骆驼–带有Swagger文档的REST服务的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。