+Spring-boot
注意:
若配置了指定的服务描述框架,如cxf-rt-rs-service-description-swagger
或cxf-rt-rs-service-description-openapi-v3
则需要加上cxf-rt-rs-service-description
依赖,默认的服务列表页面才会出现, service-list-path
才能有效。不然报 404 错误
http://cxf.apache.org/docs/springboot.html
在 java 的 配置类中
// restful web service
@Autowired
private CxfRsService rsService;
@Bean
public Server rsServer() {
final JAXRSServerFactoryBean endpoint = new JAXRSServerFactoryBean();
endpoint.setProvider(new JacksonJsonProvider());
endpoint.setAddress("/rs");
// endpoint.setServiceBeans(Arrays.<Object>asList());
endpoint.setServiceBean(rsService);
endpoint.setFeatures(Arrays.asList(new Swagger2Feature()));
return endpoint.create();
}
在项目的application.yml中,
cxf:
jaxrs:
component-scan: true
classes-scan-packages: org.apache.cxf.jaxrs.swagger,com.vtech.ws.cxf
ws 为 context,rs 为 手动配置restful服务时的地址
默认服务列表地址:'http://host:port/context/services/services'
(最后面的services可以通过cxf.servlet.init.service-list-path
属性修改, 如http://localhost:8008/ws/services/list
)
soap: http://localhost:8008/ws/services/info?wsdl (java 配置)
http://localhost:8008/ws/services/HiService?wsdl (xml配置)
rest: http://localhost:8008/ws/services/rs/sayHello/cxf ( rs 为 endpoint地址,如果指定了的话。最后的cxf为输入参数);
http://localhost:8008/ws/services/rs/swagger.json
在 application.yaml
配置文件中配置启动swagger
使用 swagger.properties
配置 swagger
在endpoint 地址后加swagger.json
或 swagger.yaml
如,若 JAX-RS endpoint 发布地址为 http://host:port/context/services/
,
'context' 是应用程序上下文目录, "/services"
是 servlet URL,
Swagger documents 则为 http://host:port/context/services/swagger.json
和 http://host:port/context/services/swagger.yaml'
swagger-ui
'http://host:port/context/services/api-docs/?url=/swagger.json' 或
'http://host:port/context/services/services' 页面中也有swagger-ui 的链接
设置 Swagger2Feature 的 'supportSwaggerUi' 为'false'取消对UI的激活
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。