com.opencsv.bean

Class JoinTest

java.lang.Object

com.opencsv.bean.JoinTest

public class JoinTest
extends Object

Author:

Andrew Rucker Jones

Constructor Summary

Constructors

Constructor and Description
JoinTest()

Method Summary

Modifier and Type	Method and Description
void	setSystemLocaleBackToDefault()
void	setSystemLocaleToValueNotGerman()
static void	storeSystemLocale()
void	testBadCustomConverter()
void	testBeanInstantiationImpossibleIllegalAccess()
void	testCaptureByNameInvalidRegex()
void	testCaptureByNameRegexWithoutCaptureGroup()
void	testCaptureByPositionInvalidRegex()
void	testCaptureByPositionRegexWithoutCaptureGroup()
void	testClosedRange() Tests that closed ranges work as expected.
void	testCustomConverterByNameRead()
void	testCustomConverterByNameWrite()
void	testCustomConverterByPositionRead()
void	testCustomConverterByPositionWrite()
void	testDoubleOpenRange() Tests that the range specification "-" works as a double open range.
void	testEmptyRangeExpression()
void	testFieldNotMultiValuedMap()
void	testFormatByNameWriteInvalidFormatString()
void	testFormatByPositionWriteInvalidFormatString()
void	testIllegalRegularExpression()
void	testNamingOverlap() Tests that an overlap in naming between CsvBindByName and CsvBindAndJoinByName is resolved to the benefit of the former.
void	testNonMatchingRegularExpression() Test with regular expression that doesn't match any header names.
void	testNonNumberRangeExpression()
void	testNoNullaryConstructor()
void	testNoNullaryConstructorNoSetter()
void	testOpenRangeNoLowerBound()
void	testOpenRangeWithoutUpperBoundry() Tests that an open range without an upper boundry works.
void	testRangeBackward() Tests that a range expression of the form "maximum-minimum" functions properly.
void	testRangeWithOnePosition() Tests a position definition with exactly one column index.
void	testReadConversionLocalePrimitiveHeaderMapping() Tests conversion of a primitive with a specified locale using header name-based mapping.
void	testReadConversionLocalePrimitivePositionMapping()
void	testReadDate() Tests reading in formatted dates.
void	testReadEmptyIndividualRequiredFieldColumnPositionMapping() Tests what happens if at least one position for a field marked as required with CsvBindAndJoinByPosition contains no value.
void	testReadEmptyIndividualRequiredFieldHeaderNameMapping() Tests what happens when a required field specified as a single header name is missing.
void	testReadEmptyOptionalFieldHeader()
void	testReadEmptyOptionalFieldPosition()
void	testReadEmptyOptionalFieldValueOnly()
void	testReadEmptyRegexAllRequiredFieldHeaderNameMapping() Tests what happens if a field marked as required and fed out of multiple headers is missing all headers that would match.
void	testReadEmptyRegexSingleRequiredFieldHeaderNameMappingValueOnly() Tests what happens if a field marked as required and fed out of multiple headers is missing a value in one matching column.
void	testReadNullOptionalFieldValueOnly()
void	testReadPrimitive() Tests reading a wrapped primitive into a MultiValuedMap.
void	testSetterThrowsException()
void	testUnassignableMultiValuedMap()
void	testUnknownMultiValuedMap()
void	testWriteColumnMapping() Tests that writing with a column position-based mapping strategy works.
void	testWriteEmptyRequiredFieldColumnPositionMapping() Tests what happens when a required field is missing in a column position mapping strategy on writing.
void	testWriteEmptyRequiredFieldInFirstBean()
void	testWriteEmptyRequiredFieldInSecondBean()
void	testWriteFieldWithoutGetter()
void	testWritePrimitive() Tests that multi-valued fields of (wrapped) primitives are written correctly.

Methods inherited from class java.lang.Object

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

Constructor Detail

JoinTest

public JoinTest()

Method Detail

storeSystemLocale

@BeforeAll
public static void storeSystemLocale()

setSystemLocaleToValueNotGerman

@BeforeEach
public void setSystemLocaleToValueNotGerman()

setSystemLocaleBackToDefault

@AfterEach
public void setSystemLocaleBackToDefault()

testReadPrimitive

@Test
public void testReadPrimitive()
                             throws IOException

Tests reading a wrapped primitive into a MultiValuedMap.

Also tests:

• Reading with a header name mapping strategy
• Reading with a regular expression that matches more than one identically named headers
• Map does not already exist
• Capture by name without a matching regular expression

Throws:

IOException - Never

testReadDate

@Test
public void testReadDate()
                        throws IOException

Tests reading in formatted dates.

Also tests:

• Reading a date with a conversion locale and header mapping
• Reading with a regular expression that matches more than one not identically named headers
• Test with comma-separated range values

Throws:

IOException - Never

testNamingOverlap

@Test
public void testNamingOverlap()
                             throws IOException

Tests that an overlap in naming between CsvBindByName and CsvBindAndJoinByName is resolved to the benefit of the former.

Also incidentally tests:

• Use of a class derived from an implementation of MultiValuedMap

Throws:

IOException - Never

testIllegalRegularExpression

@Test
public void testIllegalRegularExpression()

testNonMatchingRegularExpression

@Test
public void testNonMatchingRegularExpression()
                                            throws IOException

Test with regular expression that doesn't match any header names.

Throws:

IOException - Never

testFieldNotMultiValuedMap

@Test
public void testFieldNotMultiValuedMap()

testDoubleOpenRange

@Test
public void testDoubleOpenRange()
                               throws IOException

Tests that the range specification "-" works as a double open range.

Also incidentally tests:

• Use of an interface derived from MultiValuedMap
• Overlap of position designations between CsvBindByPosition and CsvBindAndJoinByPosition

Throws:

IOException - Never

testOpenRangeNoLowerBound

@Test
public void testOpenRangeNoLowerBound()
                                     throws IOException

Throws:

IOException

testNonNumberRangeExpression

@Test
public void testNonNumberRangeExpression()

testEmptyRangeExpression

@Test
public void testEmptyRangeExpression()

testRangeWithOnePosition

@Test
public void testRangeWithOnePosition()
                                    throws IOException

Tests a position definition with exactly one column index.

Also incidentally tests:

• Reading with a column position mapping strategy
• Map already exists
• Capture by position without a matching regular expression

Throws:

IOException - Never

testClosedRange

@Test
public void testClosedRange()
                           throws IOException

Tests that closed ranges work as expected.

Also incidentally tests:

• Adjacent ranges in one range expression
• Overlapping ranges in one range expression
• Multiple individual positions
• Spaces in range expressions
• Gaps in range expressions
• Implementation of MultiValuedMap as bean member
• Use of ArrayListValuedHashMap
• First setting the bean type, then the error locale
• Setting an error locale with complex many-to-one mappings

Throws:

IOException - Never

testOpenRangeWithoutUpperBoundry

@Test
public void testOpenRangeWithoutUpperBoundry()
                                            throws IOException

Tests that an open range without an upper boundry works.

Also tests:

• No accessor method for member variable
• Locale conversion with date and position mapping

Throws:

IOException - Never

testRangeBackward

@Test
public void testRangeBackward()
                             throws IOException

Tests that a range expression of the form "maximum-minimum" functions properly.

Also incidentally tests:

• Bean member variable lacks an assignment method
• Explicit map type
• Capture by position with a matching regular expression

Throws:

IOException - Never

testReadConversionLocalePrimitiveHeaderMapping

@Test
public void testReadConversionLocalePrimitiveHeaderMapping()
                                                          throws IOException

Tests conversion of a primitive with a specified locale using header name-based mapping.

Also incidentally tests:

• Capture by name with a matching regular expression

Throws:

IOException - Never

testReadConversionLocalePrimitivePositionMapping

@Test
public void testReadConversionLocalePrimitivePositionMapping()
                                                            throws IOException

Throws:

IOException

testReadEmptyIndividualRequiredFieldHeaderNameMapping

@Test
public void testReadEmptyIndividualRequiredFieldHeaderNameMapping()
                                                                 throws IOException

Tests what happens when a required field specified as a single header name is missing. In case it's not clear, this test uses a header name mapping strategy.

Throws:

IOException - Never

testReadEmptyRegexSingleRequiredFieldHeaderNameMappingValueOnly

@Test
public void testReadEmptyRegexSingleRequiredFieldHeaderNameMappingValueOnly()
                                                                           throws IOException

Tests what happens if a field marked as required and fed out of multiple headers is missing a value in one matching column. In case it's not clear, this test uses a header name mapping strategy.

Throws:

IOException - Never

testReadEmptyRegexAllRequiredFieldHeaderNameMapping

@Test
public void testReadEmptyRegexAllRequiredFieldHeaderNameMapping()
                                                               throws IOException

Tests what happens if a field marked as required and fed out of multiple headers is missing all headers that would match. In case it's not clear, this test uses a header name mapping strategy.

Throws:

IOException - Never

testReadEmptyIndividualRequiredFieldColumnPositionMapping

@Test
public void testReadEmptyIndividualRequiredFieldColumnPositionMapping()
                                                                     throws IOException

Tests what happens if at least one position for a field marked as required with CsvBindAndJoinByPosition contains no value. In case it's not clear, this test uses a column position mapping strategy.

Throws:

IOException - Never

testReadEmptyOptionalFieldValueOnly

@Test
public void testReadEmptyOptionalFieldValueOnly()
                                               throws IOException

Throws:

IOException

testReadNullOptionalFieldValueOnly

@Test
public void testReadNullOptionalFieldValueOnly()
                                              throws IOException

Throws:

IOException

testReadEmptyOptionalFieldHeader

@Test
public void testReadEmptyOptionalFieldHeader()
                                            throws IOException

Throws:

IOException

testReadEmptyOptionalFieldPosition

@Test
public void testReadEmptyOptionalFieldPosition()
                                              throws IOException

Throws:

IOException

testWriteEmptyRequiredFieldColumnPositionMapping

@Test
public void testWriteEmptyRequiredFieldColumnPositionMapping()
                                                            throws com.opencsv.exceptions.CsvException

Tests what happens when a required field is missing in a column position mapping strategy on writing.

Throws:

com.opencsv.exceptions.CsvException - Never

testWritePrimitive

@Test
public void testWritePrimitive()
                              throws com.opencsv.exceptions.CsvException

Tests that multi-valued fields of (wrapped) primitives are written correctly.

Also incidentally tests

• Writing a date type
• Conversion of a wrapped primitive with a locale
• Conversion of a date type with a locale
• Writing with a header mapping
• Too few values for a multivalued field
• Too many values for a multivalued field
• No value for an optional field (null)
• No value for an optional field (empty map)
• No value for an optional field (existing entries with null as their value)
• Writing multiple multivalued beans
• Subsequent bean has different headers than first bean
• Writing with a format string using header name mapping
• Writing with a format string an empty inputs

Throws:

com.opencsv.exceptions.CsvException - Never

testWriteColumnMapping

@Test
public void testWriteColumnMapping()
                                  throws com.opencsv.exceptions.CsvException

Tests that writing with a column position-based mapping strategy works.

Also incidentally tests:

• Writing more than one bean works with the column position strategy.
• More values for a position than one
• Writing empty optional positions
• Using a column position in a bean field that would not be read by that bean field
• Writing using a format string using column position mapping

Throws:

com.opencsv.exceptions.CsvException - Never

testWriteEmptyRequiredFieldInFirstBean

@Test
public void testWriteEmptyRequiredFieldInFirstBean()
                                                  throws com.opencsv.exceptions.CsvException

Throws:

com.opencsv.exceptions.CsvException

testWriteEmptyRequiredFieldInSecondBean

@Test
public void testWriteEmptyRequiredFieldInSecondBean()
                                                   throws com.opencsv.exceptions.CsvException

Throws:

com.opencsv.exceptions.CsvException

testWriteFieldWithoutGetter

@Test
public void testWriteFieldWithoutGetter()
                                       throws com.opencsv.exceptions.CsvException

Throws:

com.opencsv.exceptions.CsvException

testSetterThrowsException

@Test
public void testSetterThrowsException()

testUnknownMultiValuedMap

@Test
public void testUnknownMultiValuedMap()

testUnassignableMultiValuedMap

@Test
public void testUnassignableMultiValuedMap()

testBeanInstantiationImpossibleIllegalAccess

@Test
public void testBeanInstantiationImpossibleIllegalAccess()

testNoNullaryConstructor

@Test
public void testNoNullaryConstructor()

testNoNullaryConstructorNoSetter

@Test
public void testNoNullaryConstructorNoSetter()

testCustomConverterByNameRead

@Test
public void testCustomConverterByNameRead()
                                         throws IOException

Throws:

IOException

testCustomConverterByPositionRead

@Test
public void testCustomConverterByPositionRead()
                                             throws IOException

Throws:

IOException

testCustomConverterByNameWrite

@Test
public void testCustomConverterByNameWrite()
                                          throws com.opencsv.exceptions.CsvException,
                                                 IOException

Throws:

com.opencsv.exceptions.CsvException

IOException

testCustomConverterByPositionWrite

@Test
public void testCustomConverterByPositionWrite()
                                              throws com.opencsv.exceptions.CsvException,
                                                     IOException

Throws:

com.opencsv.exceptions.CsvException

IOException

testBadCustomConverter

@Test
public void testBadCustomConverter()
                                  throws IOException

Throws:

IOException

testCaptureByNameInvalidRegex

@Test
public void testCaptureByNameInvalidRegex()

testCaptureByPositionInvalidRegex

@Test
public void testCaptureByPositionInvalidRegex()

testCaptureByNameRegexWithoutCaptureGroup

@Test
public void testCaptureByNameRegexWithoutCaptureGroup()

testCaptureByPositionRegexWithoutCaptureGroup

@Test
public void testCaptureByPositionRegexWithoutCaptureGroup()

testFormatByNameWriteInvalidFormatString

@Test
public void testFormatByNameWriteInvalidFormatString()

testFormatByPositionWriteInvalidFormatString

@Test
public void testFormatByPositionWriteInvalidFormatString()