Class TableLoader

code/src/java/pcgen/rules/persistence/TableLoader.java:40–424

A TableLoader loads CSV-like files into Tables for PCGen. The CSV files must conform to the CSV file format with some additional limitations. Embedded newlines are not permitted in quotes. This should generate an error from TableLoader.

 * generate an error from TableLoader.
 */
public class TableLoader extends LstLineFileLoader
{
	/**
	 * A pattern for empty lines. This helps the LineProcessors from having to
	 * deal with this situation.
	 */
	private static Pattern EMPTY = Pattern.compile("^[\\s,\\\"]+$");

	/**
	 * The active LineProcessor used to interpret the contents of the next
	 * loaded line in a Table file.
	 */
	private LineProcessor processor = new ExpectStartTable();

	@Override
	public void loadLstString(LoadContext context, URI uri, String aString) throws PersistenceLayerException
	{
		//Reset to ensure prior file corruption doesn't leak into a new file
		processor = new ExpectStartTable();
		super.loadLstString(context, uri, aString);
		if (!(processor instanceof ExpectStartTable))
		{
			throw new PersistenceLayerException("Did not find last ENDTABLE: entry in " + uri);
		}
	}

	@Override
	public void parseLine(LoadContext context, String lstLine, URI sourceURI) throws PersistenceLayerException
	{
		//ignore comments
		if (lstLine.startsWith("#") || lstLine.startsWith("\"#"))
		{
			return;
		}
		//Empty line (commas, whitespace, empty quotes)
		if (EMPTY.matcher(lstLine).find())
		{
			return;
		}
		processor = processor.parseLine(context, lstLine, sourceURI);
	}

	/**
	 * A LineProcessor interprets a line of a Table file and returns the
	 * LineProcessor that should be responsible for interpreting the next line
	 * of the file.
	 * 
	 * A LineProcessor is not expected to be able to understand/comprehend
	 * either blank lines or comment lines. Both of those should be ignored
	 * prior to the line being passed to a LineProcessor.
	 */
	@FunctionalInterface
	public interface LineProcessor
	{
		/**
		 * Processes the given line of a Table file (identified by the
		 * sourceURI).
		 *