/// <summary>
/// Locates the reaction infos for performing the specified action with the specified type.
/// </summary>
/// <param name="action">The action that is to be performed by the reaction.</param>
/// <param name="typeName">The short type name of the entity that is involved in the action.</param>
/// <returns>The reaction info for the specified scenario.</returns>
public ReactionInfoCollection Locate(string action, string typeName)
{
// Create the reaction info variable to hold the return value
ReactionInfoCollection reactionInfos = new ReactionInfoCollection();
// Logging commented out to boost performance
//using (LogGroup logGroup = LogGroup.StartDebug("Locating the reaction that is appropriate for carrying out the action '" + action + "' involving the type '" + typeName + "'."))
//{
if (action == null)
throw new ArgumentNullException("action");
if (typeName == null)
throw new ArgumentNullException("typeName");
if (action == String.Empty)
throw new ArgumentException("An action must be provided other than String.Empty.", "action");
if (typeName == String.Empty)
throw new ArgumentException("A type name must be provided other than String.Empty.", "typeName");
// Get the specified type
Type type = null;
if (EntityState.IsType(typeName))
type = EntityState.GetType(typeName);
// Create a direct reaction key for the specified type
string key = Reactions.GetReactionsKey(action, typeName);
// LogWriter.Debug("Direct key: " + key);
// LogWriter.Debug("Type name: " + typeName);
// Check the direct key to see if a reaction exists
if (Reactions.ReactionExists(key))
{
LogWriter.Debug("Found reaction with key: " + key);
reactionInfos.AddRange(Reactions[key]);
}
// Navigate up the heirarchy looking for a matching reaction
// This is done even if reactions have already been found
if (type != null) // If no type was found then skip the hierarchy check as it's just a name without a corresponding type
{
// LogWriter.Debug("Not found with direct key. Looking through the hierarchy.");
reactionInfos.AddRange(LocateFromHeirarchy(action, type));
}
//}
return reactionInfos;
}
public void Test_Locate()
{
string action = "Save";
string typeName = "TestArticle";
ReactionLocator locator = new ReactionLocator(ReactionState.Reactions);
ReactionInfoCollection reactions = locator.Locate(action, typeName);
foreach (ReactionInfo reaction in reactions)
{
Type expectedType = EntityState.GetType(typeName);
Type actualType = EntityState.GetType(reaction.TypeName);
bool doMatch = expectedType.Equals(actualType) ||
expectedType.IsAssignableFrom(actualType) ||
actualType.IsAssignableFrom(expectedType);
Assert.IsTrue(doMatch, "The type '" + reaction.TypeName + "' on '" + reaction.GetType().FullName + "' reaction does not match expected type '" + typeName + "'.");
}
Assert.AreEqual(2, reactions.Count, "Invalid number of reactions found.");
}
/// <summary>
/// Locates the reaction infos for performing the specified action with the specified type by looking at the interfaces of the provided type.
/// </summary>
/// <param name="action">The action that is to be performed by the reaction.</param>
/// <param name="type">The type that is involved in the action.</param>
/// <returns>The reaction info for the specified scenario.</returns>
public ReactionInfo[] LocateFromInterfaces(string action, Type type)
{
ReactionInfoCollection reactionInfos = new ReactionInfoCollection();
// Logging commented out to boost performance
//using (LogGroup logGroup = LogGroup.StartDebug("Locating a reaction by checking the interfaces of the provided type."))
//{
Type[] interfaceTypes = type.GetInterfaces();
// Loop backwards through the interface types
for (int i = interfaceTypes.Length-1; i >= 0; i --)
{
Type interfaceType = interfaceTypes[i];
//using (LogGroup logGroup2 = LogGroup.StartDebug("Checking interface: " + interfaceType.FullName))
//{
string key = Reactions.GetReactionsKey(action, interfaceType.Name);
//LogWriter.Debug("Key: " + key);
if (Reactions.ReactionExists(key))
{
reactionInfos.AddRange(Reactions[key]);
//LogWriter.Debug("Reactions found: " + reactionInfos.Count.ToString());
}
//else
//LogWriter.Debug("No reaction found for that key.");
//}
}
//}
return reactionInfos.ToArray();
}
/// <summary>
/// Locates the reaction infos for performing the specified action with the specified type by looking at the base types and interfaces of the provided type.
/// </summary>
/// <param name="action">The action that is to be performed by the reaction.</param>
/// <param name="type">The type that is involved in the action.</param>
/// <returns>The reaction info for the specified scenario.</returns>
public ReactionInfo[] LocateFromHeirarchy(string action, Type type)
{
ReactionInfoCollection reactionInfos = new ReactionInfoCollection();
// Logging commented out to boost performance
//using (LogGroup logGroup = LogGroup.StartDebug("Locating a reaction by navigating the hierarchy of the provided type."))
//{
reactionInfos.AddRange(LocateFromInterfaces(action, type));
reactionInfos.AddRange(LocateFromBaseTypes(action, type));
//}
return reactionInfos.ToArray();
}
/// <summary>
/// Locates the reaction info for performing the specified action with the specified type by looking at the base types of the provided type.
/// </summary>
/// <param name="action">The action that is to be performed by the reaction.</param>
/// <param name="type">The type that is involved in the action.</param>
/// <returns>The reaction info for the specified scenario.</returns>
public ReactionInfo[] LocateFromBaseTypes(string action, Type type)
{
ReactionInfoCollection reactionInfos = new ReactionInfoCollection();
// Logging commented out to boost performance
//using (LogGroup logGroup = LogGroup.StartDebug("Locating reaction via the base types of the '" + (type != null ? type.FullName : "[null]") + "' type."))
//{
if (action == null)
throw new ArgumentNullException("action");
if (action == String.Empty)
throw new ArgumentException("An action must be specified.");
if (type == null)
throw new ArgumentNullException("type");
TypeNavigator navigator = new TypeNavigator(type);
while (navigator.HasNext)
{
Type nextType = navigator.Next();
if (nextType != null)
{
//using (LogGroup logGroup2 = LogGroup.StartDebug("Checking base type: " + nextType.FullName))
//{
string key = Reactions.GetReactionsKey(action, nextType.Name);
//LogWriter.Debug("Key: " + key);
// If a reaction exists for the base type then use it
if (Reactions.ReactionExists(key))
{
if (Reactions.ContainsKey(key))
reactionInfos.AddRange(Reactions[key]);
//LogWriter.Debug("Reactions found: " + reactionInfos.Count.ToString());
}
//}
}
}
//}
return reactionInfos.ToArray();
}
