StatefulServiceReplica Interface

Pacote:

system.fabric

public interface StatefulServiceReplica

Define o comportamento que rege o ciclo de vida de um réplica, como inicialização, inicialização, alterações de função e desligamento.

Observações:Os tipos de serviço com estado devem implementar essa interface. A lógica de um tipo de serviço com estado inclui o comportamento invocado em réplicas primárias e o comportamento que é invocado em réplicas secundárias. Se o autor do serviço quiser usar o fornecido FabricReplicator, o serviço também deverá implementar StateProvider para usar a implementação do StateReplicator que é fornecido por FabricReplicator

Resumo do método

Modificador e tipo	Método e descrição
void	abort() Encerra sem êxito uma instância. Observações:Perda de concessão e, em resposta ao serviço, o uso de reportFault(FaultType faultType) para relatar uma Permanent falha são exemplos de encerramento ingrato. Quando esse método é invocado, a instância de serviço deve liberar e limpo imediatamente todas as referências e retornar.
CompletableFuture<String>	changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken) Altera a função de um réplica Primário ou Secundário. Observações:A nova função é indicada como um parâmetro. Quando o serviço faz a transição para a nova função, o serviço tem a chance de atualizar seu endereço de escuta atual. O endereço de escuta é o endereço em que os clientes se conectam a ele. Isso habilita o serviço quando ele é um réplica Primário para reivindicar apenas alguns recursos, como portas, quando a comunicação de clientes é esperada.
CompletableFuture<Void>	closeAsync(CancellationToken cancellationToken) Fecha o serviço réplica quando ele está sendo desligado. Observe que o cancelamento é um aviso e que a operação ainda pode ser concluída mesmo se for cancelada.
void	initialize(StatefulServiceInitializationParameters initializationParameters) Inicializa um serviço recém-criado réplica.
CompletableFuture<Replicator>	openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken) Abre um serviço inicializado réplica para que ações adicionais possam ser executadas.

Detalhes do método

abort

public void abort()

Encerra sem êxito uma instância.

Observações:Perda de concessão e, em resposta ao serviço, o uso de reportFault(FaultType faultType) para relatar uma Permanent falha são exemplos de encerramento ingrato. Quando esse método é invocado, a instância de serviço deve liberar e limpo imediatamente todas as referências e retornar.

changeRoleAsync

public CompletableFuture changeRoleAsync(ReplicaRole newRole, CancellationToken cancellationToken)

Altera a função de um réplica Primário ou Secundário.

Observações:A nova função é indicada como um parâmetro. Quando o serviço faz a transição para a nova função, o serviço tem a chance de atualizar seu endereço de escuta atual. O endereço de escuta é o endereço em que os clientes se conectam a ele. Isso habilita o serviço quando ele é um réplica Primário para reivindicar apenas alguns recursos, como portas, quando a comunicação de clientes é esperada.

Parâmetros:

newRole - O atualizado ReplicaRole para o qual esse réplica deve fazer a transição.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

Retorna CompletableFuture do tipo java.lang.String, o novo endereço de conexão do serviço que deve ser associado ao réplica por meio da Nomenclatura do Service Fabric.

closeAsync

public CompletableFuture closeAsync(CancellationToken cancellationToken)

Fecha o serviço réplica quando ele está sendo desligado. Observe que o cancelamento é um aviso e que a operação ainda pode ser concluída mesmo se for cancelada.

Parâmetros:

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

Retorna CompletableFuture.

initialize

public void initialize(StatefulServiceInitializationParameters initializationParameters)

Inicializa um serviço recém-criado réplica.

Parâmetros:

initializationParameters - O StatefulServiceInitializationParameters para este réplica.

openAsync

public CompletableFuture openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken)

Abre um serviço inicializado réplica para que ações adicionais possam ser executadas.

Parâmetros:

openMode - Isso dá suporte à infraestrutura do Service Fabric e não deve ser usado diretamente do seu código.

partition - As StatefulServicePartition informações deste réplica.

cancellationToken -

CancellationTokenpara indicar o status de cancelamento da operação.

Retornos:

Retorna CompletableFuture><Replicator, o Replicator usado pelo serviço com estado. Para usar a implementação do Service Fabric, no openAsync(ReplicaOpenMode openMode, StatefulServicePartition partition, CancellationToken cancellationToken) , o réplica deve retornar um FabricReplicator obtido decreateReplicator(StateProvider stateProvider, ReplicatorSettings replicatorSettings)