This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch docs
in repository https://gitbox.apache.org/repos/asf/juneau.git
The following commit(s) were added to refs/heads/docs by this push:
new 27dccaa412 refactor: replace juneau-my-jetty-microservice template
with juneau-microservice-jetty module
27dccaa412 is described below
commit 27dccaa41278d71b767de3b7cf6a2ccb05cd3ddd
Author: James Bognar <[email protected]>
AuthorDate: Sun Jun 7 08:36:00 2026 -0400
refactor: replace juneau-my-jetty-microservice template with
juneau-microservice-jetty module
---
pages/release-notes/10.0.0.md | 35 +++++++++++++++++++++++++++++++++--
1 file changed, 33 insertions(+), 2 deletions(-)
diff --git a/pages/release-notes/10.0.0.md b/pages/release-notes/10.0.0.md
index 07e0dbd4cd..1b6fd4ae0c 100644
--- a/pages/release-notes/10.0.0.md
+++ b/pages/release-notes/10.0.0.md
@@ -30,7 +30,36 @@ No functional behavior was changed as part of this cleanup;
all changes were pur
### New Features
-_TBD — to be filled in as development continues._
+### juneau-microservice-jetty
+
+#### `JettyMicroservice` zero-config facade + bundled defaults
+
+`juneau-microservice-jetty` now ships a thin convenience facade,
`JettyMicroservice`, that collapses the `Microservice` + `JettyConfiguration`
bootstrap into a single static call, plus classpath defaults for `jetty.xml`
and `juneau.cfg`. End result: stand up a Jetty-backed Juneau microservice with
one Maven dependency and one `@Bean Servlet`.
+
+```java
+public class App {
+ public static void main(String[] args) throws Exception {
+ JettyMicroservice.run(args, new RootResources()).join();
+ }
+}
+```
+
+Bundled classpath defaults (all overridable):
+
+- **`jetty.xml`** — single plain-HTTP `ServerConnector` on
`$S{availablePort,10000}`. No `resourceBase` / `WebAppContext` /
`ResourceHandler` filesystem mount is registered (no static-file serving by
default — TODO-126 SAFE classification). Servlets are auto-mounted by
`JettyServerComponent` from `@Bean Servlet` contributions.
+- **`juneau.cfg`** — sections for `[Jetty]` (port, `jetty.xml` reference, var
resolution), `[REST]` (default theme), `[Console]` (interactive console enabled
with the standard `exit` / `restart` / `help` / `config` commands), `[Logging]`
(`logDir`), and `[SystemProperties]` (Jetty SLF4J adapter wiring).
+
+Override semantics are unchanged: a consumer-supplied `jetty.xml` or
`juneau.cfg` on the working directory or earlier on the classpath wins, as does
a `@Bean JettyServerFactory` / `@Bean JettySettings` in the consumer's
`@Configuration`.
+
+The `JettyMicroservice.run(...)` facade has three overloads:
+
+- `run(String[] args, Servlet rootServlet)` — interactive console enabled.
+- `run(String[] args, Servlet rootServlet, boolean startConsole)` — explicit
console opt-in/out.
+- `run(String[] args, WritableBeanStore beanStore, boolean startConsole,
Class<?>... configurations)` — power-user form for callers contributing
multiple `@Bean Servlet`s, custom `MicroserviceListener`s, or a parent bean
store.
+
+#### `juneau-my-jetty-microservice` retired (BREAKING)
+
+The legacy `juneau-my-jetty-microservice` template module has been removed
from the reactor. Consumers should migrate to the new `JettyMicroservice`
facade in `juneau-microservice-jetty` — it delivers the same zero-config
developer experience without requiring the consumer to copy a template project.
### Bug Fixes
@@ -38,7 +67,9 @@ _TBD — to be filled in as development continues._
### Breaking Changes
-_TBD — to be filled in before release. See also the major version bump note
above._
+- **`juneau-my-jetty-microservice` removed.** The template-project module has
been retired in favor of the new `JettyMicroservice` facade + bundled defaults
in `juneau-microservice-jetty`. See the New Features section above for
migration guidance.
+
+_Other entries TBD — to be filled in before release. See also the major
version bump note above._
### Deprecations
