public abstract class AbortableHSSFListener
Abstract class for use with the HSSFRequest and HSSFEventFactory, which
allows for the halting of processing.
Users should create subclass of this (which implements the usual
HSSFListener), and then override the #abortableProcessRecord(org.apache.poi.hssf.record.Record)
method to do their processing.
This should then be registered with the HSSFRequest (associating
it with Record SID's) as usual.
Process an HSSF Record. Called when a record occurs in an HSSF file.
Provides two options for halting the processing of the HSSF file.
The return value provides a means of non-error termination with a
user-defined result code. A value of zero must be returned to
continue processing, any other value will halt processing by
HSSFEventFactory with the code being passed back by
its abortable process events methods.
Error termination can be done by throwing the HSSFUserException.
Note that HSSFEventFactory will not call the inherited process
record - the record to be processed
result code of zero for continued processing.
HSSFUserException - User code can throw this to abort
file processing by HSSFEventFactory and return diagnostic information.