发布NBearLite v1.0.0: 提供强类型查询语法的非ORM数据访问组件 [8/2 更新至v1.0.0.9 beta - 修复NBearLite参考手册某些操作系统打开错误的问题]
2007-07-20 13:32
1361 查看
NBearLite是一个基于NBear的强类型查询内核的.NET 2.0开源(BSD协议)的通用数据访问组件。由NBear.org及Teddy维护。NBearLite继承了和进一步简化扩展了NBear中类似LINQ的强类型数据库查询语法(支持CRUD简单查询及GroupBy、InnerJoin,Paging等常用复杂查询),简化了命名空间、代码架构,并进一步简化了用户使用,对已有代码也没有任何侵入。NBearLite不是一个ORM工具,它不涉及实体类,NBearLite的所有查询返回Scalar/DataSet/IDataReader。
使用演示
无论是在新建的程序还是已有的程序中使用NBearLite,步骤都差不多,非常简单。
1、使用NBearLite提供的NBearLite.QueryColumnsGenerator.exe工具从已有数据库(可以是SqlServer、Oracle、MsAccess、MySql、Sqlite或PostgreSql),为表和视图生成强类型查询辅助类,并将生成的代码文件引用到项目工程。
2、在项目中引用NBearLite.dll(该DLL内置了SqlServer、Oracle和MsAccess的DbProvider,如果需要使用MySql、Sqlite或PostgreSql数据库,则还需要引用NBearLite.AdditionalDbProviders.dll)。
3、在项目的Web.config或App.config中的ConnectionStrings配置块中添加connectionstring。添加的语法可以和ADO.NET配置的标准语法一样,也可以简化设置,将providerName设为空(默认为sqlserver), sqlserver, sqlserver2005, msaccess, oracle, mysql,sqlite或postgresql。
4、接着就可以直接在项目中实例化NBearLite.Database对象,并使用Database对象访问数据库了。
具体的使用代码可以参见NBearLite.Test工程。
例如:
在NBearLite.Test工程中,SampleQueryColumnsDefinition.cs文件中保存了由NBearLite.QueryColumnsGenerator.exe工具生成的Northwind数据库的所有表和视图的强类型查询辅助类。
在DatabaseTest.cs文件中,包含了一些查询演示:
1
[TestMethod]
2
public void TestInsert()
3
{
4
Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").Execute());
5
Assert.IsTrue(db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").ExecuteReturnAutoIncrementID(Northwind.Categories.CategoryID) > 1);
6
}
7
8
[TestMethod]
9
public void TestUpdate()
10
{
11
Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").Execute());
12
Assert.IsTrue(db.Update(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").Where(Northwind.Categories.CategoryName == "test1").Execute() > 0);
13
}
14
15
[TestMethod]
16
public void TestDelete()
17
{
18
Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test111").Execute());
19
Assert.IsTrue(db.Delete(Northwind.Categories).Where(Northwind.Categories.CategoryName == "test111").Execute() > 0);
20
}
21
22
[TestMethod]
23
public void TestSelect()
24
{
25
DataSet ds = db.Select(Northwind.Categories).ToDataSet();
26
Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
27
ds = db.Select(Northwind.Categories, Northwind.Categories.CategoryName).Where(Northwind.Categories.CategoryID > 0).ToDataSet();
28
Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
29
ds = db.Select(Northwind.Categories, Northwind.Categories.CategoryName).GroupBy(Northwind.Categories.CategoryName).OrderBy(Northwind.Categories.CategoryName.Desc).SetSelectRange(2, 2, Northwind.Categories.CategoryName).ToDataSet();
30
ds = db.Select(Northwind.Categories, Northwind.Categories.__Alias("CategoriesAlias").CategoryName).Join(Northwind.Categories, "CategoriesAlias", Northwind.Categories.CategoryID == Northwind.Categories.__Alias("CategoriesAlias").CategoryID).
31
SetSelectRange(2, 2, Northwind.Categories.CategoryID).Where(Northwind.Categories.CategoryName.Length > 0 && Northwind.Categories.__Alias("CategoriesAlias").Description != null).
32
ToDataSet();
33
}
前三个Test都比较容易理解。TestSelect()中,分别演示了简单查询,分页GroupBy查询和一个自关联Join分页查询。
除了以上演示的代码之外,还可以使用Database.CustomSql()/Database.StoredProcedure()方法查询自定义sql或存储过程。
另外,NBearLite.QueryColumnsGenerator.exe工具本身也是一个使用NBearLite查询数据库的实际的实例程序。
下载
NBearLite_v1.0.0.9 Beta 及中文版NBearLite完全参考手册
修订
7/21 更新至v1.0.0.2 beta - 新增PostgreSql DbProvider,Insert/Update/Select/Delete方法的参数有部分修改,请注意参考以上已更新的的实例代码。
7/22 更新至v1.0.0.3 beta - 修复PostgreSql DbProvider中的Bug。
7/24 更新至v1.0.0.4 beta - 全面支持SqlServer,Oracle,MySql,PostgreSql数据库存储过程调用代码生成(C#/VB.NET)使用示例
7/27 更新至v1.0.0.5 beta - 支持Sub Query查询
Sub Query示例:
1
//SELECT * FROM [Products] WHERE ([Products].[CategoryID] IN ((SELECT TOP 10 [Categories].[CategoryID] FROM [Categories] ORDER BY [Categories].[CategoryID])))
2
DataSet ds = db.Select(Northwind.Products)
3
.Where(Northwind.Products.CategoryID.In
4
(
5
db.Select(Northwind.Categories, Northwind.Categories.CategoryID).SetSelectRange(10, 0, Northwind.Categories.CategoryID).ToSubQuery())
6
)
7
.ToDataSet();
8
9
//SELECT * FROM [Products] WHERE ([Products].[CategoryID] = (SELECT TOP 1 [Categories].[CategoryID] FROM [Categories] ORDER BY [Categories].[CategoryID]))
10
ds = db.Select(Northwind.Products)
11
.Where(Northwind.Products.CategoryID ==
12
(
13
db.Select(Northwind.Categories, Northwind.Categories.CategoryID).SetSelectRange(1, 0, Northwind.Categories.CategoryID).ToSubQuery())
14
)
15
.ToDataSet();
16
Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
7/28 更新至v1.0.0.6 beta - 支持Save DataTable/DataRow
Save DataTable/DataRow示例:
1
SelectSqlSection selectSection = db.Select(Northwind.Categories)
2
.Where(Northwind.Categories.CategoryID == catID)
3
.OrderBy(Northwind.Categories.CategoryID.Desc)
4
.SetSelectRange(1, 0, Northwind.Categories.CategoryID);
5
DataTable dt = selectSection.ToDataSet().Tables[0];
6
7
dt.Rows[0]["CategoryName"] = "modified";
8
9
//save a modified row
10
db.Save(selectSection.ToDbCommand(), 10, dt);
11
12
dt.Rows[0]["CategoryName"] = "modified2";
13
14
DataRow newRow = dt.NewRow();
15
newRow["CategoryName"] = "new";
16
dt.Rows.Add(newRow);
17
18
//save 1 modified row and insert a new row
19
db.Save(selectSection.ToDbCommand(), tran, 0, dt.Rows[0], dt.Rows[1]);7/29 更新至v1.0.0.7 beta - 发布中文版NBearLite完全参考手册
7/30 更新至v1.0.0.8 beta - 为Stored Procedure包装方法增加带Transaction重载
8/2 更新至v1.0.0.9 beta - 修复NBearLite参考手册某些操作系统打开错误的问题
使用演示
无论是在新建的程序还是已有的程序中使用NBearLite,步骤都差不多,非常简单。
1、使用NBearLite提供的NBearLite.QueryColumnsGenerator.exe工具从已有数据库(可以是SqlServer、Oracle、MsAccess、MySql、Sqlite或PostgreSql),为表和视图生成强类型查询辅助类,并将生成的代码文件引用到项目工程。
2、在项目中引用NBearLite.dll(该DLL内置了SqlServer、Oracle和MsAccess的DbProvider,如果需要使用MySql、Sqlite或PostgreSql数据库,则还需要引用NBearLite.AdditionalDbProviders.dll)。
3、在项目的Web.config或App.config中的ConnectionStrings配置块中添加connectionstring。添加的语法可以和ADO.NET配置的标准语法一样,也可以简化设置,将providerName设为空(默认为sqlserver), sqlserver, sqlserver2005, msaccess, oracle, mysql,sqlite或postgresql。
4、接着就可以直接在项目中实例化NBearLite.Database对象,并使用Database对象访问数据库了。
具体的使用代码可以参见NBearLite.Test工程。
例如:
在NBearLite.Test工程中,SampleQueryColumnsDefinition.cs文件中保存了由NBearLite.QueryColumnsGenerator.exe工具生成的Northwind数据库的所有表和视图的强类型查询辅助类。
在DatabaseTest.cs文件中,包含了一些查询演示:
1
[TestMethod]
2
public void TestInsert()
3
{
4
Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").Execute());
5
Assert.IsTrue(db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").ExecuteReturnAutoIncrementID(Northwind.Categories.CategoryID) > 1);
6
}
7
8
[TestMethod]
9
public void TestUpdate()
10
{
11
Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").Execute());
12
Assert.IsTrue(db.Update(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test1").Where(Northwind.Categories.CategoryName == "test1").Execute() > 0);
13
}
14
15
[TestMethod]
16
public void TestDelete()
17
{
18
Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, "test111").Execute());
19
Assert.IsTrue(db.Delete(Northwind.Categories).Where(Northwind.Categories.CategoryName == "test111").Execute() > 0);
20
}
21
22
[TestMethod]
23
public void TestSelect()
24
{
25
DataSet ds = db.Select(Northwind.Categories).ToDataSet();
26
Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
27
ds = db.Select(Northwind.Categories, Northwind.Categories.CategoryName).Where(Northwind.Categories.CategoryID > 0).ToDataSet();
28
Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
29
ds = db.Select(Northwind.Categories, Northwind.Categories.CategoryName).GroupBy(Northwind.Categories.CategoryName).OrderBy(Northwind.Categories.CategoryName.Desc).SetSelectRange(2, 2, Northwind.Categories.CategoryName).ToDataSet();
30
ds = db.Select(Northwind.Categories, Northwind.Categories.__Alias("CategoriesAlias").CategoryName).Join(Northwind.Categories, "CategoriesAlias", Northwind.Categories.CategoryID == Northwind.Categories.__Alias("CategoriesAlias").CategoryID).
31
SetSelectRange(2, 2, Northwind.Categories.CategoryID).Where(Northwind.Categories.CategoryName.Length > 0 && Northwind.Categories.__Alias("CategoriesAlias").Description != null).
32
ToDataSet();
33
}
前三个Test都比较容易理解。TestSelect()中,分别演示了简单查询,分页GroupBy查询和一个自关联Join分页查询。
除了以上演示的代码之外,还可以使用Database.CustomSql()/Database.StoredProcedure()方法查询自定义sql或存储过程。
另外,NBearLite.QueryColumnsGenerator.exe工具本身也是一个使用NBearLite查询数据库的实际的实例程序。
下载
NBearLite_v1.0.0.9 Beta 及中文版NBearLite完全参考手册
修订
7/21 更新至v1.0.0.2 beta - 新增PostgreSql DbProvider,Insert/Update/Select/Delete方法的参数有部分修改,请注意参考以上已更新的的实例代码。
7/22 更新至v1.0.0.3 beta - 修复PostgreSql DbProvider中的Bug。
7/24 更新至v1.0.0.4 beta - 全面支持SqlServer,Oracle,MySql,PostgreSql数据库存储过程调用代码生成(C#/VB.NET)使用示例
7/27 更新至v1.0.0.5 beta - 支持Sub Query查询
Sub Query示例:
1
//SELECT * FROM [Products] WHERE ([Products].[CategoryID] IN ((SELECT TOP 10 [Categories].[CategoryID] FROM [Categories] ORDER BY [Categories].[CategoryID])))
2
DataSet ds = db.Select(Northwind.Products)
3
.Where(Northwind.Products.CategoryID.In
4
(
5
db.Select(Northwind.Categories, Northwind.Categories.CategoryID).SetSelectRange(10, 0, Northwind.Categories.CategoryID).ToSubQuery())
6
)
7
.ToDataSet();
8
9
//SELECT * FROM [Products] WHERE ([Products].[CategoryID] = (SELECT TOP 1 [Categories].[CategoryID] FROM [Categories] ORDER BY [Categories].[CategoryID]))
10
ds = db.Select(Northwind.Products)
11
.Where(Northwind.Products.CategoryID ==
12
(
13
db.Select(Northwind.Categories, Northwind.Categories.CategoryID).SetSelectRange(1, 0, Northwind.Categories.CategoryID).ToSubQuery())
14
)
15
.ToDataSet();
16
Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
7/28 更新至v1.0.0.6 beta - 支持Save DataTable/DataRow
Save DataTable/DataRow示例:
1
SelectSqlSection selectSection = db.Select(Northwind.Categories)
2
.Where(Northwind.Categories.CategoryID == catID)
3
.OrderBy(Northwind.Categories.CategoryID.Desc)
4
.SetSelectRange(1, 0, Northwind.Categories.CategoryID);
5
DataTable dt = selectSection.ToDataSet().Tables[0];
6
7
dt.Rows[0]["CategoryName"] = "modified";
8
9
//save a modified row
10
db.Save(selectSection.ToDbCommand(), 10, dt);
11
12
dt.Rows[0]["CategoryName"] = "modified2";
13
14
DataRow newRow = dt.NewRow();
15
newRow["CategoryName"] = "new";
16
dt.Rows.Add(newRow);
17
18
//save 1 modified row and insert a new row
19
db.Save(selectSection.ToDbCommand(), tran, 0, dt.Rows[0], dt.Rows[1]);7/29 更新至v1.0.0.7 beta - 发布中文版NBearLite完全参考手册
7/30 更新至v1.0.0.8 beta - 为Stored Procedure包装方法增加带Transaction重载
8/2 更新至v1.0.0.9 beta - 修复NBearLite参考手册某些操作系统打开错误的问题
相关文章推荐
- 发布NBearLite v1.0.0: 提供强类型查询语法的非ORM数据访问组件 [8/2 更新至v1.0.0.9 beta - 修复NBearLite参考手册某些操作系统打开错误的问题]
- 发布NBearLite v1.0.0: 提供强类型查询语法的非ORM数据访问组件 [8/2 更新至v1.0.0.9 beta - 修复NBearLite参考手册某些操作系统打开错误的问题]
- 发布NBearLite中文版完全参考手册 + NBearLite 10分钟入门教程 + NBearLite v1.0.0.7 beta
- 发布NBearLite中文版完全参考手册 + NBearLite 10分钟入门教程 + NBearLite v1.0.0.7 beta
- 发布NBearLite中文版完全参考手册 + NBearLite 10分钟入门教程 + NBearLite v1.0.0.7 beta
- 巧用SQL的with语法生成临时结果集,进行查询与更新同步操作,解决高并发下对数据的重复访问
- 操作必须使用一个可更新的查询;HTTP 500 - 内部服务器错误; 您未被授权查看该页;您不具备使用所提供的凭据查看该目录或页的权限;HTTP 错误 401.3 - 访问被资源 ACL 拒绝
- 操作必须使用一个可更新的查询;HTTP 500 - 内部服务器错误; 您未被授权查看该页;您不具备使用所提供的凭据查看该目录或页的权限;HTTP 错误 401.3 - 访问被资源 ACL 拒绝
- 附加数据库报错:无法打开物理文件 XXX.mdf",操作系统错误 5:"5(拒绝访问。)"
- C#语句对Access中数据更新问题――Update语法错误
- Spring Framework 开发参考手册 之十一 使用ORM工具进行数据访问
- asp(非asp.net)程序访问access数据库,无法写入、修改,提示错误:当前记录集不支持更新。这可能是提供程序的限制,也可能是选定锁定类型的限制。
- SqlServer,无法为该请求检索数据, 尝试打开或创建物理文件,CREATE FILE 遇到操作系统错误(拒绝访问)。
- 操作必须使用一个可更新的查询;HTTP 500 - 内部服务器错误; 您未被授权查看该页;您不具备使用所提供的凭据查看该目录或页的权限;HTTP 错误 401.3 - 访问被资源 ACL 拒绝
- 更新数据库所有表的某一个指定字段 ,附加对‘将 varchar 值转换为数据类型为 int 的列时发生语法错误’处理方法
- SQL 语法参考手册(SQL)/数据类型
- 大家来参考。无法打开物理文件mdf,操作系统错误 5:"5(拒绝访问。)"
- 无法打开物理文件 操作系统错误 5:拒绝访问 SQL Sever
- oracle查询date类型的数据的时候的小问题
- 执行SQL语句时出现问题操作必须使用一个可更新的查询错误的解决方法