Share via

Megjegyzések a Service Fabric Reliable Actors típus szerializálásához

  • Cikk

Az összes metódus argumentumainak, az egyes metódusok által visszaadott eredménytípusoknak egy színészi felületen, valamint a színész állapotkezelőjében tárolt objektumoknak szerializálhatónak kell lenniük. Ez az aktoresemény-interfészekben definiált metódusok argumentumaira is vonatkozik. (Az aktoresemény-felület metódusai mindig üres értéket adnak vissza.)

Egyéni adattípusok

Ebben a példában a következő aktorfelület definiál egy metódust, amely egy nevű egyéni adattípust VoicemailBoxad vissza:

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

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

A felületet egy olyan szereplő valósítja meg, amely az állapotkezelőt használja egy VoicemailBox objektum tárolására:

[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");
    }
}

Ebben a példában az VoicemailBox objektum szerializálva van, ha:

  • Az objektum átvitele egy színészpéldány és egy hívó között történik.
  • Az objektumot a rendszer abban az állapotkezelőben menti, ahol a lemezen marad, és más csomópontokra replikálja.

A Reliable Actor keretrendszer DataContract szerializálást használ. Ezért az egyéni adatobjektumokat és azok tagjait a DataContract és a DataMember attribútumokkal kell jegyzetekkel ellátni.

[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()
}

Következő lépések