}

    /**
     * Converts a sort field query to add sort criteria to the context.
     *
     * @param fessConfig the Fess configuration
     * @param context the query context
     * @param termQuery the term query to convert
     * @param boost the boost value to apply
     * @param field the field name
     * @param text the query text

    //                                                                              ======
    // to suppress unexpected override by sub-class
    // you should remove the 'final' if you need to override this
    /**
     * Hook method called before action execution.
     * This method refreshes the user information if a user is logged in
     * and delegates to the view helper's action hook.
     *
     * @param runtime the action runtime context

            } catch (Exception e) {
                // Expected due to missing dependencies in test environment
                assertTrue(true);
                return;
            }

            assertEquals(0, functionBuilders.size());
        } catch (Exception e) {
            // Expected due to missing dependencies in test environment
            assertTrue(true);
        }
    }

    @Test

        } catch (final IOException e) {
            throw new DictionaryException("Failed to parse " + path, e);
        }
    }

    /**
     * Reloads the stemmer override dictionary from an input stream.
     *
     * @param updater An optional updater to apply changes.
     * @param in      The input stream to read the dictionary from.
     * @throws DictionaryException if the input stream cannot be parsed.
     */

        } catch (final IOException e) {
            throw new DictionaryException("Failed to parse " + path, e);
        }
    }

    /**
     * Reloads the stopwords dictionary from an input stream.
     *
     * @param updater An optional updater to apply changes.
     * @param in      The input stream to read the dictionary from.
     * @throws DictionaryException if the input stream cannot be parsed.
     */

        return baseQuery + " sort:" + sortField;
    }

    /**
     * Appends a query string to the query buffer with proper formatting.
     * Handles OR operators and wraps complex queries in parentheses when necessary.
     *
     * @param queryBuf the StringBuilder to append to
     * @param query the query string to append
     */
    protected void appendQuery(final StringBuilder queryBuf, final String query) {

                    newFile.delete();
                }
                throw new DictionaryException("Failed to write a userDict file.", e);
            }
            item = newItem;
        }

        /**
         * Writes a protwords item to the temporary file.
         * @param oldItem the item to write
         * @return the written item or null if deleted
         */

            }
        }
    }

    /**
     * Adds click count information to the document.
     *
     * @param doc the document to update
     * @param url the URL to get click count for
     * @param clickCountField the field name to store click count
     */
    protected void addClickCountField(final Map<String, Object> doc, final String url, final String clickCountField) {

    /**
     * The key used to specify the pattern for excluding URLs.
     * This constant can be used to retrieve or set the URL exclusion pattern
     * in configuration or processing logic.
     */
    protected static final String URL_EXCLUDE_PATTERN = "url_exclude_pattern";

    /** The underlying index update callback to delegate operations to. */
    protected IndexUpdateCallback indexUpdateCallback;

#
# Optional ENV vars
# -----------------
#   M2_HOME - location of maven2's installed home dir
#   MAVEN_OPTS - parameters passed to the Java VM when running Maven
#     e.g. to debug Maven itself, use
#       set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
#   MAVEN_SKIP_RC - flag to disable loading of mavenrc files
# ----------------------------------------------------------------------------