ASP.NET 自定义成员资格提供程序 Part.3（实现提供程序类：XmlRoleProvider）
实现角色提供程序比实现成员资格提供程序容易，因为用于管理角色的结构比较简单。没有什么新概念，只需要调用 RoleStore 类的相应方法创建角色、删除角色、将用户分配到角色以及从角色中删除用户即可。
角色提供程序的完整接口如下：
public class XmlRoleProvider : RoleProvider
{
public override void Initialize(string name, NameValueCollection config)
public override string ApplicationName { get; set; }
public override void CreateRole(string roleName)
public override bool DeleteRole(string roleName, bool throwOnPopulatedRole)
public override bool RoleExists(string roleName)
public override void AddUsersToRoles(string[] usernames, string[] roleNames)
public override void RemoveUsersFromRoles(string[] usernames, string[] roleNames)
public override string[] GetAllRoles()
public override string[] GetRolesForUser(string username)
public override string[] GetUsersInRole(string roleName)
public override bool IsUserInRole(string username, string roleName)
public override string[] FindUsersInRole(string roleName, string usernameToMatch)
}
这个类从 RoleProvider 继承而来。再次覆盖初始化自定义属性的 Initialize 方法，不过这次简单很多，因为角色提供程序只支持一小部分属性。基类提供的唯一属性就是 ApplicationName，其他的就由你来决定了。
public override void Initialize(string name, NameValueCollection config)
{
if (config == null)
{
throw new ArgumentException("config");
}
if (string.IsNullOrEmpty(name))
{
name = "XmlRoleProvider";
}
if (string.IsNullOrEmpty(config["description"]))
{
config.Remove("description");
config.Add("description", "XML Role Provider");
}
base.Initialize(name, config);
applicationName = "DefaultApp";
foreach (string key in config.Keys)
{
if (key.ToLower().Equals("applicationname"))
{
applicationName = config[key];
}
else if (key.ToLower().Equals("filename"))
{
fileName = config[key];
}
}
}
再次检查名称和描述配置参数，如果它们没有经过配置，就使用默认值初始化。不要忘记调用基类的 Initialize，否则，由基类托管的默认配置值就不会被初始化。FileName 属性指定了存储角色信息的 XML 文件名称。
接着，这个类提供了一些方法来管理角色，需要访问底层的 RoleStore 方法。例如，创建一个角色：
public override void CreateRole(string roleName)
{
SimpleRole newRole = new SimpleRole();
newRole.RoleName = roleName;
newRole.AssignedUsers = new StringCollection();
CurrentStore.Roles.Add(newRole);
currentStore.Save();
}
RoleExists() 确认传入的角色名称是否在列表中：
public override bool RoleExists(string roleName)
{
try
{
return CurrentStore.GetRole(roleName) != null;
}
catch
{
throw;
}
}
DeleteRole() 则试图删除底层存储的角色：
public override bool DeleteRole(string roleName, bool throwOnPopulatedRole)
{
try
{
SimpleRole role = CurrentStore.GetRole(roleName);
if (role == null)
{
return false;
}
else
{
CurrentStore.Roles.Remove(role);
CurrentStore.Save();
return true;
}
}
catch
{
throw;
}
}
AddUsersToRoles() 将用户添加到一个角色中。这个方法相对复杂一些。首先遍历角色数组，分别获取每一个角色实例，比较该角色的用户列表和传入的用户列表进行用户的添加：
public override void AddUsersToRoles(string[] usernames, string[] roleNames)
{
try
{
foreach (string roleName in roleNames)
{
SimpleRole role = CurrentStore.GetRole(roleName);
if (role != null)
{
foreach (string username in usernames)
{
if (!role.AssignedUsers.Contains(username))
{
role.AssignedUsers.Add(username);
}
}
}
}
CurrentStore.Save();
}
catch
{
throw;
}
}
RemoveUsersFromRoles() 的功能则和上面相反：
public override void RemoveUsersFromRoles(string[] usernames, string[] roleNames)
{
try
{
foreach (string roleName in roleNames)
{
SimpleRole role = CurrentStore.GetRole(roleName);
if (role!=null)
{
foreach (string username in usernames)
{
if (role.AssignedUsers.Contains(username))
{
role.AssignedUsers.Remove(username);
}
}
}
}
CurrentStore.Save();
}
catch
{
throw;
}
}
自定义角色提供程序其余的方法实现起来就非常简单了，大多数情况下，这些方法只是遍历存储中的角色并返回一些信息。大多数情况下是用户名或者角色名的字符串数组。如下所示：
public override string[] GetAllRoles()
{
try
{
return CurrentStore.Roles.Select(p => p.RoleName).ToArray();
}
catch
{
throw;
}
}
public override string[] GetRolesForUser(string username)
{
try
{
return CurrentStore.GetRolesForUser(username).Select(p => p.RoleName).ToArray();
}
catch
{
throw;
}
}
public override string[] GetUsersInRole(string roleName)
{
try
{
return CurrentStore.GetUsersInRole(roleName);
}
catch
{
throw;
}
}
public override bool IsUserInRole(string username, string roleName)
{
try
{
SimpleRole role = CurrentStore.GetRole(roleName);
if (role != null)
{
return role.AssignedUsers.Contains(username);
}
else
{
throw new ProviderException("Role does not exist!");
}
}
catch
{
throw;
}
}
FindUsersInRole() 试着用 roleName 参数通过模式匹配来查找用户。SQL 成员资格提供程序使用 % 符号来进行模式匹配，但是正则表达式不把 % 符号作为占位符，因此要用一个正则表达式可识别的表示来替换它，即 \w* 。
public override string[] FindUsersInRole(string roleName, string usernameToMatch)
{
try
{
SimpleRole role = CurrentStore.GetRole(roleName);
if (role != null)
{
List<string> results = new List<string>();
Regex expression = new Regex(usernameToMatch.Replace("%", @"\w*"));
foreach (string userName in role.AssignedUsers)
{
if (expression.IsMatch(userName))
{
results.Add(userName);
}
}
return results.ToArray();
}
else
{
throw new ProviderException("Role does not exist!");
}
}
catch
{
throw;
}
}
通常，知道如何实现一个提供程序之后，就会知道如何实现另一个提供程序。这个流程没有什么新的概念，只是需要一些代码量和仔细的工作。
