DBEventParserFactory Utility

RepConnector provides a utility called DBEventParserFactory that you can use to extract both metadata and actual data from a single or grouped replication event.

Use the utility with the customized formatter to extract and format data before sending it to the destination. It can also be used by an end-user application that has received the XML representation of the event.

To obtain a parser instance, use:

DBEventParser=dbe=DBEventParserFactory.get EventParser (xmldoc or repevent)

• DBEventParser APIs
  Your customized formatter can use retrieved information to generate a new message in a customized format to send to the sender processor.
• package com.sybase.connector.repra.util; setSource(Object obj) throws Exception
  Sets the source event. Must be set prior to calling other methods that retrieve information. The obj that is passed to setSource is a repevent[] object or a string representation of the XML event.
• int size()
  Returns the number of operations in the transaction.
• String getDSName() throws Exception
  Returns the number of operations in the transaction.
• String setDBName() throws Exception
  Returns the database name defined for the connection.
• String getEventId() throws Exception
  Returns the unique event ID of this transaction.
• String getOperation(int elemAt)
  Returns the operation (insert, delete, update, or exec) at the position of elemAt. If there is only one element, use 0.
• String getSchemaName(int elemAt) throws Exception
  Returns the table name or the procedure name of the operation at the position of elemAt.
• String getStatement() throws Exception
  Returns the SQL statement of the entire transaction. If the transaction contains only one operation, this API returns only one statement. If there are multiple operations in the transaction, this API returns multiple statements separated by the newline character (“\n”).
• String setStatement(int elemAt) throws Exception
  Returns a single SQL statement belonging to the operation at the position of elemAt.
• String getOwner(int elemAt) throws Exception
  Returns the owner of the table or procedure used in this operation.
• Vector getData(int elemAt) throws Exception
  Returns a vector containing hash tables which represent the names, types, and values of the fields belonging to the operation at the position of elemAt. This method is meaningful only for insert, update, and stored procedure operations.
• Vector getKeys(int elemAt) throws Exception
  Returns a vector containing hash tables that represent the names, types, and values of the key field belonging to the operation at the position of elemAt. This method is meaningful only for update and delete operations.
• String getFieldName(Hashtable field) throws Exception
  Returns the field name of this column as a string value of DBEventParser.
• int getFieldType(Hashtable field) throws Exception
  Returns the field type of this column as an int value of DBEventParser.
• Object getFieldValue(Hashtable field) throws Exception
  Returns the field value of this column as an object.
• String toXMLText(String dtdURL) throws Exception
  Returns an XML text-type (a string) containing the events of the transaction.