/// <summary>Updates a Algorithm record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public static void Update(ParameterList parameters)
{
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalAlgorithmId = ((string)(parameters["algorithmId"]));
object externalAlgorithmTypeCode = parameters["algorithmTypeCode"].Value;
object name = parameters["name"].Value;
object description = parameters["description"].Value;
object assembly = parameters["assembly"].Value;
object type = parameters["type"].Value;
object method = parameters["method"].Value;
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Resolve External Identifiers
int algorithmId = Algorithm.FindRequiredKey(configurationId, "algorithmId", externalAlgorithmId);
object algorithmTypeCode = AlgorithmType.FindOptionalKey(configurationId, "algorithmTypeCode", externalAlgorithmTypeCode);
// While the optimistic concurrency checking is disabled for the external methods, the internal methods
// still need to perform the check. This ncurrency checking logic by finding the current row version to be
// will bypass the coused when the internal method is called.
ServerDataModel.AlgorithmRow algorithmRow = algorithmTable.FindByAlgorithmId(algorithmId);
rowVersion = ((long)(algorithmRow[algorithmTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Algorithm.Update(adoTransaction, sqlTransaction, ref rowVersion, algorithmId, algorithmTypeCode, name, description, assembly, type, method, null, null);
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Inserts a Algorithm record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="algorithmTypeCode">The value for the AlgorithmTypeCode column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="description">The value for the Description column.</param>
/// <param name="assembly">The value for the Assembly column.</param>
/// <param name="type">The value for the Type column.</param>
/// <param name="method">The value for the Method column.</param>
/// <param name="externalId0">The value for the ExternalId0 column.</param>
/// <param name="externalId1">The value for the ExternalId1 column.</param>
public static int Insert(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, int algorithmTypeCode, string name, object description, string assembly, string type, string method, object externalId0, object externalId1)
{
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Apply Defaults
if ((description == null))
{
description = System.DBNull.Value;
}
if ((externalId0 == null))
{
externalId0 = System.DBNull.Value;
}
if ((externalId1 == null))
{
externalId1 = System.DBNull.Value;
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Insert the record into the ADO database.
ServerDataModel.AlgorithmRow algorithmRow = algorithmTable.NewAlgorithmRow();
algorithmRow[algorithmTable.RowVersionColumn] = rowVersion;
algorithmRow[algorithmTable.AlgorithmTypeCodeColumn] = algorithmTypeCode;
algorithmRow[algorithmTable.NameColumn] = name;
algorithmRow[algorithmTable.DescriptionColumn] = description;
algorithmRow[algorithmTable.AssemblyColumn] = assembly;
algorithmRow[algorithmTable.TypeColumn] = type;
algorithmRow[algorithmTable.MethodColumn] = method;
algorithmRow[algorithmTable.ExternalId0Column] = externalId0;
algorithmRow[algorithmTable.ExternalId1Column] = externalId1;
algorithmTable.AddAlgorithmRow(algorithmRow);
adoTransaction.DataRows.Add(algorithmRow);
// Insert the record into the SQL database.
SqlCommand sqlCommand = new SqlCommand(@"insert ""Algorithm"" (""rowVersion"",""AlgorithmId"",""AlgorithmTypeCode"",""Name"",""Description"",""Assembly"",""Type"",""Method"",""ExternalId0"",""ExternalId1"") values (@rowVersion,@algorithmId,@algorithmTypeCode,@name,@description,@assembly,@type,@method,@externalId0,@externalId1)");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@rowVersion", SqlDbType.BigInt, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, rowVersion));
sqlCommand.Parameters.Add(new SqlParameter("@algorithmId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, algorithmRow[algorithmTable.AlgorithmIdColumn]));
sqlCommand.Parameters.Add(new SqlParameter("@algorithmTypeCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, algorithmTypeCode));
sqlCommand.Parameters.Add(new SqlParameter("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name));
sqlCommand.Parameters.Add(new SqlParameter("@description", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, description));
sqlCommand.Parameters.Add(new SqlParameter("@assembly", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, assembly));
sqlCommand.Parameters.Add(new SqlParameter("@type", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, type));
sqlCommand.Parameters.Add(new SqlParameter("@method", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, method));
sqlCommand.Parameters.Add(new SqlParameter("@externalId0", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId0));
sqlCommand.Parameters.Add(new SqlParameter("@externalId1", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId1));
sqlCommand.ExecuteNonQuery();
// Return Statements
return(algorithmRow.AlgorithmId);
}
/// <summary>Initializes the static elements of an Object.</summary>
static Algorithm()
{
// The table must be locked before the indices can be read into an accelerator array.
ServerDataModel.AlgorithmLock.AcquireReaderLock(System.Threading.Timeout.Infinite);
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// This does an indirect lookup operation using the views created for the ExternalId columns. Take the index of the user
// identifier column calcualted above and use it to find a record containing the external identifier.
Algorithm.externalKeyArray = new DataView[] {
algorithmTable.UKAlgorithmExternalId0,
algorithmTable.UKAlgorithmExternalId1};
// The table must be released after the array is constructed.
ServerDataModel.AlgorithmLock.ReleaseReaderLock();
}
/// <summary>Loads a Algorithm record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public static void Load(ParameterList parameters)
{
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
object externalAlgorithmId = parameters["algorithmId"].Value;
string externalAlgorithmTypeCode = parameters["algorithmTypeCode"];
string name = parameters["name"];
object description = parameters["description"].Value;
string assembly = parameters["assembly"];
string type = parameters["type"];
string method = parameters["method"];
object externalId0 = parameters["externalId0"].Value;
object externalId1 = parameters["externalId1"].Value;
// The row versioning is largely disabled for external operations. The value is returned to the caller in the
// event it's needed for operations within the batch.
long rowVersion = long.MinValue;
// Resolve External Identifiers
int algorithmId = Algorithm.FindKey(configurationId, "algorithmId", externalAlgorithmId);
int algorithmTypeCode = AlgorithmType.FindRequiredKey(configurationId, "algorithmTypeCode", externalAlgorithmTypeCode);
// The load operation will create a record if it doesn't exist, or update an existing record. The external
// identifier is used to determine if a record exists with the same key.
if ((algorithmId == int.MinValue))
{
// Populate the 'externalId' varaibles so that the external identifier can be used to find the row when an
// external method is called with the same 'configurationId' parameter.
int externalKeyIndex = Algorithm.GetExternalKeyIndex(configurationId, "algorithmId");
object[] externalIdArray = new object[2];
externalIdArray[externalKeyIndex] = externalAlgorithmId;
externalId0 = externalIdArray[0];
externalId1 = externalIdArray[1];
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Algorithm.Insert(adoTransaction, sqlTransaction, ref rowVersion, algorithmTypeCode, name, description, assembly, type, method, externalId0, externalId1);
}
else
{
// While the optimistic concurrency checking is disabled for the external methods, the internal methods
// still need to perform the check. This ncurrency checking logic by finding the current row version to be
// will bypass the coused when the internal method is called.
ServerDataModel.AlgorithmRow algorithmRow = algorithmTable.FindByAlgorithmId(algorithmId);
rowVersion = ((long)(algorithmRow[algorithmTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Algorithm.Update(adoTransaction, sqlTransaction, ref rowVersion, algorithmId, algorithmTypeCode, name, description, assembly, type, method, externalId0, externalId1);
}
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Archives a Algorithm record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="RowVersion">The version number of this row.</param>
/// <param name="algorithmId">The value for the AlgorithmId column.</param>
/// <param name="archive">true to archive the object, false to unarchive it.</param>
public static void Archive(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, long rowVersion, int algorithmId)
{
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.AlgorithmRow algorithmRow = algorithmTable.FindByAlgorithmId(algorithmId);
if ((algorithmRow == null))
{
throw new Exception(string.Format("The Algorithm table does not have an element identified by {0}", algorithmId));
}
// Rule #2: Optimistic Concurrency Check
if ((algorithmRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Archive the child records.
for (int index = 0; (index < algorithmRow.GetBlotterRows().Length); index = (index + 1))
{
ServerDataModel.BlotterRow childBlotterRow = algorithmRow.GetBlotterRows()[index];
Blotter.ArchiveChildren(adoTransaction, sqlTransaction, childBlotterRow.RowVersion, childBlotterRow.BlotterId);
}
for (int index = 0; (index < algorithmRow.GetModelRows().Length); index = (index + 1))
{
ServerDataModel.ModelRow childModelRow = algorithmRow.GetModelRows()[index];
Model.ArchiveChildren(adoTransaction, sqlTransaction, childModelRow.RowVersion, childModelRow.ModelId);
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Delete the record in the ADO database.
algorithmRow[algorithmTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(algorithmRow);
algorithmRow.Delete();
// Archive the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"Algorithm\" set \"IsArchived\" = 1 where \"AlgorithmId\"=@algorithmId");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@algorithmId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, algorithmId));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Finds a a Algorithm record using a configuration and an external identifier.</summary>
/// <param name="configurationId">Specified which mappings (user id columns) to use when looking up external identifiers.</param>
/// <param name="parameterId">The name of the parameter as specified in the configuration table.</param>
/// <param name="externalId">The external (user supplied) identifier for the record.</param>
public static int FindKey(object configurationId, string parameterId, object externalId)
{
// A missing key will never match a column.
if ((externalId == null))
{
return int.MinValue;
}
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Look for the record using the external identifier. The configuration selected the key to use, which effectively
// selected the external id column to use for the search. If a record is found in the view, a translation still needs
// to be made back to the original table before an index to the record can be returned to the caller.
int externalKeyIndex = Algorithm.GetExternalKeyIndex(configurationId, parameterId);
System.Data.DataView externalKeyView = Algorithm.externalKeyArray[externalKeyIndex];
int recordIndex = externalKeyView.Find(new object[] {
externalId});
if ((recordIndex == -1))
{
return int.MinValue;
}
return ((int)(externalKeyView[recordIndex].Row[algorithmTable.AlgorithmIdColumn]));
}
/// <summary>Archives a Algorithm record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public static void Archive(ParameterList parameters)
{
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalAlgorithmId = parameters["algorithmId"];
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Find the internal identifier using the primar key elements.
// identifier is used to determine if a record exists with the same key.
int algorithmId = Algorithm.FindRequiredKey(configurationId, "algorithmId", externalAlgorithmId);
// While the optimistic concurrency checking is disabled for the external methods, the internal methods
// still need to perform the check. This ncurrency checking logic by finding the current row version to be
// will bypass the coused when the internal method is called.
ServerDataModel.AlgorithmRow algorithmRow = algorithmTable.FindByAlgorithmId(algorithmId);
rowVersion = ((long)(algorithmRow[algorithmTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Algorithm.Archive(adoTransaction, sqlTransaction, rowVersion, algorithmId);
}
/// <summary>Updates a Algorithm record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="rowVersion">The version number of the row</param>
/// <param name="algorithmId">The value for the AlgorithmId column.</param>
/// <param name="algorithmTypeCode">The value for the AlgorithmTypeCode column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="description">The value for the Description column.</param>
/// <param name="assembly">The value for the Assembly column.</param>
/// <param name="type">The value for the Type column.</param>
/// <param name="method">The value for the Method column.</param>
/// <param name="externalId0">The value for the ExternalId0 column.</param>
/// <param name="externalId1">The value for the ExternalId1 column.</param>
public static void Update(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, int algorithmId, object algorithmTypeCode, object name, object description, object assembly, object type, object method, object externalId0, object externalId1)
{
// Accessor for the Algorithm Table.
ServerDataModel.AlgorithmDataTable algorithmTable = ServerDataModel.Algorithm;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.AlgorithmRow algorithmRow = algorithmTable.FindByAlgorithmId(algorithmId);
if ((algorithmRow == null))
{
throw new Exception(string.Format("The Algorithm table does not have an element identified by {0}", algorithmId));
}
// Rule #2: Optimistic Concurrency Check
if ((algorithmRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Apply Defaults
if ((algorithmTypeCode == null))
{
algorithmTypeCode = algorithmRow[algorithmTable.AlgorithmTypeCodeColumn];
}
if ((name == null))
{
name = algorithmRow[algorithmTable.NameColumn];
}
if ((description == null))
{
description = algorithmRow[algorithmTable.DescriptionColumn];
}
if ((assembly == null))
{
assembly = algorithmRow[algorithmTable.AssemblyColumn];
}
if ((type == null))
{
type = algorithmRow[algorithmTable.TypeColumn];
}
if ((method == null))
{
method = algorithmRow[algorithmTable.MethodColumn];
}
if ((externalId0 == null))
{
externalId0 = algorithmRow[algorithmTable.ExternalId0Column];
}
if ((externalId1 == null))
{
externalId1 = algorithmRow[algorithmTable.ExternalId1Column];
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Update the record in the ADO database.
algorithmRow[algorithmTable.RowVersionColumn] = rowVersion;
algorithmRow[algorithmTable.AlgorithmTypeCodeColumn] = algorithmTypeCode;
algorithmRow[algorithmTable.NameColumn] = name;
algorithmRow[algorithmTable.DescriptionColumn] = description;
algorithmRow[algorithmTable.AssemblyColumn] = assembly;
algorithmRow[algorithmTable.TypeColumn] = type;
algorithmRow[algorithmTable.MethodColumn] = method;
algorithmRow[algorithmTable.ExternalId0Column] = externalId0;
algorithmRow[algorithmTable.ExternalId1Column] = externalId1;
adoTransaction.DataRows.Add(algorithmRow);
// Update the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand(@"update ""Algorithm"" set ""RowVersion""=@rowVersion,""AlgorithmTypeCode""=@algorithmTypeCode,""Name""=@name,""Description""=@description,""Assembly""=@assembly,""Type""=@type,""Method""=@method,""ExternalId0""=@externalId0,""ExternalId1""=@externalId1 where ""AlgorithmId""=@algorithmId");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@rowVersion", SqlDbType.BigInt, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, rowVersion));
sqlCommand.Parameters.Add(new SqlParameter("@algorithmId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, algorithmId));
sqlCommand.Parameters.Add(new SqlParameter("@algorithmTypeCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, algorithmTypeCode));
sqlCommand.Parameters.Add(new SqlParameter("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name));
sqlCommand.Parameters.Add(new SqlParameter("@description", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, description));
sqlCommand.Parameters.Add(new SqlParameter("@assembly", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, assembly));
sqlCommand.Parameters.Add(new SqlParameter("@type", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, type));
sqlCommand.Parameters.Add(new SqlParameter("@method", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, method));
sqlCommand.Parameters.Add(new SqlParameter("@externalId0", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId0));
sqlCommand.Parameters.Add(new SqlParameter("@externalId1", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId1));
// Update the record in the SQL database.
sqlCommand.ExecuteNonQuery();
}
