在项目中完成对象建模后,可以使用Obase来进行对象的管理(例如对象持久化),本篇教程将创建一个.NET Core控制台应用,来展示Obase的配置和对象的增删改查操作。本篇教程旨在指引简单入门。
本篇教程将以此对象模型展开
class Blog{
+BlogId:int[文章Id]
+Url:string[文章地址]
+Post:sList[文章评论]
}
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的引用
定义领域实体类
///
/// 文章
///
public class Blog
{
private int blogId;
private string url;
private List posts;
///
/// 文章Id
///
public int BlogId { get => blogId; set => blogId = value; }
///
/// 文章地址
///
public string Url { get => url; set => url = value; }
///
/// 文章评论(注意:关联引用属性需要定义为virtual)
///
public virtual List Posts { get => posts; set => posts = value; }
}
///
/// 文章评论
///
public class Post
{
private int postId;
private string title;
private string content;
private int blogId;
private Blog blog;
///
/// 评论Id
///
public int PostId { get => postId; set => postId = value; }
///
/// 评论标题
///
public string Title { get => title; set => title = value; }
///
/// 评论内容
///
public string Content { get => content; set => content = value; }
///
/// 文章Id
///
public int BlogId { get => blogId; set => blogId = value; }
///
/// 关联文章(注意:关联引用属性需要定义为virtual)
///
public virtual Blog Blog { get => blog; set => blog = value; }
}
自定义对象上下文
Obase直接与应用程序进行交互的便是ObectContext(对象上下文),项目中可以根据具体情况定义一个或者多个继承于ObjectContext的自定义对象上下文。
using freep.Obase;
using freep.Obase.ExecuteSql;
using freep.Obase.Odm.Builder;
///
/// 自定义对象上下文
///
public class MyContext : ObjectContext
{
///
/// 构造函数
///
public MyContext() : base("user=root;password=;server=localhost;database=ObaseTutorial;SslMode = none;port=3306;", true)
{
}
}
注意:自定义对象上下文通过继承父类的构造函数设置数据源连接字符串(此处为了演示方便,直接将连接字符串作为参数进行传递,实际项目中可以定义到配置文件中)。
配置对象模型
在对象数据模型生成之前,可以对数据源的类型进行设置,以及对象数据模型的配置,配置的类型包括实体类型,关联类型,关联引用,关联端,属性等的配置,本篇只展示最基本的实体类型,关联类型,关联引用的配置。
///
/// 自定义对象上下文
///
public class MyContext : ObjectContext
{
///
/// 在即将生成对象数据模型并注册到对象上下文之前调用此方法
///
/// 建模器
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
//设置模型映射目标源的类型(默认不设置未SQLServer)
modelBuilder.HasTargetSourceType(eDataSource.MySql);
//配置对象数据模型
this.ModelConfiguratoin(modelBuilder);
base.OnModelCreating(modelBuilder);
}
///
/// 配置对象数据模型
///
/// 建模器
protected virtual void ModelConfiguratoin(ModelBuilder modelBuilder)
{
//配置实体型
var blogCfg = modelBuilder.Entity();
//设置实体型的映射数据表
blogCfg.ToTable("Blog");
//设置实体型的标识属性
blogCfg.HasKeyAttribute(p => p.BlogId);
//设置实体型的标识属性为自增
blogCfg.HasKeyIsSelfIncreased(true);
//配置实体型
var postCfg = modelBuilder.Entity();
//设置实体型的映射数据表
postCfg.ToTable("Post");
//设置实体型的标识属性
postCfg.HasKeyAttribute(p => p.PostId);
//设置实体型的标识属性为自增
postCfg.HasKeyIsSelfIncreased(true);
//配置对象间隐式关联类型
var blogAssPostCfg = modelBuilder.Association();
//设置关联类型的映射数据表
blogAssPostCfg.ToTable("Post");
//设置关联映射端1(参照方)的键属性以及在关联表中映射的字段
blogAssPostCfg.AssociationEnd("End1").HasMapping("BlogId", "BlogId");
//设置关联映射端2(被参照方)的键属性以及在关联表中映射的字段
//注意:HasDefaultAsNew方法设置一个值,该值指示是否把关联端对象默认视为新对象。当该属性为true时,如果关联端对象未被显式附加到上下文,该对象将被视为新对象实施持久化。
blogAssPostCfg.AssociationEnd("End2").HasMapping("PostId", "PostId").HasDefaultAsNew(true);
//配置实体类型的关联引用属性
//参数一:关联引用属性的名称 参数二:关联引用是否具有多重性
//注:此处在配置Blog实体与Post实体关联引用属性Posts
var blogRefPosts = blogCfg.AssociationReference("Posts", true);
//设置关联引用的本端
blogRefPosts.HasLeftEnd("End1");
//设置关联引用的对端
blogRefPosts.HasRightEnd("End2");
//设置关联引用属性延迟加载
blogRefPosts.HasEnableLazyLoading(true);
//配置实体类型的关联引用属性
//参数一:关联引用属性的名称 参数二:关联引用是否具有多重性
//注:此处在配置Post实体与Blog实体关联引用属性Blog
var postRefBlog = postCfg.AssociationReference("Blog", false);
//设置关联引用的本端(注意此处Post是作为本端的)
postRefBlog.HasLeftEnd("End2");
//设置关联引用的对端
postRefBlog.HasRightEnd("End1");
}
}
定义对象集
最终对对象的操作和访问是通过对象上下文提供的对象集,此处我们定义文章和文章评论对象集:
///
/// 自定义对象上下文
///
public class MyContext : ObjectContext
{
///
/// 文章对象集
///
public ObjectSet Blogs { get; set; }
///
/// 文章评论对象集
///
public ObjectSet Posts { get; set; }
}
对象的创建、读取、更新和删除
实例化对象上下文
var myContext = new MyContext();
创建
//实例化对象
Blog blog = new Blog()
{
Url = "https://www.yuque.com/geekfish/obase/getting-started",
Posts = new List() {
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 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();