MethodType (Java Platform SE 8 )

java.lang.Object
- java.lang.invoke.MethodType

All Implemented Interfaces:

Serializable
```
public final class MethodType
extends Object
implements Serializable
```
方法类型表示方法句柄接受和返回的参数和返回类型，或方法句柄调用者传递和预期的参数和返回类型。方法类型必须在方法处理和所有的调用者之间正确匹配，和JVM的业务执行这个匹配，特别是在通话过程MethodHandle.invokeExact和MethodHandle.invoke的执行过程中，并invokedynamic说明。
该结构是一个返回类型，伴随着任意数量的参数类型。类型（原始， void和参考）由类对象表示。（为了便于说明，我们将void视为一种类型，实际上表示没有返回类型。）

的所有实例MethodType是不可变的。如果比较相等，则两个实例可以完全互换。平等取决于返回值和参数类型的成对对应关系，而不取决于任何其他值。

此类型只能通过工厂方法创建。所有工厂方法都可以缓存值，尽管不保证缓存。一些工厂方法是静态的，而其他工厂方法是修改前体方法类型的虚拟方法，例如通过更改选定的参数。

以两个版本的方式系统地显示了对参数类型组进行操作的工厂方法，从而可以使用Java数组和Java列表来处理参数类型组。查询方法parameterArray和parameterList还提供了数组和列表之间的选择。

MethodType对象有时从诸如invokedynamic字节码指令invokedynamic ，特别是从与类文件的常量池中的指令相关联的类型描述符字符串。

像类和字符串一样，方法类型也可以直接在类文件的常量池中表示为常量。方法类型可以由ldc指令加载，该ldc是指适当的CONSTANT_MethodType常量池条目。该条目是针对描述符字符串的一个CONSTANT_Utf8拼写。（有关方法类型常量的详细信息，请参阅Java虚拟机规范的第4.4.8和5.4.3.5节。）

当JVM从描述符字符串中实现MethodType时，描述符中命名的所有类都必须可访问，并将被加载。（但是类不需要初始化，就像CONSTANT_Class ）。此加载可能会在MethodType对象首次导出之前的任何时间发生。

另请参见：

Serialized Form

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`MethodType`	`appendParameterTypes(类<?>... ptypesToInsert)` 查找或创建具有其他参数类型的方法类型。
`MethodType`	`appendParameterTypes(List<类<?>> ptypesToInsert)` 查找或创建具有其他参数类型的方法类型。
`MethodType`	`changeParameterType(int num, 类<?> nptype)` 查找或创建具有单个不同参数类型的方法类型。
`MethodType`	`changeReturnType(类<?> nrtype)` 查找或创建具有不同返回类型的方法类型。
`MethodType`	`dropParameterTypes(int start, int end)` 查找或创建一种省略某些参数类型的方法类型。
`boolean`	`equals(Object x)` 将指定的对象与此类型进行比较以获得相等性。
`MethodType`	`erase()` 删除所有引用类型到 `Object` 。
`static MethodType`	`fromMethodDescriptorString(String descriptor, ClassLoader loader)` 查找或创建方法类型的实例，给定其字节码描述符的拼写。
`MethodType`	`generic()` 将所有类型（参考和原始）转换为 `Object` 。
`static MethodType`	`genericMethodType(int objectArgCount)` 查找或创建组件全部为 `Object`的方法类型。
`static MethodType`	`genericMethodType(int objectArgCount, boolean finalArray)` 查找或创建一个方法类型，其组件为 `Object` ，并带有可选的尾部 `Object[]`阵列。
`int`	`hashCode()` 返回此方法类型的哈希码值。
`boolean`	`hasPrimitives()` 报告此类型是否包含原始参数或返回值。
`boolean`	`hasWrappers()` 报告此类型是否包含包装器参数或返回值。
`MethodType`	`insertParameterTypes(int num, 类<?>... ptypesToInsert)` 查找或创建具有其他参数类型的方法类型。
`MethodType`	`insertParameterTypes(int num, List<类<?>> ptypesToInsert)` 查找或创建具有其他参数类型的方法类型。
`static MethodType`	`methodType(类<?> rtype)` 查找或创建具有给定组件的方法类型。
`static MethodType`	`methodType(类<?> rtype, 类<?> ptype0)` 查找或创建具有给定组件的方法类型。
`static MethodType`	`methodType(类<?> rtype, 类<?>[] ptypes)` 查找或创建给定方法类型的实例。
`static MethodType`	`methodType(类<?> rtype, 类<?> ptype0, 类<?>... ptypes)` 查找或创建具有给定组件的方法类型。
`static MethodType`	`methodType(类<?> rtype, List<类<?>> ptypes)` 查找或创建具有给定组件的方法类型。
`static MethodType`	`methodType(类<?> rtype, MethodType ptypes)` 查找或创建具有给定组件的方法类型。
`类<?>[]`	`parameterArray()` 将参数类型显示为数组（方便方法）。
`int`	`parameterCount()` 返回此方法类型中的参数类型数。
`List<类<?>>`	`parameterList()` 将参数类型显示为列表（方便方法）。
`类<?>`	`parameterType(int num)` 在此方法类型中返回指定索引处的参数类型。
`类<?>`	`returnType()` 返回此方法类型的返回类型。
`String`	`toMethodDescriptorString()` 生成方法类型的字节码描述符表示。
`String`	`toString()` 返回方法类型的字符串表示形式，格式为 `"(PT0,PT1...)RT"` 。
`MethodType`	`unwrap()` 将所有包装类型转换为相应的原始类型。
`MethodType`	`wrap()` 将所有原始类型转换为相应的包装类型。

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 方法详细信息
  - methodType
```
public static MethodType methodType(类<?> rtype,
                                    类<?>[] ptypes)
```
    查找或创建给定方法类型的实例。
    
    参数
    
    rtype - 返回类型
    
    ptypes - 参数类型
    
    结果
    
    具有给定组件的方法类型
    
    异常
    
    NullPointerException -如果 rtype或 ptypes或任何元件 ptypes为空
    
    IllegalArgumentException -如果任何元件 ptypes是 void.class
  - methodType
```
public static MethodType methodType(类<?> rtype,
                                    List<类<?>> ptypes)
```
    查找或创建具有给定组件的方法类型。方便methodType 。
    
    参数
    
    rtype - 返回类型
    
    ptypes - 参数类型
    
    结果
    
    具有给定组件的方法类型
    
    异常
    
    NullPointerException -如果 rtype或 ptypes或任何元件 ptypes为空
    
    IllegalArgumentException -如果任何元件 ptypes是 void.class
  - methodType
```
public static MethodType methodType(类<?> rtype,
                                    类<?> ptype0,
                                    类<?>... ptypes)
```
    查找或创建具有给定组件的方法类型。方便methodType 。前导参数类型被添加到剩余的数组中。
    
    参数
    
    rtype - 返回类型
    
    ptype0 - 第一个参数类型
    
    ptypes - 剩余的参数类型
    
    结果
    
    具有给定组件的方法类型
    
    异常
    
    NullPointerException -如果 rtype或 ptype0或 ptypes或任何元件 ptypes为空
    
    IllegalArgumentException -如果 ptype0或 ptypes或任何元件 ptypes是 void.class
  - methodType
```
public static MethodType methodType(类<?> rtype)
```
    查找或创建具有给定组件的方法类型。方便methodType 。所得到的方法没有参数类型。
    
    参数
    
    rtype - 返回类型
    
    结果
    
    具有给定返回值的方法类型
    
    异常
    
    NullPointerException - 如果 rtype为空
  - methodType
```
public static MethodType methodType(类<?> rtype,
                                    类<?> ptype0)
```
    查找或创建具有给定组件的方法类型。方便methodType 。所得到的方法具有单个给定的参数类型。
    
    参数
    
    rtype - 返回类型
    
    ptype0 - 参数类型
    
    结果
    
    具有给定返回值和参数类型的方法类型
    
    异常
    
    NullPointerException - 如果 rtype或 ptype0为空
    
    IllegalArgumentException - 如果 ptype0是 void.class
  - methodType
```
public static MethodType methodType(类<?> rtype,
                                    MethodType ptypes)
```
    查找或创建具有给定组件的方法类型。方便methodType 。将得到的方法具有相同的参数类型为ptypes ，和指定的返回类型。
    
    参数
    
    rtype - 返回类型
    
    ptypes - 提供参数类型的方法类型
    
    结果
    
    具有给定组件的方法类型
    
    异常
    
    NullPointerException - 如果 rtype或 ptypes为空
  - genericMethodType
```
public static MethodType genericMethodType(int objectArgCount,
                                           boolean finalArray)
```
    查找或创建一个方法类型，其组件为Object ，带有可选的尾随Object[]阵列。方便methodType 。所有参数和返回类型将是Object ，除了最后的数组参数，如果有的话，这将是Object[] 。
    
    参数
    
    objectArgCount - 参数数（不包括最终数组参数（如果有））
    
    finalArray - 是否会有一个尾随数组参数，类型为 Object[]
    
    结果
    
    一个普遍适用的方法类型，用于给定固定参数计数的所有调用以及收集的其他参数数组
    
    异常
    
    IllegalArgumentException - 如果 objectArgCount为负数或大于255（或254，如果 finalArray为真）
    
    另请参见：
    
    genericMethodType(int)
  - genericMethodType
```
public static MethodType genericMethodType(int objectArgCount)
```
    查找或创建一个方法类型，其组件全部为Object 。方便methodType 。所有参数和返回类型将为Object。
    
    参数
    
    objectArgCount - 参数数量
    
    结果
    
    一个普遍适用的方法类型，用于给定参数计数的所有调用
    
    异常
    
    IllegalArgumentException - 如果 objectArgCount为负数或大于255
    
    另请参见：
    
    genericMethodType(int, boolean)
  - changeParameterType
```
public MethodType changeParameterType(int num,
                                      类<?> nptype)
```
    查找或创建具有单个不同参数类型的方法类型。方便methodType 。
    
    参数
    
    num - 要更改的参数类型的索引（从零开始）
    
    nptype - 用于替换旧参数的新参数类型
    
    结果
    
    相同类型，除了所选参数更改
    
    异常
    
    IndexOutOfBoundsException -如果 num不是有效的索引 parameterArray()
    
    IllegalArgumentException - 如果 nptype是 void.class
    
    NullPointerException - 如果 nptype为空
  - insertParameterTypes
```
public MethodType insertParameterTypes(int num,
                                       类<?>... ptypesToInsert)
```
    查找或创建具有其他参数类型的方法类型。方便methodType 。
    
    参数
    
    num - 插入的参数类型的位置（从零开始）
    
    ptypesToInsert - 要插入参数列表的零个或多个新参数类型
    
    结果
    
    相同的类型，除了插入所选的参数
    
    异常
    
    IndexOutOfBoundsException - 如果 num为负数或大于 parameterCount()
    
    IllegalArgumentException -如果任何元件 ptypesToInsert是 void.class ，或者如果所产生的方法类型将具有255个以上的参数时隙
    
    NullPointerException - 如果 ptypesToInsert或其任何元素为空
  - appendParameterTypes
```
public MethodType appendParameterTypes(类<?>... ptypesToInsert)
```
    查找或创建具有其他参数类型的方法类型。方便methodType 。
    
    参数
    
    ptypesToInsert - 在参数列表结束后插入的零个或多个新参数类型
    
    结果
    
    相同的类型，除了附加了所选参数
    
    异常
    
    IllegalArgumentException -如果任何元件 ptypesToInsert是 void.class ，或者如果所产生的方法类型将具有255个以上的参数时隙
    
    NullPointerException - 如果 ptypesToInsert或其任何元素为空
  - insertParameterTypes
```
public MethodType insertParameterTypes(int num,
                                       List<类<?>> ptypesToInsert)
```
    查找或创建具有其他参数类型的方法类型。方便methodType 。
    
    参数
    
    num - 插入的参数类型的位置（从零开始）
    
    ptypesToInsert - 要插入参数列表的零个或多个新参数类型
    
    结果
    
    相同的类型，除了插入所选的参数
    
    异常
    
    IndexOutOfBoundsException - 如果 num为负数或大于 parameterCount()
    
    IllegalArgumentException -如果任何元件 ptypesToInsert是 void.class ，或者如果所产生的方法类型将具有255个以上的参数时隙
    
    NullPointerException - 如果 ptypesToInsert或其任何元素为空
  - appendParameterTypes
```
public MethodType appendParameterTypes(List<类<?>> ptypesToInsert)
```
    查找或创建具有其他参数类型的方法类型。方便methodType 。
    
    参数
    
    ptypesToInsert - 在参数列表结束后插入的零个或多个新参数类型
    
    结果
    
    相同的类型，除了附加了所选参数
    
    异常
    
    IllegalArgumentException -如果任何元件 ptypesToInsert是 void.class ，或者如果所产生的方法类型将具有255个以上的参数时隙
    
    NullPointerException - 如果 ptypesToInsert或其任何元素为空
  - dropParameterTypes
```
public MethodType dropParameterTypes(int start,
                                     int end)
```
    查找或创建一种省略某些参数类型的方法类型。方便methodType 。
    
    参数
    
    start - 要删除的第一个参数类型的索引（从零开始）
    
    end - 第一个参数类型的索引（大于 start ）不要删除
    
    结果
    
    相同的类型，除去所选参数被删除
    
    异常
    
    IndexOutOfBoundsException - 如果 start为负数或大于 parameterCount()或 end为负数或大于 parameterCount()或 start大于 end
  - changeReturnType
```
public MethodType changeReturnType(类<?> nrtype)
```
    查找或创建具有不同返回类型的方法类型。方便methodType 。
    
    参数
    
    nrtype - 一个返回参数类型替换旧的
    
    结果
    
    相同类型，除了返回类型更改
    
    异常
    
    NullPointerException - 如果 nrtype为空
  - hasPrimitives
```
public boolean hasPrimitives()
```
    报告此类型是否包含原始参数或返回值。返回类型void计数为原始数据。
    
    结果
    
    如果任何类型是原语，则为真
  - hasWrappers
```
public boolean hasWrappers()
```
    报告此类型是否包含包装器参数或返回值。包装器是包含原始值的类型，如Integer 。引用类型java.lang.Void计算为包装器，如果它作为返回类型出现。
    
    结果
    
    如果任何类型是包装器，则为true
  - erase
```
public MethodType erase()
```
    删除所有引用类型到Object 。方便methodType 。所有原始类型（包括void ）将保持不变。
    
    结果
    
    所有引用类型被替换的原始类型的版本
  - generic
```
public MethodType generic()
```
    将所有类型（参考和原始）转换为Object 。方便genericMethodType 。表达type.wrap().erase()产生相同的值type.generic() 。
    
    结果
    
    所有类型的原始类型的版本被替换
  - wrap
```
public MethodType wrap()
```
    将所有原始类型转换为相应的包装类型。方便methodType 。所有引用类型（包括包装类型）将保持不变。 A void返回类型更改为java.lang.Void 。表达type.wrap().erase()产生相同的值type.generic() 。
    
    结果
    
    所有原始类型的原始类型的版本被替换
  - unwrap
```
public MethodType unwrap()
```
    将所有包装类型转换为相应的原始类型。方便methodType 。所有原始类型（包括void ）将保持不变。 java.lang.Void的返回类型更改为void 。
    
    结果
    
    一个版本的原始类型，所有的包装类型被替换
  - parameterType
```
public 类<?> parameterType(int num)
```
    在此方法类型中返回指定索引处的参数类型。
    
    参数
    
    num - 所需参数类型的索引（从零开始）
    
    结果
    
    所选参数类型
    
    异常
    
    IndexOutOfBoundsException -如果 num不是有效的索引 parameterArray()
  - parameterCount
```
public int parameterCount()
```
    返回此方法类型中的参数类型数。
    
    结果
    
    参数类型的数量
  - returnType
```
public 类<?> returnType()
```
    返回此方法类型的返回类型。
    
    结果
    
    返回类型
  - parameterList
```
public List<类<?>> parameterList()
```
    将参数类型显示为列表（方便方法）。该列表将是不可变的。
    
    结果
    
    参数类型（作为不可变列表）
  - parameterArray
```
public 类<?>[] parameterArray()
```
    将参数类型显示为数组（方便方法）。对数组的更改不会导致类型的更改。
    
    结果
    
    参数类型（如有必要，作为新的副本）
  - equals
```
public boolean equals(Object x)
```
    将指定的对象与此类型进行比较以获得相等性。也就是说，当且仅当指定的对象也是具有完全相同的参数和返回类型的方法类型时，它返回true 。
    
    重写：
    
    equals在类别 Object
    
    参数
    
    x - 对象进行比较
    
    结果
    
    true如果此对象与obj参数相同; false否则。
    
    另请参见：
    
    Object.equals(Object)
  - hashCode
```
public int hashCode()
```
    返回此方法类型的哈希码值。它被定义为与列表的哈希码相同，其元素是返回类型，后跟参数类型。
    
    重写：
    
    hashCode在类别 Object
    
    结果
    
    该方法类型的哈希码值
    
    另请参见：
    
    Object.hashCode() ， equals(Object) ， List.hashCode()
  - toString
```
public String toString()
```
    返回方法类型的字符串表示形式，格式为"(PT0,PT1...)RT" 。方法类型的字符串表示形式是括号，以逗号分隔的类型名称列表，紧接着是返回类型。
    每种类型由其simple name表示。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    对象的字符串表示形式。
  - fromMethodDescriptorString
```
public static MethodType fromMethodDescriptorString(String descriptor,
                                                    ClassLoader loader)
                                             throws IllegalArgumentException,
                                                    TypeNotPresentException
```
    查找或创建方法类型的实例，给定其字节码描述符的拼写。方便methodType 。嵌入描述符字符串中的任何类或接口名称将通过调用给定加载程序上的ClassLoader.loadClass(java.lang.String) （或者系统类加载器上为null）来解析。
    请注意，可能遇到无法通过此方法构造的方法类型，因为它们的组件类型并不都可以从普通类加载器访问。
    
    包括这种方法是为了生成必须生成处理方法句柄的字节码的应用程序，以及invokedynamic 。
    
    参数
    
    descriptor - 字节码类型描述符字符串“（T ...）T”
    
    loader - 查找类型的类加载器
    
    结果
    
    一种匹配字节码类型描述符的方法类型
    
    异常
    
    NullPointerException - 如果字符串为空
    
    IllegalArgumentException - 如果字符串格式不正确
    
    TypeNotPresentException - 如果找不到命名类型
  - toMethodDescriptorString
```
public String toMethodDescriptorString()
```
    生成方法类型的字节码描述符表示。
    请注意，这不是fromMethodDescriptorString的严格倒数。在描述符字符串中查看时，共享一个通用名称但具有不同类加载器的两个不同的类将显示相同。
    
    包含这种方法是为了生成必须生成处理方法句柄和invokedynamic 。 fromMethodDescriptorString ，因为后者需要一个合适的类加载器参数。
    
    结果
    
    字节码类型描述符表示

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class MethodType

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

methodType

methodType

methodType

methodType

methodType

methodType

genericMethodType

genericMethodType

changeParameterType

insertParameterTypes

appendParameterTypes

insertParameterTypes

appendParameterTypes

dropParameterTypes

changeReturnType

hasPrimitives

hasWrappers

erase

generic

wrap

unwrap

parameterType

parameterCount

returnType

parameterList

parameterArray

equals

hashCode

toString

fromMethodDescriptorString

toMethodDescriptorString