Почему не получается встроить Swagger в Spring+Jersey RESTful project?

пытаюсь прикрутить к проекту с (Jersey RESTful) Swagger для документирования REST API.
Есть мануал, есть и другие немногочисленные примеры, но что-то мне не очень получается сконфигурировать.

Java-JAXRS-Quickstart
Опишу вкратце, что сделал, и прошу подсказки, что я сделал не так или чего еще не сделал?!

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 {
......


Я не совсем понимаю, что именно я сюда должен вписать (сконфигурировать).
<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>

и как мне потом достучаться к этому всему?
Проект стартует в Tomcat
  • Вопрос задан
  • 3070 просмотров
Пригласить эксперта
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы