v2.3.1

Compare Source

• Fixed racy file creation in org.agrona.MarkFile.mapNewOrExistingMarkFile. (#​340)
• Upgrade to ByteBuddy 1.17.8.
• Upgrade to Checkstyle 12.1.1.
• Upgrade to JUnit 6.0.1.

v2.3.0

Compare Source

• [Breaking] Changed org.agrona.concurrent.ShutdownSignalBarrier to use shutdown hooks instead of signals.

  Previously ShutdownSignalBarrier relied on intercepting SIGINT and SIGTERM OS signals by overriding JVM's signal handling which was preventing shutdown hooks from be executed. This in turn was breaking applications and frameworks that relied on shutdown hooks for clean termination.

  New implementation uses shutdown hooks instead and requires ShutdownSignalBarrier to be explicitly closed.

  NB: Failure to close ShutdownSignalBarrier might result in JVM not terminating!

  As the result the code using ShutdownSignalBarrier needs to be updated:

  • Old:

  class UsageSample
  {
      public static void main(final String[] args) 
      {
          try (MyService service = new MyService())
          {
              new ShutdownSignalBarrier().await();
          }
      }
  }

  • New:

  class UsageSample
  { 
      public static void main(final String[] args) 
      {
          try (ShutdownSignalBarrier barrier = new ShutdownSignalBarrier();
               MyService service = new MyService())
          {
              barrier.await();
          }
      }
  }

  In the above example ShutdownSignalBarrier is closed last to ensure that service terminates completely before ShutdownSignalBarrier closes which in turn allows JVM to exit.

• [Breaking] Deprecated org.agrona.concurrent.SigInt for removal. Use org.agrona.concurrent.ShutdownSignalBarrier instead.

  NB: org.agrona.concurrent.SigInt.register(java.lang.Runnable) is unsafe as it overrides SIGINT signal handling of the JVM thus preventing shutdown hooks from being executed.

  An example using ShutdownSignalBarrier instead of SigInt:

  • Old:

  class FlagSample
  {
      public static void main(final String[] args)
      {
          final AtomicBoolean running = new AtomicBoolean(false);
          SigInt.register(() -> running.set(false));
          while(running.get())
          {
              ...
          }
      }
  }

  • New:

  class FlagSample
  {
      public static void main(final String[] args)
      {
          final AtomicBoolean running = new AtomicBoolean(true);
          try (ShutdownSignalBarrier barrier = new ShutdownSignalBarrier(() -> running.set(false))
          {
              while (running.get())
              {
                  ...
              }
          }
      }
  }

• [Breaking] Agrona jars no longer provide OSGI metadata as bnd plugin was removed, because it breaks
  compatibility with Gradle 9.1 and causes self-dependency via baseline task.

• AtomicCounter minor javadoc improvements. (#​338)

• Upgrade to Gradle 9.1.0.

• Upgrade to ByteBuddy 1.17.7.

• Upgrade to Checkstyle 11.1.0.

• Upgrade to JUnit 5.13.4.

• Upgrade to Mockito 5.20.0.

• Upgrade to Shadow 9.2.2.

• Upgrade to Versions 0.53.0.