Package org.apache.iceberg.common

Class DynMethods.Builder

java.lang.Object

org.apache.iceberg.common.DynMethods.Builder

Enclosing class:

DynMethods

public static class DynMethods.Builder
extends Object

Constructor Summary

Constructors

Constructor	Description
Builder(String methodName)

Method Summary

Modifier and Type	Method	Description
DynMethods.UnboundMethod	build()	Returns the first valid implementation as a UnboundMethod or throws a RuntimeError if there is none.
DynMethods.BoundMethod	build(Object receiver)	Returns the first valid implementation as a BoundMethod or throws a RuntimeError if there is none.
DynMethods.UnboundMethod	buildChecked()	Returns the first valid implementation as a UnboundMethod or throws a NoSuchMethodException if there is none.
DynMethods.BoundMethod	buildChecked(Object receiver)	Returns the first valid implementation as a BoundMethod or throws a NoSuchMethodException if there is none.
DynMethods.StaticMethod	buildStatic()	Returns the first valid implementation as a StaticMethod or throws a RuntimeException if there is none.
DynMethods.StaticMethod	buildStaticChecked()	Returns the first valid implementation as a StaticMethod or throws a NoSuchMethodException if there is none.
DynMethods.Builder	ctorImpl(Class<?> targetClass, Class<?>... argClasses)	Deprecated. since 1.6.0, will be removed in 1.7.0
DynMethods.Builder	ctorImpl(String className, Class<?>... argClasses)	Deprecated. since 1.6.0, will be removed in 1.7.0
DynMethods.Builder	hiddenImpl(Class<?> targetClass, Class<?>... argClasses)	Checks for a method implementation.
DynMethods.Builder	hiddenImpl(Class<?> targetClass, String methodName, Class<?>... argClasses)	Checks for a method implementation.
DynMethods.Builder	hiddenImpl(String className, Class<?>... argClasses)	Checks for an implementation, first finding the given class by name.
DynMethods.Builder	hiddenImpl(String className, String methodName, Class<?>... argClasses)	Checks for an implementation, first finding the given class by name.
DynMethods.Builder	impl(Class<?> targetClass, Class<?>... argClasses)	Checks for a method implementation.
DynMethods.Builder	impl(Class<?> targetClass, String methodName, Class<?>... argClasses)	Checks for a method implementation.
DynMethods.Builder	impl(String className, Class<?>... argClasses)	Checks for an implementation, first finding the given class by name.
DynMethods.Builder	impl(String className, String methodName, Class<?>... argClasses)	Checks for an implementation, first finding the given class by name.
DynMethods.Builder	loader(ClassLoader newLoader)	Set the ClassLoader used to lookup classes by name.
DynMethods.Builder	orNoop()	If no implementation has been found, adds a NOOP method.

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

public Builder(String methodName)

Method Details

loader

public DynMethods.Builder loader(ClassLoader newLoader)

Set the ClassLoader used to lookup classes by name.

If not set, the current thread's ClassLoader is used.

Parameters:

newLoader - a ClassLoader

Returns:

this Builder for method chaining

orNoop

public DynMethods.Builder orNoop()

If no implementation has been found, adds a NOOP method.

Note: calls to impl will not match after this method is called!

Returns:

this Builder for method chaining

impl

public DynMethods.Builder impl(String className,
 String methodName,
 Class<?>... argClasses)

Checks for an implementation, first finding the given class by name.

Parameters:

className - name of a class

methodName - name of a method (different from constructor)

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

impl

public DynMethods.Builder impl(String className,
 Class<?>... argClasses)

Checks for an implementation, first finding the given class by name.

The name passed to the constructor is the method name used.

Parameters:

className - name of a class

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

impl

public DynMethods.Builder impl(Class<?> targetClass,
 String methodName,
 Class<?>... argClasses)

Checks for a method implementation.

Parameters:

targetClass - a class instance

methodName - name of a method (different from constructor)

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

impl

public DynMethods.Builder impl(Class<?> targetClass,
 Class<?>... argClasses)

Checks for a method implementation.

The name passed to the constructor is the method name used.

Parameters:

targetClass - a class instance

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

ctorImpl

@Deprecated
public DynMethods.Builder ctorImpl(Class<?> targetClass,
 Class<?>... argClasses)

Deprecated.

since 1.6.0, will be removed in 1.7.0

ctorImpl

@Deprecated
public DynMethods.Builder ctorImpl(String className,
 Class<?>... argClasses)

Deprecated.

since 1.6.0, will be removed in 1.7.0

hiddenImpl

public DynMethods.Builder hiddenImpl(String className,
 String methodName,
 Class<?>... argClasses)

Checks for an implementation, first finding the given class by name.

Parameters:

className - name of a class

methodName - name of a method (different from constructor)

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

hiddenImpl

public DynMethods.Builder hiddenImpl(String className,
 Class<?>... argClasses)

Checks for an implementation, first finding the given class by name.

The name passed to the constructor is the method name used.

Parameters:

className - name of a class

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

hiddenImpl

public DynMethods.Builder hiddenImpl(Class<?> targetClass,
 String methodName,
 Class<?>... argClasses)

Checks for a method implementation.

Parameters:

targetClass - a class instance

methodName - name of a method (different from constructor)

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

hiddenImpl

public DynMethods.Builder hiddenImpl(Class<?> targetClass,
 Class<?>... argClasses)

Checks for a method implementation.

The name passed to the constructor is the method name used.

Parameters:

targetClass - a class instance

argClasses - argument classes for the method

Returns:

this Builder for method chaining

See Also:

• Class.forName(String)
• Class.getMethod(String, Class[])

build

public DynMethods.UnboundMethod build()

Returns the first valid implementation as a UnboundMethod or throws a RuntimeError if there is none.

Returns:

a DynMethods.UnboundMethod with a valid implementation

Throws:

RuntimeException - if no implementation was found

build

public DynMethods.BoundMethod build(Object receiver)

Returns the first valid implementation as a BoundMethod or throws a RuntimeError if there is none.

Parameters:

receiver - an Object to receive the method invocation

Returns:

a DynMethods.BoundMethod with a valid implementation and receiver

Throws:

IllegalStateException - if the method is static

IllegalArgumentException - if the receiver's class is incompatible

RuntimeException - if no implementation was found

buildChecked

public DynMethods.UnboundMethod buildChecked()
                                      throws NoSuchMethodException

Returns the first valid implementation as a UnboundMethod or throws a NoSuchMethodException if there is none.

Returns:

a DynMethods.UnboundMethod with a valid implementation

Throws:

NoSuchMethodException - if no implementation was found

buildChecked

public DynMethods.BoundMethod buildChecked(Object receiver)
                                    throws NoSuchMethodException

Returns the first valid implementation as a BoundMethod or throws a NoSuchMethodException if there is none.

Parameters:

receiver - an Object to receive the method invocation

Returns:

a DynMethods.BoundMethod with a valid implementation and receiver

Throws:

IllegalStateException - if the method is static

IllegalArgumentException - if the receiver's class is incompatible

NoSuchMethodException - if no implementation was found

buildStaticChecked

public DynMethods.StaticMethod buildStaticChecked()
                                           throws NoSuchMethodException

Returns the first valid implementation as a StaticMethod or throws a NoSuchMethodException if there is none.

Returns:

a DynMethods.StaticMethod with a valid implementation

Throws:

IllegalStateException - if the method is not static

NoSuchMethodException - if no implementation was found

buildStatic

public DynMethods.StaticMethod buildStatic()

Returns the first valid implementation as a StaticMethod or throws a RuntimeException if there is none.

Returns:

a DynMethods.StaticMethod with a valid implementation

Throws:

IllegalStateException - if the method is not static

RuntimeException - if no implementation was found