<!-- logs (empty) -->
						<mapping>
							<directory>${packaging.fess.log.dir}</directory>
						</mapping>
						<!-- temp (empty) -->
						<mapping>
							<directory>${packaging.fess.temp.dir}</directory>
						</mapping>
						<!-- dictionary (empty) -->
						<mapping>
							<directory>${packaging.fess.dictionary.dir}</directory>
							<filemode>755</filemode>
							<username>opensearch</username>

     * @param path the path of the item
     * @param directory true if this item is a directory
     * @param size the size of the item in bytes
     * @param lastModified the last modified timestamp
     * @param encodedId the base64-encoded ID of the item
     */
    public StorageItem(final String name, final String path, final boolean directory, final long size, final ZonedDateTime lastModified,

    /**
     * Validates that a given path is safe and does not attempt path traversal attacks.
     * <p>
     * This method checks if the resolved absolute path starts with the allowed base directory,
     * preventing access to files outside the intended directory through path traversal
     * techniques like "../../../etc/passwd".
     * </p>
     * <p>
     * Example usage:
     * </p>
     * <pre>

                }
            } else if (file.isDirectory()) {
                if (logger.isDebugEnabled()) {
                    logger.debug("Processing directory: directory={}", file.getAbsolutePath());
                }
                final Set<RequestData> requestDataSet = new HashSet<>();
                if (includeContent) {
                    final File[] files = file.listFiles();

        assertFalse("Unsafe file should be blocked", FileUtil.isPathSafe(unsafeFile, baseDir));
    }

    /**
     * Test isPathSafe with path inside base directory
     *
     * @throws Exception
     */
    @Test
    public void testIsPathSafe_PathInsideBase() throws Exception {
        final Path baseDir = tempFolder.getRoot().toPath();

    protected String outputExtension = null;

    /** The temporary directory for input/output files. */
    protected File tempDir = null;

    /** The command to execute. */
    protected String command;

    /** The timeout for command execution in milliseconds. */
    protected long executionTimeout = 30L * 1000L; // 30sec

    /** The working directory for the command. */
    protected File workingDirectory = null;

                    .forEach(k -> addSystemProperty(cmdList, k.toString(), null, null));
        }
    }

    /**
     * Deletes the specified temporary directory.
     * Logs a warning if the directory cannot be deleted.
     *
     * @param ownTmpDir the temporary directory to delete
     */
    protected void deleteTempDir(final File ownTmpDir) {
        if (ownTmpDir == null) {
            return;
        }

                return false;
            }
            final File directory = dir.toFile();
            if (directory.list() != null && directory.list().length == 0 && !THUMBNAILS_DIR_NAME.equals(directory.getName())) {
                Files.delete(dir);
                if (logger.isDebugEnabled()) {
                    logger.debug("Deleted empty directory: {}", dir);
                }
                return true;
            }

     * @param directory The directory in which the file is to be created, or null if the default temporary-file directory is to be used.
     * @return The created temporary file.
     */
    protected File createTempFile(final String prefix, final String suffix, final File directory) {
        try {
            final File tempFile = File.createTempFile(prefix, suffix, directory);

                // Verify the prefix is correct
                assertEquals("crawler-S3Client-", prefix);
                assertEquals("Temp file suffix should be '.out'", ".out", suffix);
                assertNull("Directory should be null", directory);
                return super.createTempFile(prefix, suffix, directory);
            }
        };