src/java.base/share/classes/java/lang/invoke/TypeDescriptor.java

rev 58769 : imported patch type-descriptor-name

*** 25,47 ****
  package java.lang.invoke;
  
  import java.util.List;
  
  /**
!  * An entity that has a field or method type descriptor
   *
   * @jvms 4.3.2 Field Descriptors
   * @jvms 4.3.3 Method Descriptors
   *
   * @since 12
   */
  public interface TypeDescriptor {
      /**
!      * Return the type descriptor string for this instance, which must be either
!      * a field type descriptor (JVMS 4.3.2) or method type descriptor (JVMS 4.3.3).
       *
!      * @return the type descriptor
       * @jvms 4.3.2 Field Descriptors
       * @jvms 4.3.3 Method Descriptors
       */
      String descriptorString();
  
--- 25,56 ----
  package java.lang.invoke;
  
  import java.util.List;
  
  /**
!  * An entity that has a type descriptor.
   *
   * @jvms 4.3.2 Field Descriptors
   * @jvms 4.3.3 Method Descriptors
   *
   * @since 12
   */
  public interface TypeDescriptor {
      /**
!      * Returns the descriptor string for this {@code TypeDescriptor} object.
       *
!      * If this {@code TypeDescriptor} object can be described in nominal form,
!      * then this method returns a field type descriptor (JVMS {@jvms 4.3.2})
!      * or method type descriptor (JVMS {@jvms 4.3.3}).  The result descriptor
!      * string can be used to produce a
!      * {@linkplain java.lang.constant.ConstantDesc nominal descriptor}.
!      *
!      * Otherwise, the result string is not a valid type descriptor.
!      * No {@linkplain java.lang.constant.ConstantDesc nominal descriptor}
!      * can be produced from the result string.
!      *
!      * @return the descriptor string for this {@code TypeDescriptor} object
       * @jvms 4.3.2 Field Descriptors
       * @jvms 4.3.3 Method Descriptors
       */
      String descriptorString();