Name: dsR10051 Date: 12/15/2003


Filed By : SPB JCK team (###@###.###)
JDK : java full version "1.5.0-beta-b30"
JCK : 1.5
Platform[s] : Solaris
switch/Mode :
JCK test owner : http://javaweb.eng/jct/sqe/JCK-tck/usr/owners.jto
Failing Test [s] : N/A


Specification excerpt:
======================
--------- J2SE API spec v.1.5 ---------
...
    /**
     * Returns the persistence delegate for the given type.
     * The persistence delegate is calculated
     * by applying the following of rules in order:
     * <ul>
     * <li>
     * If the type is an array, an internal persistence
     * delegate is returned which will instantiate an
     * array of the appropriate type and length, initializing
     * each of its elements as if they are properties.
     * <li>
     * If the type is a proxy, an internal persistence
     * delegate is returned which will instantiate a
     * new proxy instance using the static
     * "newProxyInstance" method defined in the
     * Proxy class.
     * <li>
     * If the BeanInfo for this type has a <code>BeanDescriptor</code>
     * which defined a "persistenceDelegate" property, this
     * value is returned.
     * <li>
     * In all other cases the default persistence delegate
     * is returned. The default persistence delegate assumes
     * the type is a <em>JavaBean</em>, implying that it has a nullary constructor
     * and that its state may be characterized by the matching pairs
     * of "setter" and "getter" methods returned by the Introspector.
     * </ul>
     *
     * @param type The type of the object.
     * @return The persistence delegate for this type of object.
     *
     * @see #setPersistenceDelegate
     * @see java.beans.Introspector#getBeanInfo
     * @see java.beans.BeanInfo#getBeanDescriptor
     */
    public PersistenceDelegate getPersistenceDelegate(Class type) {

...
---------- end-of-excerpt ---------------

Problem description
===================
Javadoc for method of class java.beans.Encoder
public PersistenceDelegate getPersistenceDelegate(Class type)
is incomplete. It should explain how persistence delegate is calculated if
java.beans.Encoder.setPersistentDelegate for given type has previously called.
There are no rules in javadoc for this case.


JCK test source location:
==========================
/java/re/jck/1.5/promoted/latest/JCK-runtime-15/tests
    
======================================================================