Skip to content

lidanger/LiteDB.wiki_Translation_zh-cn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 

Repository files navigation

LiteDB - 一个单数据文件 .NET NoSQL 文档存储

Join the chat at https://gitter.im/mbdavid/LiteDB Build status Build Status

LiteDB 一个小巧、快速、轻量级的 NoSQL 嵌入式数据库。

  • Serverless NoSQL 文档存储
  • 类似于 MongoDB 的简单 API
  • 100% C# 代码,支持 .NET 3.5 / .NET 4.0 / NETStandard 1.3 / NETStandard 2.0,单 DLL (小于 300 kb)
  • 支持线程和进程安全
  • 支持文档/操作级别的 ACID
  • 支持写失败后的数据还原 (日志模式)
  • 可使用 DES (AES) 加密算法进行数据文件加密
  • 可使用特性或 fluent 映射 API 将你的 POCO 类映射为 BsonDocument
  • 可存储文件与流数据 (类似 MongoDB 的 GridFS)
  • 单数据文件存储 (类似 SQLite)
  • 支持基于文档字段索引的快速搜索 (每个集合支持多达 16 个索引)
  • 支持 LINQ 查询
  • Shell 命令行 - 试试这个在线版本
  • 相当快 - 这里是与 SQLite 的对比结果
  • 开源,对所有人免费 - 包括商业应用
  • 可以从 NuGet 安装:Install-Package LiteDB

4.0 新特性

  • 新的 表达式/路径 索引/查询支持。参考表达式
  • 支持 Include 嵌套
  • 优化的查询执行过程 (包含简单的调试说明)
  • 修复并发问题
  • 移除事务和索引自动创建
  • 支持全扫描搜索和 LINQ 搜索
  • 新的 shell 命令:基于表达式选择/转换文档以及更新字段
  • 浏览全部更新日志

在线试用

试试 LiteDB Web Shell。 由于安全原因,在线版本中,并非所有命令都可用。请使用离线版本进行全特性测试。

文档

访问 Wiki 即可获取全部文档。简单中文版本,请看这里

下载

可以在 LiteDB Releases 下载源代码或二进制文件。

LiteDB 使用入门

一个存储、搜索文档的简单示例:

// 创建你的 POCO 类
public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string[] Phones { get; set; }
    public bool IsActive { get; set; }
}

// 打开数据库 (如果不存在则创建)
using(var db = new LiteDatabase(@"MyData.db"))
{
    // 获得 customer 集合
    var col = db.GetCollection<Customer>("customers");

    // 创建你的新 customer 实例
	  var customer = new Customer
    { 
        Name = "John Doe", 
        Phones = new string[] { "8000-0000", "9000-0000" }, 
        Age = 39,
        IsActive = true
    };
    
    // 在 Name 字段上创建唯一索引
    col.EnsureIndex(x => x.Name, true);
	
    // 插入新的 customer 文档 (Id 是自增的)
    col.Insert(customer);
	
    // 更新集合中的一个文档
    customer.Name = "Joana Doe";
	
    col.Update(customer);
	
    // 使用 LINQ 查询文档 (未使用索引)
    var results = col.Find(x => x.Age > 20);
}

使用 fluent 映射器和跨文档引用处理更复杂的数据模型

// DbRef 交叉引用
public class Order
{
    public ObjectId Id { get; set; }
    public DateTime OrderDate { get; set; }
    public Address ShippingAddress { get; set; }
    public Customer Customer { get; set; }
    public List<Product> Products { get; set; }
}        

// 重用全局实例的映射器
var mapper = BsonMapper.Global;

// "Produts" 和 "Customer" 来自其他集合 (而不是嵌入的文档)
mapper.Entity<Order>()
    .DbRef(x => x.Customer, "customers")   // 1 对 1/0 引用
    .DbRef(x => x.Products, "products")    // 1 对多引用
    .Field(x => x.ShippingAddress, "addr"); // 嵌入的子文档
            
using(var db = new LiteDatabase("MyOrderDatafile.db"))
{
    var orders = db.GetCollection<Order>("orders");
        
    // 当查询 Order 时,包含引用
    var query = orders
        .Include(x => x.Customer)
        .Include(x => x.Products) // 1 对多引用
        .Find(x => x.OrderDate <= DateTime.Now);

    // 每个 Order 实例都会加载 Customer/Products 引用
    foreach(var order in query)
    {
        var name = order.Customer.Name;
        ...
    }
}

应用场景

  • 桌面/本地化的小应用程序
  • 应用程序文件格式(Application file format)
  • 小型 web 应用程序
  • 一个账户/用户一个数据库的数据存储
  • 少量并发写操作

第三方工具

更新日志

每个发布版本的变化详情都记录在发行说明中。

许可证

MIT

Copyright (c) 2017 - Maurício David

致谢

特别感谢 @negue 和 @szurgot 对可移植版本提供的帮助,以及 @lidanger 的简体中文翻译。

About

偶发兴趣,对LiteDB 文档的中文翻译,详见wiki页面。。。。。/

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published