Nested Class Summary

Method Summary

Method Details

• ofDescriptor

  static MethodTypeDesc ofDescriptor(String descriptor)

  Creates aMethodTypeDesc given a method descriptor string.

  Parameters:

  descriptor - a method descriptor string

  Returns:

  aMethodTypeDesc describing the desired method type

  Throws:

  NullPointerException - if the argument isnull

  IllegalArgumentException - if the descriptor string is not a valid method descriptor

  SeeJava Virtual Machine Specification:

  4.3.3 Method Descriptors
  

• of

  static MethodTypeDesc of(ClassDesc returnDesc)

  Returns aMethodTypeDesc with the given return type and no parameter types.

  Parameters:

  returnDesc - aClassDesc describing the return type

  Returns:

  aMethodTypeDesc with the given return type and no parameter types

  Throws:

  NullPointerException - ifreturnDesc isnull

  Since:

  21

• of

  static MethodTypeDesc of(ClassDesc returnDesc,List<ClassDesc> paramDescs)

  Returns aMethodTypeDesc given the return type and a list of parameter types.

  Parameters:

  returnDesc - aClassDesc describing the return type

  paramDescs - aList ofClassDescs describing the parameter types

  Returns:

  aMethodTypeDesc given the return type and a list of parameter types

  Throws:

  NullPointerException - if any argument or its contents arenull

  IllegalArgumentException - if any element ofparamDescs is aClassDesc forvoid

  Since:

  21

• of

  static MethodTypeDesc of(ClassDesc returnDesc,ClassDesc... paramDescs)

  Returns aMethodTypeDesc given the return type and parameter types.

  Parameters:

  returnDesc - aClassDesc describing the return type

  paramDescs -ClassDescs describing the argument types

  Returns:

  aMethodTypeDesc describing the desired method type

  Throws:

  NullPointerException - if any argument or its contents arenull

  IllegalArgumentException - if any element ofparamDescs is aClassDesc forvoid

• returnType

  ClassDesc returnType()

  Gets the return type of the method type described by thisMethodTypeDesc.

  Specified by:

  returnType in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Returns:

  aClassDesc describing the return type of the method type

• parameterCount

  int parameterCount()

  Returns the number of parameters of the method type described by thisMethodTypeDesc.

  Specified by:

  parameterCount in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Returns:

  the number of parameters

• parameterType

  ClassDesc parameterType(int index)

  Returns the parameter type of theindex'th parameter of the method type described by thisMethodTypeDesc.

  Specified by:

  parameterType in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Parameters:

  index - the index of the parameter to retrieve

  Returns:

  aClassDesc describing the desired parameter type

  Throws:

  IndexOutOfBoundsException - if the index is outside the half-open range[0, parameterCount())

• parameterList

  List<ClassDesc> parameterList()

  Returns the parameter types as an immutableList.

  Specified by:

  parameterList in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Returns:

  aList ofClassDesc describing the parameter types

• parameterArray

  ClassDesc[] parameterArray()

  Returns the parameter types as an array.

  Specified by:

  parameterArray in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Returns:

  an array ofClassDesc describing the parameter types

• changeReturnType

  MethodTypeDesc changeReturnType(ClassDesc returnType)

  Returns aMethodTypeDesc that is identical to this one, except with the specified return type.

  Specified by:

  changeReturnType in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Parameters:

  returnType - aClassDesc describing the new return type

  Returns:

  aMethodTypeDesc describing the desired method type

  Throws:

  NullPointerException - if the argument isnull

• changeParameterType

  MethodTypeDesc changeParameterType(int index,ClassDesc paramType)

  Returns aMethodTypeDesc that is identical to this one, except that a single parameter type has been changed to the specified type.

  Specified by:

  changeParameterType in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Parameters:

  index - the index of the parameter to change

  paramType - aClassDesc describing the new parameter type

  Returns:

  aMethodTypeDesc describing the desired method type

  Throws:

  NullPointerException - if any argument isnull

  IndexOutOfBoundsException - if the index is outside the half-open range[0, parameterCount)

• dropParameterTypes

  MethodTypeDesc dropParameterTypes(int start, int end)

  Returns aMethodTypeDesc that is identical to this one, except that a range of parameter types have been removed.

  Specified by:

  dropParameterTypes in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Parameters:

  start - the index of the first parameter to remove

  end - the index after the last parameter to remove

  Returns:

  aMethodTypeDesc describing the desired method type

  Throws:

  IndexOutOfBoundsException - ifstart is outside the half-open range[0, parameterCount), orend is outside the closed range[0, parameterCount], or ifstart > end

• insertParameterTypes

  MethodTypeDesc insertParameterTypes(int pos,ClassDesc... paramTypes)

  Returns aMethodTypeDesc that is identical to this one, except that a range of additional parameter types have been inserted.

  Specified by:

  insertParameterTypes in interface TypeDescriptor.OfMethod<ClassDesc,MethodTypeDesc>

  Parameters:

  pos - the index at which to insert the first inserted parameter

  paramTypes -ClassDescs describing the new parameter types to insert

  Returns:

  aMethodTypeDesc describing the desired method type

  Throws:

  NullPointerException - if any argument or its contents arenull

  IndexOutOfBoundsException - ifpos is outside the closed range[0, parameterCount]

  IllegalArgumentException - if any element ofparamTypes is aClassDesc forvoid

• descriptorString

  String descriptorString()

  Returns the method type descriptor string.

  Specified by:

  descriptorString in interface TypeDescriptor

  Returns:

  the method type descriptor string

  SeeJava Virtual Machine Specification:

  4.3.3 Method Descriptors
  

• displayDescriptor

  default String displayDescriptor()

  Returns a human-readable descriptor for this method type, using the canonical names for parameter and return types.

  Returns:

  the human-readable descriptor for this method type

• resolveConstantDesc

  MethodType resolveConstantDesc(MethodHandles.Lookup lookup) throwsReflectiveOperationException

  Resolves this descriptor reflectively, emulating the resolution behavior of JVMS5.4.3 and the access control behavior of JVMS5.4.4. The resolution and access control context is provided by theMethodHandles.Lookup parameter. No caching of the resulting value is performed.

  Specified by:

  resolveConstantDesc in interface ConstantDesc

  API Note:

  MethodTypeDesc can represent method type descriptors that are not representable byMethodType, such as methods with more than 255 parameter slots, so attempts to resolve these may result in errors.

  Parameters:

  lookup - TheMethodHandles.Lookup to provide name resolution and access control context

  Returns:

  the resolved constant value

  Throws:

  ReflectiveOperationException - if a class, method, or field could not be reflectively resolved in the course of resolution

• equals

  boolean equals(Object o)

  Compares the specified object with this descriptor for equality. Returnstrue if and only if the specified object is also aMethodTypeDesc both have the same arity, their return types are equal, and each pair of corresponding parameter types are equal.

  Overrides:

  equals in class Object

  Parameters:

  o - the other object

  Returns:

  whether this descriptor is equal to the other object

  See Also:

  • Object.hashCode()
  • HashMap