117笔记问答在Linux中集成Swagger与Spring Boot，可以按照以下步骤进行：
1. 添加依赖
首先，在你的Spring Boot项目的pom.xml文件中添加Swagger和Swagger UI的依赖。你可以使用Springfox库来实现这一点。
org.springframework.boot spring-boot-starter-web io.springfox springfox-swagger2 2.9.2 io.springfox springfox-swagger-ui 2.9.2
2. 配置Swagger
创建一个配置类来配置Swagger。这个类需要使用@Configuration注解，并且包含一个方法来定义Swagger的Docket bean。
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.demo.controller")) // 替换为你的控制器包路径
.paths(PathSelectors.any())
.build();
}
}
3. 启动应用
确保你的Spring Boot应用已经启动。你可以在终端中运行以下命令来启动应用：
./mvnw spring-boot:run
4. 访问Swagger UI
一旦应用启动，你可以通过浏览器访问Swagger UI界面。默认情况下，Swagger UI的地址是：
http://localhost:8080/swagger-ui.html
5. 配置Swagger UI（可选）
如果你想要自定义Swagger UI的外观或行为，可以在application.properties或application.yml文件中进行配置。例如：
springfox.documentation.swagger.v2.path=/api-docs
6. 使用Swagger注解
在你的控制器类和方法上使用Swagger注解来提供更多的API文档信息。例如：
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/api")
@Api(tags = "示例控制器")
public class ExampleController {
@GetMapping("/hello")
@ApiOperation("返回一个简单的问候语")
public String sayHello() {
return "Hello, World!";
}
}
通过以上步骤，你就可以在Linux环境中成功集成Swagger与Spring Boot，并且可以通过Swagger UI界面来查看和测试你的API。