import org.dbflute.optional.OptionalEntity;

/**
 * Character mapping file handler for managing character mapping dictionaries.
 * This class provides functionality to load, parse, and manage character mapping
 * rules that define how input characters should be transformed to output characters
 * during text analysis and search processing.
 *
 * Character mapping files contain mapping rules in the format:
 * input1,input2,... => output

    // Query Reserved Characters and Patterns
    // ============================================================

    /** Array of reserved characters for query processing. */
    public static final String[] RESERVED =
            { "\\", "+", "-", "&&", "||", "!", "(", ")", "{", "}", "[", "]", "^", "~", "*", "?", ";", ":", "/" };

    /** Pattern for detecting reserved characters in Lucene field queries. */

     * Enable or disable popular word tracking and display.
     * When enabled, frequently searched terms are tracked and displayed.
     */
    @Size(max = 10)
    public String popularWord;

    /**
     * Character encoding to use for CSV file exports.
     * This setting affects the encoding of downloaded CSV files.
     */
    @Required
    @Size(max = 20)
    public String csvFileEncoding;

    /**

        String[] spaces = (String[]) propMap.get(CRAWLER_DOCUMENT_SPACES);
        if (spaces == null) {
            spaces = Arrays.stream(getCrawlerDocumentSpaceCharsAsArray()).mapToObj(Character::toString).toArray(n -> new String[n]);
            propMap.put(CRAWLER_DOCUMENT_SPACES, spaces);
        }
        return spaces;
    }

     * The value is, e.g. u0009u000Au000Bu000Cu000Du001Cu001Du001Eu001Fu0020u00A0u1680u180Eu2000u2001u2002u2003u2004u2005u2006u2007u2008u2009u200Au200Bu200Cu202Fu205Fu3000uFEFFuFFFDu00B6 <br>
     * comment: Unicode space characters for document parsing.
     * @return The value of found property. (NotNull: if not found, exception but basically no way)
     */
    String getCrawlerDocumentSpaceChars();

    /**