Skip to content

v11.1.0

Latest

Choose a tag to compare

@efonsell efonsell released this 25 Oct 20:19
· 4 commits to master since this release

Highlights

  • Use Spring Boot 4 in nflow-examples
  • Fix #735: workflow instances stuck after graceful shutdown
  • Recover workflow instances from dead executors in configurable chunks to avoid too large SQL IN clauses
  • Fix #731: refuse to start when the default Spring transaction manager does not manage nFlow's DataSource
  • Fix #670: swagger-annotations is no longer a transitive dependency of the REST API modules
  • Add support to query archived workflow instances in nflow-explorer (#539)

Details

  • nflow-engine
    • Fix race condition that could leave workflow instances being stuck during graceful shutdown (#735).
      • Instances claimed by an executor just before a graceful shutdown could be left owned by that executor, and since the shutdown was marked graceful, no other node recovered them.
      • Such instances are now released when the executor's thread pool has finished shutting down, so other nodes can pick them up.
    • Recover workflow instances from dead executors in chunks controlled by nflow.db.max_sql_in_parameters.
      This avoids oversized SQL IN clauses, especially on SQL Server.
    • Fix startup check for transaction support (#731).
      The check only verified that some transaction was active, so it passed when the host application's @Primary PlatformTransactionManager managed a different DataSource than nFlow's.
      In that case nFlow's multi-statement writes were not atomic, e.g. a workflow instance could be processed before its state variables were committed.
      The check now also requires that the active transaction disables auto commit on nFlow's DataSource.
      If startup now fails with Transaction support must be enabled, the application's transaction manager does not manage nFlow's DataSource. Either:
      • use the same DataSource for the application and nFlow, or
      • keep nFlow's own DataSource, define a DataSourceTransactionManager on the @NFlow DataSource as the @Primary transaction manager. The application must then define its own named transaction manager and use it explicitly in its @Transactional code.
        Note that with separate DataSources, changes to application tables and nFlow tables cannot be made atomically in one transaction, unless a JTA/XA transaction manager spans both DataSources.
  • nflow-rest-api-common, nflow-rest-api-spring-web, nflow-rest-api-jax-rs
    • Fix #670: io.swagger.core.v3:swagger-annotations now has provided scope, so it is not added to the runtime classpath of applications using these modules.
      Applications that generate OpenAPI docs need it on their classpath.
  • nflow-explorer
    • Only allow http and https URLs in the returnUrl query parameter of the return link.
    • Update @azure/msal-browser to 4.30.0 and @azure/msal-react to 3.0.29. This may affect msalConfig in config.js:
      • system.allowNativeBroker is renamed to system.allowPlatformBroker.
      • With cache.cacheLocation: 'localStorage', MSAL now encrypts cached tokens using a key stored in a session cookie. Users may need to sign in again after closing the browser.
    • Add support to query archived workflow instances (#539).
      • Add "Include archived instances" checkbox to the workflow instance search form. The archive is searched only if the main tables return fewer instances than the maximum number of results.
      • Archived workflow instances can be opened from the search results. They are shown as read-only and cannot be updated.
      • Show an error message instead of an endless spinner when a workflow instance cannot be loaded.
  • Dependency updates
    • apache cxf 4.2.4
    • asm 9.11.1
    • commons-lang3 3.21.0
    • guava 33.7.2-jre
    • db2 jcc 12.1.5.0
    • hibernate validator 9.1.5.Final
    • HikariCP 7.1.0
    • jackson 2.22
    • jackson-databind, jackson-joda and jackson-jakarta-rs-json-provider 3.2.4
    • javassist 3.33.0-GA
    • jersey 4.0.3
    • jetty 12.1.14
    • joda-time 2.15.0
    • logback 1.6.5
    • mariadb 4.0.0
    • metrics 4.2.40
    • mssql 13.6.1.jre11
    • mysql-connector 26.10.0
    • ojdbc11 23.26.3.0.0
    • postgresql 42.7.14
    • reactor-core 3.8.8
    • reactor-netty 1.3.8
    • slf4j 2.0.20
    • spring 7.0.10
    • swagger 2.2.55
    • spotbugs 4.10.5
    • h2 2.5.252
    • junit5 6.1.3
    • mockito 5.24.0
    • jersey-container-simple-http replaced with jersey-container-jdk-http
  • nflow-explorer dependency updates
    • nodejs 26.12.1
    • pnpm 12.15.0
    • typescript 7.0.2
    • vite 8.3.5
    • @vitejs/plugin-react 6.1.2
    • @azure/msal-browser 4.30.0 and @azure/msal-react 3.0.29
    • react-router-dom 7.18.4
    • @fontsource/roboto 5.3.0
    • date-fns 4.4.0
    • moment 2.31.0
    • sass 1.106.1