swagger - 将 swagger API 文档 (swagger.json) 解析为 Java 对象

Question

我想将任何复杂的 swagger-API-document(swagger.json) 解析为 Java 对象。

可能是列表>

有哪些可用选项？

我正在尝试使用 io.swagger.parser.SwaggerParser。

但我想确保我知道其他可用选项并且我使用了足以解析任何复杂文档的正确解析器。

目前我们正在尝试如下。

public  List<Map<String,Object>> parse(String swaggerDocString) throws SwaggerParseException{
    try{
        Swagger swagger = new SwaggerParser().parse(swaggerDocString);
        return processSwagger(swagger);
    }catch(Exception ex){
        String exceptionRefId=OSGUtil.getExceptionReferenceId();
        logger.error("exception ref id " + exceptionRefId +  " : Error while loading swagger file " + ex);
        throw new SwaggerParseException("", ex.getLocalizedMessage(),exceptionRefId);
    }
}

public  List<Map<String,Object>> processSwagger(Swagger swagger){
    List<Map<String,Object>>  finalResult=new ArrayList<>();
    Map<String, Model>  definitions = swagger.getDefinitions();
    // loop all the available paths of the swagger
    if(swagger.getPaths()!=null && swagger.getPaths().keySet()!=null &&swagger.getPaths().keySet().size()>0 ){
        swagger.getPaths().keySet().forEach(group->{
            //get the path
            Path path=swagger.getPath(group);
            //list all the operations of the path
            Map<HttpMethod,Operation> mapList=path.getOperationMap();
            mapList.forEach((httpMethod,operation)->{
                processPathData(finalResult,operation,path,group,httpMethod,definitions,group);
            });

        });
    }
    return finalResult;
}

有什么区别

swagger-compat-spec-parser, Swagger 的解析器

Answer 1

swagger 拥有所有技术的实现。 https://swagger.io/tools/open-source/open-source-integrations/

将 swagger 解析为 Java 的详细信息在此处。 https://github.com/swagger-api/swagger-parser/tree/v1