第 277 章 URI 格式
rest-openapi:[specificationPath#]operationId
其中 operationId 是 OpenApi 规格中的操作 ID,specificationPath 是规格的路径。如果没有指定 specificationPath,则默认为 openapi.json。查找机制使用 Camels ResourceHelper 来加载资源,这意味着您可以使用 CLASSPATH 资源(classpath:my-specification.json), 文件(file:/some/path.json), web (http://api.example.com/openapi.json)或引用 bean (ref:nameOfBean)或使用 bean (bean:nameOfBean.methodName)来获取规格资源,失败,失败:
此组件不充当 HTTP 客户端,它将该客户端委派给上述另一个组件。查找机制搜索实施 RestProducerFactory 接口并使用的单一组件。如果 CLASSPATH 包含多个,则应设置 property componentName 来指示要委派哪些组件。
大多数配置都从 OpenApi 规范获取,但存在选项,通过在组件或端点中指定它们来覆盖它们。通常,如果主机 或 basePath 与规格不同,则您只需要覆盖主机或 basePath。
host 参数应包含包含方案、主机名和端口号的绝对 URI,例如: https://api.example.com
使用 componentName,您可以指定用于执行请求的组件,此命名组件需要存在于 Camel 上下文中,并实现所需的 RestProducerFactory 接口 swig-wagonas 处理顶部列出的组件。
如果您没有在组件或端点级别指定 componentName,则会搜索 CLASSPATH 以获得合适的委派。CLASSPATH 上应该只有一个组件,它实现了 RestProducerFactory 接口,以便它正常工作。
此组件的端点 URI 是很方便的,这意味着除了消息标头外,您还可以将 REST 操作的参数指定为端点参数,对于所有后续调用来说,它们会保持恒定的,因此仅将此功能用于对所有调用时常数的参数,如 /api/{version}/users/{id}。