This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git
The following commit(s) were added to refs/heads/master by this push:
new ecbe971ac Update new docs
ecbe971ac is described below
commit ecbe971ac80e51eea69b7a6b202d4b4670c126f4
Author: James Bognar <[email protected]>
AuthorDate: Wed Sep 17 15:04:27 2025 -0400
Update new docs
---
juneau-docs-poc/docs/release-notes/8.1.0.md | 68 +++++++++++++++++++----------
1 file changed, 44 insertions(+), 24 deletions(-)
diff --git a/juneau-docs-poc/docs/release-notes/8.1.0.md
b/juneau-docs-poc/docs/release-notes/8.1.0.md
index d2148e11c..ab9d816c4 100644
--- a/juneau-docs-poc/docs/release-notes/8.1.0.md
+++ b/juneau-docs-poc/docs/release-notes/8.1.0.md
@@ -198,31 +198,47 @@ New support for using Servlet request attributes.
~~RestMethod.attrs()~~
~~RestResource.attrs()~~
This deprecates the following APIs:
-~~RequestProperties~~
-~~RestMethodProperties~~
-[RestRequest]({{API_DOCS}}/org/apache/juneau/rest/RestRequest.html)
-~~RestRequest.getProperties() getProperties()~~
-~~RestRequest.prop(String,Object) prop(String,Object)~~
+
+<tree>
+<java-class>~~RequestProperties~~</java-class>
+<java-class>~~RestMethodProperties~~</java-class>
+<java-class>[RestRequest]({{API_DOCS}}/org/apache/juneau/rest/RestRequest.html)</java-class>
+<node-1><java-method>~~RestRequest.getProperties()
getProperties()~~</java-method></node-1>
+<node-1><java-method>~~RestRequest.prop(String,Object)
prop(String,Object)~~</java-method></node-1>
+</tree>
+
Added the following classes that provide the same support as the servlet
classes but doesn't extend from `HttpServlet`.
This fixes an issue where instances of ~~BasicRestServlet~~ are registered as
top-level servlets even though
-you don't want them to be.
-~~BasicRest~~ - Non-servlet equivalent to ~~BasicRestServlet~~
-~~BasicRestGroup~~ - Non-servlet equivalent to ~~BasicRestServletGroup~~
-~~BasicRestJena~~ - Non-servlet equivalent to ~~BasicRestServletJena~~
-~~BasicRestJenaGroup~~ - Non-servlet equivalent to
~~BasicRestServletJenaGroup~~
+you don't want them to be.
+
+<tree>
+<java-abstract-class>~~BasicRest~~ - Non-servlet equivalent to
~~BasicRestServlet~~</java-abstract-class>
+<java-abstract-class>~~BasicRestGroup~~ - Non-servlet equivalent to
~~BasicRestServletGroup~~</java-abstract-class>
+<java-abstract-class>~~BasicRestJena~~ - Non-servlet equivalent to
~~BasicRestServletJena~~</java-abstract-class>
+<java-abstract-class>~~BasicRestJenaGroup~~ - Non-servlet equivalent to
~~BasicRestServletJenaGroup~~</java-abstract-class>
+</tree>
+
HTML widgets now have access to the `RestResponse` object if they need access
to the output bean.
New annotations for simplified role-based guards on classes and methods:
-~~RestResource~~
-~~roleGuard()~~
-~~rolesDeclared()~~
-~~RestMethod~~
-~~RestMethod.roleGuard roleGuard()~~
-~~RestMethod.rolesDeclared rolesDeclared()~~
+
+<tree>
+<java-annotation>~~RestResource~~</java-annotation>
+<node-1><java-method>~~roleGuard()~~</java-method></node-1>
+<node-1><java-method>~~rolesDeclared()~~</java-method></node-1>
+<java-annotation>~~RestMethod~~</java-annotation>
+<node-1><java-method>~~RestMethod.roleGuard
roleGuard()~~</java-method></node-1>
+<node-1><java-method>~~RestMethod.rolesDeclared
rolesDeclared()~~</java-method></node-1>
+</tree>
+
New annotations for fine-tuned handling of http-methods/http-headers as query
parameters and others:
-~~RestResource~~
-~~allowedHeaderParams()~~
-~~allowedMethodHeaders()~~
-~~allowedMethodParams()~~
+
+<tree>
+<java-annotation>~~RestResource~~</java-annotation>
+<node-1><java-method>~~allowedHeaderParams()~~</java-method></node-1>
+<node-1><java-method>~~allowedMethodHeaders()~~</java-method></node-1>
+<node-1><java-method>~~allowedMethodParams()~~</java-method></node-1>
+</tree>
+
The ~~@RestResource(path)~~annotation can now use variables:
```text
@@ -238,10 +254,14 @@ New methods:
[RestResponse]({{API_DOCS}}/org/apache/juneau/rest/RestResponse.html)
[getCharset()]({{API_DOCS}}/org/apache/juneau/rest/RestResponse.html#getCharset())
New interface method for catching arbitrary thrown objects and converting them
to other throwables.
-~~RestCallHandler~~
-~~RestCallHandler.convertThrowable(Throwable) convertThrowable(Throwable)~~
-~~BasicRestCallHandler~~
-~~convertThrowable(Throwable)~~
+
+<tree>
+<java-class>~~RestCallHandler~~</java-class>
+<node-1><java-method>~~RestCallHandler.convertThrowable(Throwable)
convertThrowable(Throwable)~~</java-method></node-1>
+<java-class>~~BasicRestCallHandler~~</java-class>
+<node-1><java-method>~~convertThrowable(Throwable)~~</java-method></node-1>
+</tree>
+
Support for fine-tuned logging of HTTP requests and responses.
```text
