Antes de comenzar
Más abajo se describe cada tipo de función.
El intermediario invocará la función de entrada cuando el analizador definido por el usuario debe analizar un mensaje de entrada. El analizador debe indicar al intermediario qué cantidad de almacenamiento intermedio de corriente de bits de entrada reclama como propietario. En el caso de una cabecera de tamaño fijo, el analizador reclama el tamaño de la cabecera. Si el analizador está destinado a manejar el mensaje completo, reclama el resto del almacenamiento intermedio.
int cpiParseBufferEncoded( CciParser* parser, CciContext* context, int encoding, int ccsid ){ PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ; int rc;
pc->iBuffer = (void *)cpiBufferPointer(&rc, parser); pc->iIndex = 0;
pc->iEncoding = encoding; pc->iCcsid = ccsid;
pc->iSize = cpiBufferSize(&rc, parser);
pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex);
pc->iCurrentElement = cpiRootElement(&rc, parser);
pc->iInTag = 0;
return(pc->iSize); }
Las funciones de análisis generales, por ejemplo, cpiParseFirstChild son las que invoca el intermediario cuando se ha de crear el árbol de elementos de sintaxis para poder evaluar una expresión ESQL o Java. Por ejemplo, un nodo de filtro utiliza una referencia de campo ESQL en una expresión ESQL. Esta referencia de campo se debe resolver a fin de evaluar la expresión. Se invoca la función de análisis general del analizador, quizá repetidamente, hasta que el elemento solicitado se crea o hasta que el analizador reconoce que dicho elemento no existe.
void cpiParseFirstChild( CciParser* parser, CciContext* context, CciElement* element ){ PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ; int rc; if ((!cpiElementCompleteNext(&rc, element)) && (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME)) { while ((!cpiElementCompleteNext(&rc, element)) && (!cpiFirstChild(&rc, element)) && (pc->iCurrentElement)) { pc->iCurrentElement = parseNextItem(parser, context, pc->iCurrentElement); } } return; }
El intermediario invocará la función de salida cuando el analizador definido por el usuario debe serializar un árbol de elementos de sintaxis en una corriente de bits de salida. Por ejemplo, es posible que un nodo Compute haya creado un árbol en el dominio del analizador definido por el usuario. Cuando este árbol necesite que, por ejemplo, un nodo MQOutput lo produzca como salida, el analizador será responsable de añadir el almacenamiento intermedio de corriente de bits de salida con los datos que representan el árbol que se ha creado.
int cpiWriteBufferEncoded( CciParser* parser, CciContext* context, int encoding, int ccsid ){ PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ; int initialSize = 0; int rc = 0; const void* a; CciByte b; initialSize = cpiBufferSize(&rc, parser); a = cpiBufferPointer(&rc, parser); b = cpiBufferByte(&rc, parser, 0); cpiAppendToBuffer(&rc, parser, (char *)"Algunos datos de prueba", 14); return cpiBufferSize(0, parser) - initialSize; }
Normalmente, dado que los datos de mensaje de entrada tienen un solo formato de mensaje, un analizador es responsable de analizar el contenido entero del mensaje. El nombre de clase del analizador que se necesita se define en el campo Formato del MQMD o de la cabecera MQRFH2 del mensaje de entrada.
Sin embargo, es posible que el mensaje conste de varios formatos, donde, por ejemplo, hay una cabecera en un formato seguida de datos en otro formato. En este caso, el primer analizador tiene que identificar el nombre de clase del analizador que es responsable del siguiente formato de la cadena, y así sucesivamente. En un analizador definido por el usuario, el intermediario invoca la función de implementación cpiNextParserClassName cuando necesita navegar hacia abajo en una cadena de clases de analizador para un mensaje que contiene varios formatos de mensaje.
Si el analizador definido por el usuario soporta el análisis de un formato de mensaje que forma parte de un formato de mensaje múltiple, el analizador definido por el usuario debe implementar la función cpiNextParserClassName.
void cpiNextParserClassName( CciParser* parser, CciContext* context, CciChar* buffer, int size ){ PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ; int rc = 0;
CciCharNCpy(buffer, pc->iNextParserClassName, size); return; }