* a regex pattern matches the query.
     */
    protected String queryPlaceHolder = "__QUERY__";

    /**
     * Initializes the RelatedContentHelper by loading related content configurations
     * from the data store. This method is called automatically after dependency
     * injection is complete.
     *
     * PostConstruct annotation ensures this method is called after the bean

 * only one of them (allRequired = false). It also supports a default rule that always matches.
 *
 * <p>
 * The class uses a map of field names to Pattern objects to store the regular expressions.
 * The match method extracts the values of the specified fields from the ResponseData and
 * applies the corresponding regular expressions.
 * </p>
 *
 * <p>
 * Example usage:
 * </p>
 *

### SuggestSettings (Configuration)
Location: `src/main/java/org/codelibs/fess/suggest/settings/SuggestSettings.java`

Manages configuration stored in OpenSearch: analyzers, bad words, elevate words, timeouts.

### SuggestItem (Domain Entity)
Location: `src/main/java/org/codelibs/fess/suggest/entity/SuggestItem.java`

        validate(form, messages -> {}, this::asEditHtml);
        verifyToken(this::asEditHtml);
        getFileConfig(form).ifPresent(entity -> {
            try {
                fileConfigService.store(entity);
                saveInfo(messages -> messages.addSuccessCrudCreateCrudTable(GLOBAL));
            } catch (final Exception e) {
                logger.warn("Failed to process a request.", e);

        validate(form, messages -> {}, this::asEditHtml);
        verifyToken(this::asEditHtml);
        createProtwordsItem(form, this::asEditHtml).ifPresent(entity -> {
            protwordsService.store(form.dictId, entity);
            saveInfo(messages -> messages.addSuccessCrudCreateCrudTable(GLOBAL));
        }).orElse(() -> throwValidationError(messages -> messages.addErrorsCrudFailedToCreateInstance(GLOBAL), this::asEditHtml));

    @Override
    public void setInitParameterMap(final Map<String, Object> params) {
        this.params.putAll(params);
    }

    /**
     * Initializes the parameter map of the wrapped factory with the parameters stored in this wrapper.
     */
    public void initParameterMap() {
        factory.setInitParameterMap(params);
    }

    /**
     * Initializes the wrapped factory.
     */
    @Override

    }

    /**
     * Fetch a private field value via reflection.  This helper keeps the
     * test code tidy and is used where unit‑testing logic relies on
     * internally stored data.
     */
    private static Object getPrivateField(Object target, String name) {
        try {
            java.lang.reflect.Field f = target.getClass().getDeclaredField(name);
            f.setAccessible(true);

            final ZipEntry entry = new ZipEntry(id + "/fess_config.properties");
            try {
                zos.putNextEntry(entry);
                prop.store(zos, getHostInfo());
            } catch (final IOException e) {
                logger.warn("Failed to access fess_config.properties.", e);
            }
        }
    }

    /**

        validate(form, messages -> {}, this::asEditHtml);
        verifyToken(this::asEditHtml);
        getElevateWord(form).ifPresent(entity -> {
            try {
                elevateWordService.store(entity);
                suggestHelper.addElevateWord(entity.getSuggestWord(), entity.getReading(), entity.getLabelTypeValues(),
                        entity.getPermissions(), entity.getBoost(), false);

            }
            if (bufferIndex + len > buffer.length) {
                throw new SMBProtocolDecodingException("Buffer overflow");
            }

            // Store the decoded data
            this.data = new byte[len];
            System.arraycopy(buffer, bufferIndex, this.data, 0, len);

            return len;
        }

        public byte[] getData() {