Compensator Classe

Definizione

Rappresenta la classe base di tutti i compensatori CRM (Compensating Resource Manager).Represents the base class for all Compensating Resource Manager (CRM) Compensators.

public ref class Compensator : System::EnterpriseServices::ServicedComponent
public class Compensator : System.EnterpriseServices.ServicedComponent
type Compensator = class
    inherit ServicedComponent
Public Class Compensator
Inherits ServicedComponent
Ereditarietà

Esempio

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questa classe.The following code example demonstrates the use of this class.

// A CRM Compensator
public ref class AccountCompensator : public Compensator
{
private:
    bool receivedPrepareRecord;

public:
    AccountCompensator()
    {
        receivedPrepareRecord = false;
    } 

public:
    virtual void BeginPrepare() override 
    {
        // nothing to do
    }

public:
    virtual bool PrepareRecord(LogRecord^ log) override 
    {

        // Check the validity of the record.
        if (log == nullptr)
        {
            return false;
        }
        array<Object^>^ record = dynamic_cast<array<Object^>^>(log->Record);
        if (record == nullptr)
        {
            return false;
        }
        if (record->Length != 2)
        {
            return false;
        }

        // The record is valid.
        receivedPrepareRecord = true;
        return true;              
    }

public:
    virtual bool EndPrepare() override
    {
        // Allow the transaction to proceed onlyif we have received a prepare
        // record.
        if (receivedPrepareRecord)
        {
            return true;
        }
        else
        {
            return false;
        }
    }

public:
    virtual void BeginCommit(bool commit) override
    {
        // nothing to do
    }

public:
    virtual bool CommitRecord(LogRecord^ log) override
    {
        // nothing to do
        return(false);
    }

public:
    virtual void EndCommit() override
    {
        // nothing to do
    }

public:
    virtual void BeginAbort(bool abort) override
    {
        // nothing to do
    }

public:
    virtual bool AbortRecord(LogRecord^ log) override
    {

        // Check the validity of the record.
        if (log == nullptr)
        {
            return true;
        }
        array<Object^>^ record = dynamic_cast<array<Object^>^>(log->Record);
        if (record == nullptr)
        {
            return true;
        }
        if (record->Length != 2)
        {
            return true;
        }

        // Extract old account data from the record.
        String^ filename = (String^) record[0];
        int balance = (int) record[1];

        // Restore the old state of the account.
        WriteAccountBalance(filename, balance);

        return false;
    }

public:
    virtual void EndAbort() override
    {
        // nothing to do
    }    

};
// A CRM Compensator
public class AccountCompensator : Compensator
{

    private bool receivedPrepareRecord = false;

    public override void BeginPrepare ()
    {
        // nothing to do
    }

    public override bool PrepareRecord (LogRecord log)
    {

        // Check the validity of the record.
        if (log == null) return(true);
        Object[] record = log.Record as Object[];
        if (record == null) return(true);
        if (record.Length != 2) return(true);

        // The record is valid.
        receivedPrepareRecord = true;
        return(false);
    }

    public override bool EndPrepare ()
    {
        // Allow the transaction to proceed onlyif we have received a prepare record.
        if (receivedPrepareRecord)
        {
            return(true);
        }
        else
        {
            return(false);
        }
    }

    public override void BeginCommit (bool commit)
    {
        // nothing to do
    }

    public override bool CommitRecord (LogRecord log)
    {
        // nothing to do
        return(false);
    }

    public override void EndCommit ()
    {
        // nothing to do
    }

    public override void BeginAbort (bool abort)
    {
        // nothing to do
    }

    public override bool AbortRecord (LogRecord log)
    {

        // Check the validity of the record.
        if (log == null) return(true);
        Object[] record = log.Record as Object[];
        if (record == null) return(true);
        if (record.Length != 2) return(true);

        // Extract old account data from the record.
        string filename = (string) record[0];
        int balance = (int) record[1];

        // Restore the old state of the account.
        AccountManager.WriteAccountBalance(filename, balance);

        return(false);
    }

    public override void EndAbort ()
    {
        // nothing to do
    }
}
' A CRM Compensator

Public Class AccountCompensator
    Inherits Compensator
    
    Private receivedPrepareRecord As Boolean = False
    
    
    Public Overrides Sub BeginPrepare() 
    
    End Sub
    
    ' nothing to do
    Public Overrides Function PrepareRecord(ByVal log As LogRecord) As Boolean 
        
        ' Check the validity of the record.
        If log Is Nothing Then
            Return True
        End If
        Dim record As [Object]() = log.Record
        
        If record Is Nothing Then
            Return True
        End If
        If record.Length <> 2 Then
            Return True
        End If 
        ' The record is valid.
        receivedPrepareRecord = True
        Return False
    
    End Function 'PrepareRecord
    
    Public Overrides Function EndPrepare() As Boolean 
        ' Allow the transaction to proceed onlyif we have received a prepare record.
        If receivedPrepareRecord Then
            Return True
        Else
            Return False
        End If
    
    End Function 'EndPrepare
    
    Public Overrides Sub BeginCommit(ByVal commit As Boolean) 
    
    End Sub
    
    ' nothing to do
    Public Overrides Function CommitRecord(ByVal log As LogRecord) As Boolean 
        ' nothing to do
        Return False
    
    End Function 'CommitRecord
    
    Public Overrides Sub EndCommit() 
    
    End Sub
    
    ' nothing to do
    Public Overrides Sub BeginAbort(ByVal abort As Boolean) 
    
    End Sub
    
    ' nothing to do
    Public Overrides Function AbortRecord(ByVal log As LogRecord) As Boolean 
        
        ' Check the validity of the record.
        If log Is Nothing Then
            Return True
        End If
        Dim record As [Object]() = log.Record
        
        If record Is Nothing Then
            Return True
        End If
        If record.Length <> 2 Then
            Return True
        End If 
        ' Extract old account data from the record.
        Dim filename As String = CStr(record(0))
        Dim balance As Integer = Fix(record(1))
        
        ' Restore the old state of the account.
        AccountManager.WriteAccountBalance(filename, balance)
        
        Return False
    
    End Function 'AbortRecord
    
    Public Overrides Sub EndAbort() 
    
    End Sub
End Class

Questo compensatore viene usato dalla classe del ruolo di lavoro seguente.This compensator is used by the following worker class.

// A CRM Worker
[Transaction]
public ref class Account : public ServicedComponent
{

    // A data member for the account file name.
private:
    String^ filenameValue;

public:
    property String^ Filename
    {
        String^ get()
        {
            return filenameValue;
        }
        void set( String^ value )
        {
            filenameValue = value;
        }
    }

    // A boolean data member that determines whether to commit or abort the 
    // transaction.
private:
    bool allowCommitValue;

public:
    property bool AllowCommit
    {
        bool get()
        {
            return allowCommitValue;
        }
        void set( bool value )
        {
            allowCommitValue = value;
        }
    }

    // Debit the account, 
public:
    void DebitAccount(int amount)
    {

        // Create a new clerk using the AccountCompensator class.
        Clerk^ clerk = gcnew Clerk(AccountCompensator::typeid,
            "An account transaction compensator", CompensatorOptions::AllPhases);

        // Create a record of previous account status, and deliver it to the
        // clerk.
        int balance = ReadAccountBalance(Filename);

        array<Object^>^ record = gcnew array<Object^>(2);
        record[0] = Filename;
        record[1] = balance;

        clerk->WriteLogRecord(record);
        clerk->ForceLog();

        // Perform the transaction
        balance -= amount;

        Console::WriteLine("{0}: {1}", Filename, balance);

        WriteAccountBalance(Filename, balance);

        // Commit or abort the transaction 
        if (AllowCommit)
        {
            ContextUtil::SetComplete();
        }
        else
        {
            ContextUtil::SetAbort();
        }

    }

};
// A CRM Worker
[Transaction]
public class Account : ServicedComponent
{

    // A data member for the account file name.
    private string filename;

    public string Filename
    {
        get
        {
            return(filename);
        }
        set
        {
            filename = value;
        }
    }

    // A boolean data member that determines whether to commit or abort the transaction.
    private bool commit;

    public bool AllowCommit
    {
        get
        {
            return(commit);
        }
        set
        {
            commit = value;
        }
    }

    // Debit the account,
    public void DebitAccount (int ammount)
    {

        // Create a new clerk using the AccountCompensator class.
        Clerk clerk = new Clerk(typeof(AccountCompensator),
          "An account transaction compensator", CompensatorOptions.AllPhases);

        // Create a record of previous account status, and deliver it to the clerk.
        int balance = AccountManager.ReadAccountBalance(filename);

    Object[] record = new Object[2];
    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)
        {
            ContextUtil.SetComplete();
        }
        else
        {
            ContextUtil.SetAbort();
        }
    }
}
' 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 Sub
    
End Class

Nell'esempio di codice riportato di seguito viene illustrato un client che esercita questa classe Compensator e worker.The following code example demonstrates a client that exercises this compensator and worker.

#using "System.EnterpriseServices.dll"

using namespace System;

[assembly: System::Reflection::AssemblyKeyFile("CrmServer.key")];

int main ()
{

    // Create a new account object. The object is created in a COM+ server application.
    Account^ account = gcnew Account();

    // Transactionally debit the account.
    try
    {
        account->Filename = System::IO::Path::GetFullPath("JohnDoe");
        account->AllowCommit = true;
        account->DebitAccount(3);
    }
    finally
    {
        delete account;
    }

}
using System;

public class CrmClient
{

    public static void Main ()
    {

        // Create a new account object. The object is created in a COM+ server application.
        Account account = new Account();

        // Transactionally debit the account.
        try
        {
            account.Filename = System.IO.Path.GetFullPath("JohnDoe");
            account.AllowCommit = true;
            account.DebitAccount(3);
        }
        finally
        {
            account.Dispose();
        }
    }
}
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
End Class

Commenti

L'utente deve estendersi da questo oggetto per scrivere un compensatore di transazione personalizzato.The user should extend from this object in order to write a custom transaction Compensator.

Un compensatore deve avere sempre un costruttore pubblico. in caso contrario, il motore di ripristino non è in grado di crearlo.A Compensator must always have a public constructor; otherwise, the recovery engine cannot create it.

Per altre informazioni, vedere procedura: creare un gestione risorse di compensazione (CRM).For more information, see How to: Create a Compensating Resource Manager (CRM).

Costruttori

Compensator()

Inizializza una nuova istanza della classe Compensator.Initializes a new instance of the Compensator class.

Proprietà

Clerk

Recupera un valore che rappresenta l'oggetto CRM (Compensating Resource Manager) Clerk.Gets a value representing the Compensating Resource Manager (CRM) Clerk object.

Metodi

AbortRecord(LogRecord)

Recapita un record del log per la classe Compensator CRM (Compensating Resource Manager) durante la fase di interruzione.Delivers a log record to the Compensating Resource Manager (CRM) Compensator during the abort phase.

Activate()

Metodo chiamato dall’infrastruttura quando l’oggetto viene creato o allocato da un pool.Called by the infrastructure when the object is created or allocated from a pool. Sottoporre a override il metodo per aggiungere codice di inizializzazione personalizzato agli oggetti.Override this method to add custom initialization code to objects.

(Ereditato da ServicedComponent)
BeginAbort(Boolean)

Notifica alla classe Compensator CRM (Compensating Resource Manager) la fase di interruzione del completamento della transazione e l'imminente recapito dei record.Notifies the Compensating Resource Manager (CRM) Compensator of the abort phase of the transaction completion, and the upcoming delivery of records.

BeginCommit(Boolean)

Notifica alla classe Compensator CRM (Compensating Resource Manager) la fase di commit del completamento della transazione e l'imminente recapito dei record.Notifies the Compensating Resource Manager (CRM) Compensator of the commit phase of the transaction completion and the upcoming delivery of records.

BeginPrepare()

Notifica alla classe Compensator CRM (Compensating Resource Manager) la fase di preparazione del completamento della transazione e l'imminente recapito dei record.Notifies the Compensating Resource Manager (CRM) Compensator of the prepare phase of the transaction completion and the upcoming delivery of records.

CanBePooled()

Questo metodo viene chiamato dall’infrastruttura prima che l’oggetto sia inserito nuovamente nel pool.This method is called by the infrastructure before the object is put back into the pool. Sottoporre a override il metodo per determinare il reinserimento dell'oggetto nel pool.Override this method to vote on whether the object is put back into the pool.

(Ereditato da ServicedComponent)
CommitRecord(LogRecord)

Recapita un record del log in ordine di inoltro durante la fase di commit.Delivers a log record in forward order during the commit phase.

Construct(String)

Metodo chiamato dall'infrastruttura subito dopo la chiamata al costruttore, passando la stringa del costruttore.Called by the infrastructure just after the constructor is called, passing in the constructor string. Sottoporre a override il metodo per utilizzare il valore della stringa del costruttore.Override this method to make use of the construction string value.

(Ereditato da ServicedComponent)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Deactivate()

Metodo chiamato dall’infrastruttura quando l’oggetto sta per essere disattivato.Called by the infrastructure when the object is about to be deactivated. Sottoporre a override il metodo per aggiungere codice di completamento personalizzato agli oggetti quando si utilizza codice compilato JIT o il pool di oggetti.Override this method to add custom finalization code to objects when just-in-time (JIT) compiled code or object pooling is used.

(Ereditato da ServicedComponent)
Dispose()

Rilascia tutte le risorse usate da ServicedComponent.Releases all resources used by the ServicedComponent.

(Ereditato da ServicedComponent)
Dispose(Boolean)

Rilascia le risorse non gestite usate da ServicedComponent e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the ServicedComponent and optionally releases the managed resources.

(Ereditato da ServicedComponent)
EndAbort()

Notifica alla classe Compensator CRM (Compensating Resource Manager) che ha ricevuto tutti i record disponibili durante la fase di interruzione.Notifies the Compensating Resource Manager (CRM) Compensator that it has received all the log records available during the abort phase.

EndCommit()

Notifica alla classe Compensator CRM (Compensating Resource Manager) che ha recapitato tutti i record disponibili durante la fase di commit.Notifies the Compensating Resource Manager (CRM) Compensator that it has delivered all the log records available during the commit phase.

EndPrepare()

Notifica alla classe Compensator CRM (Compensating Resource Manager) che ha ricevuto tutti i record disponibili durante la fase di preparazione.Notifies the Compensating Resource Manager (CRM) Compensator that it has had all the log records available during the prepare phase.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()
Obsoleta.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleta.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
PrepareRecord(LogRecord)

Recapita un record del log in ordine di inoltro durante la fase di preparazione.Delivers a log record in forward order during the prepare phase.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IRemoteDispatch.RemoteDispatchAutoDone(String)

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

Garantisce che, nel contesto COM+, il bit done dell'oggetto della classe ServicedComponent sia impostato su true dopo una chiamata a un metodo remoto.Ensures that, in the COM+ context, the ServicedComponent class object's done bit is set to true after a remote method invocation.

(Ereditato da ServicedComponent)
IRemoteDispatch.RemoteDispatchNotAutoDone(String)

Non garantisce che, nel contesto COM+, il bit done dell'oggetto della classe ServicedComponent sia impostato su true dopo una chiamata a un metodo remoto.Does not ensure that, in the COM+ context, the ServicedComponent class object's done bit is set to true after a remote method invocation.

(Ereditato da ServicedComponent)
IServicedComponentInfo.GetComponentInfo(Int32, String[])

Ottiene alcune informazioni sull'istanza della classe ServicedComponent.Obtains certain information about the ServicedComponent class instance.

(Ereditato da ServicedComponent)

Si applica a