OpenAPI documents support enumeration types

Author: kevin70

http-generator-core/src/main/java/io/avaje/http/generator/core/openapi/SchemaDocBuilder.java

@@ -3,6 +3,7 @@
 import static io.avaje.http.generator.core.Util.typeDef;
 
 import io.avaje.http.generator.core.javadoc.Javadoc;
+import io.swagger.v3.oas.models.media.StringSchema;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
@@ -11,6 +12,7 @@
 
 import javax.lang.model.element.AnnotationMirror;
 import javax.lang.model.element.Element;
+import javax.lang.model.element.ElementKind;
 import javax.lang.model.element.Modifier;
 import javax.lang.model.element.TypeElement;
 import javax.lang.model.element.VariableElement;
@@ -149,9 +151,24 @@ Schema<?> toSchema(TypeMirror type) {
     if (types.isAssignable(type, iterableType)) {
       return buildIterableSchema(type);
     }
+    Element e = types.asElement(type);
+    if (e != null && e.getKind() == ElementKind.ENUM) {
+      return buildEnumSchema(e);
+    }
     return buildObjectSchema(type);
   }
 
+  private Schema<?> buildEnumSchema(Element e) {
+    var schema = new StringSchema();
+    e.getEnclosedElements().stream()
+      .filter(ec -> ec.getKind().equals(ElementKind.ENUM_CONSTANT))
+      .forEach(ec -> schema.addEnumItem(ec.getSimpleName().toString()));
+
+    var doc = Javadoc.parse(elements.getDocComment(e));
+    schema.setDescription(doc.getDescription());
+    return schema;
+  }
+
   private Schema<?> buildObjectSchema(TypeMirror type) {
     String objectSchemaKey = getObjectSchemaName(type);
 

tests/test-jex/src/main/java/org/example/web/HelloDto.java

@@ -8,4 +8,5 @@ public class HelloDto {
   public int id;
   @NotNull
   public String name;
+  public ServerType serverType;
 }