AppBox升级进行时

AppBox 是基于 FineUI 的通用权限管理框架，包括用户管理、职称管理、部门管理、角色管理、角色权限管理等模块。

 

关联表的查询操作

使用 Include 方法，我们可以在一次数据库查询中将关联表的数据一并取出。

比如查询在线用户列表页面，需要在前端显示关联的用户信息，如下所示：

<x:Grid ID="Grid1" runat="server" BoxFlex="1" ShowBorder="true" ShowHeader="false"
	EnableCheckBoxSelect="false" EnableRowNumber="true" DataKeyNames="ID" AllowSorting="true"
	OnSort="Grid1_Sort" SortColumnIndex="0" SortDirection="DESC" AllowPaging="true"
	IsDatabasePaging="true" OnPageIndexChange="Grid1_PageIndexChange">
	<Columns>
		<x:BoundField DataField="UpdateTime" SortField="UpdateTime" DataFormatString="{0:yyyy-MM-dd HH:mm}"
			Width="120px" HeaderText="最后操作时间" />
		<x:BoundField DataField="LoginTime" SortField="LoginTime" Width="120px" DataFormatString="{0:yyyy-MM-dd HH:mm}"
			HeaderText="登录时间" />
		<x:BoundField DataField="User.Name" SortField="User.Name" Width="100px" HeaderText="用户名" />
		<x:BoundField DataField="User.ChineseName" SortField="User.ChineseName" Width="100px" HeaderText="中文名" />
		<x:BoundField DataField="IPAdddress" ExpandUnusedSpace="true" HeaderText="IP地址" />
		<x:WindowField Text="查看" Title="查看" WindowID="Window1" DataIFrameUrlFields="User.ID"
			DataIFrameUrlFormatString="~/admin/user_view.aspx?id={0}" Width="50px" />
	</Columns>
</x:Grid>

其中“用户名”和“中文名”以及“查看”按钮，都用到了导航属性User（Navigation Property），所以我们在查询时也使用Include来避免延迟加载：

IQueryable<Online> q = DB.Onlines.Include(o => o.User);

// 在用户名中搜索
string searchText = ttbSearchMessage.Text.Trim();
if (!String.IsNullOrEmpty(searchText))
{
	q = q.Where(o => o.User.Name.Contains(searchText));
}

DateTime lastD = DateTime.Now.AddHours(-2);
q = q.Where(o => o.UpdateTime > lastD);

// 在添加条件之后，排序和分页之前获取总记录数
Grid1.RecordCount = q.Count();

// 排列和数据库分页
q = SortAndPage<Online>(q, Grid1);

Grid1.DataSource = q;
Grid1.DataBind();

　　

为了更形象的说明 Include 的作用，我们使用工具ExpressProfile来监视对数据库的操作：http://expressprofiler.codeplex.com/　　

首先看下页面显示效果：

 

使用 Include 情况下，看下对数据库的操作：

可以看到有两次数据库查询（获取总记录数查询和分页数据查询），相应的查询语句分别为：

获取总记录数的SQL查询语句：

exec sp_executesql N'SELECT 
[GroupBy1].[A1] AS [C1]
FROM ( SELECT 
	COUNT(1) AS [A1]
	FROM [dbo].[Onlines] AS [Extent1]
	WHERE [Extent1].[UpdateTime] > @p__linq__0
)  AS [GroupBy1]',N'@p__linq__0 datetime2(7)',@p__linq__0='2013-08-23 15:35:08.2573160'
go

分页数据查询的SQL语句：

exec sp_executesql N'SELECT TOP (20) 
[Project1].[ID] AS [ID], 
[Project1].[IPAdddress] AS [IPAdddress], 
[Project1].[LoginTime] AS [LoginTime], 
[Project1].[UpdateTime] AS [UpdateTime], 
[Project1].[ID1] AS [ID1], 
[Project1].[Name] AS [Name], 
[Project1].[Email] AS [Email], 
[Project1].[Password] AS [Password], 
[Project1].[Enabled] AS [Enabled], 
[Project1].[Gender] AS [Gender], 
[Project1].[ChineseName] AS [ChineseName], 
[Project1].[EnglishName] AS [EnglishName], 
[Project1].[Photo] AS [Photo], 
[Project1].[QQ] AS [QQ], 
[Project1].[CompanyEmail] AS [CompanyEmail], 
[Project1].[OfficePhone] AS [OfficePhone], 
[Project1].[OfficePhoneExt] AS [OfficePhoneExt], 
[Project1].[HomePhone] AS [HomePhone], 
[Project1].[CellPhone] AS [CellPhone], 
[Project1].[Address] AS [Address], 
[Project1].[Remark] AS [Remark], 
[Project1].[IdentityCard] AS [IdentityCard], 
[Project1].[Birthday] AS [Birthday], 
[Project1].[TakeOfficeTime] AS [TakeOfficeTime], 
[Project1].[LastLoginTime] AS [LastLoginTime], 
[Project1].[CreateTime] AS [CreateTime], 
[Project1].[DeptID] AS [DeptID]
FROM ( SELECT [Project1].[ID] AS [ID], [Project1].[IPAdddress] AS [IPAdddress], [Project1].[LoginTime] AS [LoginTime], [Project1].[UpdateTime] AS [UpdateTime], [Project1].[ID1] AS [ID1], [Project1].[Name] AS [Name], [Project1].[Email] AS [Email], [Project1].[Password] AS [Password], [Project1].[Enabled] AS [Enabled], [Project1].[Gender] AS [Gender], [Project1].[ChineseName] AS [ChineseName], [Project1].[EnglishName] AS [EnglishName], [Project1].[Photo] AS [Photo], [Project1].[QQ] AS [QQ], [Project1].[CompanyEmail] AS [CompanyEmail], [Project1].[OfficePhone] AS [OfficePhone], [Project1].[OfficePhoneExt] AS [OfficePhoneExt], [Project1].[HomePhone] AS [HomePhone], [Project1].[CellPhone] AS [CellPhone], [Project1].[Address] AS [Address], [Project1].[Remark] AS [Remark], [Project1].[IdentityCard] AS [IdentityCard], [Project1].[Birthday] AS [Birthday], [Project1].[TakeOfficeTime] AS [TakeOfficeTime], [Project1].[LastLoginTime] AS [LastLoginTime], [Project1].[CreateTime] AS [CreateTime], [Project1].[DeptID] AS [DeptID], row_number() OVER (ORDER BY [Project1].[UpdateTime] DESC) AS [row_number]
	FROM ( SELECT 
		[Extent1].[ID] AS [ID], 
		[Extent1].[IPAdddress] AS [IPAdddress], 
		[Extent1].[LoginTime] AS [LoginTime], 
		[Extent1].[UpdateTime] AS [UpdateTime], 
		[Extent2].[ID] AS [ID1], 
		[Extent2].[Name] AS [Name], 
		[Extent2].[Email] AS [Email], 
		[Extent2].[Password] AS [Password], 
		[Extent2].[Enabled] AS [Enabled], 
		[Extent2].[Gender] AS [Gender], 
		[Extent2].[ChineseName] AS [ChineseName], 
		[Extent2].[EnglishName] AS [EnglishName], 
		[Extent2].[Photo] AS [Photo], 
		[Extent2].[QQ] AS [QQ], 
		[Extent2].[CompanyEmail] AS [CompanyEmail], 
		[Extent2].[OfficePhone] AS [OfficePhone], 
		[Extent2].[OfficePhoneExt] AS [OfficePhoneExt], 
		[Extent2].[HomePhone] AS [HomePhone], 
		[Extent2].[CellPhone] AS [CellPhone], 
		[Extent2].[Address] AS [Address], 
		[Extent2].[Remark] AS [Remark], 
		[Extent2].[IdentityCard] AS [IdentityCard], 
		[Extent2].[Birthday] AS [Birthday], 
		[Extent2].[TakeOfficeTime] AS [TakeOfficeTime], 
		[Extent2].[LastLoginTime] AS [LastLoginTime], 
		[Extent2].[CreateTime] AS [CreateTime], 
		[Extent2].[DeptID] AS [DeptID]
		FROM  [dbo].[Onlines] AS [Extent1]
		INNER JOIN [dbo].[Users] AS [Extent2] ON [Extent1].[UserID] = [Extent2].[ID]
		WHERE [Extent1].[UpdateTime] > @p__linq__0
	)  AS [Project1]
)  AS [Project1]
WHERE [Project1].[row_number] > 0
ORDER BY [Project1].[UpdateTime] DESC',N'@p__linq__0 datetime2(7)',@p__linq__0='2013-08-23 15:35:08.2573160'
go

Entity Framework生成的SQL语句包含了子查询和关联查询，还是蛮复杂的。

我们把这两条SQL语句分别在VS2012的服务器资源管理器中执行一下，就能看到和页面上相同的结果了：　　

　　

作为对比，来看下不使用 Include 的数据库SQL查询语句：

 

此时，除了获取总记录数的SQL查询和获取分页数据的SQL查询，还多了 3 条获取用户信息的SQL查询，其中一个获取用户信息的SQL语句为：

exec sp_executesql N'SELECT 
[Extent2].[ID] AS [ID], 
[Extent2].[Name] AS [Name], 
[Extent2].[Email] AS [Email], 
[Extent2].[Password] AS [Password], 
[Extent2].[Enabled] AS [Enabled], 
[Extent2].[Gender] AS [Gender], 
[Extent2].[ChineseName] AS [ChineseName], 
[Extent2].[EnglishName] AS [EnglishName], 
[Extent2].[Photo] AS [Photo], 
[Extent2].[QQ] AS [QQ], 
[Extent2].[CompanyEmail] AS [CompanyEmail], 
[Extent2].[OfficePhone] AS [OfficePhone], 
[Extent2].[OfficePhoneExt] AS [OfficePhoneExt], 
[Extent2].[HomePhone] AS [HomePhone], 
[Extent2].[CellPhone] AS [CellPhone], 
[Extent2].[Address] AS [Address], 
[Extent2].[Remark] AS [Remark], 
[Extent2].[IdentityCard] AS [IdentityCard], 
[Extent2].[Birthday] AS [Birthday], 
[Extent2].[TakeOfficeTime] AS [TakeOfficeTime], 
[Extent2].[LastLoginTime] AS [LastLoginTime], 
[Extent2].[CreateTime] AS [CreateTime], 
[Extent2].[DeptID] AS [DeptID]
FROM  [dbo].[Onlines] AS [Extent1]
INNER JOIN [dbo].[Users] AS [Extent2] ON [Extent1].[UserID] = [Extent2].[ID]
WHERE [Extent1].[ID] = @EntityKeyValue1',N'@EntityKeyValue1 int',@EntityKeyValue1=2
go

其在VS2012中的执行结果为：

　　

关联表的新增操作

在前面的文章中，我们已经看到如何新增一个用户，并为用户添加角色列表，如下所示：

User item = new User();
item.Name = tbxName.Text.Trim();
item.Password = PasswordUtil.CreateDbPassword(tbxPassword.Text.Trim());
item.ChineseName = tbxRealName.Text.Trim();
item.Gender = ddlGender.SelectedValue;
item.CompanyEmail = tbxCompanyEmail.Text.Trim();
item.Email = tbxEmail.Text.Trim();
item.OfficePhone = tbxOfficePhone.Text.Trim();
item.OfficePhoneExt = tbxOfficePhoneExt.Text.Trim();
item.HomePhone = tbxHomePhone.Text.Trim();
item.CellPhone = tbxCellPhone.Text.Trim();
item.Remark = tbxRemark.Text.Trim();
item.Enabled = cbxEnabled.Checked;
item.CreateTime = DateTime.Now;
 
// 添加所有角色
if (!String.IsNullOrEmpty(hfSelectedRole.Text))
{
    int[] roleIDs = StringUtil.GetIntArrayFromString(hfSelectedRole.Text);
     
    item.Roles = new List<Role>();
    foreach (int roleID in roleIDs)
    {
        Role role = new Role { ID = roleID };
        DB.Roles.Attach(role);
        item.Roles.Add(role);
    }
}
 
DB.Users.Add(item);
DB.SaveChanges();

　　

关联表的删除操作

从角色中删除多个用户的操作，用Subsonic来实现的代码：

List<int> roleIds = GetSelectedDataKeyIDs(Grid1);
List<int> userIds = GetSelectedDataKeyIDs(Grid2);

new Delete().From<XRoleUser>()
	.Where(XRoleUser.RoleIdColumn).IsEqualTo(roleIds[0])
	.And(XRoleUser.UserIdColumn).In(userIds)
	.Execute();

使用Entity Framework时，由于需要先将需要的数据载入，所以代码稍微有点复杂：

Role role = DB.Roles.Include(r => r.Users)
	.Where(r => r.ID == roleID)
	.FirstOrDefault();

foreach (int userID in userIDs)
{
	User user = role.Users.Where(u => u.ID == userID).FirstOrDefault();
	if (user != null)
	{
		role.Users.Remove(user);
	}
}

DB.SaveChanges();

上面代码也可以简化为：

Role role = DB.Roles.Include(r => r.Users)
	.Where(r => r.ID == roleID)
	.FirstOrDefault();

role.Users.Where(u => userIDs.Contains(u.ID)).ToList().ForEach(u => role.Users.Remove(u));

DB.SaveChanges();

　　

下面再来看看如果移除属于某个部门的多个用户，由于部门和用户是一对多的关系，所以我们可以先找到这些用户，再清空这些用户所属的部门，如下所示：

DB.Users.Include(u => u.Dept)
	.Where(u => userIDs.Contains(u.ID))
	.ToList()
	.ForEach(u => u.Dept = null);

DB.SaveChanges();

另一种做法，先找到这个部门，然后从部门的用户列表Users（导航属性）中删除这些用户，如下所示：

Dept dept = DB.Depts.Include(d => d.Users)
	.Where(d => d.ID == deptID)
	.FirstOrDefault();

foreach (int userID in userIDs)
{
	User user = dept.Users.Where(u => u.ID == userID).FirstOrDefault();
	if (user != null)
	{
		dept.Users.Remove(user);
	}
}

DB.SaveChanges();

上面两种做法的结果是完全一致的。　　

关联表的更新操作

以更新单个用户信息为例，一个用户可以属于一个部门（Dept） ，可以拥有多个角色（Role），使用Subsonic更新用户信息的代码如下所示：

using (TransactionScope scope = new TransactionScope())
{
    int userId = GetQueryIntValue("id");
    XUser item = XUser.FetchByID(userId);
    //item.Name = tbxName.Text.Trim();
    item.ChineseName = tbxRealName.Text.Trim();
    item.Gender = ddlGender.SelectedValue;
    item.CompanyEmail = tbxEmail.Text.Trim();
    item.PersonalEmail = tbxPersonalEmail.Text.Trim();
    item.CellPhone = tbxCellPhone.Text.Trim();
    item.OfficePhone = tbxOfficePhone.Text.Trim();
    item.OfficePhoneExt = tbxOfficePhoneExt.Text.Trim();
    item.HomePhone = tbxHomePhone.Text.Trim();
    item.Remark = tbxRemark.Text.Trim();
    item.Enabled = cbxEnabled.Checked;
    //item.RoleId = Convert.ToInt32(ddlRole.SelectedValue);
    //item.DeptId = Convert.ToInt32(ddlDept.SelectedValue);
    item.Save();
 
 
    // 删除用户所属的所有角色
    new Delete().From(XRoleUser.Schema)
        .Where(XRoleUser.UserIdColumn).IsEqualTo(userId)
        .Execute();
 
    // 添加所有角色
    if (!String.IsNullOrEmpty(hfSelectedRole.Text))
    {
        XRoleUserCollection roleUsers = new XRoleUserCollection();
        foreach (string roleIdStr in hfSelectedRole.Text.Split(','))
        {
            int id = Convert.ToInt32(roleIdStr);
 
            XRoleUser roleUser = new XRoleUser();
            roleUser.RoleId = id;
            roleUser.UserId = userId;
 
            roleUsers.Add(roleUser);
        }
        roleUsers.SaveAll();
    }
 
 
    // 删除用户所属的所有部门
    new Delete().From(XDeptUser.Schema)
        .Where(XDeptUser.UserIdColumn).IsEqualTo(userId)
        .Execute();
 
    // 添加所有部门
    if (!String.IsNullOrEmpty(hfSelectedDept.Text))
    {
        XDeptUser deptUser = new XDeptUser();
        deptUser.DeptId = Convert.ToInt32(hfSelectedDept.Text);
        deptUser.UserId = userId;
        deptUser.Save();
    }
 
    scope.Complete();
}

这里的数据库查询比较多，分别为：

1. 查询单个数据的信息；

2. 删除用户所属的所有角色；

3. 添加用户的新角色；

4. 删除用户所属的部门；

5. 添加用户所属的新部门；（这个地方是数据库设计也不大合理，其实不需单独表来保存部门用户信息）　　

完成相同的功能，来看下Entity Framework的实现：

int id = GetQueryIntValue("id");
User item = DB.Users
    .Include(u => u.Dept)
    .Include(u => u.Roles)
    .Where(u => u.UserID == id).FirstOrDefault();
//item.Name = tbxName.Text.Trim();
item.ChineseName = tbxRealName.Text.Trim();
item.Gender = ddlGender.SelectedValue;
item.CompanyEmail = tbxCompanyEmail.Text.Trim();
item.Email = tbxEmail.Text.Trim();
item.CellPhone = tbxCellPhone.Text.Trim();
item.OfficePhone = tbxOfficePhone.Text.Trim();
item.OfficePhoneExt = tbxOfficePhoneExt.Text.Trim();
item.HomePhone = tbxHomePhone.Text.Trim();
item.Remark = tbxRemark.Text.Trim();
item.Enabled = cbxEnabled.Checked;
 
if (String.IsNullOrEmpty(hfSelectedDept.Text))
{
    item.Dept = null;
}
else
{
    int newDeptID = Convert.ToInt32(hfSelectedDept.Text);
    if (item.Dept.DeptID != newDeptID)
    {
        Dept newDept = new Dept { DeptID = newDeptID };
        DB.Depts.Attach(newDept);
        item.Dept = newDept;
    }
}
 
if (String.IsNullOrEmpty(hfSelectedRole.Text))
{
    item.Roles = null;
}
else
{
    int[] roleIDs = StringUtil.GetIntArrayFromString(hfSelectedRole.Text);
 
    int[] addRoleIDs = roleIDs.Except(item.Roles.Select(r => r.RoleID)).ToArray();
    int[] removeRoleIDs = item.Roles.Select(r => r.RoleID).Except(roleIDs).ToArray();
 
    foreach (int roleID in addRoleIDs)
    {
        var role = new Role { RoleID = roleID };
        DB.Roles.Attach(role);
        item.Roles.Add(role);
    }
    foreach (int roleID in removeRoleIDs)
    {
        item.Roles.Remove(item.Roles.Single(r => r.RoleID == roleID));
    }
 
}
 
DB.SaveChanges();

　　

这里，我们又再次用到了 Attach 方法，实际上这样使用 Attach 是有风险的，下一节我们会重点讲解 Attach 的使用。 

下载或捐赠AppBox

1. AppBox v2.0 是免费软件，免费提供下载：http://fineui.com/bbs/forum.php?mod=viewthread&tid=3788 

2. AppBox v3.0 是捐赠软件，你可以通过捐赠作者来获取AppBox v3.0的全部源代码（http://fineui.com/donate/）。