Saltar al contenido

Swagger Codegen (con complemento maven) para OpenAPI 3.0

Después de mucho luchar hemos hallado el resultado de este contratiempo que agunos usuarios de nuestro sitio web tienen. Si tienes algo que compartir no dudes en dejar tu comentario.

Solución:

Para usar Swagger Codegen con el complemento Maven para la especificación OpenAPI 3.0.0, puede considerar usar OpenAPI Generator en su lugar (que es una versión impulsada por la comunidad de Swagger Codegen).


    org.openapitools
    openapi-generator-maven-plugin
    3.3.4

Ref: https://github.com/OpenAPITools/openapi-generator#12—artifacts-on-maven-central

(consulte las preguntas y respuestas sobre por qué bifurcamos Swagger Codegen)

El complemento maven de codegen swagger v3 lanzado en abril de 2019 genera bibliotecas de clientes Java en funcionamiento a partir de una especificación OpenAPI 3.0, estoy usando esta configuración de complemento Maven pom.xml:


    io.swagger.codegen.v3
    swagger-codegen-maven-plugin
    3.0.8
    
    ..

El resto de las entradas de configuración y configOptions no han cambiado desde la versión 2.4.5. Tuve que reemplazar la antigua dependencia de anotación con lo siguiente para que el código del cliente se compilara:

    
        io.swagger.core.v3
        swagger-annotations
        2.0.8
    

Por solicitud de @ kozla13 a continuación, agregué un ejemplo completo de POM.



    4.0.0
    
    org.example.swaggerapi.client
    swagger-client
    Example
    0.0.1-SNAPSHOT
    
        11
        UTF-8
        UTF-8
        org.example.so
    
    
        
        
            javax.annotation
            javax.annotation-api
            1.3.2
        
        
            io.swagger.core.v3
            swagger-annotations
            2.0.8
        
        
            org.springframework
            spring-context
            5.1.10.RELEASE
        
        
        
            org.springframework
            spring-web
            5.1.10.RELEASE
        
        
        
            com.fasterxml.jackson.core
            jackson-core
            2.9.9
        
        
            com.fasterxml.jackson.core
            jackson-annotations
            2.9.0
        
        
            com.fasterxml.jackson.core
            jackson-databind
            2.9.9.3
        
        
            com.fasterxml.jackson.jaxrs
            jackson-jaxrs-json-provider
            2.9.9
        
        
            com.fasterxml.jackson.datatype
            jackson-datatype-jsr310
            2.9.9
        
        
        
            org.junit.jupiter
            junit-jupiter-api
            5.3.2
            test
        
    
    
        
            
                
                io.swagger.codegen.v3
                swagger-codegen-maven-plugin
                3.0.8
                
                    
                        
                            generate
                        
                        
                            $project.basedir/ric-plt-a1/a1/openapi.yaml
                            java
                            $client.base.package.name
                            $client.base.package.name.model
                            $client.base.package.name.api
                            $client.base.package.name.invoker
                            
                                $project.groupId
                                $project.artifactId
                                $project.version
                                resttemplate
                                true
                                java8
                                Apache 2.0
                                https://www.apache.org/licenses/LICENSE-2.0
                            
                        
                    
                
            
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    $java.version
                    $java.version
                
            
        
    

Calificaciones y reseñas

¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)



Utiliza Nuestro Buscador

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *