API java : ActivationSystem


java.rmi.activation
Interface ActivationSystem

All Superinterfaces:
Remote

public interface ActivationSystem
extends Remote

The ActivationSystem provides a means for registering groups and "activatable" objects to be activated within those groups. The ActivationSystem works closely with the Activator, which activates objects registered via the ActivationSystem, and the ActivationMonitor, which obtains information about active and inactive objects, and inactive groups.

Since:
1.2
See Also:
Activator, ActivationMonitor

Field Summary
static int SYSTEM_PORT
          The port to lookup the activation system.
 
Method Summary
 ActivationMonitor activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation)
          Callback to inform activation system that group is now active.
 ActivationDesc getActivationDesc(ActivationID id)
          Returns the activation descriptor, for the object with the activation identifier, id.
 ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
          Returns the activation group descriptor, for the group with the activation group identifier, id.
 ActivationGroupID registerGroup(ActivationGroupDesc desc)
          Register the activation group.
 ActivationID registerObject(ActivationDesc desc)
          The registerObject method is used to register an activation descriptor, desc, and obtain an activation identifier for a activatable remote object.
 ActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc)
          Set the activation descriptor, desc for the object with the activation identifier, id.
 ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)
          Set the activation group descriptor, desc for the object with the activation group identifier, id.
 void shutdown()
          Shutdown the activation system.
 void unregisterGroup(ActivationGroupID id)
          Remove the activation group.
 void unregisterObject(ActivationID id)
          Remove the activation id and associated descriptor previously registered with the ActivationSystem; the object can no longer be activated via the object's activation id.
 

Field Detail

SYSTEM_PORT

static final int SYSTEM_PORT
The port to lookup the activation system.

See Also:
Constant Field Values
Method Detail

registerObject

ActivationID registerObject(ActivationDesc desc)
                            throws ActivationException,
                                   UnknownGroupException,
                                   RemoteException
The registerObject method is used to register an activation descriptor, desc, and obtain an activation identifier for a activatable remote object. The ActivationSystem creates an ActivationID (a activation identifier) for the object specified by the descriptor, desc, and records, in stable storage, the activation descriptor and its associated identifier for later use. When the Activator receives an activate request for a specific identifier, it looks up the activation descriptor (registered previously) for the specified identifier and uses that information to activate the object.

Parameters:
desc - the object's activation descriptor
Returns:
the activation id that can be used to activate the object
Throws:
ActivationException - if registration fails (e.g., database update failure, etc).
UnknownGroupException - if group referred to in desc is not registered with this system
RemoteException - if remote call fails
Since:
1.2

unregisterObject

void unregisterObject(ActivationID id)
                      throws ActivationException,
                             UnknownObjectException,
                             RemoteException
Remove the activation id and associated descriptor previously registered with the ActivationSystem; the object can no longer be activated via the object's activation id.

Parameters:
id - the object's activation id (from previous registration)
Throws:
ActivationException - if unregister fails (e.g., database update failure, etc).
UnknownObjectException - if object is unknown (not registered)
RemoteException - if remote call fails
Since:
1.2

registerGroup

ActivationGroupID registerGroup(ActivationGroupDesc desc)
                                throws ActivationException,
                                       RemoteException
Register the activation group. An activation group must be registered with the ActivationSystem before objects can be registered within that group.

Parameters:
desc - the group's descriptor
Returns:
an identifier for the group
Throws:
ActivationException - if group registration fails
RemoteException - if remote call fails
Since:
1.2

activeGroup

ActivationMonitor activeGroup(ActivationGroupID id,
                              ActivationInstantiator group,
                              long incarnation)
                              throws UnknownGroupException,
                                     ActivationException,
                                     RemoteException
Callback to inform activation system that group is now active. This call is made internally by the ActivationGroup.createGroup method to inform the ActivationSystem that the group is now active.

Parameters:
id - the activation group's identifier
group - the group's instantiator
incarnation - the group's incarnation number
Returns:
monitor for activation group
Throws:
UnknownGroupException - if group is not registered
ActivationException - if a group for the specified id is already active and that group is not equal to the specified group or that group has a different incarnation than the specified group
RemoteException - if remote call fails
Since:
1.2

unregisterGroup

void unregisterGroup(ActivationGroupID id)
                     throws ActivationException,
                            UnknownGroupException,
                            RemoteException
Remove the activation group. An activation group makes this call back to inform the activator that the group should be removed (destroyed). If this call completes successfully, objects can no longer be registered or activated within the group. All information of the group and its associated objects is removed from the system.

Parameters:
id - the activation group's identifier
Throws:
ActivationException - if unregister fails (e.g., database update failure, etc).
UnknownGroupException - if group is not registered
RemoteException - if remote call fails
Since:
1.2

shutdown

void shutdown()
              throws RemoteException
Shutdown the activation system. Destroys all groups spawned by the activation daemon and exits the activation daemon.

Throws:
RemoteException - if failed to contact/shutdown the activation daemon
Since:
1.2

setActivationDesc

ActivationDesc setActivationDesc(ActivationID id,
                                 ActivationDesc desc)
                                 throws ActivationException,
                                        UnknownObjectException,
                                        UnknownGroupException,
                                        RemoteException
Set the activation descriptor, desc for the object with the activation identifier, id. The change will take effect upon subsequent activation of the object.

Parameters:
id - the activation identifier for the activatable object
desc - the activation descriptor for the activatable object
Returns:
the previous value of the activation descriptor
Throws:
UnknownGroupException - the group associated with desc is not a registered group
UnknownObjectException - the activation id is not registered
ActivationException - for general failure (e.g., unable to update log)
RemoteException - if remote call fails
Since:
1.2
See Also:
getActivationDesc(java.rmi.activation.ActivationID)

setActivationGroupDesc

ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
                                           ActivationGroupDesc desc)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException
Set the activation group descriptor, desc for the object with the activation group identifier, id. The change will take effect upon subsequent activation of the group.

Parameters:
id - the activation group identifier for the activation group
desc - the activation group descriptor for the activation group
Returns:
the previous value of the activation group descriptor
Throws:
UnknownGroupException - the group associated with id is not a registered group
ActivationException - for general failure (e.g., unable to update log)
RemoteException - if remote call fails
Since:
1.2
See Also:
getActivationGroupDesc(java.rmi.activation.ActivationGroupID)

getActivationDesc

ActivationDesc getActivationDesc(ActivationID id)
                                 throws ActivationException,
                                        UnknownObjectException,
                                        RemoteException
Returns the activation descriptor, for the object with the activation identifier, id.

Parameters:
id - the activation identifier for the activatable object
Returns:
the activation descriptor
Throws:
UnknownObjectException - if id is not registered
ActivationException - for general failure
RemoteException - if remote call fails
Since:
1.2
See Also:
setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)

getActivationGroupDesc

ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException
Returns the activation group descriptor, for the group with the activation group identifier, id.

Parameters:
id - the activation group identifier for the group
Returns:
the activation group descriptor
Throws:
UnknownGroupException - if id is not registered
ActivationException - for general failure
RemoteException - if remote call fails
Since:
1.2
See Also:
setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)

Ces informations proviennent du site de http://java.sun.com

Remarques

Contenu

Le contenu de cette page provient du site de Sun, et est généré depuis un cache sur l'infobrol après certains traitements automatisés. La présentation peut donc différer du document original, mais le contenu aussi. Vous pouvez utiliser ce bouton pour afficher la page originale du site de Sun :

Quels sont les motivations de cette démarche?

Maintenir les pages en cache sur différents sites peut offrir plus de disponibilité.

Chaque page est indexée dans la base de donnée, ce qui permet de retrouver facilement les informations, au moyen des sommaires, du moteur de recherche interne, etc.

Des facilités sont mises en place pour que les membres de l'infobrol puissent effectuer des traductions en français des différents documents. Ceci devrait permettre aux débutants en programmation Java de consulter les API en français s'ils maîtrisent moins bien la langue de Shakespeare. Dans le cas où une traduction a été soumise, elle est disponible au moyen d'un lien en bas de page. Si la traduction a été validée, la page s'affiche par défaut en français, et un lien en bas de page permet d'atteindre la version en anglais.

Le code sur l'infobrol est automatiquement coloré selon la syntaxe, et les différents mots clés sont transformés en liens pour accéder rapidement aux informations.

Vous avez la possibilité de partager vos expériences en proposant vos propres extraits de code en utilisant le bouton "ajouter un commentaire" en bas de page. Si vous visitez simplement l'infobrol, vous avez déjà accès à cette fonction, mais si vous étes membre du brol, vous pouvez en plus utiliser des boutons supplémentaires de mise en forme, dont la coloration automatique de vos extraits de codes.

Réseaux sociaux

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

 

Nuage de mots clés

7 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

 

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html
Aucun commentaire pour cette page

© Ce document issu de l′infobrol est enregistré sous le certificat Cyber PrInterDeposit Digital Numbertection. Enregistrement IDDN n° 5329-2819
Document créé le 30/08/06 20:07, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http:///www.gaudry.be/java-api-rf-java/rmi/activation/ActivationSystem.html
St.Gaudry©07.01.02
Outils (masquer)
||
Recherche (afficher)
Recherche :

Utilisateur (masquer)
Apparence (afficher)
Stats (afficher)
15838 documents
455 astuces.
550 niouzes.
3107 definitions.
447 membres.
8121 messages.

Document genere en :
0,09 seconde

Mises à jour :
Mises à jour du site
Citation (masquer)
Aimer, c'est trouver, grâce à un autre, sa vérité et aider cet autre à trouver la sienne. C'est créer une complicité passionnée.

Jacques de Bourbon Busset
 
l'infobrol
Nous sommes le Mardi 23 Mai 2017, 10:43, toutes les heures sont au format GMT+1.00 Heure, heure d'été (+1)