com.hervian.lambda

类 LambdaFactory

java.lang.Object

com.hervian.lambda.LambdaFactory

public class LambdaFactory
extends java.lang.Object

Copyright 2016 Anders Granau Høfft Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. END OF NOTICE In essence, this class simply wraps the functionality of LambdaMetafactory.metafactory(java.lang.invoke.MethodHandles.Lookup, String, MethodType, MethodType, MethodHandle, MethodType).
However, some additional logic is needed to handle the case of

• static Method vs instance method.
• primitive method parameters, vs Object (or subclasses thereof, including boxed primitives)
• private methods

作者:

Anders Granau Høfft

构造器概要

构造器

构造器和说明
LambdaFactory()

方法概要

限定符和类型	方法和说明
static com.hervian.lambda.Lambda	create(java.lang.reflect.Method method) creates a Lambda with the same access rights as a Method with setAccessible()==true.
static <T> T	create(java.lang.reflect.Method method, java.lang.Class<T> interfaceClass, java.lang.String signatatureName) Similar to create(Method), except that this factory method returns a dynamically generated implementation of the argument provided interface.
static com.hervian.lambda.Lambda	create(java.lang.reflect.Method method, java.lang.invoke.MethodHandles.Lookup lookup) Same as create(Method) but with an extra parameter that allows for more fine grained configuration of the access rights of the generated Lambda implementation.
static <T> T	create(java.lang.reflect.Method method, java.lang.invoke.MethodHandles.Lookup lookup, java.lang.Class<T> interfaceClass, java.lang.String signatatureName) Same as create(Method, Class, String), but with an additional parameter in the form of a Lookup object.
static <T> T	createLambda(java.lang.reflect.Method method, java.lang.invoke.MethodHandles.Lookup lookup, java.lang.Class<T> interfaceClass, java.lang.String signatatureName, boolean createSpecial)
static com.hervian.lambda.Lambda	createSpecial(java.lang.reflect.Method method) Same as create(Method) except that this method returns a Lambda that will not be subject to dynamic method dispatch.
static <T> T	createSpecial(java.lang.reflect.Method method, java.lang.Class<T> interfaceClass, java.lang.String signatatureName) Same as create(Method) except that this method returns a Lambda that will not be subject to dynamic method dispatch.
static com.hervian.lambda.Lambda	createSpecial(java.lang.reflect.Method method, java.lang.invoke.MethodHandles.Lookup lookup) Same as create(Method, java.lang.invoke.MethodHandles.Lookup) except that this method returns a Lambda that will not be subject to dynamic method dispatch.
static <T> T	createSpecial(java.lang.reflect.Method method, java.lang.invoke.MethodHandles.Lookup lookup, java.lang.Class<T> interfaceClass, java.lang.String signatatureName)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

LambdaFactory

public LambdaFactory()

方法详细资料

create

public static com.hervian.lambda.Lambda create(java.lang.reflect.Method method)
                                        throws java.lang.Throwable

creates a Lambda with the same access rights as a Method with setAccessible()==true. That is, both private, package, protected and public methods are accessible to the created Lambda.

参数:

method - A Method object which defines what to invoke.

返回:

A dynamically generated class that implements the Lambda interface and the a method that corresponds to the Method. The implementation offers invocation speed similar to that of a direct method invocation.

抛出:

java.lang.Throwable

createSpecial

public static com.hervian.lambda.Lambda createSpecial(java.lang.reflect.Method method)
                                               throws java.lang.Throwable

Same as create(Method) except that this method returns a Lambda that will not be subject to dynamic method dispatch.

Example:
Let class A implement a method called 'someMethod'. And let class B extend A and override 'someMethod'.
Then, calling createSpecial(Method) with a Method object referring to A.someMethod, will return a Lambda that calls A.someMethod, even when invoked with B as the instance.

抛出:

java.lang.Throwable

create

public static com.hervian.lambda.Lambda create(java.lang.reflect.Method method,
                                               java.lang.invoke.MethodHandles.Lookup lookup)
                                        throws java.lang.Throwable

Same as create(Method) but with an extra parameter that allows for more fine grained configuration of the access rights of the generated Lambda implementation. The lookup's access rights reflect the class, which created it. To access private methods of a class using this constructor, the Lookup must either have been created in the given class, or the Method must have setAccessible()==true. Create a Lookup like this: MethodHandles.lookup().

参数:

method - A Method object which defines what to invoke.

lookup - A Lookup describing the access rights of the generated Lambda. Create a Lookup like this: MethodHandles.lookup().

返回:

A dynamically generated class that implements the Lambda interface and the a method that corresponds to the Method. The implementation offers invocation speed similar to that of a direct method invocation.

抛出:

java.lang.Throwable

createSpecial

public static com.hervian.lambda.Lambda createSpecial(java.lang.reflect.Method method,
                                                      java.lang.invoke.MethodHandles.Lookup lookup)
                                               throws java.lang.Throwable

Same as create(Method, java.lang.invoke.MethodHandles.Lookup) except that this method returns a Lambda that will not be subject to dynamic method dispatch. See createSpecial(Method)

抛出:

java.lang.Throwable

create

public static <T> T create(java.lang.reflect.Method method,
                           java.lang.Class<T> interfaceClass,
                           java.lang.String signatatureName)
                    throws java.lang.Throwable

Similar to create(Method), except that this factory method returns a dynamically generated implementation of the argument provided interface. The provided signatureName must identify a method, whose arguments corresponds to the Method. (If the Method is a non-static method the interface method's first parameter must be an Object, and the subsequent parameters must match the Method.)

Example:
Method method = MyClass.class.getDeclaredMethod("myStaticMethod", int.class, int.class);
IntBinaryOperator sam = LambdaFactory.create(method, IntBinaryOperator.class, "applyAsInt");
int result = sam.applyAsInt(3, 11);

参数:

method - A Method object which defines what to invoke.

interfaceClass - The interface, which the dynamically generated class shall implement.

signatatureName - The name of an abstract method from the interface, which the dynamically create class shall implement.

返回:

A dynamically generated implementation of the argument provided interface. The implementation offers invocation speed similar to that of a direct method invocation.

抛出:

java.lang.Throwable

createSpecial

public static <T> T createSpecial(java.lang.reflect.Method method,
                                  java.lang.Class<T> interfaceClass,
                                  java.lang.String signatatureName)
                           throws java.lang.Throwable

Same as create(Method) except that this method returns a Lambda that will not be subject to dynamic method dispatch. See createSpecial(Method)

抛出:

java.lang.Throwable

create

public static <T> T create(java.lang.reflect.Method method,
                           java.lang.invoke.MethodHandles.Lookup lookup,
                           java.lang.Class<T> interfaceClass,
                           java.lang.String signatatureName)
                    throws java.lang.Throwable

Same as create(Method, Class, String), but with an additional parameter in the form of a Lookup object. See create(Method, java.lang.invoke.MethodHandles.Lookup) for a description of the Lookup parameter.

参数:

method -

lookup -

interfaceClass -

signatatureName -

返回:

抛出:

java.lang.Throwable

createSpecial

public static <T> T createSpecial(java.lang.reflect.Method method,
                                  java.lang.invoke.MethodHandles.Lookup lookup,
                                  java.lang.Class<T> interfaceClass,
                                  java.lang.String signatatureName)
                           throws java.lang.Throwable

抛出:

java.lang.Throwable

createLambda

public static <T> T createLambda(java.lang.reflect.Method method,
                                 java.lang.invoke.MethodHandles.Lookup lookup,
                                 java.lang.Class<T> interfaceClass,
                                 java.lang.String signatatureName,
                                 boolean createSpecial)
                          throws java.lang.Throwable

抛出:

java.lang.Throwable