cds.aladin
Class PlasticManager

java.lang.Object
  cds.aladin.PlasticManager

All Implemented Interfaces:

AppMessagingInterface

public class PlasticManager
extends java.lang.Object
implements AppMessagingInterface

Classe gérant toutes les connexions avec le hub PLASTIC (PLatform for AStronomical Tools InterCommunication) Cette classe se charge de la connexion avec le hub, et permet d'envoyer des messages au hub Le fait de faire passer tout ce qui est relatif à PLASTIC par une classe dédiée permet de passer relativement facilement d'une implémentation du protocole à une autre Les classes modifiées ou créées pour supporter PLASTIC sont les suivantes (package cds.aladin) : - Aladin : l'ajout des fonctionnalités PLASTIC est subordonné à la variable Aladin.PLASTIC_SUPPORT, qui pour le moment prend la valeur de Aladin.PROTO --> ajout d'un menu PLASTIC (variable MPLASTIC) permettant de s'inscrire/désinscrire auprès du hub (dans sous-menu SMPLASTIC) --> modif. dans méthode quit() : on se désincrit du hub avant de quitter l'appli --> modif. dans suiteInit() : mise à jour de l'état des items du sous-menu PLASTIC --> modif dans action(Event,Object) : gestion des évts inscription/désinscription --> ajout de la méthode setPlasticButtonMode() --> ajout de la méthode broadcastSelectedPlanes - Calque : --> modif. de selectAllObjectInPlans() : envoi d'un message "showObjects" lors de la sélection de tous les objets d'un plan - Localisation : --> modif. de la méthode setPos(...) pour permettre l'envoi du message pointAtCoords (cette méthode est appelée dans ViewSimple.mouseUp(Event,int,int) - PlasticManager (cette classe) : implémente l'interface PlasticListener --> gère la registration/unregistration auprès du hub PLASTIC --> gère globalement l'envoi et la réception des messages PLASTIC On récupère le singleton de cette classe via la méthode statique getSingleton(Aladin) - Select : --> ajout d'items dans le popup pour permettre le broadcast de plans --> ajout des actions correspondant à ces items - View : --> ajout d'une méthode selectSourcesByRowNumber(PlanCatalog pc, int[] rowIdx) pour sélectionner des objets d'après leur numéro d'ordre dans leur plancatalog --> modif. de setMesure() pour envoyer le message "showObjects" lors de la sélection d'une ou plusieurs sources --> ajout de getSelectedSources() --> modif. de showSource(Source o) : ajout de l'envoi du message approprié - ViewSimple : --> petite modif dans mouseUp(Event,int,int)

Version:

0.75 Ajout du message MSG_HIGHLIGHT_OBJECT 0.7 Ajout des méthodes broadcastTable et broadcastImage. Les broadcast se font désormais sur demande, et plus automatiquement Broadcaste à tout le monde ou à une liste d'applications Les URLs broadcastés sont désormais correctes (conformes à la RFC 1738) 0.6 Support de tout hub PLASTIC conforme au standard. Plus de dépendance avec les librairies ACR 0.55 Le message MSG_SELECT_OBJECTS envoie un tableau d'int désormais. En réception, on garde le cas tableau de long "au cas où" 0.5 Ajout de messages (messages envoyés ET messages traités) 0.1 Creation, 02 Dec 2005

Author:

Thomas Boch [CDS]

See Also:

PLASTIC specification

Nested Class Summary

Nested classes/interfaces inherited from interface cds.aladin.AppMessagingInterface

AppMessagingInterface.AbstractMessage

Field Summary

Fields inherited from interface cds.aladin.AppMessagingInterface

ABSTRACT_MSG_LOAD_CHARAC_FROM_URL, ABSTRACT_MSG_LOAD_FITS, ABSTRACT_MSG_LOAD_SPECTRUM_FROM_URL, ABSTRACT_MSG_LOAD_VOT_FROM_URL, ICON_URL, NO_PLASTIC, PLASTIC_CAN_TRANSMIT, PLASTIC_CONNECTED_ALONE, PLASTIC_NOT_CONNECTED

Method Summary

boolean	broadcastImage(PlanImage pi, java.lang.String[] recipients) "Diffusion" du PlanCatalog à toutes les applications Plastic
boolean	broadcastTable(PlanCatalog pc, java.lang.String[] recipients) "Diffusion" du PlanCatalog à toutes les applications Plastic
java.lang.String[]	getAppsSupporting(AppMessagingInterface.AbstractMessage abstractMsg)
java.lang.Object	getAppWithName(java.lang.String s)
boolean	getPlasticTrace()
PlasticWidget	getPlasticWidget()
java.lang.String	getProtocolName()
boolean	internalHubRunning()
boolean	isRegistered()
java.lang.Object	perform(java.net.URI sender, java.net.URI message, java.util.List args) implémentation de l'interface PlasticListener
boolean	ping() ping the hub
void	pointAtCoords(double ra, double dec)
boolean	register(boolean silent, boolean launchHubIfNeeded) Register with the plastic hub
void	sendHighlightObjectsMsg(Source source) Envoie le message MSG_HIGHLIGHT_OBJECT au hub (si connecté)
void	sendMessageLoadCharac(java.lang.String url, java.lang.String name, java.util.List recipients)
void	sendMessageLoadImage(java.lang.String url, java.lang.String name, java.util.List recipients)
void	sendMessageLoadSpectrum(java.lang.String url, java.lang.String spectrumId, java.lang.String spectrumName, java.util.Map metadata, java.util.List recipients) si recipients==null --> broadcast
void	sendSelectObjectsMsg() Sends to the plastic hub the MSG_SELECT_OBJECTS message, with all currently selected sources
void	setPlasticTrace(boolean plasticTrace)
void	setPlasticWidget(PlasticWidget widget)
boolean	startInternalHub() lancement du hub PlasKit, en interne
void	stopInternalHub(boolean dontAsk)
void	trace(java.lang.String s)
boolean	unregister()
boolean	unregister(boolean force)
boolean	unregister(boolean force, boolean destroyInternalHub) Unregister from the plastic hub
void	updateState() met à jour l'état courant (connecté ou non, etc)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

register

public boolean register(boolean silent,
                        boolean launchHubIfNeeded)

Register with the plastic hub

Specified by:

register in interface AppMessagingInterface

Parameters:

launchHubIfNeeded - si silent==true, on essaye automatiquement de lancer un hub s'il n'en existe pas. Sinon, on passe par une boite de dialogue de confirmation

Returns:

true if Aladin was registered, false otherwise

unregister

public boolean unregister()

Specified by:

unregister in interface AppMessagingInterface

unregister

public boolean unregister(boolean force)

Specified by:

unregister in interface AppMessagingInterface

unregister

public boolean unregister(boolean force,
                          boolean destroyInternalHub)

Unregister from the plastic hub

Specified by:

unregister in interface AppMessagingInterface

Parameters:

force - on force la désinscription

Returns:

true if Aladin is unregistered, false otherwise

isRegistered

public boolean isRegistered()

Specified by:

isRegistered in interface AppMessagingInterface

startInternalHub

public boolean startInternalHub()

lancement du hub PlasKit, en interne

Specified by:

startInternalHub in interface AppMessagingInterface

Returns:

true si tout s'est bien passé, false sinon

stopInternalHub

public void stopInternalHub(boolean dontAsk)

Specified by:

stopInternalHub in interface AppMessagingInterface

getAppWithName

public java.lang.Object getAppWithName(java.lang.String s)

Specified by:

getAppWithName in interface AppMessagingInterface

sendMessageLoadImage

public void sendMessageLoadImage(java.lang.String url,
                                 java.lang.String name,
                                 java.util.List recipients)

Specified by:

sendMessageLoadImage in interface AppMessagingInterface

sendMessageLoadSpectrum

public void sendMessageLoadSpectrum(java.lang.String url,
                                    java.lang.String spectrumId,
                                    java.lang.String spectrumName,
                                    java.util.Map metadata,
                                    java.util.List recipients)

Description copied from interface: AppMessagingInterface

si recipients==null --> broadcast

Specified by:

sendMessageLoadSpectrum in interface AppMessagingInterface

sendMessageLoadCharac

public void sendMessageLoadCharac(java.lang.String url,
                                  java.lang.String name,
                                  java.util.List recipients)

Specified by:

sendMessageLoadCharac in interface AppMessagingInterface

getAppsSupporting

public java.lang.String[] getAppsSupporting(AppMessagingInterface.AbstractMessage abstractMsg)

Specified by:

getAppsSupporting in interface AppMessagingInterface

getProtocolName

public java.lang.String getProtocolName()

Specified by:

getProtocolName in interface AppMessagingInterface

ping

public boolean ping()

ping the hub

Specified by:

ping in interface AppMessagingInterface

broadcastTable

public boolean broadcastTable(PlanCatalog pc,
                              java.lang.String[] recipients)

"Diffusion" du PlanCatalog à toutes les applications Plastic

Specified by:

broadcastTable in interface AppMessagingInterface

Parameters:

pc - le PlanCatalog à broadcaster

recipients - tableau des destinataires. Si null, on envoie à tout le monde

broadcastImage

public boolean broadcastImage(PlanImage pi,
                              java.lang.String[] recipients)

"Diffusion" du PlanCatalog à toutes les applications Plastic

Specified by:

broadcastImage in interface AppMessagingInterface

Parameters:

pi - le PlanImage à broadcaster

recipients - tableau des destinataires. Si null, on envoie à tout le monde

sendSelectObjectsMsg

public void sendSelectObjectsMsg()

Sends to the plastic hub the MSG_SELECT_OBJECTS message, with all currently selected sources

Specified by:

sendSelectObjectsMsg in interface AppMessagingInterface

pointAtCoords

public void pointAtCoords(double ra,
                          double dec)

Specified by:

pointAtCoords in interface AppMessagingInterface

internalHubRunning

public boolean internalHubRunning()

Specified by:

internalHubRunning in interface AppMessagingInterface

updateState

public void updateState()

met à jour l'état courant (connecté ou non, etc)

Specified by:

updateState in interface AppMessagingInterface

sendHighlightObjectsMsg

public void sendHighlightObjectsMsg(Source source)

Envoie le message MSG_HIGHLIGHT_OBJECT au hub (si connecté)

Specified by:

sendHighlightObjectsMsg in interface AppMessagingInterface

Parameters:

source - la source à montrer

See Also:

View.showSource(Source)

setPlasticWidget

public void setPlasticWidget(PlasticWidget widget)

Specified by:

setPlasticWidget in interface AppMessagingInterface

getPlasticWidget

public PlasticWidget getPlasticWidget()

Specified by:

getPlasticWidget in interface AppMessagingInterface

perform

public java.lang.Object perform(java.net.URI sender,
                                java.net.URI message,
                                java.util.List args)

implémentation de l'interface PlasticListener

trace

public void trace(java.lang.String s)

Specified by:

trace in interface AppMessagingInterface

getPlasticTrace

public boolean getPlasticTrace()

Specified by:

getPlasticTrace in interface AppMessagingInterface

Returns:

Returns the plasticTrace.

setPlasticTrace

public void setPlasticTrace(boolean plasticTrace)

Specified by:

setPlasticTrace in interface AppMessagingInterface

Parameters:

plasticTrace - The plasticTrace to set.