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
commit e5453b9e0032313d39c0177615c7ebade6fb29a1 Author: James Bognar <[email protected]> AuthorDate: Tue May 12 10:20:39 2026 -0400 docs(9.5): document MarshallingInterceptor -> commons.bean.BeanInterceptor move (Phase 5a) Removes the BeanInterceptor row from the 9.5 rename tables (the rename was reverted by Phase 5a; net effect is a package move only), adds a new "Package Moves" subsection describing the swap.MarshallingInterceptor -> commons.bean.BeanInterceptor migration, and updates BeanAnnotation.md to reference the new fully-qualified class name. Co-authored-by: Cursor <[email protected]> --- pages/release-notes/9.5.0.md | 11 ++++++++++- pages/topics/02.04.03.BeanAnnotation.md | 4 ++-- pages/topics/23.01.V9.5-migration-guide.md | 1 - 3 files changed, 12 insertions(+), 4 deletions(-) diff --git a/pages/release-notes/9.5.0.md b/pages/release-notes/9.5.0.md index f6022db9a0..6311aef1f7 100644 --- a/pages/release-notes/9.5.0.md +++ b/pages/release-notes/9.5.0.md @@ -38,7 +38,6 @@ A comprehensive rename of annotation and engine types to clarify the distinction | `BeanTraverseContext` | `MarshallingTraverseContext` | | `BeanTraverseSession` | `MarshallingTraverseSession` | | `BeanRecursionException` | `MarshallingRecursionException` | -| `BeanInterceptor` | `MarshallingInterceptor` | | `BeanStringSwap` | `MarshallingStringSwap` | | `BeanContextConverter` | `MarshallingContextConverter` | | `BeanDefMapper` | `MarshallingDefMapper` | @@ -49,6 +48,16 @@ A comprehensive rename of annotation and engine types to clarify the distinction The following `BeanXxx` types model the *Java bean structure* and are deliberately unchanged: `BeanMap`, `BeanMeta`, `BeanPropertyMeta`, `BeanPropertyValue`, `BeanPropertyConsumer`, `BeanRegistry`, `BeanDictionaryMap`, `BeanDictionaryList`, `BeanProxyInvocationHandler`, `BeanDiff`. +##### Package Moves (Phase 5 of bean-layer split) + +As part of the bean-layer split (separating bean-modeling from marshalling), the `BeanInterceptor` type was moved into the new `org.apache.juneau.commons.bean` package in `juneau-commons`: + +| Old | New | +|-----|-----| +| `org.apache.juneau.swap.MarshallingInterceptor` | `org.apache.juneau.commons.bean.BeanInterceptor` | + +This is both a rename (back to the pre-9.5 `BeanInterceptor` name) and a package move. Source code referencing the type by simple name through wildcard imports may need to update its import from `org.apache.juneau.swap.*` to `org.apache.juneau.commons.bean.*` (or add an explicit import). + ##### New Feature: `@Marshalled(as=STRING)` Strategy A new `MarshalledAs` enum with values `DETECT` (default) and `STRING` has been added to `@Marshalled`: diff --git a/pages/topics/02.04.03.BeanAnnotation.md b/pages/topics/02.04.03.BeanAnnotation.md index 39d0a7a795..18ac6861ab 100644 --- a/pages/topics/02.04.03.BeanAnnotation.md +++ b/pages/topics/02.04.03.BeanAnnotation.md @@ -110,11 +110,11 @@ public class C3 extends C2 { } ``` -The <a href="/site/apidocs/org/apache/juneau/annotation/Marshalled.html#interceptor()" target="_blank">@Marshalled(interceptor)</a> annotation and <a href="/site/apidocs/org/apache/juneau/swap/MarshallingInterceptor.html" target="_blank">MarshallingInterceptor</a> class can be used to perform interception and inline handling of bean getter and setter calls. +The <a href="/site/apidocs/org/apache/juneau/annotation/Marshalled.html#interceptor()" target="_blank">@Marshalled(interceptor)</a> annotation and <a href="/site/apidocs/org/apache/juneau/commons/bean/BeanInterceptor.html" target="_blank">BeanInterceptor</a> class can be used to perform interception and inline handling of bean getter and setter calls. ```java // Interceptor that strips out sensitive information on Address beans. -public class AddressInterceptor extends MarshallingInterceptor { +public class AddressInterceptor extends BeanInterceptor { @Override public Object readProperty(Address bean, String name, Object value) { diff --git a/pages/topics/23.01.V9.5-migration-guide.md b/pages/topics/23.01.V9.5-migration-guide.md index 8b3f6c2480..6d98cb28bc 100644 --- a/pages/topics/23.01.V9.5-migration-guide.md +++ b/pages/topics/23.01.V9.5-migration-guide.md @@ -63,7 +63,6 @@ teams jumping from 9.1 (or earlier) directly to 9.5 have a single reference. | `BeanTraverseContext` | `MarshallingTraverseContext` | | `BeanTraverseSession` | `MarshallingTraverseSession` | | `BeanRecursionException` | `MarshallingRecursionException` | -| `BeanInterceptor` | `MarshallingInterceptor` | | `BeanStringSwap` | `MarshallingStringSwap` — also see `@Marshalled(as=STRING)` for the common case | | `BeanContextConverter` | `MarshallingContextConverter` | | `BeanDefMapper` | `MarshallingDefMapper` |
