Версия для печати темы
Нажмите сюда для просмотра этой темы в оригинальном формате
Форум программистов > Java EE (J2EE) и Spring > Интегрировать Swagger в Spring+Jersey REST proj?


Автор: Killer_13 12.3.2014, 17:44
Здравствуйте, помогите разобраться как встроить Swagger в проект. Существующие инструкции не помогли достигнуть результата. 

Есть проект Spring + Jersey RESTful, стартует в Tomcat.

Вопрос: что, как и куда добавить чтоб запустить Swagger?

Есть manuls 

https://github.com/wordnik/swagger-core/wiki/Java-Setup-for-Spring---Jersey---JAX-RS
https://github.com/wordnik/swagger-core/wiki/Java-JAXRS-Quickstart

пример
https://github.com/wordnik/swagger-core/tree/master/samples/java-jersey2

но не совсем понятно, из какого мануала конфигурировать.. ((
по какому адресу потом стучаться?

web.xml

Код

    <servlet>
        <servlet-name>jersey</servlet-name>
        <servlet-class>com.sun.jersey.spi.spring.container.servlet.SpringServlet</servlet-class>
        <init-param>
            <param-name>com.sun.jersey.config.property.packages</param-name>
            <param-value>com.mypackage;com.wordnik.swagger.jersey.listing</param-value>
        </init-param>
        <init-param>
            <param-name>com.sun.jersey.api.json.POJOMappingFeature</param-name>
            <param-value>true</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>jersey</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>

    <servlet>
        <servlet-name>JerseyJaxrsConfig</servlet-name>
        <servlet-class>com.wordnik.swagger.jersey.config.JerseyJaxrsConfig</servlet-class>
        <init-param>
            <param-name>api.version</param-name>
            <param-value>1.0.0</param-value>
        </init-param>
        <init-param>
            <param-name>swagger.api.basepath</param-name>
            <param-value>http://localhost:8002/api</param-value>
        </init-param>
        <load-on-startup>2</load-on-startup>
    </servlet>


depedency in pom.xml

Код

        <dependency>
            <groupId>com.wordnik</groupId>
            <artifactId>swagger-jersey-jaxrs_2.10</artifactId>
            <version>1.3.0</version>
        </dependency>



Ну и в классе добавил аннотацию

Код


import javax.ws.rs.Path;
import org.springframework.stereotype.Component;
import com.wordnik.swagger.annotations.Api;

@Component
@Path("service/part")
@Api(value = "service/part", description = "Operations about .....")
public class PartServiceController {
......



Я не совсем понимаю, что именно я сюда должен вписать(сконфигурировать), зачем прописывать localhost с таким портом...

Код

        <init-param>
            <param-name>api.version</param-name>
            <param-value>1.0.0</param-value>
        </init-param>
        <init-param>
            <param-name>swagger.api.basepath</param-name>
            <param-value>http://localhost:8002/api</param-value>
        </init-param>

Автор: longtail 12.3.2014, 20:21
Смотри мануал к классу System.Windows.AttachedPropertyBrowsableWhenAttributePresentAttribute под .NET. В этом классе давно решена твоя проблема. Пишешь прогу с использованием этого класса и с её помощью интегрируешь проекты.

Автор: Killer_13 12.3.2014, 20:45
Цитата(longtail @ 12.3.2014,  20:21)
Смотри мануал к классу System.Windows.AttachedPropertyBrowsableWhenAttributePresentAttribute под .NET. В этом классе давно решена твоя проблема. Пишешь прогу с использованием этого класса и с её помощью интегрируешь проекты.

Спасибо за ответ, но мне нужно решить задачу с существующими именно для решения такой задачи инструментами. А не изобретать третье колесо в велосипеде... По моему это не серьезно в javaEE - проектах впихивать какой-то NET-класс.

Powered by Invision Power Board (http://www.invisionboard.com)
© Invision Power Services (http://www.invisionpower.com)