https://github.com/chrisgleissner/jisolate

Java Code Isolation
https://github.com/chrisgleissner/jisolate

classloader classloader-isolation isolation java java-11 java-8 vm-isolation

Last synced: 2 days ago
JSON representation

Java Code Isolation

• Host: GitHub
• URL: https://github.com/chrisgleissner/jisolate
• Owner: chrisgleissner
• Created: 2013-03-25T22:43:52.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2021-04-26T18:06:15.000Z (over 3 years ago)
• Last Synced: 2024-09-25T01:40:16.850Z (2 days ago)
• Topics: classloader, classloader-isolation, isolation, java, java-11, java-8, vm-isolation
• Language: Java
• Homepage:
• Size: 70.3 KB
• Stars: 16
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-2.0.txt

Awesome Lists containing this project

README

        
# Jisolate

[![Build Status](https://travis-ci.org/chrisgleissner/jisolate.svg?branch=master)](https://travis-ci.org/chrisgleissner/jisolate)

[![Coverage Status](https://coveralls.io/repos/chrisgleissner/jisolate/badge.svg)](https://coveralls.io/r/chrisgleissner/jisolate)

Jisolate is an API for isolating Java classes using either classloader or VM isolation. 

## Why Isolation?

Isolates are useful to load the same class multiple times, typically using different configurations.

For example, some frameworks are configured using static singletons. For tests, it is often useful 

to start multiple instances of these frameworks, each with its own configuration.  

## Classloader Isolation

Classloader isolation uses a child-first classloader combined with thread-local system properties

to ensure that non-JDK classes can be loaded multiple times in the same JVM. 

Classloader isolation is the isolation approach of choice as it is the most performant approach of ensuring isolation

and allows for an easy way to communicate results from the isolated code back to its invoker.

```java

Jisolate.classLoaderIsolation()

    .withIsolatableClass(IsolatedClass.class)

    .withIsolatableArguments("foo")

    .isolate();

```

## VM Isolation

VM isolation spawns a child VM process. This provides even better isolation than the classloader approach,

but it takes slightly longer to setup.

```java

Jisolate.jvmIsolation()

    .withMainClass(IsolatedClass.class)

    .withMainClassArguments("foo")

    .isolate();

```

#### Lifecycle control

VM isolation also allows for forcefully terminating the isolated JVM process when it's no longer needed:

```java

try (JvmIsolate isolate = Jisolate.jvmIsolation()

    .withMainClass(IsolatedClass.class)

    .withMainClassArguments("foo")

    .isolate()) {

    

    // The isolated JVM is automatically terminated on leaving this block    

}

```

## JSR-121

Jisolate is not an implementation of JSR-121, the Application

Isolation API Specification. Instead, it is a light-weight and pragmatic approach of providing

a best effort isolation of Java classes that is useful for many scenarios.