});
    }

    /**
     * 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) {

    @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

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 {

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

## 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) {

                }
            }
        }
        Path path = paths.get(id);
        if (path == null && artifact instanceof DefaultArtifact defaultArtifact) {
            path = defaultArtifact.getArtifact().getPath();
        }
        return Optional.ofNullable(path);
    }

    @Override
    public void setPath(@Nonnull ProducedArtifact artifact, Path path) {

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,
  ) {

## Sobre proxies con un prefijo de path eliminado { #about-proxies-with-a-stripped-path-prefix }

Ten en cuenta que un proxy con prefijo de path eliminado es solo una de las formas de configurarlo.

Probablemente en muchos casos, el valor por defecto será que el proxy no tenga un prefijo de path eliminado.

    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)
  }