}

    /**
     * Gets a path mapping by ID.
     *
     * @param id the path mapping ID
     * @return the path mapping
     */
    public OptionalEntity<PathMapping> getPathMapping(final String id) {
        return pathMappingBhv.selectByPK(id);
    }

    /**
     * Stores a path mapping.
     *
     * @param pathMapping the path mapping to store
     */

                || path.startsWith("ftp:") || path.startsWith("storage:")) {
            return path;
        }

        if (path.startsWith("www.")) {
            return "http://" + path;
        }

        if (path.startsWith("//")) {
            return "file://" + path;
        }
        if (path.startsWith("/")) {
            return "file:" + path;
        }
        if (!path.startsWith("file:")) {

         * @throws NullPointerException if path is null
         */
        PathSource(Path path) {
            this(path, null);
        }

        /**
         * Constructs a new PathSource with the specified path and location.
         *
         * @param path the filesystem path to the source content

    /**
     * Displays the main path mapping administration page.
     *
     * @param form the search form containing search criteria
     * @return HTML response for the path mapping list page
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index(final SearchForm form) {
        return asListHtml();
    }

    /**
     * Displays the path mapping list with pagination support.
     *

          "type": "mapping",
          "mappings_path": "${fess.dictionary.path}fa/mapping.txt"
        },
        "mapping_ja_filter": {
          "type": "mapping",
          "mappings_path": "${fess.dictionary.path}ja/mapping.txt"
        },
        "mapping_filter": {
          "type": "mapping",
          "mappings_path": "${fess.dictionary.path}mapping.txt"
        },
        "traditional_chinese_convert": {

import org.lastaflute.web.Execute;
import org.lastaflute.web.response.JsonResponse;

import jakarta.annotation.Resource;

/**
 * API action for admin path mapping management.
 * Provides RESTful API endpoints for managing path mapping settings in the Fess search engine.
 * Path mappings define URL path transformations and redirections for crawling and indexing.
 */
public class ApiAdminPathmapAction extends FessApiAdminAction {

## Dependencies for groups of *path operations* { #dependencies-for-groups-of-path-operations }

    /**
     * Reads text from a file using the default encoding.
     *
     * @param path
     *            The file path. Must not be {@literal null} or empty.
     * @return The text read from the file.
     */
    public static String readText(final String path) {
        assertArgumentNotEmpty("path", path);
        return readText(path, Charset.defaultCharset().name());
    }

    /**

     *
     * @param path
     *            The {@link Path} to the properties file. If {@code null}, a {@link FileAccessException} is thrown.
     * @throws FileAccessException
     *             If the file cannot be accessed or created.
     */
    public DynamicProperties(final Path path) {
        this(path == null ? null : path.toFile());
    }

    /**

    }

    public void setPath_Equal(String path) {
        setPath_Term(path, null);
    }

    public void setPath_Equal(String path, ConditionOptionCall<TermQueryBuilder> opLambda) {
        setPath_Term(path, opLambda);
    }

    public void setPath_Term(String path) {
        setPath_Term(path, null);
    }

    public void setPath_Term(String path, ConditionOptionCall<TermQueryBuilder> opLambda) {