在動作項目服務中實作服務層級功能

發行項
06/01/2023

如服務分層所述，動作項目服務本身是可靠的服務。您可以撰寫自己的服務，其衍生自 ActorService。您也可以繼承具狀態服務時的相同方式來實作服務層級功能，例如：

服務備份與還原。
適用於所有動作項目的共用功能，例如斷路器。
遠端處理程序會在動作項目服務本身，以及每個個別動作項目上進行呼叫。

使用動作項目服務

動作項目執行個體具有其執行所在之動作項目服務的存取權。透過動作項目服務，動作項目執行個體可以程式設計方式取得服務內容。服務內容包含分割區識別碼、服務名稱、應用程式名稱及其他 Azure Service Fabric 平台特定的資訊。

Task MyActorMethod()
{
    Guid partitionId = this.ActorService.Context.PartitionId;
    string serviceTypeName = this.ActorService.Context.ServiceTypeName;
    Uri serviceInstanceName = this.ActorService.Context.ServiceName;
    string applicationInstanceName = this.ActorService.Context.CodePackageActivationContext.ApplicationName;
}

CompletableFuture<?> MyActorMethod()
{
    UUID partitionId = this.getActorService().getServiceContext().getPartitionId();
    String serviceTypeName = this.getActorService().getServiceContext().getServiceTypeName();
    URI serviceInstanceName = this.getActorService().getServiceContext().getServiceName();
    String applicationInstanceName = this.getActorService().getServiceContext().getCodePackageActivationContext().getApplicationName();
}

就像所有 Reliable Services，動作項目服務必須在 Service Fabric 執行階段，利用某個服務類型來註冊。為了讓動作項目服務執行您的動作項目執行個體，也必須向動作項目服務註冊您的動作項目類型。 ActorRuntime 註冊方法會替動作項目執行這項工作。在最簡單的情況下，您可以註冊動作項目類型，而動作項目服務會接著使用預設設定。

static class Program
{
    private static void Main()
    {
        ActorRuntime.RegisterActorAsync<MyActor>().GetAwaiter().GetResult();

        Thread.Sleep(Timeout.Infinite);
    }
}

或者，您可以使用註冊方法提供的 Lambda，來建構自己的動作項目服務。您可以接著設定動作項目服務，並明確地建構動作項目執行個體。您可以透過建構函式，將相依性插入動作項目。

static class Program
{
    private static void Main()
    {
        ActorRuntime.RegisterActorAsync<MyActor>(
            (context, actorType) => new ActorService(context, actorType, () => new MyActor()))
            .GetAwaiter().GetResult();

        Thread.Sleep(Timeout.Infinite);
    }
}

static class Program
{
    private static void Main()
    {
      ActorRuntime.registerActorAsync(
              MyActor.class,
              (context, actorTypeInfo) -> new FabricActorService(context, actorTypeInfo),
              timeout);

        Thread.sleep(Long.MAX_VALUE);
    }
}

動作項目服務方法

動作項目服務會實作 IActorService (C#) 或 ActorService (Java)，而它會接著實作 IService (C#) 或 Service (Java)。這是 Reliable Services 遠端處理功能所使用的介面，能夠在服務方法上進行遠端程序呼叫。它包含的服務層級方法可使用服務遠端處理功能從遠端呼叫。您可以使用它來列舉和刪除動作項目。

自訂動作項目服務

您可以使用動作項目註冊 lambda，註冊自 ActorService (C#) 和 FabricActorService (Java) 延伸的自訂動作項目服務。接著，您可以撰寫繼承 ActorService (C#) 或 FabricActorService (Java) 的服務，以實作自己的服務層級功能。自訂動作項目服務會繼承來自 ActorService (C#) 或 FabricActorService (Java) 的所有動作項目執行階段功能，而且可用來實作您自己的服務方法。

class MyActorService : ActorService
{
    public MyActorService(StatefulServiceContext context, ActorTypeInformation typeInfo, Func<ActorBase> newActor)
        : base(context, typeInfo, newActor)
    { }
}

class MyActorService extends FabricActorService
{
    public MyActorService(StatefulServiceContext context, ActorTypeInformation typeInfo, BiFunction<FabricActorService, ActorId, ActorBase> newActor)
    {
         super(context, typeInfo, newActor);
    }
}

static class Program
{
    private static void Main()
    {
        ActorRuntime.RegisterActorAsync<MyActor>(
            (context, actorType) => new MyActorService(context, actorType, () => new MyActor()))
            .GetAwaiter().GetResult();

        Thread.Sleep(Timeout.Infinite);
    }
}

public class Program
{
    public static void main(String[] args)
    {
        ActorRuntime.registerActorAsync(
                MyActor.class,
                (context, actorTypeInfo) -> new FabricActorService(context, actorTypeInfo),
                timeout);
        Thread.sleep(Long.MAX_VALUE);
    }
}

實作動作項目備份與還原

自訂動作項目服務會利用已經存在於 ActorService中的遠端處理接聽程式，藉以公開用來備份動作項目資料的方法。如需範例，請參閱備份與還原動作項目。

使用遠端 V2(介面相容) 堆疊的動作項目

遠端 V2 (介面相容，也稱為 V2_1) 堆疊具有 V2 遠端堆疊的所有功能。它的介面與遠端 V1 堆疊相容，但是 V2 與 V1 不具回溯相容性。若要從 V1 升級為 V2_1 而不會影響服務可用性，請遵循下一節中的步驟。

若要使用遠端 V2_1 堆疊，必須進行下列變更：

在動作項目介面上新增下列組件屬性。

[assembly:FabricTransportActorRemotingProvider(RemotingListenerVersion = RemotingListenerVersion.V2_1,RemotingClientVersion = RemotingClientVersion.V2_1)]

建置和升級動作項目服務和動作項目用戶端專案，以開始使用 V2 堆疊。

將動作項目服務升級至遠端 V2 (介面相容) 堆疊，而不會影響服務可用性。

這項變更是 2 個步驟的升級作業。遵循此序列中的步驟。

在動作項目介面上新增下列組件屬性。此屬性會為動作項目服務啟動兩個接聽程式：V1 (現有) 與 V2_1 接聽程式。透過這項變更來升級動作項目服務。
```
[assembly:FabricTransportActorRemotingProvider(RemotingListenerVersion = RemotingListenerVersion.V1|RemotingListenerVersion.V2_1,RemotingClientVersion = RemotingClientVersion.V2_1)]
```
在完成先前的升級之後，將動作項目用戶端升級。此步驟可確保動作項目 Proxy 使用遠端 V2_1 堆疊。

此步驟是選擇性的。變更前一個屬性以移除 V1 接聽程式。

[assembly:FabricTransportActorRemotingProvider(RemotingListenerVersion = RemotingListenerVersion.V2_1,RemotingClientVersion = RemotingClientVersion.V2_1)]

使用遠端 V2 堆疊的動作項目

透過 2.8 版 NuGet 套件，使用者現在可以使用遠端 V2 堆疊，其效能更好並可提供自訂序列化等功能。遠端 V2 與現有的遠端堆疊 (現在稱為 V1 遠端堆疊) 不具回溯相容性。

若要使用遠端 V2 堆疊，必須進行下列變更。