feat(schema): Doc for UniDirectionalOneToManyWithOneDbSet

EntityFramework.Explained/Schema/Relationships/UniDirectionalOneToMany/UniDirectionalOneToManyWithOneDbSet.cs

@@ -0,0 +1,96 @@
+using EntityFramework.Explained._Tools.TestContexts;
+using Microsoft.EntityFrameworkCore;
+using QuickPulse.Explains;
+using QuickPulse.Explains.Text;
+
+namespace EntityFramework.Explained.Schema.Relationships.UniDirectionalOneToMany;
+
+[DocFile]
+[DocContent(
+@"Because the entity used in the `DbSet` has a collection of another entity type, the latter are mapped as well.  
+EF infers and includes related entities in the schema even when only one side is explicitly registered in the `DbContext`.  
+")]
+public class UniDirectionalOneToManyWithOneDbSet
+{
+    [DocExample]
+    public class Post
+    {
+        public int Id { get; set; }
+        public Blog Blog { get; set; } = default!;
+    }
+
+    [DocExample]
+    public class Blog
+    {
+        public int Id { get; set; }
+    }
+
+    [Fact]
+    [DocContent("When using the following simple model of *one* `Blog` containing *many* `Posts`: ")]
+    [DocCodeExample(typeof(Blog))]
+    [DocCodeExample(typeof(Post))]
+    [DocContent("And then adding a `DbSet<Blog>` to the `DbContext` EF generates the following ddl for Sql Server:  \n")]
+    [DocContent("**Blog:**")]
+    [DocCodeExample(typeof(UniDirectionalOneToManyWithOneDbSet), nameof(ExpectedDdlScriptForBlog))]
+    [DocContent("**Post:**")]
+    [DocCodeExample(typeof(UniDirectionalOneToManyWithOneDbSet), nameof(ExpectedDdlScriptForPost))]
+    [DocContent("**Index:**")]
+    [DocCodeExample(typeof(UniDirectionalOneToManyWithOneDbSet), nameof(ExpectedDdlScriptForIndex))]
+    [DocContent("*Note:* No other mappings were added.")]
+    public void SqlServer()
+    {
+        using var context = new TestSqlServerContext<Post>();
+
+        var sql = context.Database.GenerateCreateScript();
+
+        var reader = LinesReader.FromText(sql);
+
+        Assert.Equal(ExpectedDdlScriptForBlog(), reader.NextLines(4));
+
+        reader.Skip(3);
+        Assert.Equal(ExpectedDdlScriptForPost(), reader.NextLines(6));
+
+        reader.Skip(3);
+        Assert.Equal(ExpectedDdlScriptForIndex(), reader.NextLine());
+
+        reader.Skip(4);
+        Assert.True(reader.EndOfContent());
+    }
+
+    [DocSnippet]
+    [DocReplace("return", "")]
+    private string[] ExpectedDdlScriptForBlog()
+    {
+        return
+            [
+                "CREATE TABLE [Blog] (",
+                "    [Id] int NOT NULL IDENTITY,",
+                "    CONSTRAINT [PK_Blog] PRIMARY KEY ([Id])",
+                ");"
+            ];
+    }
+
+    [DocSnippet]
+    [DocReplace("return", "")]
+    [DocReplace("Item", "Post")]
+    private string[] ExpectedDdlScriptForPost()
+    {
+        return
+            [
+                "CREATE TABLE [Items] (",
+                "    [Id] int NOT NULL IDENTITY,",
+                "    [BlogId] int NOT NULL,",
+                "    CONSTRAINT [PK_Items] PRIMARY KEY ([Id]),",
+                "    CONSTRAINT [FK_Items_Blog_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blog] ([Id]) ON DELETE CASCADE",
+                ");"
+            ];
+    }
+
+    [DocSnippet]
+    [DocReplace("return", "")]
+    [DocReplace("Item", "Post")]
+    private string ExpectedDdlScriptForIndex()
+    {
+        return "CREATE INDEX [IX_Items_BlogId] ON [Items] ([BlogId]);";
+    }
+}