Package de.bcxp.challenge.countries

Class CountryCsvParser

java.lang.Object

de.bcxp.challenge.common.documentParsing.csv.CsvParser

de.bcxp.challenge.countries.CountryCsvParser

All Implemented Interfaces:

IDocumentParser

public class CountryCsvParser
extends CsvParser

A CSV parser specialized for parsing country data entries.

CountryParser extends CsvParser to read CSV files containing country information, including country name, population, and area. Each CSV record is mapped to a CountryEntry.

The parser expects the CSV file to contain headers matching the field names: "Name", "Population", and "Area (km²)".

See Also:

• CsvParser
• CountryEntry

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	AREA
private static final org.apache.logging.log4j.Logger	logger
private static final String	NAME
private static final String	POPULATION

Constructor Summary

Constructors

Constructor	Description
CountryCsvParser(char delimiter, Locale locale)	Constructs a CountryCsvParser with the specified CSV delimiter and Locale.

Method Summary

Modifier and Type	Method	Description
protected List<DocumentEntry>	getEntriesFromRecords(Iterable<org.apache.commons.csv.CSVRecord> records)	Converts a collection of CSV records into a list of DocumentEntry objects, specifically CountryEntry instances.

Methods inherited from class de.bcxp.challenge.common.documentParsing.csv.CsvParser

getDelimiter, getLocale, parseDocument

Methods inherited from class java.lang.Object

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

Field Details

logger

private static final org.apache.logging.log4j.Logger logger

NAME

private static final String NAME

See Also:

• Constant Field Values

POPULATION

private static final String POPULATION

See Also:

• Constant Field Values

AREA

private static final String AREA

See Also:

• Constant Field Values

Constructor Details

CountryCsvParser

public CountryCsvParser(char delimiter,
 Locale locale)

Constructs a CountryCsvParser with the specified CSV delimiter and Locale.

Parameters:

delimiter - the character used to separate values in the CSV file.

locale - Locale used when parsing number

Method Details

getEntriesFromRecords

protected List<DocumentEntry> getEntriesFromRecords(Iterable<org.apache.commons.csv.CSVRecord> records)
                                             throws NumberFormatException,
ParseException

Converts a collection of CSV records into a list of DocumentEntry objects, specifically CountryEntry instances. Each record is expected to contain country-related data such as the name, population, and area.

Specified by:

getEntriesFromRecords in class CsvParser

Parameters:

records - an Iterable of CSVRecord objects containing country data. Each record must provide values for NAME, POPULATION, and AREA.

Returns:

a List of DocumentEntry objects, where each entry corresponds to a parsed CountryEntry from the CSV records.

Throws:

NumberFormatException - if numeric values (population or area) cannot be parsed.

ParseException - if a parsing error occurs during number conversion (e.g., due to locale-specific formatting issues).