Struct JavaLocatorError 

pub struct JavaLocatorError { /* private fields */ }

Error type for Java locator operations.

This error type encapsulates various errors that can occur when locating or working with Java installations.

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::new("Java not found".to_string());
println!("Error: {}", error);

Implementations

impl JavaLocatorError

pub fn description(&self) -> &str

Returns the error description.

Returns

Error description string

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::new("Test error".to_string());
assert_eq!(error.description(), "Test error");

pub fn java_not_found() -> Self

Creates an error indicating Java is not installed or not in PATH.

Returns

A JavaLocatorError with appropriate message

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::java_not_found();

pub fn file_not_found(file_name: &str, java_home: &str) -> Self

Creates an error indicating a file was not found in the Java installation.

Arguments

• file_name - Name of the file that was not found
• java_home - Java home directory where the file was searched

Returns

A JavaLocatorError with appropriate message

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::file_not_found("libjsig.so", "/usr/lib/jvm/java-11");

pub fn command_failed(command: &str, error: &str) -> Self

Creates an error indicating a command execution failure.

Arguments

• command - Command that failed
• error - Underlying error

Returns

A JavaLocatorError with appropriate message

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::command_failed("java -version", "Permission denied");

pub fn invalid_installation(path: &str, reason: &str) -> Self

Creates an error indicating an invalid Java installation.

Arguments

• path - Path to the invalid Java installation
• reason - Reason why the installation is invalid

Returns

A JavaLocatorError with appropriate message

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::invalid_installation("/invalid/path", "Executable not found");

pub fn invalid_utf8_path(path: &str) -> Self

Creates an error indicating an invalid UTF-8 sequence in a path.

Arguments

• path - Path that contains invalid UTF-8

Returns

A JavaLocatorError with appropriate message

Examples

use java_manager::JavaLocatorError;

let error = JavaLocatorError::invalid_utf8_path("<invalid-utf8-path>");

Trait Implementations

impl Debug for JavaLocatorError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for JavaLocatorError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the error for display.

Arguments

• f - Formatter

Returns

Formatter result

impl Error for JavaLocatorError

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

Returns the error description (for compatibility with std::error::Error).

Returns

Error description

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

Returns the cause of the error (if any).

Returns

None (this error doesn’t wrap other errors)

fn source(&self) -> Option<&(dyn Error + 'static)>

Provides source of the error (for compatibility with Rust 1.30+).

Returns

None (this error doesn’t wrap other errors)

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for JavaLocatorError

fn from(err: Error) -> JavaLocatorError

Converts a std::io::Error to a JavaLocatorError.

Arguments

• err - IO error to convert

Returns

A JavaLocatorError with the IO error description

impl From<PatternError> for JavaLocatorError

fn from(err: PatternError) -> JavaLocatorError

Converts a glob::PatternError to a JavaLocatorError.

Arguments

• err - Glob pattern error to convert

Returns

A JavaLocatorError with the glob error description

impl From<Utf8Error> for JavaLocatorError

fn from(err: Utf8Error) -> JavaLocatorError

Converts a std::str::Utf8Error to a JavaLocatorError.

Arguments

• err - UTF-8 error to convert

Returns

A JavaLocatorError with the UTF-8 error description