Início / coding / Perguntas / 79315033
Accepted
CoderJammer
Asked: 2024-12-29 13:54:57 +0800 CST

Erro de atributos do OpenApi maven-plugin-generator

  • 772

Estou usando SpringBoot 3.4.1, Java 21 e estou tentando gerar classes de servidor Spring (Api mais Modelo).

Tenho esta configuração maven no módulo do projeto do gerador:

 <dependency>
     <groupId>org.springdoc</groupId>
     <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
     <version>2.7.0</version>
 </dependency>
 
 <build>
    <plugins>
        <plugin>
            <groupId>org.openapitools</groupId>
            <artifactId>openapi-generator-maven-plugin</artifactId>
            <version>7.10.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                    <configuration>
                        <inputSpec>${project.basedir}/src/main/resources/api-docs.yaml</inputSpec>
                        <output>${project.build.directory}/generated-sources</output>
                        <generatorName>spring</generatorName>
                        <apiPackage>com.api.rest.web.resources</apiPackage>
                        <modelPackage>com.api.rest.model</modelPackage>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Também escrevi este .yamlarquivo simples para testar o gerador:

openapi: "3.0.2"
info:
title: Example Rest Archetype
version: 0.0.1

components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
          format: int64
        name:
          type: string
          minLength: 3
          maxLength: 20
        surname:
          type: string
          minLength: 3
          maxLength: 20
        username:
          type: string
          minLength: 3
          maxLength: 30
        email:
          type: string
          minLength: 3
          maxLength: 30
        address:
          type: array
          items:
            $ref: "#/components/schemas/Address"
      required:
       - name
       - surname
       - username
    Address:
      type: object
      properties:
        id:
          type: integer
          format: int64
        description:
          type: string
          minLength: 3
          maxLength: 20
        user:
          type: object
          $ref: "#/components/schemas/User"
    Error:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
      required:
       - code
       - message

É isso. Eu sei que o atributo pathsestá faltando, mas quando eu compilo o módulo eu recebo outros dois erros e não entendo o porquê. Este é o resultado:

Errors: 
 -attribute paths is missing
 -attribute components.schemas.Error.properties is not of type `object`
 -attribute components.schemas.User.properties is not of type `object`

O que está errado?

Corrigi meu .yamlarquivo porque usei o editor IntelliJ e provavelmente o erro de recuo foi devido à adição de espaço para formatá-lo como um código aqui. De qualquer forma, perdi a jacksondependência no meu pom.xmle certamente isso causou o erro.

Muito obrigado.

spring-boot

1 respostas

  1. Best Answer

    Há alguns erros de indentação no seu yaml. Adicionei o que faltava paths: {}para habilitar a compilação.

    Arquivo corrigido

    openapi: "3.0.2"
info:
  title: Example Rest Archetype
  version: 0.0.1

paths: {}

components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
          format: int64
        name:
          type: string
          minLength: 3
          maxLength: 20
        surname:
          type: string
          minLength: 3
          maxLength: 20
        username:
          type: string
          minLength: 3
          maxLength: 30
        email:
          type: string
          minLength: 3
          maxLength: 30
        address:
          type: array
          items:
            $ref: "#/components/schemas/Address"
      required:
        - name
        - surname
        - username
    Address:
      type: object
      properties:
        id:
          type: integer
          format: int64
        description:
          type: string
          minLength: 3
          maxLength: 20
        user:
          $ref: "#/components/schemas/User"
    Error:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
      required:
        - code
        - message

    Para gerar anotações Jakarta, adicionei <useJakartaEe>true</useJakartaEe>.

    POM completo

    <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.1</version>
        <relativePath/>
    </parent>
    <groupId>com.api.rest</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>21</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>2.7.0</version>
        </dependency>
        <dependency>
            <groupId>org.openapitools</groupId>
            <artifactId>jackson-databind-nullable</artifactId>
            <version>0.2.6</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.openapitools</groupId>
                <artifactId>openapi-generator-maven-plugin</artifactId>
                <version>7.10.0</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>generate</goal>
                        </goals>
                        <configuration>
                            <inputSpec>${project.basedir}/src/main/resources/api-docs.yaml</inputSpec>
                            <output>${project.build.directory}/generated-sources</output>
                            <generatorName>spring</generatorName>
                            <apiPackage>com.api.rest.web.resources</apiPackage>
                            <modelPackage>com.api.rest.model</modelPackage>
                            <configOptions>
                                <useJakartaEe>true</useJakartaEe>
                            </configOptions>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <mainClass>com.api.rest.DemoApplication</mainClass>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>build-info</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>
    • 2

relate perguntas