3.0.2

This is a bugfix release of Helidon and is recommended for all users of Helidon 3.

CHANGES

• CORS: Fix CORS annotation handling error in certain cases 5104
• Config: @ConfigProperties without bean defining annotation - 3x 4853
• DBClient: Issue #4719 - Helidon DBClient does not trigger an Exception when no sane DB connection can be obtained 4771
• Health: Use lazy values to initialized HealthSupport FT handlers 5146
• JAX-RS: Make Application subclasses available via our context during Feature executions (3.x) 4786
• Jersey: Register a low-priority exception mapper to log internal errors 5073
• Messaging: AQ Connector - JEP 290 4672
• Metrics: Fix OpenMetrics formatting error (3.x) 4900
• MicroProfile: Fix identification of parallel startup of CDI 4993
• MicroProfile: MP path based static content should use index.html (3.x) 4736
• Native-image: add serial config required for oracle driver (3.x) 4960
• Reactive: MultiFromBlockingInputStream RC fix 3x 3597
• RestClient proxy test exclusion removed 4769
• Security: Access token refresh - 3.x 4821
• Security: JWT-Auth implementation encrypted token recognition fixed 4811
• WebClient: DNS resolver should not be possible to set per request 4814
• WebClient: Dns resolver type method on webclient builder 4838
• WebClient: Round Robin added as DNS resolver option 4798
• WebServer: Default header size increased to 16K - Helidon 3.x 5016
• WebServer: Watermarked response backpressure 3x 4724
• Dependencies: Update graphql-java to 17.4 4966
• Dependencies: Upgrade Hibernate to 6.1.4.Final, EclipseLink to 3.0.3 5100
• Dependencies: Upgrade Postgre driver 4742
• Dependencies: Upgrade protobuf-java 5133
• Dependencies: Upgrade reactive-streams to 1.0.4 5045
• Dependencies: Upgrade snakeyaml to 1.32 4922
• Dependencies: Upgrades OCI to 2.45.0 on helidon-3.x 4827
• Docs: Fix for issue 4793 in tracing doc 4795
• Docs: editorial updates to DB Client guide 4499
• Docs: 4184 logging for an MP app 4903
• Docs: Documentation minor fix 4902
• Docs: Fix broken links for Oracle Universal Connection Pool (#4781) 4862
• Docs: Fix broken links for ServerThreadPoolSupplier and ScheduledThreadPoolSupplier in mp/fault-tolerance.adoc (#4899) 4909
• Docs: Fix invalid example in se/config/advanced-configuration.adoc (#4775) 4920
• Docs: Fix misplaced attribute settings 4954
• Docs: Fix the structure of the table in the section "Traced spans" (#4792) 4859
• Docs: Replace deprecated ServerConfiguration.builder() on WebServer.builder() in docs - backport 3.x (#5025) 5117
• Docs: Update a few icons in the docs 4937
• Docs: Updated supported version of MicroProfile to 5.0 4917
• Docs: update old K8s deployment yaml 4760
• Docs: updates for PR 4520 language review 4731
• Examples: 4857 arch fix minor issues (backport) 4874
• Examples: Formatting of generated Helidon SE quickstart (backport) 4969
• Examples: Quickstart MP with Jackson fix JSON message 4905
• Examples: Remove module-info files from examples (3.x) 4894
• Examples: Tracing config updates in archetype 5137
• Examples: WebClient dependency in generated Helidon SE Quickstart should be in test scope (backport) 5020
• Examples: change beans.xml 4845
• Examples: k8s and v8o support in archetype (3.x) 4887
• Examples: Do not generate CDS archive when using Dockerfile.jlink 5158
• Test: 4980 EchoServiceTest timeout 5005
• Test: 5068 mock connector beans xml 3x 5069
• Test: Add robustness to some of the timing-susceptible metrics tests; add util matcher with retry 5047
• Test: Add some retries because post-request metrics updates occur after the response is sent 5136
• Test: Do not use retry to fix the test; stats are approximate; just check for existence, not values 5112
• Test: Fix FT intermittent failure - archetype build (backport) 4934
• Test: Fix for failing GraphQL tests on Windows 4732
• Test: HelidonTest doesn't start container properly with TestInstance.Lifecycle.PER_CLASS #4663 4865
• Test: Intermittent test fix, using random port for tests. 4800
• Test: Issue 4740 - JPA integration tests should run on every build 5027
• Test: Special Windows build Config TCK profile no longer needed 4816
• Test: Use Hamcrest assertions instead of JUnit in tests 5057 (and others)

2.5.5

This is a bugfix release of Helidon. It is recommended for all users of Helidon 2.

CHANGES

• Common: Add info to Charbuf exceptions 5368
• Config: Provide MP config profile support for application.yaml 5565
• DBClient: Handle exception on inTransaction apply 5644
• Docker: remove -Ddocker.build=true 5486
• Fault Tolerance: Additional @Retry strategies 5230
• GRPC: Grpc component Does not handle package directive in proto files. 5150
• Health: Use lazy values to initialized HealthSupport FT handlers 5106
• LRA: LRA false warning 5554
• Messaging: Message body operator matching with parameters 5523
• MicroProfile: Add null check to MP Server.Builder.config() 5363
• OpenAPI: Add support for OpenAPI UI [2.x] 5584
• Security: Add relativeUris flag in OidcConfig to allow Oidc webclient to use relative path on the request URI 5267
• Security: Jwt scope handling extended over array support 5520
• Security: Multitenant lazy loading implementation improved 5678
• Security: OIDC multi-tenant and lazy loading implementation 5168
• Security: Use only public APIs to read PKCS#1 keys (#5240) 5259
• Vault: Remove experimental flag from Vault docs (#5431) 5539
• WebServer: Log an entry in warning level for a 400 or 413 response 5298
• WebServer: NullPointerException when there is an illegal character in the request 5470
• WebServer: WebServer.Builder media support methods with Supplier variants 5640
• Copyrights: Remove trailing empty line in copyright comment 5324 and others
• Dependencies: Fix Guava version to match that required by the grpc-java libraries 5446
• Dependencies: Manage protobuf version using BOM 5177
• Dependencies: Upgrade PostgreSQL JDBC driver dependency to 42.4.3 5563
• Dependencies: Upgrade grpc-java to 1.49.2 5360
• Dependencies: Upgrade protobuf-java. 5132
• Dependencies: Upgrade to jackson-databind-2.13.4.2 via bom 2.13.4.20221013 5303
• Dependencies: Upgrade build-tools to 2.3.7 5705
• Docs: Add doc describing use of OpenAPI code generator to 2.x 5590
• Docs: Archetype Doc 5576
• Docs: Replace deprecated ServerConfiguration.builder() on WebServer.builder() in docs - backport 2.x (#5024) 5119
• Docs: flatMapCompletionStage javadoc fix 5623
• Examples: Add OCI MP Archetype 5366
• Examples: Include istio and lra examples in reactor. Fix version numbers 5277
• Examples: Remove license-report from maven lifecycle 5245
• Tests: Add some retries because post-request metrics updates occur after the response is sent 5142
• Tests: Fix Intermittent TestJBatchEndpoint.runJob 5558
• Tests: Fix intermittent jBatch test 5248
• Tests: Move checkLazyFaultToleranceInitialization() test to its own class 5138
• Tests: Remove value check of executor metrics; just check for existence 5120
• Tests: Simplify named socket WebTarget injection in Tests 5315
• Tests: Use Hamcrest assertions instead of JUnit 5275 and others

4.0.0-ALPHA2

This is the second Alpha build of Helidon 4.0.0 and is intended as a preview release only. Do not use this release in production. It is suitable only for experimentation. APIs are subject to change. Documentation is incomplete. And some functionality is experimental and not fully tested.

The big news in Helidon 4.0.0 is the introduction of Helidon Nima -- a ground up webserver implementation based on JDK Project Loom.

Helidon 4.0.0 is a major release that includes significant new features and fixes. As a major release it also includes some backward incompatible API changes.

Java 19 is required to use Heldon 4.0.0.

CHANGES

• Common: Refactor HTTP header class names to a more natural approach. 4858
• Config: Refactor helidon config 4.0 4776
• Config: Use common Config in common configurable. 5015
• Config: fix for issue in handling ConfigProperties using List 4959
• DBClient: Helidon DBClient does not trigger an Exception when no sane DB connection can be obtained 4773
• Dependencies: Upgrade EclipseLink to 3.0.3 and Hibernate to 6.1.4.Final 5101
• Dependencies: Upgrade reactive streams to 1.0.4 5046
• Dependencies: Upgrade snakeyaml to 1.32 4923
• Dependencies: Update graphql-java to 17.4 4983
• FT: retry checkMetricsForExecutorService 5103
• JAX-RS: Register a low-priority exception mapper to log internal errors 5082
• Logging: Logging refactoring 4825
• MicroProfile: Fix identification of parallel startup of CDI 4964
• Native Image: remove redundant reflect-config.json 4844
• Nima: Context support for Níma WebServer 4867
• Nima: Perf improvements 4818
• Nima: Port and cleanup of old reactive tests for Nima bulkheads 4823
• Nima: Shutdown executors while stopping the server 4819
• Reactive: MultiFromBlockingInputStream RC fix 4x 5055
• Security: Access token refresh - 4.x backport 4822
• WebServer: Default header size increased to 16K for Http1ConnectionProvider in NIMA 5017
• WebServer: Use Header.create() for both header names and header values. 4864
• WebServer: Watermarked response backpressure 4x 5063
• Doc: Fix invalid example in se/config/advanced-configuration.adoc - backport 4.x (#4775) 4944
• Doc: Fix misplaced attribute settings 4955
• Doc: Formatting of generated Helidon SE quickstart 4967
• Doc: Preamble fix 5051
• Doc: Ported Access Log documentation to 4.x 5054
• Examples: 4834 4835 fix archetype test issues 4841
• Examples: Remove module-info files from examples 4895
• Examples: WebClient dependency in generated Helidon SE Quickstart should be in test scope 5019
• Examples: add serial config required for oracle driver 4961
• Examples: fix db issues in Helidon archetype 4805
• Examples: k8s and v8o support in archetype 4891
• Test: 5068 mock connector beans xml 4x 5070
• Test: Ported TestInstance.Lifecycle.PER_CLASS fix to 4.x 5052
• Test: Updated intermittently failing CircuitBreakerTest 5033
• Test: Add robustness to some of the timing-susceptible metrics tests; add util matcher with retry 5032
• Test: EchoServiceTest timeout 5007
• Test: Ported combined FT test to Nima and enhancements to Async 4840
• Test: Removed deprecated tests, disabled pipelining test. 5010
• Test: Special Windows build Config TCK profile no longer needed - 4.x 4870
• Test: Vault tests 5026
• Test: integration tests should run on every build 5080

2.5.4

This is a bugfix release of Helidon. It is recommended for all users of Helidon 2.

CHANGES

• CORS: Fix CORS annotation handling error in certain cases 5102
• DBClient: Helidon DBClient does not trigger an Exception when no sane DB connection can be obtained 4772
• Examples: Remove module-info files from examples 4893
• JAX-RS: Register a low-priority exception mapper to log internal errors 5059
• Metrics: OpenMetrics formatting issue; add tests 4901
• MicroProfile: Fix identification of parallel startup of CDI 4994
• WebClient: WebClient uses DataPropagationProvider to module-info 4916
• WebServer: Default header size increased to 16K Helidon Server and docs 5018
• WebServer: Watermarked response backpressure 5062
• Dependencies: Update graphql-java to 17.4 4992
• Dependencies: Upgrade build-tools to 2.3.6 5099
• Dependencies: Upgrade eclipselink to 2.7.11 4974
• Dependencies: Upgrade hibernate to 5.6.11.Final 4965
• Dependencies: Upgrade reactive-sreams to 1.0.4 5044
• Dependencies: Upgrade snakeyaml to 1.32 4921
• Dependencies: upgrade hibernate validator to 6.2.5 5037
• Docs: Fix invalid example in se/config/advanced-configuration.adoc (#4775) 4943
• Docs: Sec provider 4810 5034
• Test: EchoServiceTest timeout 5006
• Test: Fixed race condition in the OCI Metrics integration test between retrieval of metrics from registry and asserting that from expected results 4897
• Test: MultiFromBlockingInputStream RC fix 5061
• Test: Rest Client timeout test exclusion 5077
• Test: ThreadPoolTest 4988
• Test: Use Hamcrest assertions instead of JUnit (#1749) 5087 and others

2.5.3

This is a bugfix release of Helidon. It is recommended for all users of Helidon 2.

Compatibility

2.5.3 is API compatible with 2.4.0.

CHANGES

• Config: Injection of Map from configuration now honors prefix (backport) 4659
• Config: Obtaining parent dir for watcher service fixed 4666
• Config: Unescape the keys when config is returned as a map 4678
• Dependencies: Upgrade snakeyaml to 1.31 4849
• Dependencies: Upgrades OCI to 2.41.0 4812
• Docs: Fix K8s deployment yaml 4761
• Grpc: Upgrade protobuf to support osx-aarch_64 architecture 4630
• JAX-RS: Make Application subclasses available via our context during Feature executions 4745
• LRA: 4749 LRA fixes backport 4824
• MicroProfile: MP path based static content should use index.html 4735
• Native image: Issue #4741 - Upgrade Postgre driver to 42.4.1 4780
• Security: Access token refresh 4758
• Security: Configuration parameter 'cookie-encryption-password' takes only a single character rather than a string (#4512) 4657
• Tests: Intermittent test fix, using random port for tests 4801
• WebClient: DNS resolver should not be possible to set per request 4815
• WebClient: Dns resolver type method on webclient builder 4839
• WebClient: Round Robin added as DNS resolver option 4806
• WebServer: WebServerTls parts should not be initialized when disabled 4651

4.0.0-ALPHA1

We are pleased to announce Helidon 4.0.0-ALPHA1. The big news in this release is the introduction of Helidon Nima -- the foundation of the next generation of Helidon. Nima's server implementation is written from the ground up to take advantage of virtual threads from JDK Project Loom.

This is an Alpha build of Helidon 4.0.0. It is experimental and intended as a technology preview only. Do not use this release in production. APIs are subject to change and functionality is incomplete. Over the upcoming months we will have additional 4.0.0 Alpha builds as we continue to migrate code to Nima.

JDK 19 Early Access is required to use Helidon 4.0.0-ALPHA1.

For more information including how to try Helidon Nima see Helidon Níma — Helidon on Virtual Threads

3.0.1

This is a bugfix release of Helidon and is recommended for all users of Helidon 3.

CHANGES

• Common: Change log level to fine for exception caught while intercepting 4640
• Config: Map injection behavior restored 4653
• Config: Obtaining parent dir for watcher service fixed 4665
• Config: Unescape the keys when config is returned as a map 4715
• Deps: Upgrade protobuf to support osx-aarch_64 architecture 4662
• FT: Changes to FT implementation to support interception of proxy methods 4650
• Messaging: JMS Shim wraps null message fix 4671
• Metrics: Config metadata should be optional and provided 4728
• OCI: Undo manual shaded jar tasks 4619
• Security: Configuration parameter 'cookie-encryption-password' takes only a single character rather than a string 4675
• Test: Coordinator test fix 4610
• Test: Fix location of JDK to use a link and not installation 4661
• Test: Fixed orphaned modules. 4658
• WebServer: WebServerTls parts should not be initialized when disabled 4652
• WebSocket: Updated WebSocketHandler to correctly propagate query params from weberver to Tyrus 4647
• Build: Fix all copyright warnings. 4660
• Build: Fix release.sh to update version in attributes.adoc 4689
• Docs: various documentation updates 4727 4627 4707 4713 4714 4623 4726 4689 4687 4692 4676 4637 4723 4730
• Examples: Add examples for SE and MP to update counters of HTTP response status ranges (1xx, 2xx, etc.) 4617
• Examples: Fix JDK base image in Dockerfiles 4634
• Examples: Remove redundant pkg folder in a project generated by helidon CLI 4642

3.0.0

We are pleased to announce Helidon 3.0.0 a major release that includes significant new features and fixes. As a major release it also includes some backward incompatible API changes.

Notable Changes

• MicroProfile 5.0
• Jakarta EE 9.1 with javax to jakarta Java package namespace change
• Java 17 minimum JDK. Java 11 no longer supported.
• JEP-290 security hardening
• Updated Helidon SE routing API
• Numerous other enhancements and fixes

Upgrading from Helidon 2

For information concerning upgrading your Helidon 2 application to Helidon 3 please see:

• Helidon MP 3.x Upgrade Guide
• Helidon SE 3.x Upgrade Guide

CHANGES

For the list of changes please see the the 3.0.0 CHANGELOG

2.5.2

This is a bugfix release of Helidon. It is recommended for all users of Helidon 2.

Compatibility

2.5.2 is API compatible with 2.4.0.

CHANGES

• CORS: Correct return of path from MP CORS request adapter; add test (2.x) 4434
• CORS: Preserve order of mapped cross-origin config path entries from config; add test (2.x) 4432
• Common: Completed @deprecated annotation and fixed Javadoc 4389
• Common: Completed @deprecated annotations in common configurable 4395
• Common: Update @Deprecated anno in 2.x service-common/rest 4392
• Config: Add helidon-config-yaml-mp as a dependency in helidon-microprofile-config. (#4379) 4394
• Docs: Add documentation for hocon/json support and meta-config extensibility on MP 4391
• Docs: Fix MP references in SE metrics guide 4648
• Examples: Add examples for SE and MP to update counters of HTTP response status ranges (1xx, 2xx, etc.) for 2.x 4616
• Examples: Fix gRPC examples that are failing. (#4585) 4635
• Examples: OCI Integration Examples Update 2.x 4502
• Examples: Uses lowercase for database column names in se … 4274
• FT: Added config support for bulkheads, breakers, timeouts and retries 4337
• FT: Changes to FT implementation to support interception of proxy methods 4641
• JAX-RS: Change log level to fine for exception caught while intercepting 4632
• LRA: Coordinator test fix #4544 backport 4611
• LRA: Deprecations cleanup 2.x 4450
• Metrics: Fix deprecation annotations in metrics; update doc; revise examples (2.x) 4396
• Metrics: Remove unneeded dependency 4378
• Native Image: Add module info to native image extensions. 4588
• Native Image: Removed final from proxied types 4586
• Security: Added X509 certificate context key when client certificate is present and pem trust store configuration 4226
• Security: JEP-290 2.x 4587
• Test: Removed usage of deprecated method. 4401
• Tracing: Cleanup of E2E test for tracing. 4589
• Tracing: Update for Jaeger tracing. 4631
• WebClient: Context propagation across HTTP. 4612
• WebClient: Set executor of CompletableFuture for response with no content. (#4540) 4596
• WebServer: Updated TyrusSupport to correctly propagate query params from webserver 4624
• WebServer: Wrong Http/2 version 2x 4629

2.5.1

This is a bugfix release of Helidon. It is recommended for all users of Helidon 2.

Due to an intermitent issue with MicroProfile Fault Tolerance when used in a native image, we recommend using GraalVM 21.3.2 to partially mitigates the issue.

Compatibility

2.5.1 is API compatible with 2.4.0.

In this release we are no longer managing the version of Mockito for Helidon applications. If you were depending on that you will need to manage the version yourself.

CHANGES

• CDI: Abstract decorator class now gets correct proxy name in Weld 4135
• Common: Enable thread pool growth at threshold instead of above it 4245
• Common: Improve threadNamePrefix defaulting to be more informative 4165
• Common: Properly count completed and failed thread pool tasks 4244
• Config: Fix retention of @configured 4113
• Config: Remove dependency on helidon-common-reactive from config 4225
• Config: Support Hocon/Json Configuration Source for MP 4218
• Config: Support for Hocon inclusion of files without an extension 4162
• Config: Turn off reference substitution in Hocon parser level for lazy resolution of references 4167
• FaultTolerance: Fix some test regressions and some code simplifications 4239
• FaultTolerance: Fixed a few problems with Fallback and Multi's in SE 4157
• FaultTolerance: Make require transitive for helidon common reactive module 4233
• FaultTolerance: New AnnotationFinder to handle transitive annotations in FT 4216
• JPA: Adds XA support to Helidon's UCP integration 4292
• Metrics: Add cache control to metrics and health endpoints 4257
• Metrics: Correct Prometheus output for timer and JSON output for SimpleTimer 4242
• MicroProfile: Support of Bean Validation in Helidon MP #721 3885
• Native-image: Native image configuration reflection update for Jaeger 4118
• Security: Do not fail when expected audience is null 4174
• Security: Fix JwtProvider wrong error message 4137
• Security: Injection of empty SecurityContext 4173
• Security: OIDC update to support HTTPS identity provider 4270
• Security: RoleContainer support added 4275
• WebClient: Case insensitive client request headers fix 4111
• WebClient: MDC propagation 4112
• gRPC: Fixing io.grpc module-info and MP gRPC client and server module-info files 4189
• Build: Add test-nightly.sh 4277
• Dependencies: Move mockito dependency management to root pom 4283
• Dependencies: Upgrade Netty to 4.1.77.Final 4250
• Dependencies: Upgrade google-api-client 4324
• Dependencies: Upgrade jackson to 2.13.2.2 4179
• Dependencies: Upgrades Eclipselink to 2.7.10 4131
• Dependencies: Uppgrade grpc-java to 1.45.1 4146
• Dependencies: Yasson version updated 4261
• Docs: Add IDCS related info to MP Security example 4328
• Docs: Fix guide broken links and typos 4119 for 4134
• Docs: Fix guide. Change JPA Scope. 4169
• Docs: Update OCI integration documentation to reflect use of new OCI SDK extension 4329
• Examples: Gradle: Add helidon test dependency. Add task dependency for jandex 4230
• Examples: Fix deps in jpa examples plus some cleanup 4130
• Examples: Use OBJECT schema type with requiredProperties in Quickstart MP 4149
• Examples: remove buffered multipart example 4104
• Tests: Fixed problem in DelayRetryPolicyTest that would cause all delays to be zero 4217
• Tests: Fixed dbclient integration tests build issue. 4099
• Tests: Use 127.0.0.1 for client connections in test (instead of 0.0.0.0) 4280
• Tests: possible fix for HttpPipelineTest hang 4139