com.dpslink.flash.imports

Class ImportProcessor

java.lang.Object

com.dpslink.flash.imports.ImportProcessor

All Implemented Interfaces:

java.io.Serializable

public class ImportProcessor
extends java.lang.Object
implements java.io.Serializable

Converts text data to a data structure and performes import actions.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private FlashServletContext	ivContext The current context for the servlet or thread using this class.
private java.util.HashMap<java.lang.String,Import<? extends JDBCObject<?>>>	ivImportObjects A cache of import object instances.
private int	ivNumOfRecords The number of processed records
private ImportParser	ivParser A reference to the current import parser.
private static long	serialVersionUID The class' serialization version id.

Constructor Summary

Constructors

Constructor and Description
ImportProcessor(FlashServletContext ctx) Constructs a new instance of the import processor class with the given servlet or thread context.

Method Summary

Modifier and Type	Method and Description
private int	getActionCode(java.lang.String action, int lineNo) Returns the action code for specified action parameter or -1 if the action is not valid.
FlashServletContext	getContext() Returns the current context for the servlet or thread using this class.
Import<? extends JDBCObject<?>>	getImportObject(java.lang.String ident, int lineNo) Creates and returns the import object for the ident import type.
void	housekeeping() Garbage collection: Kills (nullifies) the import objects and their associated objects used during import.
void	logFooter(boolean sysOK, int lineNo) Writes the log file's footer with number of file lines processed, number of records processed and final result of processing (OK if processing ended normally).
void	logHeader(java.lang.String fileName) Writes the log file's header with input file name.
void	processLine(java.lang.String line, int lineNo) Parses a text line into a collection of values and performs import actions.
void	processValues(java.lang.String line, int lineNo, java.util.ArrayList<java.lang.String> values) Performs import actions as defined by the supplied collection of values.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

The class' serialization version id.

See Also:

Constant Field Values

ivContext

private FlashServletContext ivContext

The current context for the servlet or thread using this class.

ivParser

private ImportParser ivParser

A reference to the current import parser.

ivImportObjects

private java.util.HashMap<java.lang.String,Import<? extends JDBCObject<?>>> ivImportObjects

A cache of import object instances. The key identifies the type of import data (i.e. Product, Categoty, etc.) There will be only one instance per type existing in the cache at any given time.

ivNumOfRecords

private int ivNumOfRecords

The number of processed records

Constructor Detail

ImportProcessor

public ImportProcessor(FlashServletContext ctx)

Constructs a new instance of the import processor class with the given servlet or thread context.

Parameters:

ctx - (FlashServletContext) The current servlet or thread context.

Method Detail

getContext

public FlashServletContext getContext()

Returns the current context for the servlet or thread using this class.

Returns:

FlashServletContext - The current servlet or thread context.

processLine

public void processLine(java.lang.String line,
                        int lineNo)

Parses a text line into a collection of values and performs import actions.

Parameters:

line - (String) The text line being processed.

lineNo - (int) The input file line number being processed.

processValues

public void processValues(java.lang.String line,
                          int lineNo,
                          java.util.ArrayList<java.lang.String> values)

Performs import actions as defined by the supplied collection of values. The collection of values is typically derived from a parsed delimited text file but may also be extracted from an Excel spreadsheet.

Parameters:

line - (String) The text line or spreadsheet row being processed.

lineNo - (int) The line number or row number being processed.

values - (ArrayList) The values to process.

getActionCode

private int getActionCode(java.lang.String action,
                          int lineNo)

Returns the action code for specified action parameter or -1 if the action is not valid.

Parameters:

action - (int) Action to be performed (i.e. add, update, delete).

lineNo - (int) The number of the processed input file line.

Returns:

int - The action code, or -1 if action not valid.

getImportObject

public Import<? extends JDBCObject<?>> getImportObject(java.lang.String ident,
                                                       int lineNo)

Creates and returns the import object for the ident import type.

Parameters:

ident - (String) The identifier for the type of import record.

lineNo - (int) The number of the processed input file line.

Returns:

Import - The import object to perform the import action.

logHeader

public void logHeader(java.lang.String fileName)

Writes the log file's header with input file name.

Parameters:

fileName - (String) The name of the input file.

logFooter

public void logFooter(boolean sysOK,
                      int lineNo)

Writes the log file's footer with number of file lines processed, number of records processed and final result of processing (OK if processing ended normally).

Parameters:

sysOK - (boolean) Indicates if the input processing ended normally (i.e. with no unexpected system errors).

lineNo - (int) The number of file lines processed.

housekeeping

public void housekeeping()

Garbage collection: Kills (nullifies) the import objects and their associated objects used during import.