#region License
/*
* Copyright 2002-2005 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#endregion
#if NET_2_0
#region Imports
using System.Collections.Specialized;
#endregion
namespace Spring.Web.Providers{
/// <summary>
/// An Interface for <see cref="RoleProviderAdapter"/> class.
/// </summary>
/// <remarks>
/// <p>
/// Configuration for this provider <b>requires</b> <c>providerId</c> element set in web.config file,
/// as the Id of wrapped provider (defined in the Spring context).
/// </p>
/// </remarks>
/// <author>Damjan Tomic</author>
public interface IRoleProvider
{
///<summary>
///Initializes the provider.
///</summary>
///
///<param name="config">A collection of the name/value pairs representing the provider-specific
/// attributes specified in the configuration for this provider.
/// The <c>providerId</c> attribute is mandatory.
/// </param>
///<param name="name">The friendly name of the provider.</param>
///<exception cref="T:System.ArgumentNullException">The <paramref name="name"/> or <paramref name="config"/> is null.</exception>
///<exception cref="T:System.InvalidOperationException">An attempt is made to call <see cref="M:System.Configuration.Provider.ProviderBase.Initialize(System.String,System.Collections.Specialized.NameValueCollection)"></see> on a provider after the provider has already been initialized.</exception>
///<exception cref="T:System.ArgumentException">The <paramref name="name"/> has a length of zero or providerId attribute is not set.</exception>
void Initialize(string name, NameValueCollection config);
///<summary>
///Gets the friendly name used to refer to the provider during configuration.
///</summary>
///
///<returns>
///The friendly name used to refer to the provider during configuration.
///</returns>
string Name { get; }
///<summary>
///Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).
///</summary>
///
///<returns>
///A brief, friendly description suitable for display in administrative tools or other UIs.
///</returns>
string Description { get; }
///<summary>
///Gets a value indicating whether the specified user is in the specified role for the configured applicationName.
///</summary>
///
///<returns>
///true if the specified user is in the specified role for the configured applicationName; otherwise, false.
///</returns>
///
///<param name="username">The user name to search for.</param>
///<param name="roleName">The role to search in.</param>
bool IsUserInRole(string username, string roleName);
///<summary>
///Gets a list of the roles that a specified user is in for the configured applicationName.
///</summary>
///
///<returns>
///A string array containing the names of all the roles that the specified user is in for the configured applicationName.
///</returns>
///
///<param name="username">The user to return a list of roles for.</param>
string[] GetRolesForUser(string username);
///<summary>
///Adds a new role to the data source for the configured applicationName.
///</summary>
///
///<param name="roleName">The name of the role to create.</param>
void CreateRole(string roleName);
///<summary>
///Removes a role from the data source for the configured applicationName.
///</summary>
///
///<returns>
///true if the role was successfully deleted; otherwise, false.
///</returns>
///
///<param name="throwOnPopulatedRole">If true, throw an exception if roleName has one or more members and do not delete roleName.</param>
///<param name="roleName">The name of the role to delete.</param>
bool DeleteRole(string roleName, bool throwOnPopulatedRole);
///<summary>
///Gets a value indicating whether the specified role name already exists in the role data source for the configured applicationName.
///</summary>
///
///<returns>
///true if the role name already exists in the data source for the configured applicationName; otherwise, false.
///</returns>
///
///<param name="roleName">The name of the role to search for in the data source. </param>
bool RoleExists(string roleName);
///<summary>
///Adds the specified user names to the specified roles for the configured applicationName.
///</summary>
///
///<param name="roleNames">A string array of the role names to add the specified user names to. </param>
///<param name="usernames">A string array of user names to be added to the specified roles. </param>
void AddUsersToRoles(string[] usernames, string[] roleNames);
///<summary>
///Removes the specified user names from the specified roles for the configured applicationName.
///</summary>
///
///<param name="roleNames">A string array of role names to remove the specified user names from. </param>
///<param name="usernames">A string array of user names to be removed from the specified roles. </param>
void RemoveUsersFromRoles(string[] usernames, string[] roleNames);
///<summary>
///Gets a list of users in the specified role for the configured applicationName.
///</summary>
///
///<returns>
///A string array containing the names of all the users who are members of the specified role for the configured applicationName.
///</returns>
///
///<param name="roleName">The name of the role to get the list of users for. </param>
string[] GetUsersInRole(string roleName);
///<summary>
///Gets a list of all the roles for the configured applicationName.
///</summary>
///
///<returns>
///A string array containing the names of all the roles stored in the data source for the configured applicationName.
///</returns>
///
string[] GetAllRoles();
///<summary>
///Gets an array of user names in a role where the user name contains the specified user name to match.
///</summary>
///
///<returns>
///A string array containing the names of all the users where the user name matches usernameToMatch and the user is a member of the specified role.
///</returns>
///
///<param name="usernameToMatch">The user name to search for.</param>
///<param name="roleName">The role to search in.</param>
string[] FindUsersInRole(string roleName, string usernameToMatch);
///<summary>
///Gets or sets the name of the application to store and retrieve role information for.
///</summary>
///
///<returns>
///The name of the application to store and retrieve role information for.
///</returns>
///
string ApplicationName { get; set; }
}
}
#endif
|