/// <summary>Archives a BlockOrder 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="blockOrderId">The value for the BlockOrderId 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 blockOrderId)
{
// Accessor for the BlockOrder Table.
ServerDataModel.BlockOrderDataTable blockOrderTable = ServerDataModel.BlockOrder;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.BlockOrderRow blockOrderRow = blockOrderTable.FindByBlockOrderId(blockOrderId);
if ((blockOrderRow == null))
{
throw new Exception(string.Format("The BlockOrder table does not have an element identified by {0}", blockOrderId));
}
// Rule #2: Optimistic Concurrency Check
if ((blockOrderRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Archive the child records.
for (int index = 0; (index < blockOrderRow.GetAllocationRows().Length); index = (index + 1))
{
ServerDataModel.AllocationRow childAllocationRow = blockOrderRow.GetAllocationRows()[index];
Allocation.Archive(adoTransaction, sqlTransaction, childAllocationRow.RowVersion, childAllocationRow.AllocationId);
}
for (int index = 0; (index < blockOrderRow.GetBlockOrderTreeRowsByFKBlockOrderBlockOrderTreeChildId().Length); index = (index + 1))
{
ServerDataModel.BlockOrderTreeRow childBlockOrderTreeRow = blockOrderRow.GetBlockOrderTreeRowsByFKBlockOrderBlockOrderTreeChildId()[index];
BlockOrderTree.Archive(adoTransaction, sqlTransaction, childBlockOrderTreeRow.RowVersion, childBlockOrderTreeRow.ParentId, childBlockOrderTreeRow.ChildId);
}
for (int index = 0; (index < blockOrderRow.GetBlockOrderTreeRowsByFKBlockOrderBlockOrderTreeParentId().Length); index = (index + 1))
{
ServerDataModel.BlockOrderTreeRow childBlockOrderTreeRow = blockOrderRow.GetBlockOrderTreeRowsByFKBlockOrderBlockOrderTreeParentId()[index];
BlockOrderTree.Archive(adoTransaction, sqlTransaction, childBlockOrderTreeRow.RowVersion, childBlockOrderTreeRow.ParentId, childBlockOrderTreeRow.ChildId);
}
for (int index = 0; (index < blockOrderRow.GetExecutionRows().Length); index = (index + 1))
{
ServerDataModel.ExecutionRow childExecutionRow = blockOrderRow.GetExecutionRows()[index];
Execution.Archive(adoTransaction, sqlTransaction, childExecutionRow.RowVersion, childExecutionRow.ExecutionId);
}
for (int index = 0; (index < blockOrderRow.GetOrderRows().Length); index = (index + 1))
{
ServerDataModel.OrderRow childOrderRow = blockOrderRow.GetOrderRows()[index];
Order.Archive(adoTransaction, sqlTransaction, childOrderRow.RowVersion, childOrderRow.OrderId);
}
for (int index = 0; (index < blockOrderRow.GetPlacementRows().Length); index = (index + 1))
{
ServerDataModel.PlacementRow childPlacementRow = blockOrderRow.GetPlacementRows()[index];
Placement.Archive(adoTransaction, sqlTransaction, childPlacementRow.RowVersion, childPlacementRow.PlacementId);
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Delete the record in the ADO database.
blockOrderRow[blockOrderTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(blockOrderRow);
blockOrderRow.Delete();
// Archive the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"BlockOrder\" set \"IsArchived\" = 1 where \"BlockOrderId\"=@blockOrderId");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@blockOrderId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, blockOrderId));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Collects the table lock request(s) for an Update operation</summary>
/// <param name="adoTransaction">A list of locks required for this operation.</param>
public static void Archive(AdoTransaction adoTransaction)
{
// These table lock(s) are required for the 'Archive' operation.
adoTransaction.LockRequests.Add(new TableWriterRequest(ServerDataModel.BlockOrder));
Allocation.Archive(adoTransaction);
BlockOrderTree.Archive(adoTransaction);
Execution.Archive(adoTransaction);
Placement.Archive(adoTransaction);
}
/// <summary>Inserts a BlockOrderTree record using Metadata Parameters.</summary>
/// <param name="parameters">Contains the metadata parameters.</param>
public static void Archive(ParameterList parameters)
{
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
long rowVersion = parameters["rowVersion"];
int parentId = parameters["parentId"];
int childId = parameters["childId"];
// Call the internal method to complete the operation.
BlockOrderTree.Archive(adoTransaction, sqlTransaction, rowVersion, parentId, childId);
}
/// <summary>Inserts a BlockOrderTree record using Metadata Parameters.</summary>
/// <param name="parameters">Contains the metadata parameters.</param>
public static void Insert(ParameterList parameters)
{
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
int parentId = parameters["parentId"];
int childId = parameters["childId"];
// The rowVersion is passed back to the caller in the event it's needed for additional commands in the batch.
long rowVersion = long.MinValue;
// Call the internal method to complete the operation.
BlockOrderTree.Insert(adoTransaction, sqlTransaction, ref rowVersion, parentId, childId);
// Return values.
parameters["rowVersion"] = rowVersion;
}
