Poznámky k serializaci typu Reliable Actors pro Service Fabric

  • Článek

Argumenty všech metod, typy výsledků úkolů vrácené každou metodou v rozhraní objektu actor a objekty uložené ve správci stavu objektu actor musí být serializovatelný datový kontrakt. To platí také pro argumenty metod definovaných v rozhraních událostí objektu actor. (Metody rozhraní událostí objektu actor vždy vrací void.)

Vlastní datové typy

V tomto příkladu definuje následující rozhraní objektu actor metodu, která vrací vlastní datový typ s názvem VoicemailBox:

public interface IVoiceMailBoxActor : IActor
{
    Task<VoicemailBox> GetMailBoxAsync();
}

public interface VoiceMailBoxActor extends Actor
{
    CompletableFuture<VoicemailBox> getMailBoxAsync();
}

Rozhraní je implementováno objektem actor, který používá správce stavu k uložení objektu VoicemailBox :

[StatePersistence(StatePersistence.Persisted)]
public class VoiceMailBoxActor : Actor, IVoicemailBoxActor
{
    public VoiceMailBoxActor(ActorService actorService, ActorId actorId)
        : base(actorService, actorId)
    {
    }

    public Task<VoicemailBox> GetMailboxAsync()
    {
        return this.StateManager.GetStateAsync<VoicemailBox>("Mailbox");
    }
}


@StatePersistenceAttribute(statePersistence = StatePersistence.Persisted)
public class VoiceMailBoxActorImpl extends FabricActor implements VoicemailBoxActor
{
    public VoiceMailBoxActorImpl(ActorService actorService, ActorId actorId)
    {
         super(actorService, actorId);
    }

    public CompletableFuture<VoicemailBox> getMailBoxAsync()
    {
         return this.stateManager().getStateAsync("Mailbox");
    }
}

V tomto příkladu VoicemailBox se objekt serializuje, když:

  • Objekt se přenáší mezi instancí objektu actor a volajícím.
  • Objekt se uloží do správce stavu, kde se uloží na disk a replikuje do jiných uzlů.

Rozhraní Reliable Actor používá serializaci DataContract. Proto musí být vlastní datové objekty a jejich členy anotovány atributy DataContract a DataMember v uvedeném pořadí.

[DataContract]
public class Voicemail
{
    [DataMember]
    public Guid Id { get; set; }

    [DataMember]
    public string Message { get; set; }

    [DataMember]
    public DateTime ReceivedAt { get; set; }
}

public class Voicemail implements Serializable
{
    private static final long serialVersionUID = 42L;

    private UUID id;                    //getUUID() and setUUID()

    private String message;             //getMessage() and setMessage()

    private GregorianCalendar receivedAt; //getReceivedAt() and setReceivedAt()
}

[DataContract]
public class VoicemailBox
{
    public VoicemailBox()
    {
        this.MessageList = new List<Voicemail>();
    }

    [DataMember]
    public List<Voicemail> MessageList { get; set; }

    [DataMember]
    public string Greeting { get; set; }
}

public class VoicemailBox implements Serializable
{
    static final long serialVersionUID = 42L;
    
    public VoicemailBox()
    {
        this.messageList = new ArrayList<Voicemail>();
    }

    private List<Voicemail> messageList;   //getMessageList() and setMessageList()

    private String greeting;               //getGreeting() and setGreeting()
}

Další kroky