Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4968536

DOC: Javadoc for java.beans.Encoder.getPersistenceDelegate is incomplete

    XMLWordPrintable

    Details

    • Subcomponent:
    • Resolved In Build:
      b84
    • CPU:
      sparc
    • OS:
      solaris_2.6

      Description

      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
          
      ======================================================================

        Attachments

          Activity

            People

            Assignee:
            malenkov Sergey Malenkov (Inactive)
            Reporter:
            sdasunw Sda Sda (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: