cpiNextParserClassName

Zweck

Optionale Funktion zur Ausgabe des Namens der nächsten Parserklasse in der Kette (falls vorhanden). Sie ermöglicht dem Parser die Rückgabe des Namens der Parserklasse an den Broker, die den nächsten Abschnitt oder Rest des Nachrichteninhalts handhabt. Normalerweise gibt es bei Nachrichten mit einfachem Formattyp nur ein einziger Nachrichteninhaltparser; es ist dann nicht erforderlich, diese Funktion zu nutzen. Bei Nachrichten mit einem komplexeren Formattyp und mehreren Nachrichtenparsern sollte jeder Parser den nächsten in der Kette identifizieren, indem der Name im Parameter buffer ausgegeben wird. Der letzte Parser in der Kette muss eine leere Zeichenfolge ausgeben.

Wenn Sie den Namen eines Parsers angeben, der mit WebSphere Message Broker bereitgestellt wird, müssen Sie den korrekten Klassennamen 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 den der Klassenname des Parsers gespeichert werden sollte (Eingabe).
size
Die Länge (in Byte) des Puffers, der vom Broker bereitgestellt wird (Eingabe).

Rückgabewerte

Keine.

Beispielprogramm

Dieses Beispiel stammt aus der Beispiel-Parserdatei 'BipSampPluginParser.c' (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);
  }

  /* Namen in den Broker kopieren */
  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: 23. Aug. 2006
as08120_