private final int sharing;

    /**
     * Instantiate a random access file from URL
     *
     * @param url the SMB URL of the file to access
     * @param mode the access mode ("r" for read-only, "rw" for read-write)
     * @param sharing the sharing flags for file access
     * @param tc the CIFS context to use for the connection
     * @throws SmbException if an SMB error occurs

     */
    private final String option;

    /**
     * Creates a new enumeration value for a path associated to the given tool option.
     *
     * @param location the {@code javax.tool} enumeration value, or {@code null} if none.
     * @param option the Java tools option for this path, or {@code null} if none
     */
    JavaPathType(JavaFileManager.Location location, String option) {
        this.location = location;

     * Default constructor.
     */
    private OptionalUtil() {
        // Default constructor
    }

    /**
     * Creates an OptionalEntity from a nullable entity.
     *
     * @param <T> the type of the entity
     * @param entity the entity (can be null)
     * @return the OptionalEntity
     */
    public static <T> OptionalEntity<T> ofNullable(final T entity) {
        return OptionalEntity.ofNullable(entity, () -> {});

        Arrays.fill(masterPassword, '\0');
    }

    /**
     * Initialize secure credential storage with existing salt and password
     *
     * @param masterPassword the master password
     * @param salt the salt for key derivation
     * @throws GeneralSecurityException if encryption setup fails
     */

     *
     * @param params the map containing field names as keys and configuration values as values
     */
    public FieldConfigs(final Map<String, String> params) {
        this.params = params;
    }

    /**
     * Retrieves the configuration for the specified field name.
     *
     * @param fieldName the name of the field to get configuration for

     */
    public Map<String, String> getQueryMap() {
        return queryMap;
    }

    /**
     * Adds a query to the query map with the specified display key.
     *
     * @param key the display key for the query
     * @param query the query string to add
     */
    public void addQuery(final String key, final String query) {
        queryMap.put(key, query);
    }

    /**

public class ArtifactInstallerException extends MavenException {

    /**
     *
     */
    @Serial
    private static final long serialVersionUID = 3652561971360586373L;

    /**
     * @param message the message of the error
     * @param e {@link Exception}
     */
    public ArtifactInstallerException(String message, Exception e) {
        super(message, e);
    }

 */
@Experimental
public class ProjectBuilderException extends MavenException {

    @Serial
    private static final long serialVersionUID = -7629871850875943799L;

    /**
     * @param message the message to give
     * @param e the {@link Exception}
     */
    public ProjectBuilderException(String message, Exception e) {
        super(message, e);
    }

 */
@Experimental
public class ToolchainManagerException extends MavenException {

    @Serial
    private static final long serialVersionUID = -9465854226608498L;

    /**
     * @param message the message to give
     * @param e the {@link Exception}
     */
    public ToolchainManagerException(String message, Exception e) {
        super(message, e);
    }

    /**
     * A class that provides an input stream for reading from a temporary file.
     * This class wraps a {@link FileInputStream} to read from the specified temporary file.
     *
     * @param tempFile the temporary file to be read
     * @throws FileNotFoundException if the specified file does not exist
     */
    public TemporaryFileInputStream(final File tempFile) throws FileNotFoundException {