SpringDoc-儿童课程没有添加到Swagger Spec Schema

Question

我正在使用Spring-boot v2.6.7和Springdoc v1.6.8。以下是对象建模。我添加了一个端点，该端点将课程作为响应返回。我希望Swagger Spec会生成课程类型，而英语的孩子类型也有一个 itemport 字段字段，这是CourseItem的超级文字，并且有一个子类型，其中包括文件夹，课程，课程，课程，课程和测试。我希望Swagger规格包括所有子类型的适当架构定义。

package com.example.springdocdemo.domain

import com.fasterxml.jackson.annotation.JsonSubTypes
import com.fasterxml.jackson.annotation.JsonTypeInfo
import io.swagger.v3.oas.annotations.media.Schema
import java.util.UUID

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "type")
@JsonSubTypes(
    value = [
        JsonSubTypes.Type(value = EnglishCourse::class, name = "EnglishCourse")
    ]
)
abstract class Course {
    abstract val id: UUID
    abstract val name: String
    abstract val code: String
}

class EnglishCourse(
    val items: List<CourseItem>,
    override val id: UUID,
    override val code: String,
    override val name: String,
) : Course()

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "type")
@JsonSubTypes(
    value = [
        JsonSubTypes.Type(value = Folder::class, name = "FOLDER"),
        JsonSubTypes.Type(value = Lesson::class, name = "LESSON"),
        JsonSubTypes.Type(value = Test::class, name = "TEST")
    ]
)
@Schema(discriminatorProperty = "type", allOf = [Folder::class, Lesson::class, Test::class])
interface CourseItem {
    val type: CourseItemType
    val id: UUID
}

@Schema
class Folder(
    val items: List<CourseItem>,
    override val id: UUID,
    override val type: CourseItemType,
) : CourseItem {
    fun items() = println(items)
}

class Lesson(
    val name: String,
    override val id: UUID,
    override val type: CourseItemType,
) : CourseItem

class Test(
    val name: String,
    override val id: UUID,
    override val type: CourseItemType,
) : CourseItem

enum class CourseItemType {
    Folder, Lesson, Test
}

下面是文件夹类型的架构定义，

"Folder": {
    "required": [
      "id",
      "type"
    ],
    "type": "object",
    "allOf": [
      {
        "$ref": "#/components/schemas/CourseItem"
      }
    ]
  },

它不包含字段ID和项目。有什么解决方案吗？该代码可以在此处找到： https：//github.com/bhaveshssppringdoc-springdoc-sissue-springdoc-sissue

Answer 1

也许尝试

@Schema(subTypes = {EnglishCourse.class})