AMETAS.place
Class AMETASPURepository

java.lang.Object
  AMETAS.place.AMETASPURepository

All Implemented Interfaces:

java.io.Serializable

public class AMETASPURepository

extends java.lang.Object

implements java.io.Serializable

Speichert Typbeschreibungen von Stellennutzern. Die permanente Registrierung ist gedacht, um Stellennutzer zu registrieren, die an dieser Stelle gestartet werden können. Dies sind Dienste und Benutzeradapter sowie hier installierte Agenten. Dazu zählen jedoch nicht die angekommenen Agenten. Daher wird eine zweite Tabelle verwendet, in der die gerade laufenden Stellennutzer stehen. Typvermittler, die nach einer Instanzvermittlung gefragt werden, werden die Abfragen zur temporären Registrierung benötigen; bei einer Typvermittlung können beide Tabellen von Interesse sein. Indes sind lediglich die Einträge der permanenten Registrierung für Neuinstantiierungen von Interesse.

See Also:

Serialized Form

Field Summary

static long	NOTIMEOUT Konstante, die angibt, dass der Eintrag nicht verworfen werden soll.
static long	STILLHERE Konstante, die angibt, dass der Stellennutzer noch hier ist.

Method Summary

java.lang.String	getAlias(java.lang.String sName) Gibt den Aliasnamen des angegebenen registrierten Stellennutzers zurück.
java.lang.String	getDescription(java.lang.String sName) Gibt die Beschreibung des angegebenen registrierten Stellennutzers zurück.
java.lang.String[]	getPUList() Liefert eine Liste der registrierten Agenten und Benutzeradapter.
java.util.Enumeration	getRunningPUs() Liefert eine Aufzählung aller gerade laufenden PUs.
java.util.Vector	getServiceParams(java.lang.String sServiceName) Liefert die Parameter für einen Dienst.
AMETASIdentityID	getStarterID(AMETASPlaceUserID puid) Liefert den Starter zum durch die ID angegebenen Stellennutzer.
java.lang.String[]	getStartupServices() Liefert die Dienste, die zu Beginn gleich gestartet werden sollen.
AMETASType[]	getTypes(AMETASPlaceUserID puid) Liefert die Typbeschreibung des angegebenen PUs.
AMETASType[]	getTypes(java.lang.String sName) Liefert die Typen des registrierten Stellennutzers.
void	registerLocalPU(java.lang.String sName, java.lang.String sAlias, AMETASType type, java.lang.String sVerbalDescription, boolean bPublic) Registrieren eines Eintrags mit Typbeschreibung.
void	registerService(java.lang.String sName, java.lang.String sAlias, java.util.Vector vctParams, AMETASType[] aType, boolean bStartup, java.lang.String sOtherIdy, java.lang.String sOtherPassphrase) Registrieren eines Eintrags für einen Dienst mit Typbeschreibung.
void	unregisterLocalPU(java.lang.String sName) Deregistrieren von Einträgen.
void	unregisterService(java.lang.String sName) Deregistrieren von Einträgen.

Methods inherited from class java.lang.Object

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

Field Detail

NOTIMEOUT

public static final long NOTIMEOUT

Konstante, die angibt, dass der Eintrag nicht verworfen werden soll.

See Also:

Constant Field Values

STILLHERE

public static final long STILLHERE

Konstante, die angibt, dass der Stellennutzer noch hier ist.

See Also:

Constant Field Values

Method Detail

registerLocalPU

public void registerLocalPU(java.lang.String sName,
                            java.lang.String sAlias,
                            AMETASType type,
                            java.lang.String sVerbalDescription,
                            boolean bPublic)

Registrieren eines Eintrags mit Typbeschreibung. Hiermit können auch bisherige Einträge modifiziert werden. Diese Methode ist Diensten zugänglich.

Parameters:

sName - SPU-/Klassenname des Stellennutzers (inklusive Parametrisierung)

sAlias - Aliasname des Stellennutzers (auch "echter Name")

type - Typbeschreibung des Stellennutzers

sVerbalDescription - Verbale Beschreibung des Stellennutzers.

bPublic - wenn true, wird der Eintrag jedem Nachfrager angezeigt (etwa in AMAI).

unregisterLocalPU

public void unregisterLocalPU(java.lang.String sName)

Deregistrieren von Einträgen. Diese Methode ist Diensten zugänglich.

Parameters:

sName - Name des Stellennutzers.

registerService

public void registerService(java.lang.String sName,
                            java.lang.String sAlias,
                            java.util.Vector vctParams,
                            AMETASType[] aType,
                            boolean bStartup,
                            java.lang.String sOtherIdy,
                            java.lang.String sOtherPassphrase)

Registrieren eines Eintrags für einen Dienst mit Typbeschreibung. Hiermit können auch bisherige Einträge modifiziert werden. Diese Methode sorgt dafür, dass die Parameterdatei neu geschrieben wird. Diese Methode ist Diensten zugänglich.

Parameters:

sName - SPU-/Klassenname des Stellennutzers (inklusive Parametrisierung)

sAlias - Aliasname des Stellennutzers (auch "echter Name")

vctParams - Parameter.

aType - Typbeschreibung des Stellennutzers

bStartup - wenn true, soll der Dienst beim nächsten Stellenstart automatisch gestartet werden.

sOtherIdy - Dateiname der Identität, die zum Neustart von Stellennutzern durch Dienste verwendet werden soll.

sOtherPassphrase - Mantra zum Signieren der neuen Stellennutzer.

unregisterService

public void unregisterService(java.lang.String sName)

Deregistrieren von Einträgen. Diese Methode ist Diensten zugänglich.

Parameters:

sName - Name des Stellennutzers.

getAlias

public java.lang.String getAlias(java.lang.String sName)
                          throws java.util.NoSuchElementException

Gibt den Aliasnamen des angegebenen registrierten Stellennutzers zurück. Diese Methode ist Diensten zugänglich.

Parameters:

sName - SPU-/Klassenname des Stellennutzers.

Returns:

Aliasname (auch "echter Name").

Throws:

java.util.NoSuchElementException - wenn es keine solche Registrierung gibt.

getDescription

public java.lang.String getDescription(java.lang.String sName)
                                throws java.util.NoSuchElementException

Gibt die Beschreibung des angegebenen registrierten Stellennutzers zurück. Diese Methode ist Diensten zugänglich.

Parameters:

sName - SPU-/Klassenname des Stellennutzers.

Returns:

Verbale Beschreibung.

Throws:

java.util.NoSuchElementException - wenn es keine solche Registrierung gibt.

getTypes

public AMETASType[] getTypes(java.lang.String sName)
                      throws java.util.NoSuchElementException

Liefert die Typen des registrierten Stellennutzers.

Parameters:

sName - SPU-/Klassenname des Stellennutzers.

Returns:

Typbeschreibung.

Throws:

java.util.NoSuchElementException - wenn es keine solche Registrierung gibt.

getServiceParams

public java.util.Vector getServiceParams(java.lang.String sServiceName)
                                  throws java.util.NoSuchElementException

Liefert die Parameter für einen Dienst. Diese Methode ist Diensten zugänglich.

Parameters:

sServiceName - Name des Dienstes (inklusive Parametersatzname)

Returns:

Parameter des angegebenen Parametersatzes oder null, wenn es keine Parameter gibt.

Throws:

java.util.NoSuchElementException - wenn es keine solche Registrierung gibt.

getStartupServices

public java.lang.String[] getStartupServices()

Liefert die Dienste, die zu Beginn gleich gestartet werden sollen. Diese Methode ist Diensten zugänglich.

Returns:

Liste der zu startenden Dienste.

getPUList

public java.lang.String[] getPUList()

Liefert eine Liste der registrierten Agenten und Benutzeradapter. Ausgenommen sind alle Stellennutzer, die nicht öffentlich registriert wurden. Diese Methode ist Diensten zugänglich.

Returns:

Liste der registrierten Stellennutzer.

getRunningPUs

public java.util.Enumeration getRunningPUs()

Liefert eine Aufzählung aller gerade laufenden PUs. Gerade laufend ist mit Vorbehalt zu verstehen; es können natürlich auch gerade abgereiste Agenten sein. Jedoch ist dann in der Regel die Beschreibung noch eine Weile vorhanden. Wer zu lange wartet, hat Pech. Diese Methode ist Diensten zugänglich.

Returns:

Aufzählung aller laufenden Stellennutzer.

getStarterID

public AMETASIdentityID getStarterID(AMETASPlaceUserID puid)
                              throws java.util.NoSuchElementException

Liefert den Starter zum durch die ID angegebenen Stellennutzer.

Parameters:

puid - ID des betreffenden Stellennutzers.

Returns:

Identitäts-ID des Starters.

Throws:

java.util.NoSuchElementException - wenn der Stellennutzer hier nie gelaufen oder die Verfallszeit schon vergangen ist.

getTypes

public AMETASType[] getTypes(AMETASPlaceUserID puid)
                      throws java.util.NoSuchElementException

Liefert die Typbeschreibung des angegebenen PUs.

Parameters:

puid - ID des betreffenden Stellennutzers.

Returns:

Typbeschreibung des Stellennutzers.

Throws:

java.util.NoSuchElementException - wenn der Stellennutzer hier nie gelaufen oder die Verfallszeit schon vergangen ist.