org.supercsv.cellprocessor.constraint

Class RequireHashCode

java.lang.Object

org.supercsv.cellprocessor.CellProcessorAdaptor

org.supercsv.cellprocessor.constraint.RequireHashCode

All Implemented Interfaces:

BoolCellProcessor, CellProcessor, DateCellProcessor, DoubleCellProcessor, LongCellProcessor, StringCellProcessor

public class RequireHashCode
extends CellProcessorAdaptor
implements BoolCellProcessor, DateCellProcessor, DoubleCellProcessor, LongCellProcessor, StringCellProcessor

This processor converts the input to a String, and ensures that the input's hash function matches any of a given set of hashcodes. Lookup time is O(1).

This constraint is a very efficient way of ensuring constant expressions are present in certain columns of the CSV file, such as "BOSS", "EMPLOYEE", or when a column denotes an action to be taken for the input line such as "D" (delete), "I" (insert), ...

Since:

1.50

Constructor Summary

Constructors

Constructor and Description
RequireHashCode(int... requiredHashcodes) Constructs a new RequireHashCode processor, which converts the input to a String, and ensures that the input's hash function matches any of a given set of hashcodes.
RequireHashCode(int[] requiredHashcodes, CellProcessor next) Constructs a new RequireHashCode processor, which converts the input to a String, ensures that the input's hash function matches any of a given set of hashcodes, then calls the next processor in the chain.
RequireHashCode(int requiredHashcode, CellProcessor next) Constructs a new RequireHashCode processor, which converts the input to a String, ensures that the input's hash function matches the supplied hashcode, then calls the next processor in the chain.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	execute(java.lang.Object value, CsvContext context) This method is invoked by the framework when the processor needs to process data or check constraints.

Methods inherited from class org.supercsv.cellprocessor.CellProcessorAdaptor

toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RequireHashCode

public RequireHashCode(int... requiredHashcodes)

Constructs a new RequireHashCode processor, which converts the input to a String, and ensures that the input's hash function matches any of a given set of hashcodes.

Parameters:

requiredHashcodes - one or more hashcodes

Throws:

java.lang.NullPointerException - if requiredHashcodes is null

java.lang.IllegalArgumentException - if requiredHashcodes is empty

RequireHashCode

public RequireHashCode(int requiredHashcode,
                       CellProcessor next)

Constructs a new RequireHashCode processor, which converts the input to a String, ensures that the input's hash function matches the supplied hashcode, then calls the next processor in the chain.

Parameters:

requiredHashcode - the required hashcode

next - the next processor in the chain

Throws:

java.lang.NullPointerException - if next is null

RequireHashCode

public RequireHashCode(int[] requiredHashcodes,
                       CellProcessor next)

Constructs a new RequireHashCode processor, which converts the input to a String, ensures that the input's hash function matches any of a given set of hashcodes, then calls the next processor in the chain.

Parameters:

requiredHashcodes - one or more hashcodes

next - the next processor in the chain

Throws:

java.lang.NullPointerException - if requiredHashcodes or next is null

java.lang.IllegalArgumentException - if requiredHashcodes is empty

Method Detail

execute

public java.lang.Object execute(java.lang.Object value,
                                CsvContext context)

This method is invoked by the framework when the processor needs to process data or check constraints.

Specified by:

execute in interface CellProcessor

Throws:

SuperCsvCellProcessorException - if value is null

SuperCsvConstraintViolationException - if value isn't one of the required hash codes