com.ibm.etill.framework.eventmgr
Class EventListener

java.lang.Object
  |
  +--com.ibm.etill.framework.admin.AdminObject
        |
        +--com.ibm.etill.framework.eventmgr.EventListener
All Implemented Interfaces:
Archivable, EventConstants, PSServerAdminConstants, PSServerEventListenerConstants

public synchronized class EventListener
extends AdminObject
implements EventConstants, PSServerEventListenerConstants


Fields inherited from interface com.ibm.etill.framework.eventmgr.EventConstants
ACCOUNTNUMBER, BATCH_OBJECT, BATCHNUMBER, CASSETTE_EVENT, CASSETTENAME, COMPONENTNAME, CREDIT_OBJECT, CREDITNUMBER, CURRENTSTATE, DOWN, ENABLED, EVENTLISTENER, EVENTTYPE, FRAMEWORK, HOSTNAME, LISTENERURI, MERCHANT_EVENT, MERCHANTNUMBER, NETMGR_EVENT, OBJECTNAME, ORDER_OBJECT, ORDERDATA1, ORDERDATA2, ORDERDATA3, ORDERDATA4, ORDERDATA5, ORDERNUMBER, PAYMENT_OBJECT, PAYMENTNUMBER, PORTNUMBER, PREVIOUSSTATE, PRIMARYRC, SECONDARYRC, SEPARATOR, SOCKSHOST, SOCKSPORT, STATE_CHANGE_EVENT, STATUS, TIMEGENERATED, TIMEREGISTERED, TRANSACTIONID, UP
 
Fields inherited from interface com.ibm.etill.framework.xdm.PSServerEventListenerConstants
APPROXIMATE_XDM_OBJECT_SIZE, COL_CASSETTENAME, COL_EVENTTYPE, COL_LISTENERURL, COL_MERCHANTNUMBER, COL_SOCKSHOST, COL_SOCKSPORT, COL_TIMEREGISTERED, EVENTLISTENERTABLE
 
Fields inherited from interface com.ibm.etill.framework.xdm.PSServerAdminConstants
COL_ACTIVE, COL_ENABLED, COL_MESSAGESKEY, COL_PENDING, COL_VALID
 
Constructor Summary
EventListener(int, String, String, String, int, String, long)
           
 
Method Summary
static ReturnCodeStructure createObject(int, String, String, String, int, String)
           
 void createRecord(Connection)
          Creates a new record representing this object in a Commerce Payments database table.
static ReturnCodeStructure deleteObject(int, String, String, String)
           
 void deleteRecord(Connection)
          Deletes an existing or newly-created record representing this object from a database table.
 String getCassetteName()
           
 int getEventType()
           
 String getHostName()
           
 String getListenerURI()
           
 String getListenerURL()
           
 String getMerchantNumber()
           
 int getPortNumber()
           
 String getSocksHost()
           
 int getSocksPort()
           
 long getTimeRegistered()
           
static ReturnCodeStructure modifyObject(int, String, String, String, Boolean)
           
static EventListener obtainObject(int, String, String, String)
           
static void removeObject(int, String, String, String)
           
static void retrieveListeners()
           
 void startObject()
          Implemented by subclasses to start this AdminObject.
 void stopObject()
          Implemented by subclasses to stop this AdminObject.
 String toString()
          Implemented by subclasses to format this AdminObject for tracing purposes.
 void updateRecord(Connection)
          Updates an existing or newly-created record representing this object in a Payment Server database table.
 
Methods inherited from class com.ibm.etill.framework.admin.AdminObject
addCassetteMessage, addFrameworkMessage, getActive, getEnabled, getInvalidList, getPending, processConfigurationChanges, processExtension, setActive, setEnabled, setEnabled, setPending, validateExtension
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

EventListener

public EventListener(int,
                     String,
                     String,
                     String,
                     int,
                     String,
                     long)
Method Detail

startObject

public void startObject()
                 throws ETillRuntimeException
Description copied from class: AdminObject
Implemented by subclasses to start this AdminObject. The Framework calls this method as required.
Overrides:
startObject in class AdminObject
Following copied from class: com.ibm.etill.framework.admin.AdminObject
Throws:
ETillAbortOperation - thrown if the object cannot be started.

stopObject

public void stopObject()
                throws ETillRuntimeException
Description copied from class: AdminObject
Implemented by subclasses to stop this AdminObject. The Framework calls this method as required.
Overrides:
stopObject in class AdminObject
Following copied from class: com.ibm.etill.framework.admin.AdminObject
Throws:
ETillAbortOperation - thrown if the object cannot be stopped.

createObject

public static ReturnCodeStructure createObject(int,
                                               String,
                                               String,
                                               String,
                                               int,
                                               String)
                                        throws ETillAbortOperation

modifyObject

public static ReturnCodeStructure modifyObject(int,
                                               String,
                                               String,
                                               String,
                                               Boolean)
                                        throws ETillAbortOperation

deleteObject

public static ReturnCodeStructure deleteObject(int,
                                               String,
                                               String,
                                               String)
                                        throws ETillAbortOperation

obtainObject

public static EventListener obtainObject(int,
                                         String,
                                         String,
                                         String)

removeObject

public static void removeObject(int,
                                String,
                                String,
                                String)
                         throws ETillAbortOperation

retrieveListeners

public static void retrieveListeners()
                              throws ETillInitException

createRecord

public void createRecord(Connection)
                  throws ETillAbortOperation
Description copied from interface: Archivable
Creates a new record representing this object in a Commerce Payments database table. The CommitPoint object calls this method during commit processing when this Archivable object is a member of the CommitPoint create list. This method should never be called directly from cassettes.

The implementation of this method determines which table is used and which data members from the object are to be stored into the table.

Following copied from interface: com.ibm.etill.framework.archive.Archivable
Parameters:
Connection - The JDBC Connection object used to access the database.
Throws:
ETillAbortOperation - Thrown if an SQLException is caught.

updateRecord

public void updateRecord(Connection)
                  throws ETillAbortOperation
Description copied from interface: Archivable
Updates an existing or newly-created record representing this object in a Payment Server database table. The CommitPoint object calls this method during commit processing when this Archivable object is a member of the CommitPoint update list. This method should never be called directly from cassettes.

If the Archivable object's record is being created within the same CommitPoint as this update, the CommitPoint object will ensure that the update is applied after the record has been created. The implementation of this method determines which fields in the record will be updated.

Following copied from interface: com.ibm.etill.framework.archive.Archivable
Parameters:
Connection - The JDBC Connection object used to access the database.
Throws:
ETillAbortOperation - Thrown if an SQLException is caught.

deleteRecord

public void deleteRecord(Connection)
                  throws ETillAbortOperation
Description copied from interface: Archivable
Deletes an existing or newly-created record representing this object from a database table. The CommitPoint object calls this method during commit processing when this Archivable object is a member of the CommitPoint delete list. This method should never be called directly from cassettes.

If the Archivable object's record is being created within the same CommitPoint as this deletion, the CommitPoint object will simply remove all operations on this record before committing the changes.

Following copied from interface: com.ibm.etill.framework.archive.Archivable
Parameters:
Connection - The JDBC Connection object used to access the database.
Throws:
ETillAbortOperation - Thrown if an SQLException is caught.

getEventType

public int getEventType()

getMerchantNumber

public String getMerchantNumber()

getListenerURI

public String getListenerURI()

getListenerURL

public String getListenerURL()

getHostName

public String getHostName()

getPortNumber

public int getPortNumber()

getSocksHost

public String getSocksHost()

getSocksPort

public int getSocksPort()

getTimeRegistered

public long getTimeRegistered()

getCassetteName

public String getCassetteName()

toString

public String toString()
Description copied from class: AdminObject
Implemented by subclasses to format this AdminObject for tracing purposes.
Overrides:
toString in class AdminObject
Following copied from class: com.ibm.etill.framework.admin.AdminObject
Returns:
String - a string representation of the key elements of this AdminObject.