org.supercsv.cellprocessor.constraint

Class IsIncludedIn

java.lang.Object

org.supercsv.cellprocessor.CellProcessorAdaptor

org.supercsv.cellprocessor.constraint.IsIncludedIn

All Implemented Interfaces:

BoolCellProcessor, CellProcessor, DateCellProcessor, DoubleCellProcessor, LongCellProcessor, StringCellProcessor

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

This processor ensures that the input value belongs to a specific set of (unchangeable) values. If you want to check if the value is an element of a (possibly changing) Collection, then use IsElementOf instead.

Since:

1.50

Author:

Dominique De Vito, James Bassett

Field Summary

Fields inherited from class org.supercsv.cellprocessor.CellProcessorAdaptor

next

Constructor Summary

Constructors

Constructor and Description
IsIncludedIn(java.lang.Object[] possibleValues) Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values.
IsIncludedIn(java.lang.Object[] possibleValues, CellProcessor next) Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values, then calls the next processor in the chain.
IsIncludedIn(java.util.Set<java.lang.Object> possibleValues) Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values.
IsIncludedIn(java.util.Set<java.lang.Object> possibleValues, CellProcessor next) Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values, 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, validateInputNotNull

Methods inherited from class java.lang.Object

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

Constructor Detail

IsIncludedIn

public IsIncludedIn(java.util.Set<java.lang.Object> possibleValues)

Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values.

Parameters:

possibleValues - the Set of values

Throws:

java.lang.NullPointerException - if possibleValues is null

java.lang.IllegalArgumentException - if possibleValues is empty

IsIncludedIn

public IsIncludedIn(java.util.Set<java.lang.Object> possibleValues,
                    CellProcessor next)

Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values, then calls the next processor in the chain.

Parameters:

possibleValues - the Set of values

next - the next processor in the chain

Throws:

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

java.lang.IllegalArgumentException - if possibleValues is empty

IsIncludedIn

public IsIncludedIn(java.lang.Object[] possibleValues)

Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values.

Parameters:

possibleValues - the array of values

Throws:

java.lang.NullPointerException - if possibleValues is null

java.lang.IllegalArgumentException - if possibleValues is empty

IsIncludedIn

public IsIncludedIn(java.lang.Object[] possibleValues,
                    CellProcessor next)

Constructs a new IsIncludedIn processor, which ensures that the input value belongs to a specific set of given values, then calls the next processor in the chain.

Parameters:

possibleValues - the array of values

next - the next processor in the chain

Throws:

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

java.lang.IllegalArgumentException - if possibleValues 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

Parameters:

value - the value to be processed

context - the CSV context

Returns:

the result of cell processor execution

Throws:

SuperCsvCellProcessorException - if value is null

SuperCsvConstraintViolationException - if value isn't one of the possible values