Package Summary Overview Summary

### class:SwitchBootstraps [CHANGED]
public class SwitchBootstraps extends Object `SwitchBootstraps` is a preview API of the Java platform. Programs can only use `SwitchBootstraps` when preview features are enabled. Preview features may be removed in a future release, or upgraded to permanent features of the Java platform. Bootstrap methods for linking `invokedynamic` call sites that implement the selection functionality of the `switch` statement. The bootstraps take additional static arguments corresponding to the `case` labels of the `switch`, implicitly numbered sequentially from `[0..N)`. Since: 17 21
public class SwitchBootstraps extends Object `SwitchBootstraps` is a preview API of the Java platform. Programs can only use `SwitchBootstraps` when preview features are enabled. Preview features may be removed in a future release, or upgraded to permanent features of the Java platform. Bootstrap methods for linking `invokedynamic` call sites that implement the selection functionality of the `switch` statement. The bootstraps take additional static arguments corresponding to the `case` labels of the `switch`, implicitly numbered sequentially from `[0..N)`. Since: 17 | public class SwitchBootstraps extends Object Bootstrap methods for linking `invokedynamic` call sites that implement the selection functionality of the `switch` statement. The bootstraps take additional static arguments corresponding to the `case` labels of the `switch`, implicitly numbered sequentially from `[0..N)`. Since: 21

### method:typeSwitch(java.lang.invoke.MethodHandles.Lookup,java.lang.String,java.lang.invoke.MethodType,java.lang.Object...) [CHANGED]
### typeSwitch public static CallSite typeSwitch (MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels) Bootstrap method for linking an `invokedynamic` call site that implements a `switch` on a target of a reference type. The static arguments are an array of case labels which must be non-null and of type `String` or `Integer` or `Class`. The type of the returned `CallSite`'s method handle will have a return type of `int`. It has two parameters: the first argument will be an `Object` instance (`target`) and the second will be `int` (`restart`). If the `target` is `null`, then the method of the call site returns -1. If the `target` is not `null`, then the method of the call site returns the index of the first element in the `labels` array starting from the `restart` index matching one of the following conditions: the element is of type `Class` that is assignable from the target's class; or the element is of type `String` or `Integer` and equals to the target. the element is of type that is an enum and equals to the target. If no element in the `labels` array matches the target, then the method of the call site return the length of the `labels` array. Parameters: `lookup` - Represents a lookup context with the accessibility privileges of the caller. When used with `invokedynamic`, this is stacked automatically by the VM. `invocationName` - unused `invocationType` - The invocation type of the `CallSite` with two parameters, a reference type, an `int`, and `int` as a return type. `labels` - case labels - `String` and `Integer` constants and `Class` instances, in any combination Returns: a `CallSite` returning the first matching element as described above Throws: `NullPointerException` - if any argument is `null` `IllegalArgumentException` - if any element in the labels array is null, if the invocation type is not not a method type of first parameter of a reference type, second parameter of type `int` and with `int` as its return type, or if `labels` contains an element that is not of type `String`, `Integer`, `Class` or `Class` an enum type. See Java Virtual Machine Specification : 4.4.6 The CONSTANT_NameAndType_info Structure 4.4.10 The CONSTANT_Dynamic_info and CONSTANT_InvokeDynamic_info Structures
### typeSwitch public static CallSite typeSwitch (MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels) Bootstrap method for linking an `invokedynamic` call site that implements a `switch` on a target of a reference type. The static arguments are an array of case labels which must be non-null and of type `String` or `Integer` or `Class`. The type of the returned `CallSite`'s method handle will have a return type of `int`. It has two parameters: the first argument will be an `Object` instance (`target`) and the second will be `int` (`restart`). If the `target` is `null`, then the method of the call site returns -1. If the `target` is not `null`, then the method of the call site returns the index of the first element in the `labels` array starting from the `restart` index matching one of the following conditions: the element is of type `Class` that is assignable from the target's class; or the element is of type `String` or `Integer` and equals to the target. If no element in the `labels` array matches the target, then the method of the call site return the length of the `labels` array. Parameters: `lookup` - Represents a lookup context with the accessibility privileges of the caller. When used with `invokedynamic`, this is stacked automatically by the VM. `invocationName` - unused `invocationType` - The invocation type of the `CallSite` with two parameters, a reference type, an `int`, and `int` as a return type. `labels` - case labels - `String` and `Integer` constants and `Class` instances, in any combination Returns: a `CallSite` returning the first matching element as described above Throws: `NullPointerException` - if any argument is `null` `IllegalArgumentException` - if any element in the labels array is null, if the invocation type is not not a method type of first parameter of a reference type, second parameter of type `int` and with `int` as its return type, or if `labels` contains an element that is not of type `String`, `Integer` or `Class`. See Java Virtual Machine Specification : 4.4.6 The CONSTANT_NameAndType_info Structure 4.4.10 The CONSTANT_Dynamic_info and CONSTANT_InvokeDynamic_info Structures | ### typeSwitch public static CallSite typeSwitch (MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels) Bootstrap method for linking an `invokedynamic` call site that implements a `switch` on a target of a reference type. The static arguments are an array of case labels which must be non-null and of type `String` or `Integer` or `Class`. The type of the returned `CallSite`'s method handle will have a return type of `int`. It has two parameters: the first argument will be an `Object` instance (`target`) and the second will be `int` (`restart`). If the `target` is `null`, then the method of the call site returns -1. If the `target` is not `null`, then the method of the call site returns the index of the first element in the `labels` array starting from the `restart` index matching one of the following conditions: the element is of type `Class` that is assignable from the target's class; or the element is of type `String` or `Integer` and equals to the target. the element is of type that is an enum and equals to the target. If no element in the `labels` array matches the target, then the method of the call site return the length of the `labels` array. Parameters: `lookup` - Represents a lookup context with the accessibility privileges of the caller. When used with `invokedynamic`, this is stacked automatically by the VM. `invocationName` - unused `invocationType` - The invocation type of the `CallSite` with two parameters, a reference type, an `int`, and `int` as a return type. `labels` - case labels - `String` and `Integer` constants and `Class` instances, in any combination Returns: a `CallSite` returning the first matching element as described above Throws: `NullPointerException` - if any argument is `null` `IllegalArgumentException` - if any element in the labels array is null, if the invocation type is not not a method type of first parameter of a reference type, second parameter of type `int` and with `int` as its return type, or if `labels` contains an element that is not of type `String`, `Integer`, `Class` or an enum type. See Java Virtual Machine Specification : 4.4.6 The CONSTANT_NameAndType_info Structure 4.4.10 The CONSTANT_Dynamic_info and CONSTANT_InvokeDynamic_info Structures