ActorProxyBase Classe

Paquet:

microsoft.servicefabric.actors.client

• java.lang.Object
• • ProxyBase
  • • microsoft.servicefabric.actors.client.ActorProxyBase

public class ActorProxyBase extends ProxyBase implements ActorProxy

Fournit l’implémentation de base pour le proxy vers les objets d’acteur distants qui implémentent des interfaces IActor.

Récapitulatif du constructeur

Constructeur	Description
ActorProxyBase()	Initialise une nouvelle instance de la classe ActorProxy.

Résumé de la méthode

Modificateur et type	Méthode et description
static<T extends Actor> T	create(Class<T> actorInterfaceType, ActorId actorId) Crée un proxy vers l’objet actor qui implémente une interface d’acteur. Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .
static<T extends Actor> T	create(Class<T> actorInterfaceType, ActorId actorId, String applicationName) Crée un proxy vers l’objet actor qui implémente une interface d’acteur. Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .
static<T extends Actor> T	create(Class<T> actorInterfaceType, ActorId actorId, String applicationName, String serviceName) Crée un proxy vers l’objet actor qui implémente une interface d’acteur. Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .
static<T extends Actor> T	create(Class<T> actorInterfaceType, ActorId actorId, String applicationName, String serviceName, String listenerName) Crée un proxy vers l’objet actor qui implémente une interface d’acteur. Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .
static<T extends Actor> T	create(Class<T> actorInterfaceType, ActorId actorId, URI serviceUri) Crée un proxy vers l’objet acteur qui implémente une interface d’acteur.
static<T extends Actor> T	create(Class<T> actorInterfaceType, ActorId actorId, URI serviceUri, String listenerName) Crée un proxy vers l’objet acteur qui implémente une interface d’acteur.
Object	createRequestMessageBody(Object requestMessageBodyValue)
Object	deserializeMessage(byte[] msgBodyValue)
ActorId	getActorId() Obtient ActorId associé à l’objet proxy.
ActorServicePartitionClientImpl	getActorServicePartitionClient() Obtient microsoft.servicefabric.actors.remoting.client.internal.ActorServicePartitionClientImpl que ce proxy utilise pour communiquer avec l’acteur.
FabricActorProxyFactory	getDefaultProxyFactory() Obtient la fabrique de proxy d’acteur par défaut.
Object	getResponseMessageBodyValue(Object responseMessageBody)
void	initialize(ActorServicePartitionClientImpl actorServicePartitionClient) Méthode permettant d’initialiser le proxy d’acteur instance Pour une utilisation interne uniquement.
void	invoke(int interfaceId, int methodId, byte[] requestMsgBodyBytes)
CompletableFuture<byte[]>	invokeAsync(int interfaceId, int methodId, byte[] requestMsgBodyBytes, CancellationToken cancellationToken)
byte []	serializeMessage(Object msgBodyValue)

Membres hérités

ProxyBase.continueWith(CompletableFuture<Object> future) ProxyBase.getReturnValue(int interfaceId, int methodId, Object responseBody) ProxyBase.invoke(int interfaceId, int methodId, Object requestMsgBodyValue) ProxyBase.invokeAsync(int interfaceId, int methodId, Object requestMsgBodyValue, CancellationToken cancellationToken) ProxyBase.ProxyBase()

Détails du constructeur

ActorProxyBase

protected ActorProxyBase()

Initialise une nouvelle instance de la classe ActorProxy.

Détails de la méthode

create

public static static T create(Class actorInterfaceType, ActorId actorId)

Crée un proxy vers l’objet actor qui implémente une interface d’acteur.

Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .

Paramètres:

actorInterfaceType - Interface d’acteur implémentée par l’objet d’acteur distant. L’objet proxy retourné implémente cette interface.

actorId - ID d’acteur de l’objet d’acteur proxy. Les méthodes appelées sur ce proxy entraînent l’envoi de requêtes à l’acteur avec cet ID.

Retours:

Objet proxy d’acteur qui implémente ActorProxy et TActorInterface.

Exception:

URISyntaxException - Lève une exception lorsque le format d’URI non valide est passé en tant que applicationName

create

public static static T create(Class actorInterfaceType, ActorId actorId, String applicationName)

Crée un proxy vers l’objet actor qui implémente une interface d’acteur.

Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .

Paramètres:

actorInterfaceType - Interface d’acteur implémentée par l’objet d’acteur distant. L’objet proxy retourné implémente cette interface.

actorId - ID d’acteur de l’objet d’acteur proxy. Les méthodes appelées sur ce proxy entraînent l’envoi de requêtes à l’acteur avec cet ID.

applicationName - Nom de l’application Service Fabric qui contient le service d’acteur hébergeant les objets d’acteur. Ce paramètre peut être null si le client s’exécute dans le cadre de cette même application Service Fabric. Pour plus d'informations, consultez la section Notes.

Retours:

Objet proxy d’acteur qui implémente ActorProxy et TActorInterface.

Exception:

URISyntaxException - Lève une exception lorsque le format d’URI non valide est passé en tant que applicationName

create

public static static T create(Class actorInterfaceType, ActorId actorId, String applicationName, String serviceName)

Crée un proxy vers l’objet actor qui implémente une interface d’acteur.

Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .

Paramètres:

actorInterfaceType - Interface d’acteur implémentée par l’objet d’acteur distant. L’objet proxy retourné implémente cette interface.

actorId - ID d’acteur de l’objet d’acteur proxy. Les méthodes appelées sur ce proxy entraînent l’envoi de requêtes à l’acteur avec cet ID.

applicationName - Nom de l’application Service Fabric qui contient le service d’acteur hébergeant les objets d’acteur. Ce paramètre peut être null si le client s’exécute dans le cadre de cette même application Service Fabric. Pour plus d'informations, consultez la section Notes.

serviceName - Nom du service Service Fabric tel que configuré par ActorServiceAttribute sur l’implémentation de l’acteur. Par défaut, le nom du service est dérivé du nom de l’interface d’acteur. Toutefois ActorServiceAttribute , est requis lorsqu’un acteur implémente plusieurs interfaces d’acteur ou qu’une interface d’acteur dérive d’une autre interface d’acteur, car la détermination du serviceName ne peut pas être effectuée automatiquement.

Retours:

Objet proxy d’acteur qui implémente ActorProxy et TActorInterface.

Exception:

URISyntaxException - Lève une exception lorsque le format d’URI non valide est passé en tant que applicationName

create

public static static T create(Class actorInterfaceType, ActorId actorId, String applicationName, String serviceName, String listenerName)

Crée un proxy vers l’objet actor qui implémente une interface d’acteur.

Le paramètre applicationName peut être null si le client s’exécute dans le cadre de la même application Service Fabric que le service d’acteur avec lequel il a l’intention de communiquer. Dans ce cas, le nom de l’application est déterminé à partir de CodePackageActivationContextet est obtenu en appelant la getApplicationName() propriété .

Paramètres:

actorInterfaceType - Interface d’acteur implémentée par l’objet d’acteur distant. L’objet proxy retourné implémente cette interface.

actorId - ID d’acteur de l’objet d’acteur proxy. Les méthodes appelées sur ce proxy entraînent l’envoi de requêtes à l’acteur avec cet ID.

applicationName - Nom de l’application Service Fabric qui contient le service d’acteur hébergeant les objets d’acteur. Ce paramètre peut être null si le client s’exécute dans le cadre de cette même application Service Fabric. Pour plus d'informations, consultez la section Notes.

serviceName - Nom du service Service Fabric tel que configuré par ActorServiceAttribute sur l’implémentation de l’acteur. Par défaut, le nom du service est dérivé du nom de l’interface d’acteur. Toutefois ActorServiceAttribute , est requis lorsqu’un acteur implémente plusieurs interfaces d’acteur ou qu’une interface d’acteur dérive d’une autre interface d’acteur, car la détermination du serviceName ne peut pas être effectuée automatiquement.

listenerName - Par défaut, un service d’acteur n’a qu’un seul écouteur auquel les clients peuvent se connecter et communiquer avec eux. Toutefois, il est possible de configurer un service d’acteur avec plusieurs écouteurs, le paramètre listenerName spécifie le nom de l’écouteur auquel se connecter.

Retours:

Objet proxy d’acteur qui implémente ActorProxy et TActorInterface.

Exception:

URISyntaxException - Lève une exception lorsque le format d’URI non valide est passé en tant que applicationName

create

public static static T create(Class actorInterfaceType, ActorId actorId, URI serviceUri)

Crée un proxy vers l’objet acteur qui implémente une interface d’acteur.

Paramètres:

actorInterfaceType - Interface d’acteur implémentée par l’objet acteur distant. L’objet proxy retourné implémente cette interface.

actorId - ID d’acteur de l’objet acteur proxy. Les méthodes appelées sur ce proxy entraînent l’envoi de requêtes à l’acteur avec cet ID.

serviceUri - URI du service d’acteur

Retours:

Objet proxy d’acteur qui implémente ActorProxy et TActorInterface. Interface d’acteur implémentée par l’objet acteur distant. L’objet proxy retourné implémente cette interface.

create

public static static T create(Class actorInterfaceType, ActorId actorId, URI serviceUri, String listenerName)

Crée un proxy vers l’objet acteur qui implémente une interface d’acteur.

Paramètres:

actorInterfaceType - Interface d’acteur implémentée par l’objet acteur distant. L’objet proxy retourné implémente cette interface.

actorId - ID d’acteur de l’objet acteur proxy. Les méthodes appelées sur ce proxy entraînent l’envoi de requêtes à l’acteur avec cet ID.

serviceUri - URI du service d’acteur

listenerName - Par défaut, un service acteur n’a qu’un seul écouteur auquel les clients peuvent se connecter et communiquer avec. Toutefois, il est possible de configurer un service d’acteur avec plusieurs écouteurs, le paramètre listenerName spécifie le nom de l’écouteur auquel se connecter.

Retours:

Objet proxy d’acteur qui implémente ActorProxy et TActorInterface. Interface d’acteur implémentée par l’objet acteur distant. L’objet proxy retourné implémente cette interface.

createRequestMessageBody

protected Object createRequestMessageBody(Object requestMessageBodyValue)

Paramètres:

requestMessageBodyValue

deserializeMessage

protected Object deserializeMessage(byte[] msgBodyValue)

Paramètres:

msgBodyValue

getActorId

public ActorId getActorId()

Obtient ActorId associé à l’objet proxy.

Remplacements:

ActorProxyBase.getActorId()

Retours:

ActorId associé à l’objet proxy.

getActorServicePartitionClient

public ActorServicePartitionClientImpl getActorServicePartitionClient()

Obtient microsoft.servicefabric.actors.remoting.client.internal.ActorServicePartitionClientImpl que ce proxy utilise pour communiquer avec l’acteur.

Remplacements:

ActorProxyBase.getActorServicePartitionClient()

Retours:

microsoft.servicefabric.actors.remoting.client.internal.ActorServicePartitionClientImpl que ce proxy utilise pour communiquer avec l’acteur.

getDefaultProxyFactory

public static FabricActorProxyFactory getDefaultProxyFactory()

Obtient la fabrique de proxy d’acteur par défaut.

Retours:

Objet par défaut FabricActorProxyFactory .

getResponseMessageBodyValue

protected Object getResponseMessageBodyValue(Object responseMessageBody)

Paramètres:

responseMessageBody

initialize

public void initialize(ActorServicePartitionClientImpl actorServicePartitionClient)

Méthode permettant d’initialiser le proxy d’acteur instance Pour une utilisation interne uniquement.

Paramètres:

actorServicePartitionClient - instance d’ActorServicePartitionClientImpl

invoke

protected void invoke(int interfaceId, int methodId, byte[] requestMsgBodyBytes)

Paramètres:

interfaceId

methodId

requestMsgBodyBytes

invokeAsync

protected CompletableFuture invokeAsync(int interfaceId, int methodId, byte[] requestMsgBodyBytes, CancellationToken cancellationToken)

Paramètres:

interfaceId

methodId

requestMsgBodyBytes

cancellationToken

serializeMessage

protected byte [] serializeMessage(Object msgBodyValue)

Paramètres:

msgBodyValue