return false
    }
    if (pattern.isNullOrEmpty() ||
      pattern.startsWith(".") ||
      pattern.endsWith("..")
    ) {
      // Invalid pattern.
      return false
    }

    // Normalize hostname and pattern by turning them into absolute domain names if they are not
    // yet absolute. This is needed because server certificates do not normally contain absolute

         *                 If null, the path string representation is used
         */
        protected PathSource(Path path, String location) {
            this.path = requireNonNull(path, "path").normalize();
            this.location = location != null ? location : this.path.toString();
        }

        @Override
        @Nullable
        public Path getPath() {
            return path;
        }

 * - [url] — the canonical, https:// URL for the license text
 * - [aliases] — all known POM `<licenses><license><name>` strings that map to this license;
 *   used by [GenerateLicenseFile] to normalise inconsistent spellings across the Maven ecosystem
 *
 * ## Adding a new dependency with an unrecognised license
 *
 * If `./gradlew generateLicenseFile` fails with "declare a license name not registered in

        }
        return str;
    }

    @Nonnull
    public static Path getCanonicalPath(Path path) {
        requireNonNull(path, "path");
        return path.toAbsolutePath().normalize();
    }

    @Nonnull
    public static Map<String, String> toMap(Properties properties) {
        requireNonNull(properties, "properties");
        HashMap<String, String> map = new HashMap<>();

        public int getType() {
            return LIST_ITEM;
        }

        @Override
        public boolean isNull() {
            return (size() == 0);
        }

        void normalize() {
            for (int i = size() - 1; i >= 0; i--) {
                Item lastItem = get(i);

                if (lastItem.isNull()) {
                    if (i == size() - 1 || get(i + 1).getType() == STRING_ITEM) {

        assertArgumentNotNull("pathToCheck", pathToCheck);
        assertArgumentNotNull("baseDirectory", baseDirectory);

        final Path normalizedPath = pathToCheck.toAbsolutePath().normalize();
        final Path normalizedBase = baseDirectory.toAbsolutePath().normalize();
        return normalizedPath.startsWith(normalizedBase);
    }

    /**
     * Validates that a given file is safe and does not attempt path traversal attacks.
     * <p>

        if (StringUtil.isBlank(path)) {
            throw new IllegalArgumentException("File path cannot be blank.");
        }
        try {
            final Path filePath = Paths.get(path).normalize();
            final String normalizedPath = filePath.toString();
            if (normalizedPath.contains("..")) {
                throw new IllegalArgumentException("Invalid file path: path=" + path);
            }

        // file. Ideally, we'd do full pattern-evaluation against the sysprops, but this
        // is a first step. There are several replacements below, in order to normalize
        // the path character before we operate on the string as a regex input, and
        // in order to avoid surprises with the File construction...

        return ComponentUtil.getSearchEngineClient()
                .deleteByQuery(ComponentUtil.getFessConfig().getIndexDocumentUpdateIndex(), queryContext.getQueryBuilder());
    }

    /**
     * Extracts and normalizes language preferences from request parameters or browser locale.
     *
     * This method prioritizes explicit language parameters over browser locale settings
     * and handles special cases like "all languages" selection.

    protected String escapeLDAPSearchFilter(final String filter) {
        return LdapUtil.escapeValue(filter);
    }

    /**
     * Normalizes a permission name based on configuration settings.
     *
     * @param name the permission name to normalize
     * @return the normalized permission name
     */
    public String normalizePermissionName(final String name) {
        if (fessConfig.isLdapLowercasePermissionName()) {