Ristretto ClassLoader

Getting Started

Implementation of a JVM Class Loader that is used to load Java classes. Classes can be loaded from the file system or from a URL; jar and modules are supported. A runtime Java class loader can be created from any version of AWS Corretto. The runtime class loader will download and install the requested version of Corretto into and create a class loader that can be used to load Java classes.

The AWS Corretto runtime is installed in the following directory:

• Unix: $HOME/.ristretto/<version>
• Windows: %USERPROFILE%\.ristretto\<version>

Examples

use ristretto_classloader::{ClassLoader, ClassPath, Result};
use std::sync::Arc;

#[tokio::main]
async fn main() -> Result<()> {
    #[tokio::main]
    async fn main() -> Result<()> {
        let (version, class_loader) = runtime::class_loader("21").await?;
        let class_name = "java.util.HashMap";
        println!("Loading {class_name} from Java runtime {version}");
        let class = ClassLoader::load_class(&Arc::new(class_loader), class_name).await?;
        println!("{class:?}");
        Ok(())
    }
}

Feature flags

The following features are available:

Safety

These crates use #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.