Fix schema generation with allOf inheritance (#2815)

Resolves #2268.
domaindrivendev · Apr 19, 2024 · a17b464 · a17b464
1 parent 1c29b4b
commit a17b464
Show file tree

Hide file tree

Showing 3 changed files with 30 additions and 14 deletions.
diff --git a/src/Swashbuckle.AspNetCore.SwaggerGen/SchemaGenerator/SchemaGenerator.cs b/src/Swashbuckle.AspNetCore.SwaggerGen/SchemaGenerator/SchemaGenerator.cs
@@ -362,6 +362,7 @@ private OpenApiSchema CreateObjectSchema(DataContract dataContract, SchemaReposi
                 AdditionalPropertiesAllowed = false
             };
 
+            OpenApiSchema root = schema;
             var applicableDataProperties = dataContract.ObjectProperties;
 
             if (_generatorOptions.UseAllOfForInheritance || _generatorOptions.UseOneOfForPolymorphism)
@@ -370,7 +371,15 @@ private OpenApiSchema CreateObjectSchema(DataContract dataContract, SchemaReposi
                 {
                     var baseTypeSchema = GenerateConcreteSchema(baseTypeDataContract, schemaRepository);
 
-                    schema.AllOf.Add(baseTypeSchema);
+                    if (_generatorOptions.UseAllOfForInheritance)
+                    {
+                        root = new OpenApiSchema();
+                        root.AllOf.Add(baseTypeSchema);
+                    }
+                    else
+                    {
+                        schema.AllOf.Add(baseTypeSchema);
+                    }
 
                     applicableDataProperties = applicableDataProperties
                         .Where(dataProperty => dataProperty.MemberInfo.DeclaringType == dataContract.UnderlyingType);
@@ -423,7 +432,12 @@ private OpenApiSchema CreateObjectSchema(DataContract dataContract, SchemaReposi
                 schema.AdditionalProperties = GenerateSchema(dataContract.ObjectExtensionDataType, schemaRepository);
             }
 
-            return schema;
+            if (root != schema)
+            {
+                root.AllOf.Add(schema);
+            }
+
+            return root;
         }
 
         private bool IsKnownSubType(DataContract dataContract, out DataContract baseTypeDataContract)

diff --git a/.../Swashbuckle.AspNetCore.Newtonsoft.Test/SchemaGenerator/NewtonsoftSchemaGeneratorTests.cs b/.../Swashbuckle.AspNetCore.Newtonsoft.Test/SchemaGenerator/NewtonsoftSchemaGeneratorTests.cs
@@ -418,14 +418,15 @@ public void GenerateSchema_SupportsOption_UseAllOfForInheritance()
             var referenceSchema = subject.GenerateSchema(typeof(SubType1), schemaRepository);
 
             var schema = schemaRepository.Schemas[referenceSchema.Reference.Id];
-            Assert.Equal("object", schema.Type);
-            Assert.Equal(new[] { "Property1" }, schema.Properties.Keys);
             Assert.NotNull(schema.AllOf);
-            var allOf = Assert.Single(schema.AllOf);
-            Assert.NotNull(allOf.Reference);
-            Assert.Equal("BaseType", allOf.Reference.Id);
+            Assert.Equal(2, schema.AllOf.Count);
+            var baseSchema = schema.AllOf[0];
+            Assert.Equal("BaseType", baseSchema.Reference.Id);
+            Assert.NotNull(baseSchema.Reference);
+            var subSchema = schema.AllOf[1];
+            Assert.Equal(new[] { "Property1" }, subSchema.Properties.Keys);
             // The base type schema
-            var baseTypeSchema = schemaRepository.Schemas[allOf.Reference.Id];
+            var baseTypeSchema = schemaRepository.Schemas[baseSchema.Reference.Id];
             Assert.Equal("object", baseTypeSchema.Type);
             Assert.Equal(new[] { "BaseProperty" }, baseTypeSchema.Properties.Keys);
         }

diff --git a/...shbuckle.AspNetCore.SwaggerGen.Test/SchemaGenerator/JsonSerializerSchemaGeneratorTests.cs b/...shbuckle.AspNetCore.SwaggerGen.Test/SchemaGenerator/JsonSerializerSchemaGeneratorTests.cs
@@ -492,14 +492,15 @@ public void GenerateSchema_SupportsOption_UseAllOfForInheritance()
             var referenceSchema = subject.GenerateSchema(typeof(SubType1), schemaRepository);
 
             var schema = schemaRepository.Schemas[referenceSchema.Reference.Id];
-            Assert.Equal("object", schema.Type);
-            Assert.Equal(new[] { "Property1" }, schema.Properties.Keys);
             Assert.NotNull(schema.AllOf);
-            var allOf = Assert.Single(schema.AllOf);
-            Assert.NotNull(allOf.Reference);
-            Assert.Equal("BaseType", allOf.Reference.Id);
+            Assert.Equal(2, schema.AllOf.Count);
+            var baseSchema = schema.AllOf[0];
+            Assert.Equal("BaseType", baseSchema.Reference.Id);
+            Assert.NotNull(baseSchema.Reference);
+            var subSchema = schema.AllOf[1];
+            Assert.Equal(new[] { "Property1" }, subSchema.Properties.Keys);
             // The base type schema
-            var baseTypeSchema = schemaRepository.Schemas[allOf.Reference.Id];
+            var baseTypeSchema = schemaRepository.Schemas[baseSchema.Reference.Id];
             Assert.Equal("object", baseTypeSchema.Type);
             Assert.Equal(new[] { "BaseProperty" }, baseTypeSchema.Properties.Keys);
         }