- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我试图让 Swagger 从属性文件 swagger.properties
中读取 API 文档,但不能。在 @ApiOperation
注释中有一个错误提示:Attribute value must be constant
。关于如何解决此问题并能够从属性文件中读取文档的任何建议?
这是 Controller 代码:
package com.demo.student.demo.controller;
import com.demo.student.demo.entity.Student;
import com.demo.student.demo.service.StudentService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping(value = "/v1/students")
@Api(description = "Set of endpoints for Creating, Retrieving, Updating and Deleting of Students.")
public class StudentController {
private final String message;
public StudentController(@Value("${test.swagger.message}") String message){
this.message=message;
}
@Autowired
private StudentService studentService;
@GetMapping
@ApiOperation(message)
public List<Student> findAll(){
return studentService.findAl();
}
}
另外,我如何在@API(description) 中的类级别注入(inject)一个值?
最佳答案
有一个解决方法。但是你需要一个额外的依赖 - springfox
。
您可以编写一个插件,将来自外部文件的文本注入(inject)到您的 @ApiOperation
description
字段中。我在我的项目中使用它来注入(inject) Markdown 文件。它非常方便,因为 Swagger 支持 markdown,并且每个端点都有一个单独的文件,让您有机会编写大量的 API 描述(如果您使用的是 IntelliJ IDEA 或类似工具,也可以在 markdown 编辑器中)。
这是您需要的代码:
为您要提供描述的每个端点自定义注释 (@ApiDescription
)。注释的值将是您的 Markdown 文件或属性文件的文件路径。稍后插件将在提供的文件路径中查找文件并将描述设置为文件的内容。
@Target({ ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
public @interface ApiDescription {
String value() default "";
}
插件本身。它是一个扩展点。在这种情况下,我们希望稍后交换或设置 @ApiOperation
注释的描述值。查看Springfox Plugins .
...
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spi.service.OperationBuilderPlugin;
import springfox.documentation.spi.service.contexts.OperationContext;
import springfox.documentation.spring.web.DescriptionResolver;
...
@Component
public class ApiDescriptionPlugin implements OperationBuilderPlugin {
private final DescriptionResolver resolver;
@Autowired
public ApiDescriptionPlugin(DescriptionResolver resolver) {
this.resolver = resolver;
}
@Override
public void apply(OperationContext context) {
Optional<ApiDescription> descOptional = context.findAnnotation(ApiDescription.class);
boolean hasText = descOptional.isPresent() && StringUtils.hasText(descOptional.get().value());
if(!hasText) {
return;
}
final String file = descOptional.get().value();
final URL url = Resources.getResource(file);
String description;
try {
description = Resources.toString(url, StandardCharsets.UTF_8);
} catch(IOException e) {
log.error("Error while reading markdown description file {}", file, e);
description = String.format("Markdown file %s not loaded", file);
}
context.operationBuilder().notes(resolver.resolve(description));
}
@Override
public boolean supports(DocumentationType type) {
return true;
}
}
简单地用@ApiDescription("/notes/auth/login.md")
注释端点(文件必须在resources
文件夹)
您可以调整此示例以使用属性文件(我不知道您的结构是什么样子以及您如何分隔不同的 API 描述)。这种使用 markdown 文件的解决方法对于编写大量描述并使它们远离实际代码很有用。
它适用于 Swagger 2.0。
试一试。
关于spring - Swagger 从属性文件中读取文档,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/58998687/
我需要将文本放在 中在一个 Div 中,在另一个 Div 中,在另一个 Div 中。所以这是它的样子: #document Change PIN
奇怪的事情发生了。 我有一个基本的 html 代码。 html,头部, body 。(因为我收到了一些反对票,这里是完整的代码) 这是我的CSS: html { backgroun
我正在尝试将 Assets 中的一组图像加载到 UICollectionview 中存在的 ImageView 中,但每当我运行应用程序时它都会显示错误。而且也没有显示图像。 我在ViewDidLoa
我需要根据带参数的 perl 脚本的输出更改一些环境变量。在 tcsh 中,我可以使用别名命令来评估 perl 脚本的输出。 tcsh: alias setsdk 'eval `/localhome/
我使用 Windows 身份验证创建了一个新的 Blazor(服务器端)应用程序,并使用 IIS Express 运行它。它将显示一条消息“Hello Domain\User!”来自右上方的以下 Ra
这是我的方法 void login(Event event);我想知道 Kotlin 中应该如何 最佳答案 在 Kotlin 中通配符运算符是 * 。它指示编译器它是未知的,但一旦知道,就不会有其他类
看下面的代码 for story in book if story.title.length < 140 - var story
我正在尝试用 C 语言学习字符串处理。我写了一个程序,它存储了一些音乐轨道,并帮助用户检查他/她想到的歌曲是否存在于存储的轨道中。这是通过要求用户输入一串字符来完成的。然后程序使用 strstr()
我正在学习 sscanf 并遇到如下格式字符串: sscanf("%[^:]:%[^*=]%*[*=]%n",a,b,&c); 我理解 %[^:] 部分意味着扫描直到遇到 ':' 并将其分配给 a。:
def char_check(x,y): if (str(x) in y or x.find(y) > -1) or (str(y) in x or y.find(x) > -1):
我有一种情况,我想将文本文件中的现有行包含到一个新 block 中。 line 1 line 2 line in block line 3 line 4 应该变成 line 1 line 2 line
我有一个新项目,我正在尝试设置 Django 调试工具栏。首先,我尝试了快速设置,它只涉及将 'debug_toolbar' 添加到我的已安装应用程序列表中。有了这个,当我转到我的根 URL 时,调试
在 Matlab 中,如果我有一个函数 f,例如签名是 f(a,b,c),我可以创建一个只有一个变量 b 的函数,它将使用固定的 a=a1 和 c=c1 调用 f: g = @(b) f(a1, b,
我不明白为什么 ForEach 中的元素之间有多余的垂直间距在 VStack 里面在 ScrollView 里面使用 GeometryReader 时渲染自定义水平分隔线。 Scrol
我想知道,是否有关于何时使用 session 和 cookie 的指南或最佳实践? 什么应该和什么不应该存储在其中?谢谢! 最佳答案 这些文档很好地了解了 session cookie 的安全问题以及
我在 scipy/numpy 中有一个 Nx3 矩阵,我想用它制作一个 3 维条形图,其中 X 轴和 Y 轴由矩阵的第一列和第二列的值、高度确定每个条形的 是矩阵中的第三列,条形的数量由 N 确定。
假设我用两种不同的方式初始化信号量 sem_init(&randomsem,0,1) sem_init(&randomsem,0,0) 现在, sem_wait(&randomsem) 在这两种情况下
我怀疑该值如何存储在“WORD”中,因为 PStr 包含实际输出。? 既然Pstr中存储的是小写到大写的字母,那么在printf中如何将其给出为“WORD”。有人可以吗?解释一下? #include
我有一个 3x3 数组: var my_array = [[0,1,2], [3,4,5], [6,7,8]]; 并想获得它的第一个 2
我意识到您可以使用如下方式轻松检查焦点: var hasFocus = true; $(window).blur(function(){ hasFocus = false; }); $(win
我是一名优秀的程序员,十分优秀!