*       authoritative location}
   *   <li>{@linkplain LoadingCache#refresh refreshing of entries}, including {@linkplain
   *       CacheBuilder#refreshAfterWrite automated refreshing}
   *   <li>{@linkplain LoadingCache#getAll bulk loading requests}, including {@linkplain
   *       CacheLoader#loadAll bulk loading implementations}
   * </ul>
   *

import org.dbflute.optional.OptionalEntity;

import jakarta.annotation.Resource;

/**
 * Service class for managing character mapping operations.
 * <p>
 * This service handles character mapping management including CRUD operations
 * and list retrieval. Character mappings are used for text normalization
 * and character substitution during document processing and search operations.
 * </p>
 */
public class CharMappingService {

import jakarta.servlet.http.HttpServletResponseWrapper;

/**
 * Wrapper for HTTP servlet responses in web API context.
 * This class extends HttpServletResponseWrapper to provide custom response handling
 * for web API responses, including dummy output stream management.
 */
public class WebApiResponse extends HttpServletResponseWrapper {

    /**
     * Constructs a WebApiResponse with the specified response.
     *

This is normally the best way to contribute to the project.

## External Contributions

External contributions are very welcome and appreciated, including answering questions, submitting PRs, etc. 🙇‍♂️

/**
 * Form class for editing request header configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing request header entries,
 * including tracking information for optimistic locking and audit trails.
 * Request headers are used to customize HTTP requests sent during web crawling operations.
 *
 */
public class EditForm extends CreateForm {

    /**

/**
 * Form class for editing elevate word configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing elevate word entries,
 * including tracking information for optimistic locking and audit trails.
 * Elevate words are used to boost specific documents in search results when certain keywords are matched.
 *
 */
public class EditForm extends CreateForm {

import jakarta.annotation.Resource;
import jakarta.servlet.ServletContext;

/**
 * Base action class for admin pages in Fess.
 * <p>
 * This abstract class provides common functionality for all admin actions,
 * including authentication, authorization, and HTML data setup.
 * </p>
 *
 */
public abstract class FessAdminAction extends FessBaseAction {

    /** Constant suffix for view names. */

/**
 * Form class for editing synonym dictionary entries in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing synonym entries.
 * Synonyms are used to expand search queries by including terms with similar meanings.
 *
 */
public class EditForm extends CreateForm {

    /**
     * Creates a new EditForm instance.
     */
    public EditForm() {
        super();
    }

    /**

import org.jspecify.annotations.Nullable;

/**
 * Exception thrown upon the failure of a <a
 * href="https://github.com/google/guava/wiki/ConditionalFailuresExplained">verification check</a>,
 * including those performed by the convenience methods of the {@link Verify} class.
 *
 * @since 17.0
 */
@GwtCompatible
public class VerifyException extends RuntimeException {

 */
public interface IndexExportFormatter {

    /**
     * Returns the file extension for this format (e.g. ".html", ".json").
     *
     * @return the file extension including the leading dot
     */
    String getFileExtension();

    /**
     * Returns the default index file name for this format (e.g. "index.html", "index.json").
     *
     * @return the index file name
     */