面向对象存储框架：Obase快速入门

在项目中完成对象建模后，可以使用Obase来进行对象的管理（例如对象持久化），本篇教程将创建一个.NET Core控制台应用，来展示Obase的配置和对象的增删改查操作。本篇教程旨在指引简单入门。

本篇教程将以此对象模型展开

class Blog{
    +BlogId:int[文章Id]
    +Url:string[文章地址]
    +Post:sList<Post>[文章评论]
}
class Post{
    +PostId:int[评论Id]
    +Title:string[评论标题]
    +Content:string[评论内容]
    +Blog:Blog[关联文章]
}
Blog "1"-right-"*"  Post
hide empty member

从NuGet安装Obase

• 在VS的NuGet包管理器中添加程序包源：http://nuget.suiyiyun.cn:8081/nuget
• 在NuGet包管理器中选择Obase进行安装

项目搭建

• 打开 Visual Studio
• 单击“创建新项目”
• 选择带有 C# 标记的“控制台应用 (.NET Core)” ，然后单击“下一步”
• 输入“ObaseTutorial” 作为名称，然后单击“创建”
• 添加对freep.Obase.dll的引用

定义领域实体类

	/// <summary>
    /// 文章
    /// </summary>
    public class Blog
    {
        private int blogId;
        private string url;
        private List<Post> posts;
        /// <summary>
        /// 文章Id
        /// </summary>
        public int BlogId { get => blogId; set => blogId = value; }
        /// <summary>
        /// 文章地址
        /// </summary>
        public string Url { get => url; set => url = value; }
       /// <summary>
       /// 文章评论（注意：关联引用属性需要定义为virtual）
       /// </summary>
        public virtual List<Post> Posts { get => posts; set => posts = value; }
    }
   /// <summary>
    /// 文章评论
    /// </summary>
    public class Post
    {
        private int postId;
        private string title;
        private string content;
        private int blogId;
        private Blog blog;
        /// <summary>
        /// 评论Id
        /// </summary>
        public int PostId { get => postId; set => postId = value; }
        /// <summary>
        /// 评论标题
        /// </summary>
        public string Title { get => title; set => title = value; }
        /// <summary>
        /// 评论内容
        /// </summary>
        public string Content { get => content; set => content = value; }
        /// <summary>
        /// 文章Id
        /// </summary>
        public int BlogId { get => blogId; set => blogId = value; }
        /// <summary>
        /// 关联文章（注意：关联引用属性需要定义为virtual）
        /// </summary>
        public virtual Blog Blog { get => blog; set => blog = value; }
    }

自定义对象上下文

Obase直接与应用程序进行交互的便是ObectContext（对象上下文），项目中可以根据具体情况定义一个或者多个继承于ObjectContext的自定义对象上下文。

	using freep.Obase;
	using freep.Obase.ExecuteSql;
	using freep.Obase.Odm.Builder;
	/// <summary>
    /// 自定义对象上下文
    /// </summary>
    public class MyContext : ObjectContext
    {
        /// <summary>
        /// 构造函数
        /// </summary>
        public MyContext() : base("user=root;password=;server=localhost;database=ObaseTutorial;SslMode = none;port=3306;", true)
        {
        }
    }

注意：自定义对象上下文通过继承父类的构造函数设置数据源连接字符串（此处为了演示方便，直接将连接字符串作为参数进行传递，实际项目中可以定义到配置文件中）。

配置对象模型

在对象数据模型生成之前，可以对数据源的类型进行设置，以及对象数据模型的配置，配置的类型包括实体类型，关联类型，关联引用，关联端，属性等的配置，本篇只展示最基本的实体类型，关联类型，关联引用的配置。

    /// <summary>
    /// 自定义对象上下文
    /// </summary>
    public class MyContext : ObjectContext
    {
		/// <summary>
        /// 在即将生成对象数据模型并注册到对象上下文之前调用此方法
        /// </summary>
        /// <param name="modelBuilder">建模器</param>
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            //设置模型映射目标源的类型(默认不设置未SQLServer)
            modelBuilder.HasTargetSourceType(eDataSource.MySql);
            //配置对象数据模型
            this.ModelConfiguratoin(modelBuilder);
            base.OnModelCreating(modelBuilder);
        }
        /// <summary>
        /// 配置对象数据模型
        /// </summary>
        /// <param name="modelBuilder">建模器</param>
        protected virtual void ModelConfiguratoin(ModelBuilder modelBuilder)
        {
        	//配置实体型
            var blogCfg = modelBuilder.Entity<Blog>();
            //设置实体型的映射数据表
            blogCfg.ToTable("Blog");
            //设置实体型的标识属性
            blogCfg.HasKeyAttribute(p => p.BlogId);
            //设置实体型的标识属性为自增
            blogCfg.HasKeyIsSelfIncreased(true);
            //配置实体型
            var postCfg = modelBuilder.Entity<Post>();
            //设置实体型的映射数据表
            postCfg.ToTable("Post");
            //设置实体型的标识属性
            postCfg.HasKeyAttribute(p => p.PostId);
            //设置实体型的标识属性为自增
            postCfg.HasKeyIsSelfIncreased(true);
            //配置对象间隐式关联类型
            var blogAssPostCfg = modelBuilder.Association<Blog, Post>();
            //设置关联类型的映射数据表
            blogAssPostCfg.ToTable("Post");
            //设置关联映射端1（参照方）的键属性以及在关联表中映射的字段
            blogAssPostCfg.AssociationEnd<Blog>("End1").HasMapping("BlogId", "BlogId");
            //设置关联映射端2（被参照方）的键属性以及在关联表中映射的字段
            //注意：HasDefaultAsNew方法设置一个值，该值指示是否把关联端对象默认视为新对象。当该属性为true时，如果关联端对象未被显式附加到上下文，该对象将被视为新对象实施持久化。
            blogAssPostCfg.AssociationEnd<Post>("End2").HasMapping("PostId", "PostId").HasDefaultAsNew(true);
            //配置实体类型的关联引用属性
            //参数一：关联引用属性的名称 参数二：关联引用是否具有多重性
            //注：此处在配置Blog实体与Post实体关联引用属性Posts
            var blogRefPosts = blogCfg.AssociationReference<Blog, Post>("Posts", true);
            //设置关联引用的本端
            blogRefPosts.HasLeftEnd("End1");
            //设置关联引用的对端
            blogRefPosts.HasRightEnd("End2");
            //设置关联引用属性延迟加载
            blogRefPosts.HasEnableLazyLoading(true);
            //配置实体类型的关联引用属性
            //参数一：关联引用属性的名称 参数二：关联引用是否具有多重性
            //注：此处在配置Post实体与Blog实体关联引用属性Blog
            var postRefBlog = postCfg.AssociationReference<Blog, Post>("Blog", false);
            //设置关联引用的本端（注意此处Post是作为本端的）
            postRefBlog.HasLeftEnd("End2");
            //设置关联引用的对端
            postRefBlog.HasRightEnd("End1");
        }
	}

定义对象集

最终对对象的操作和访问是通过对象上下文提供的对象集，此处我们定义文章和文章评论对象集：

    /// <summary>
    /// 自定义对象上下文
    /// </summary>
    public class MyContext : ObjectContext
    {
        /// <summary>
        /// 文章对象集
        /// </summary>
        public ObjectSet<Blog> Blogs { get; set; }
        /// <summary>
        /// 文章评论对象集
        /// </summary>
        public ObjectSet<Post> Posts { get; set; }
    }

对象的创建、读取、更新和删除

实例化对象上下文

var myContext = new MyContext();

创建

//实例化对象
Blog blog = new Blog()
{
    Url = "https://www.yuque.com/geekfish/obase/getting-started",
    Posts = new List<Post>() {
        new Post (){  Title= "请问Obase怎么安装？", Content = "暂时只提供dll文件"}
    }
};
//将对象附加到对象上下文
myContext.Blogs.Attach(blog);
//将对象保存到数据源
myContext.SaveChanges();

读取

using System.Linq;
//从持久化源查询数据
Blog firstBlog = myContext.Blogs.OrderBy(p => p.Url).First();
//访问关联引用属性
List<Post> posts = firstBlog.Posts;

更新

 //修改属性
firstBlog.Url = "http://www.test.com/aa.html";
//将对象保存到数据源
myContext.SaveChanges();

删除

//删除指定对象
myContext.Blogs.Remove(firstBlog);
//根据条件删除指定对象
myContext.Blogs.Delete(p => p.BlogId == 1);
//将对象保存到数据源(只有在保存后，数据才真实删除)
myContext.SaveChanges();