Clerk Class
.NET Framework 2.0
Writes records of transactional actions to a log.
Namespace: System.EnterpriseServices.CompensatingResourceManager
Assembly: System.EnterpriseServices (in system.enterpriseservices.dll)
Assembly: System.EnterpriseServices (in system.enterpriseservices.dll)
The following code example demonstrates the use of this class.
' A CRM Worker <Transaction()> _ Public Class Account Inherits ServicedComponent ' A data member for the account file name. Private filename As String Public Property Filenam() As String Get Return Filename End Get Set(ByVal value As String) filename = Value End Set End Property ' A boolean data member that determines whether to commit or abort the transaction. Private commit As Boolean Public Property AllowCommit() As Boolean Get Return commit End Get Set commit = value End Set End Property ' Debit the account, Public Sub DebitAccount(ByVal ammount As Integer) ' Create a new clerk using the AccountCompensator class. Dim clerk As New Clerk(GetType(AccountCompensator), "An account transaction compensator", CompensatorOptions.AllPhases) ' Create a record of previous account status, and deliver it to the clerk. Dim balance As Integer = AccountManager.ReadAccountBalance(Filenam) Dim record(1) As [Object] record(0) = filename record(1) = balance clerk.WriteLogRecord(record) clerk.ForceLog() ' Perform the transaction balance -= ammount AccountManager.WriteAccountBalance(filename, balance) ' Commit or abort the transaction If commit Then ContextUtil.SetComplete() Else ContextUtil.SetAbort() End If End Class 'Account
// A CRM Worker
/** @attribute Transaction()
*/
public class Account extends ServicedComponent
{
// A data member for the account file name.
/** @property
*/
private String fileName;
public String get_fileName()
{
return fileName;
} //get_fileName
public void set_fileName(String value)
{
fileName = value;
} //set_fileName
// A boolean data member that determines whether to commit or
// abort the transaction.
private boolean commit;
/** @property
*/
public boolean get_AllowCommit()
{
return commit;
} //get_AllowCommit
/** @property
*/
public void set_AllowCommit(boolean value)
{
commit = value;
} //set_AllowCommit
// Debit the account,
public void DebitAccount(int ammount)
{
// Create a new clerk using the AccountCompensator class.
Clerk clerk = new Clerk(AccountCompensator.class.ToType(),
"An account transaction compensator",
CompensatorOptions.AllPhases);
// Create a record of previous account status, and deliver
// it to the clerk.
Console.WriteLine("filename = " + fileName);
int balance = AccountManager.ReadAccountBalance(fileName);
Object record[] = new Object[2];
record.set_Item(0, fileName);
record.set_Item(1,(Int32)balance);
clerk.WriteLogRecord(record);
clerk.ForceLog();
// Perform the transaction
balance -= ammount;
AccountManager.WriteAccountBalance(fileName, balance);
// Commit or abort the transaction
if (commit) {
ContextUtil.SetComplete();
}
else {
ContextUtil.SetAbort();
}
} //DebitAccount
} //Account
The following code example demonstrates the corresponding Compensator class.
Imports System Public Class CrmClient Public Shared Sub Main() ' Create a new account object. The object is created in a COM+ server application. Dim account As New Account() ' Transactionally debit the account. Try account.Filenam = System.IO.Path.GetFullPath("JohnDoe") account.AllowCommit = True account.DebitAccount(3) Finally account.Dispose() End Try End Sub 'Main End Class 'CrmClient
import System.*;
public class CrmClient
{
public static void main(String[] args)
{
// Create a new account object. The object is created in a COM+
// server application.
Account account = new Account();
// Transactionally debit the account.
try {
account.set_fileName(System.IO.Path.GetFullPath("JohnDoe"));
account.set_AllowCommit(true);
account.DebitAccount(3);
}
finally {
account.Dispose();
}
} //main
} //CrmClient
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Community Additions
ADD
Show: