Adhesive框架系列文章--Mongodb数据服务使用实践

在此文中，我们会实践一下，如何使用Mongodb数据服务存储新的自定义数据。之前我们说过了，使用Mongodb数据服务只有4步这么简单：

1）定义实体

2）定义元数据

3）配置Mongodb数据服务

4）调用API插入数据

在这里，我们希望使用Mongodb存放书籍借阅的信息：

   public enum Status
    {
        借出 = 1,
        归还 = 2,
        丢失 = 3,
    }

    [MongodbPersistenceEntity("Test", DisplayName = "书籍借阅信息", Name = "Book")]
    public class Book
    {
        [MongodbPersistenceItem(MongodbIndexOption = MongodbIndexOption.AscendingAndUnique, IsPrimaryKey = true)]
        [MongodbPresentationItem(ShowInTableView = true, DisplayName = "主键")]
        public string ID { get; set; }

        [MongodbPersistenceItem(IsTableName = true)]
        [MongodbPresentationItem(DisplayName = "部门", ShowInTableView = true)]
        public string DeptName { get; set; }

        [MongodbPersistenceItem(MongodbIndexOption = MongodbIndexOption.Descending, IsTimeColumn = true, ColumnName = "T")]
        [MongodbPresentationItem(MongodbSortOption = MongodbSortOption.Descending, DisplayName = "时间", ShowInTableView = true)]
        public DateTime ServerTime { get; set; }

        [MongodbPresentationItem(DisplayName = "书名", ShowInTableView = true)]
        public string Name { get; set; }

        [MongodbPersistenceItem(MongodbIndexOption = MongodbIndexOption.Ascending)]
        [MongodbPresentationItem(DisplayName = "借书者",  ShowInTableView = true, MongodbFilterOption = MongodbFilterOption.TextBoxFilter)]
        public string UserName { get; set; }

        [MongodbPersistenceItem(MongodbIndexOption = MongodbIndexOption.Ascending)]
        [MongodbPresentationItem(DisplayName = "状态变化", ShowInTableView = true, MongodbFilterOption = MongodbFilterOption.DropDownListFilter)]
        public Status Status { get; set; }

        [MongodbPersistenceItem(MongodbIndexOption = MongodbIndexOption.Ascending)]
        [MongodbPresentationItem(DisplayName = "书籍分类", ShowInTableView = true, MongodbFilterOption = MongodbFilterOption.CheckBoxListFilter)]
        public string Category { get; set; }

        [MongodbPresentationItem(DisplayName = "备注")]
        public string Memo { get; set; }
    }

其中包含：

1）主键ID，显示在表格视图中，做唯一索引

2）部门名，显示在表格视图中，作为表名

3）书名，显示在表格视图中

4）时间，显示在表格视图中，倒序排列，倒序索引

5）借书者，显示在表格视图中，可以通过文本框进行搜索，索引

6）状态变化，显示在表格视图中，这是一个枚举，可以通过下拉列表进行搜索，索引

7）书籍分类，显示在表格视图中，可以通过复选框进行搜索，索引

8）备注，不显示在表格视图中

并且，我们把这个实体存放在名为Test的分类中，数据库名也就是为Test__Book__年月（分库）。

 

在定义了数据之后只需调用API插入数据即可：

var book = new Book()
                {
                    DeptName = DeptName.SelectedValue,
                    ID = Guid.NewGuid().ToString(),
                    Memo = Memo.Text,
                    UserName = UserName.Text,
                    ServerTime = DateTime.Now,
                    Name = BookName.Text,
                    Status = (Status)Enum.Parse(typeof(Status), Status.SelectedValue),
                    Category = BookCategory.Text
                };
                MongodbService.MongodbInsertService.Insert(book);

前台：

部门
        <asp:DropDownList ID="DeptName" runat="server">
            <asp:ListItem>Tech</asp:ListItem>
            <asp:ListItem>Sales</asp:ListItem>
            <asp:ListItem>Market</asp:ListItem>
        </asp:DropDownList>
        &nbsp;状态
        <asp:DropDownList ID="Status" runat="server">
            <asp:ListItem>借出</asp:ListItem>
            <asp:ListItem>归还</asp:ListItem>
            <asp:ListItem>丢失</asp:ListItem>
        </asp:DropDownList>
        &nbsp;分类
        <asp:TextBox ID="BookCategory" runat="server">技术书</asp:TextBox>
        &nbsp;书名
        <asp:TextBox ID="BookName" runat="server">《乔布斯传》</asp:TextBox>
        &nbsp;借书者
        <asp:TextBox ID="UserName" runat="server">朱晔</asp:TextBox>
        &nbsp;备注
        <asp:TextBox ID="Memo" runat="server">是一本好书</asp:TextBox>

 

之前我们说过，为了安全考虑，如果要把数据提交到Mongodb数据服务中，必须在配置服务中进行配置，把类型注册进去，打开配置后台：

进入全局配置中的Mongodb服务配置（也就是客户端配置），进入配置项列表，增加一项：

名字填写类型的完整名，比如Adhesive.Test.WebApp.Book，然后修改类型完整名也为Adhesive.Test.WebApp.Book：

这就完成了客户端的配置，同样对于服务端，进入Mongodb服务端配置节点，再进入服务配置列表

增加一项，命名为Adhesive.Test.WebApp.Book，然后修改类型完整名也为Adhesive.Test.WebApp.Book：

这里大部分配置和客户端配置差不多，可以从“是否提交到数据库”这个配置看出这是服务端的配置。并且可以看到，服务端使用8个线程来提交数据，而客户端只有一个线程。

至此，我们就可以打开前台提交数据了：

插入一些数据后到后台查看：

点击进入列表视图：

我们插入了三条记录，由于我们在列上定义过搜索的规则，我们可以打开高级数据筛选：

比如，我们只查看状态变化是借出的记录：

我们再添加几条记录，借书者其它名字：

来尝试搜索一下陈锋借出书籍的记录：

结果正式我们需要的！

 

当然，分组统计和数据量统计功能也同样可用：

 

数据想怎么看就怎么看！

 

不需要考虑数据提交时的异步队列、不需要考虑数据的索引、不需要考虑数据的分表分库、不需要考虑数据呈现后台、不需要考虑实现配置，只需要写自己的业务逻辑代码，一切交给Mongodb数据服务。其实Mongodb数据服务主要用来存对内的非业务逻辑的日志、统计和状态数据，因为通用的数据后台完全可以满足我们的需求。在下一篇文章中，我们会介绍如何针对新的数据进行报警的配置。