Skip to content

Latest commit

 

History

History
93 lines (69 loc) · 2.88 KB

README.md

File metadata and controls

93 lines (69 loc) · 2.88 KB
Raw

quasar-core fork

This is a fork of Parallel Universe's Quasar fibers library for Java, updated to work only with Java 9+ without modules.

Requirements

  • Java 9 or higher

Instrumenting in Gradle

Add the plugin to your plugins block in build.gradle and include a dependency on this library:

build.gradle

buildscript {
  repositories {
    // required to help plugin find library
    mavenCentral()
  }
}

plugins {
  id 'java-library'
  id 'com.hiddenswitch.fibers.instrument' version '10.0.6'
}

dependencies {
  api "com.hiddenswitch:quasar-core:10.0.6"
}

Your code is now instrumented. The fibers extension supports the following settings:

build.gradle

fibers {
  // The Quasar instrumentation includes checks to see if the methods it is entering are instrumented.
  check = false
  // Prints instrumentation messages.
  verbose = false
  // Allows Java synchronized blocks to be instrumented.
  allowMonitors = false
  // Allows suspendable methods to call Java blocking methods.
  allowBlocking = false
  // Prints debug messaging.
  debug = false
  // Writes the instrumented classes
  writeClasses = true
  // Automatically determine which methods should be instrumented based on static analysis.
  scanSuspendables = false
  // Instrument the interfaces that suspendable methods override.
  scanSuspendableSupers = false
}

All compileJava tasks for all source sets will be instrumented.

What's New

  • Support for Java 12-16
  • Non-AOT support for GraalVM
  • Micrometer metrics
  • A Gradle plugin

What's Fixed

  • Support for Java 9-11 (#337, #344, #317)
  • A stack size bug (#309)
  • vertx-sync fork is now updated (#327)
  • Suspendable iterators (#297)
  • A time error (#319)
  • Package relocation for asm to prevent conflicts with other libraries that use it.

Unsupported

  • GraalVM's Native Image cannot build instrumented libraries. (Comment on oracle/graal/3759) to get Graal to fix this issue)
  • actors: passes tests but unused anywhere in production
  • maven-plugin

Coming Soon

  • How to reference the uninstrumented libraries for building native images using Threads instead of Fibers.

What's Missing

  • Kryo-based fiber serialization
  • disruptor, galaxy, kotlin and reactive-streams since they are out of scope for being tested by me

Development

How do I edit gradle-plugin-test?

In IntelliJ, right click on gradle-plugin-test/build.gradle and choose Link Gradle Project.