/**
     * 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.
     *

client = TestClient(app)


@pytest.mark.parametrize(
    "path,expected_status,expected_response",
    [
        ("/api_route", 200, {"message": "Hello World"}),
        ("/non_decorated_route", 200, {"message": "Hello World"}),
        ("/nonexistent", 404, {"detail": "Not Found"}),
    ],
)
def test_get_path(path, expected_status, expected_response):
    response = client.get(path)
    assert response.status_code == expected_status

    @Override
    public String alignToBaseDirectory(String path, File basedir) {
        String result = path;

        if (path != null && basedir != null) {
            path = path.replace('\\', File.separatorChar).replace('/', File.separatorChar);

            File file = new File(path);
            if (file.isAbsolute()) {
                // path was already absolute, just normalize file separator and we're done

                });
    }

    /**
     * Flush cached writes for a file path
     *
     * @param path file path
     */
    private void flushCachedWrites(String path) {
        log.debug("Flushing cached writes for path: {}", path);

        WeakReference<SmbFile> ref = fileCache.get(path);
        if (ref != null) {
            SmbFile file = ref.get();
            if (file != null) {

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 }

     * @deprecated Use {@link #FileSource(Path)} instead.
     */
    @Deprecated
    public FileSource(File file) {
        this(Objects.requireNonNull(file, "file cannot be null").toPath());
    }

    /**
     * Creates a new source backed by the specified file.
     *
     * @param path The file, must not be {@code null}.
     * @since 4.0.0
     */
    public FileSource(Path path) {

    private static final String FESS_VAR_PATH = "fess.var.path";

    /** System property key for Fess web application path */
    private static final String FESS_WEBAPP_PATH = "fess.webapp.path";

    /** System property key for Java temporary directory */
    private static final String JAVA_IO_TMPDIR = "java.io.tmpdir";

    /** System property key for Tomcat configuration path */

    super.delete(path, mustExist)
  }

  override fun sink(
    path: Path,
    mustCreate: Boolean,
  ): Sink {
    log("sink($path)")

    return super.sink(path, mustCreate)
  }

  override fun source(file: Path): Source {
    log("source($file)")

    return super.source(file)
  }

import okio.ForwardingSink
import okio.Path
import okio.Sink

class FaultyFileSystem constructor(
  delegate: FileSystem?,
) : ForwardingFileSystem(delegate!!) {
  private val writeFaults: MutableSet<Path> = LinkedHashSet()
  private val deleteFaults: MutableSet<Path> = LinkedHashSet()
  private val renameFaults: MutableSet<Path> = LinkedHashSet()

  fun setFaultyWrite(
    file: Path,
    faulty: Boolean,
  ) {