Propriétés propres aux fabriques de connexions JMS

Les propriétés supplémentaires suivantes sont disponibles pour une fabrique de connexions JMS.

ClientId

Spécifie un ID client si la fabrique de connexions est destinée à être utilisée par un abonné durable.

AddressList

Indique les noms (et éventuellement les numéros de port) des instances de broker de message avec lesquelles les applications vont communiquer. Chaque adresse de la liste indique le nom d'hôte (et éventuellement le port de l'hôte et le service de connexion) pour la connexion. Par exemple, la valeur peut être earth ou earth:7677. Spécifiez le numéro de port si le broker de message est exécuté sur un autre port que le port par défaut (7676). Si les paramètres de propriété spécifient plusieurs hôtes et plusieurs ports dans un environnement inclus dans un cluster, le premier hôte disponible dans la liste est utilisé, à moins que la valeur de la propriété AddressListBehavior ne soit RANDOM.

Pour plus d'informations, reportez-vous au manuel Message Queue Developer's Guide for Java Clients.

La valeur par défaut est l'hôte local et le numéro de port par défaut (7676). Le client tentera de se connecter à un broker sur le port 7676 de l'hôte local.

UserName

Nom utilisateur de la fabrique de connexions.

La valeur par défaut est guest.

Password

Mot de passe de la fabrique de connexions.

La valeur par défaut est guest.

ReconnectEnabled

Si cette propriété a la valeur true, indique que le programme client tente de se reconnecter à un serveur de messagerie (ou à la liste d'adresses indiquée dans AddressList) en cas de perte de connexion.

La valeur par défaut est true.

ReconnectAttempts

Définit le nombre de tentatives de connexion (ou de reconnexion) pour chaque adresse indiquée dans AddressList avant que le programme client ne passe à l'adresse suivante dans la liste. La valeur -1 indique que le nombre de tentatives de reconnexion est illimité (le programme client tentera de se connecter à la première adresse jusqu'à ce qu'il y parvienne).

La valeur par défaut est 3.

ReconnectInterval

Spécifie l'intervalle, en millisecondes, entre les tentatives de reconnexion. Cet intervalle s'applique aux tentatives sur chaque adresse indiquée dans AddressList, ainsi qu'aux adresses successives dans la liste. Si l'intervalle est trop court, le broker n'a pas le temps de récupérer. S'il est trop long, le délai de reconnexion peut être inacceptable.

La valeur par défaut est 30 000.

AddressListBehavior

Indique si les tentatives de connexion doivent suivre l'ordre des adresses indiquées dans l'attribut AddressList (PRIORITY) ou un ordre aléatoire (RANDOM).

RANDOM signifie que le processus de reconnexion choisit une adresse au hasard dans AddressList. Si un grand nombre de clients sont susceptibles de se connecter en utilisant la même fabrique de connexions, cette valeur les empêche d'être tous connectés à la même adresse.

PRIORITY signifie que le processus de reconnexion tentera toujours de se connecter à la première adresse de serveur dans AddressList et n'utilisera une autre adresse que si le premier broker n'est pas disponible.

La valeur par défaut est RANDOM.

AddressListIterations

Indique le nombre d'itérations du programme client dans AddressList pour établir (ou rétablir) une connexion. La valeur -1 indique que le nombre de tentatives est illimité.

La valeur par défaut est 3. La valeur maximale est 2 147 483 647.