/// <summary>Loads a Property 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 Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // Extract the parameters from the command batch. AdoTransaction adoTransaction = parameters["adoTransaction"]; SqlTransaction sqlTransaction = parameters["sqlTransaction"]; object configurationId = parameters["configurationId"].Value; object externalId0 = parameters["externalId0"].Value; object externalId1 = parameters["externalId1"].Value; object externalId2 = parameters["externalId2"].Value; object externalId3 = parameters["externalId3"].Value; object name = parameters["name"].Value; int propertyCode = parameters["propertyCode"]; // The row versioning is largely disabled for external operations. long rowVersion = long.MinValue; // Find the record using the unique identifier. If it doesn't exist, it will be inserted, if it does exist, // it will be updated. ServerMarketData.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode); if ((propertyRow == null)) { // Call the internal 'Insert' method to complete the operation. MarkThree.Guardian.Core.Property.Insert(adoTransaction, sqlTransaction, ref rowVersion, externalId0, externalId1, externalId2, externalId3, name, propertyCode); } else { // This will bypass the optimistic concurrency checking required by the internal method. rowVersion = ((long)(propertyRow[propertyTable.RowVersionColumn])); // Call the internal 'Update' method to complete the operation. MarkThree.Guardian.Core.Property.Update(adoTransaction, sqlTransaction, ref rowVersion, externalId0, externalId1, externalId2, externalId3, name, propertyCode); } // Return values parameters["rowVersion"] = rowVersion; }
/// <summary>Archives a Property 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="propertyCode">The value for the PropertyCode 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 propertyCode) { // Accessor for the Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // Rule #1: Make sure the record exists before updating it. ServerMarketData.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode); if ((propertyRow == null)) { throw new Exception(string.Format("The Property table does not have an element identified by {0}", propertyCode)); } // Rule #2: Optimistic Concurrency Check if ((propertyRow.RowVersion != rowVersion)) { throw new System.Exception("This record is busy. Please try again later."); } // Archive the child records. // Increment the row version rowVersion = ServerMarketData.RowVersion.Increment(); // Delete the record in the ADO database. propertyRow[propertyTable.RowVersionColumn] = rowVersion; adoTransaction.DataRows.Add(propertyRow); propertyRow.Delete(); // Archive the record in the SQL database. SqlCommand sqlCommand = new SqlCommand("update \"Property\" set \"IsArchived\" = 1 where \"PropertyCode\"=@propertyCode"); sqlCommand.Connection = sqlTransaction.Connection; sqlCommand.Transaction = sqlTransaction; sqlCommand.Parameters.Add(new SqlParameter("@propertyCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, propertyCode)); sqlCommand.ExecuteNonQuery(); }
/// <summary>Inserts a Property record.</summary> /// <param name="transaction">Commits or rejects a set of commands as a unit</param> /// <param name="externalId0">The value for the ExternalId0 column.</param> /// <param name="externalId1">The value for the ExternalId1 column.</param> /// <param name="externalId2">The value for the ExternalId2 column.</param> /// <param name="externalId3">The value for the ExternalId3 column.</param> /// <param name="name">The value for the Name column.</param> /// <param name="propertyCode">The value for the PropertyCode column.</param> public static void Insert(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, object externalId0, object externalId1, object externalId2, object externalId3, object name, int propertyCode) { // Accessor for the Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // Apply Defaults if ((externalId0 == null)) { externalId0 = System.DBNull.Value; } if ((externalId1 == null)) { externalId1 = System.DBNull.Value; } if ((externalId2 == null)) { externalId2 = System.DBNull.Value; } if ((externalId3 == null)) { externalId3 = System.DBNull.Value; } if ((name == null)) { name = System.DBNull.Value; } // Increment the row version rowVersion = ServerMarketData.RowVersion.Increment(); // Insert the record into the ADO database. ServerMarketData.PropertyRow propertyRow = propertyTable.NewPropertyRow(); propertyRow[propertyTable.RowVersionColumn] = rowVersion; propertyRow[propertyTable.ExternalId0Column] = externalId0; propertyRow[propertyTable.ExternalId1Column] = externalId1; propertyRow[propertyTable.ExternalId2Column] = externalId2; propertyRow[propertyTable.ExternalId3Column] = externalId3; propertyRow[propertyTable.NameColumn] = name; propertyRow[propertyTable.PropertyCodeColumn] = propertyCode; propertyTable.AddPropertyRow(propertyRow); adoTransaction.DataRows.Add(propertyRow); // Insert the record into the SQL database. SqlCommand sqlCommand = new SqlCommand("insert \"Property\" (\"rowVersion\",\"ExternalId0\",\"ExternalId1\",\"ExternalId2\",\"Extern" + "alId3\",\"Name\",\"PropertyCode\") values (@rowVersion,@externalId0,@externalId1,@ext" + "ernalId2,@externalId3,@name,@propertyCode)"); 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("@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.Parameters.Add(new SqlParameter("@externalId2", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId2)); sqlCommand.Parameters.Add(new SqlParameter("@externalId3", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId3)); sqlCommand.Parameters.Add(new SqlParameter("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name)); sqlCommand.Parameters.Add(new SqlParameter("@propertyCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, propertyCode)); sqlCommand.ExecuteNonQuery(); }
/// <summary>Initializes the static elements of an Object.</summary> static Property() { // The table must be locked before the indices can be read into an accelerator array. ServerMarketData.PropertyLock.AcquireReaderLock(System.Threading.Timeout.Infinite); // Accessor for the Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // 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. Property.externalKeyArray = new DataView[] { propertyTable.KeyPropertyExternalId0, propertyTable.KeyPropertyExternalId1, propertyTable.KeyPropertyExternalId2, propertyTable.KeyPropertyExternalId3}; // The table must be released after the array is constructed. ServerMarketData.PropertyLock.ReleaseReaderLock(); }
/// <summary>Archives a Property 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 Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // Extract the parameters from the command batch. AdoTransaction adoTransaction = parameters["adoTransaction"]; SqlTransaction sqlTransaction = parameters["sqlTransaction"]; object configurationId = parameters["configurationId"].Value; int propertyCode = parameters["propertyCode"]; // The row versioning is largely disabled for external operations. long rowVersion = long.MinValue; // 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. ServerMarketData.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode); rowVersion = ((long)(propertyRow[propertyTable.RowVersionColumn])); // Call the internal method to complete the operation. MarkThree.Guardian.Core.Property.Archive(adoTransaction, sqlTransaction, rowVersion, propertyCode); }
/// <summary>Finds a a Property 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 Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // 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 = Property.GetExternalKeyIndex(configurationId, parameterId); System.Data.DataView externalKeyView = Property.externalKeyArray[externalKeyIndex]; int recordIndex = externalKeyView.Find(new object[] { externalId}); if ((recordIndex == -1)) { return int.MinValue; } return ((int)(externalKeyView[recordIndex].Row[propertyTable.PropertyCodeColumn])); }
/// <summary>Updates a Property 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 Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // Extract the parameters from the command batch. AdoTransaction adoTransaction = parameters["adoTransaction"]; SqlTransaction sqlTransaction = parameters["sqlTransaction"]; object configurationId = parameters["configurationId"].Value; object name = parameters["name"].Value; string externalPropertyCode = parameters["propertyCode"]; // The row versioning is largely disabled for external operations. long rowVersion = long.MinValue; // Resolve External Identifiers int propertyCode = Property.FindRequiredKey(configurationId, "propertyCode", externalPropertyCode); // This will bypass the internal optimistic concurrency checking by providing the current rowVersion to the // internal method. ServerMarketData.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode); rowVersion = ((long)(propertyRow[propertyTable.RowVersionColumn])); // Call the internal method to complete the operation. MarkThree.Guardian.Core.Property.Update(adoTransaction, sqlTransaction, ref rowVersion, null, null, null, null, name, propertyCode); // Return values. parameters["rowVersion"] = rowVersion; }
/// <summary>Updates a Property 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="externalId0">The value for the ExternalId0 column.</param> /// <param name="externalId1">The value for the ExternalId1 column.</param> /// <param name="externalId2">The value for the ExternalId2 column.</param> /// <param name="externalId3">The value for the ExternalId3 column.</param> /// <param name="name">The value for the Name column.</param> /// <param name="propertyCode">The value for the PropertyCode column.</param> public static void Update(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, object externalId0, object externalId1, object externalId2, object externalId3, object name, int propertyCode) { // Accessor for the Property Table. ServerMarketData.PropertyDataTable propertyTable = ServerMarketData.Property; // Rule #1: Make sure the record exists before updating it. ServerMarketData.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode); if ((propertyRow == null)) { throw new Exception(string.Format("The Property table does not have an element identified by {0}", propertyCode)); } // Rule #2: Optimistic Concurrency Check if ((propertyRow.RowVersion != rowVersion)) { throw new System.Exception("This record is busy. Please try again later."); } // Apply Defaults if ((externalId0 == null)) { externalId0 = propertyRow[propertyTable.ExternalId0Column]; } if ((externalId1 == null)) { externalId1 = propertyRow[propertyTable.ExternalId1Column]; } if ((externalId2 == null)) { externalId2 = propertyRow[propertyTable.ExternalId2Column]; } if ((externalId3 == null)) { externalId3 = propertyRow[propertyTable.ExternalId3Column]; } if ((name == null)) { name = propertyRow[propertyTable.NameColumn]; } // Increment the row version rowVersion = ServerMarketData.RowVersion.Increment(); // Update the record in the ADO database. propertyRow[propertyTable.RowVersionColumn] = rowVersion; propertyRow[propertyTable.ExternalId0Column] = externalId0; propertyRow[propertyTable.ExternalId1Column] = externalId1; propertyRow[propertyTable.ExternalId2Column] = externalId2; propertyRow[propertyTable.ExternalId3Column] = externalId3; propertyRow[propertyTable.NameColumn] = name; adoTransaction.DataRows.Add(propertyRow); // Update the record in the SQL database. SqlCommand sqlCommand = new SqlCommand("update \"Property\" set \"RowVersion\"=@rowVersion,\"ExternalId0\"=@externalId0,\"Extern" + "alId1\"=@externalId1,\"ExternalId2\"=@externalId2,\"ExternalId3\"=@externalId3,\"Name\"" + "=@name where \"PropertyCode\"=@propertyCode"); 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("@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.Parameters.Add(new SqlParameter("@externalId2", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId2)); sqlCommand.Parameters.Add(new SqlParameter("@externalId3", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId3)); sqlCommand.Parameters.Add(new SqlParameter("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name)); sqlCommand.Parameters.Add(new SqlParameter("@propertyCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, propertyCode)); // Update the record in the SQL database. sqlCommand.ExecuteNonQuery(); }