infernap12/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2026-01-28 12:09:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

8366002: Beans.instantiate needs to describe the lookup procedure

Browse Source 
Reviewed-by: serb, aivanov
This commit is contained in:
Phil Race 2025-10-07 19:08:22 +00:00
parent 7f070d356c
commit 6bfd018bea
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/java.desktop/share/classes/java/beans/Beans.java
View File

@ -64,6 +64,22 @@ public class Beans {
* <p>
* Instantiate a JavaBean.
* </p>
* The bean is created based on a name relative to a class-loader.
* This name should be a {@linkplain ClassLoader##binary-name binary name} of a class such as "a.b.C".
* <p>
* The given name can indicate either a serialized object or a class.
* We first try to treat the {@code beanName} as a serialized object
* name then as a class name.
* <p>
* When using the {@code beanName} as a serialized object name we convert the
* given {@code beanName} to a resource pathname and add a trailing ".ser" suffix.
* We then try to load a serialized object from that resource.
* <p>
* For example, given a {@code beanName} of "x.y", {@code Beans.instantiate} would first
* try to read a serialized object from the resource "x/y.ser" and if
* that failed it would try to load the class "x.y" and create an
* instance of that class.
*
* @return a JavaBean
* @param cls the class-loader from which we should create
* the bean. If this is null, then the system
@ -84,6 +100,22 @@ public class Beans {
* <p>
* Instantiate a JavaBean.
* </p>
* The bean is created based on a name relative to a class-loader.
* This name should be a {@linkplain ClassLoader##binary-name binary name} of a class such as "a.b.C".
* <p>
* The given name can indicate either a serialized object or a class.
* We first try to treat the {@code beanName} as a serialized object
* name then as a class name.
* <p>
* When using the {@code beanName} as a serialized object name we convert the
* given {@code beanName} to a resource pathname and add a trailing ".ser" suffix.
* We then try to load a serialized object from that resource.
* <p>
* For example, given a {@code beanName} of "x.y", {@code Beans.instantiate} would first
* try to read a serialized object from the resource "x/y.ser" and if
* that failed it would try to load the class "x.y" and create an
* instance of that class.
*
* @return a JavaBean
*
* @param cls the class-loader from which we should create