SOMA.naming.place
Class PlaceNameService

java.lang.Object
  |
  +--SOMA.naming.place.PlaceNameService

public class PlaceNameService
extends java.lang.Object

Servizio di nomi di place, PNS.

Il servizio realizza la metafora di una tabella in cui vengono memorizzate le PlaceInfo. La chiave di ricerca e' di tipo PlaceID, identificatore del place.

Affinche' un place entri a far parte di un dominio e' necessario che il PNS del place si registri presso il PNS del default place del dominio.

In ogni momento il PNS puo' richiedere l'aggiornamento della tabella dei place del dominio sia al default place, sia a un place qualsiasi, ove questo sia necessario.

Author:
Livio Profiri
See Also:
PNSExplorerItem, DomainNameService

Constructor Summary
PlaceNameService(Environment env)
          Costruttore.
 
Method Summary
 PlaceInfo getPlace(PlaceID placeID)
          Restituisce la PlaceInfo corrispondente a placeID, o null se non trovata.
 void listPlaces(java.io.PrintStream out)
          Stampa la lista di tutti i place del dominio su out.
 PlaceInfo putPlace(PlaceInfo newPlaceInfo)
          Inserisce una PlaceInfo.
 boolean refresh()
          Richiesta di refresh della tabella al PNS del default place.
 boolean refresh(java.net.InetAddress host, int port)
          Richiesta di refresh della tabella al PNS di un place qualsiasi.
 boolean register(java.net.InetAddress host, int port)
          Registrazione presso il PNS del default place del dominio.
 PlaceInfo removePlace(PlaceID aPlaceID)
          Elimina la placeInfo corrispondente a aPlaceID.
 void sendToAllPlaces(Command command)
          Spedisce un comando a tutti i place della tabella.
 void sendToAllPlaces(Command command, PlaceID DontSendMe)
          Spedisce un comando a tutti i place della tabella, escluso il place DontSendMe.
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PlaceNameService

public PlaceNameService(Environment env)
Costruttore.
Parameters:
env - L'environment del place.
Method Detail

getPlace

public PlaceInfo getPlace(PlaceID placeID)
Restituisce la PlaceInfo corrispondente a placeID, o null se non trovata.

putPlace

public PlaceInfo putPlace(PlaceInfo newPlaceInfo)
Inserisce una PlaceInfo.

Se e' un default place e PlaceInfo e' nuova, aggiorna gli altri place.

Returns:
Il vecchio valore memorizzato o null se si tratta di un nuovo place.

removePlace

public PlaceInfo removePlace(PlaceID aPlaceID)
Elimina la placeInfo corrispondente a aPlaceID.

Se e' un default place e aPlaceID e' presente, aggiorna gli altri place.

Returns:
Il vecchio valore memorizzato o null se si tratta di un nuovo place.

listPlaces

public void listPlaces(java.io.PrintStream out)
Stampa la lista di tutti i place del dominio su out.

register

public boolean register(java.net.InetAddress host,
                        int port)
Registrazione presso il PNS del default place del dominio.

Viene inviato un PlaceRegisterCommand al default place, individuato dalla coppia host:port.


refresh

public boolean refresh()
Richiesta di refresh della tabella al PNS del default place.

Viene inviato un PlaceRefreshCommand.Request al PNS del default place.


refresh

public boolean refresh(java.net.InetAddress host,
                       int port)
Richiesta di refresh della tabella al PNS di un place qualsiasi.

Viene inviato un PlaceRefreshCommand.Request al PNS del place individuato dalla coppiahost:port.


sendToAllPlaces

public void sendToAllPlaces(Command command)
Spedisce un comando a tutti i place della tabella.

sendToAllPlaces

public void sendToAllPlaces(Command command,
                            PlaceID DontSendMe)
Spedisce un comando a tutti i place della tabella, escluso il place DontSendMe.

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object