cpiNextParserClassName

Zweck

Optionale Funktion, die den Namen der nächsten Parser-Klasse in der Kette zurückgibt, falls vorhanden. Der Parser kann mit dieser Funktion den Namen der Parser-Klasse, die den nächsten Abschnitt oder den Rest des Nachrichteninhalts verarbeitet, an den Broker zurückgeben. Normalerweise ist für Nachrichten mit einem einfachen Formattyp nur ein Parser für den Nachrichteninhalt vorhanden, so dass diese Funktion nicht erforderlich ist. Bei Nachrichten mit einem komplexeren Formattyp und mehreren Nachrichtenparsern sollte jeder Parser den nächsten Parser in der Kette identifizieren, indem er seinen Namen im Parameter buffer zurückgibt. Der letzte Parser in der Kette muss eine leere Zeichenfolge zurückgeben.

Wenn Sie den Namen eines Parsers angeben, der im Lieferumfang von WebSphere Message Broker enthalten ist, müssen Sie den richtigen Klassennamen des Parsers verwenden.

Definiert in Typ Mitglied
CPI_VFT Optional iFpNextParserClassName

Syntax

void cpiNextParserClassName(
CciParser*   parser,
CciContext*  context,
CciChar*     buffer,
int          size);

Parameter

parser
Die Adresse des Parserobjekts (Eingabe).
context
Die Adresse des Kontextes des Parserobjekts (Eingabe).
buffer
Die Adresse eines Puffers, in dem der Parser-Klassenname gespeichert werden soll (Eingabe).
size
Die Länge (in Byte) des vom Broker bereitgestellten Puffers.

Rückgabewerte

Keine.

Beispiel

Dieses Beispiel wurde aus der Parser-Beispieldatei 'BipSampPluginParser.c' entnommen (Zeile 732 bis 756).

void cpiNextParserClassName(
CciParser*  parser,
CciContext* context,
CciChar*    buffer,
int         size
){
PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
int                rc = 0;
if (pc->trace) {
fprintf(pc->tracefile, "PLUGIN: -> cpiNextParserClassName() parser=0x%x context=0x%x\n",
parser, context);
fflush(pc->tracefile);
}
/* Copy the name to the broker */
CciCharNCpy(buffer, pc->iNextParserClassName, size);
if (pc->trace) {
fprintf(pc->tracefile, "PLUGIN: <- cpiNextParserClassName()\n");
fflush(pc->tracefile);
}
return;
}
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiNextParserCodedCharSetId
cpiNextParserEncoding
C-Parser-Implementierungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08120_