qualifiedTypeName()

Die Systemfunktion 'javaLib.qualifiedTypeName()' gibt den vollständig qualifizierten Namen der Klasse eines Objekts im EGL-Java™-Objektbereich zurück.

Weitere Informationen zum EGL-Java-Objektbereich, in dem 'javaLib.qualifiedTypeName()' und ähnliche Funktionen ausgeführt werden, finden Sie im Abschnitt Java-Zugriffsfunktionen. EGL verwaltet diese Methode für Java-Zugriff zwecks Kompatibilität mit früheren Versionen. Verwenden Sie für neuen Code die leistungsfähigere ExternalType-Syntax. Weitere Informationen finden Sie im Abschnitt ExternalType-Abschnitt.

Syntax

  javaLib.qualifiedTypeName(Kennung javaObjId in)
  returns (Ergebnis STRING)
Kennung
Eine von der Groß-/Kleinschreibung abhängige Kennung, die auf ein Objekt im Objektbereich verweist. Bei der Eingabe kann es sich um eine beliebige Variable oder einen beliebigen Ausdruck handeln, die/der mit dem Typ STRING zuordnungskompatibel ist und in den Java-Typ 'objID' umgesetzt wird, wie in einem späteren Beispiel gezeigt wird. EGL schneidet Einzel- und Doppelbyteleerzeichen am Anfang und Ende des Argumentwertes ab.
Ergebnis
Wenn Sie den Rückgabewert zu einer Variablen zuordnen, muss diese Variable mit dem Typ STRING zuordnungskompatibel sein.

Beispiel

Im folgenden Beispiel wird der Klassenname zurückgegeben, der der angegebenen ID zugeordnet ist:

  myClassName = javaLib.qualifiedTypeName("myId" as "objID:java");

Hinweise zu Fehlern

Ist die Programmeigenschaft 'v60ExceptionCompatibility' nicht oder auf NO gesetzt, führt eine Ausnahmebedingung dazu, dass EGL eine Ausnahmebedingung vom Typ 'JavaObjectException' auslöst. Andere Fehler führen dazu, dass EGL eine Ausnahmebedingung vom Typ 'RuntimeException' auslöst.

Ist die Programmeigenschaft 'v60ExceptionCompatibility' auf YES gesetzt, kann ein Fehler während der Verarbeitung von 'javaLib.qualifiedTypeName()' dazu führen, dass 'sysVar.errorCode' auf einen in der nächsten Tabelle aufgeführten Wert gesetzt wird.

Tabelle 1. Fehlercodes für 'qualifiedTypeName()'
Wert in 'sysVar.errorCode' Beschreibung
00001001 Das Objekt weist einen Nullwert auf, oder die angegebene Kennung ist nicht im Objektbereich vorhanden.

Feedback