ch.obermuhlner.scriptengine.java.constructor

Class DefaultConstructorStrategy

java.lang.Object

ch.obermuhlner.scriptengine.java.constructor.DefaultConstructorStrategy

All Implemented Interfaces:

ConstructorStrategy

public class DefaultConstructorStrategy
extends java.lang.Object
implements ConstructorStrategy

The default ConstructorStrategy implementation. This implementation has three static constructor methods to define the constructor that should be called:

• byDefaultConstructor() to call the public default no-argument constructor.
• byArgumentTypes(Class[], Object...) to call the public constructor with the specified argument types and pass it the specified arguments.
• byMatchingArguments(Object...) to call a public constructor that matches the specified arguments.

Method Summary

Modifier and Type	Method and Description
static DefaultConstructorStrategy	byArgumentTypes(java.lang.Class<?>[] argumentTypes, java.lang.Object... arguments) Creates a DefaultConstructorStrategy that will call the public constructor with the specified argument types and passes the specified argument list.
static DefaultConstructorStrategy	byDefaultConstructor() Creates a DefaultConstructorStrategy that will call the public default no-argument constructor.
static DefaultConstructorStrategy	byMatchingArguments(java.lang.Object... arguments) Creates a DefaultConstructorStrategy that will call a public constructor that matches the specified arguments.
java.lang.Object	construct(java.lang.Class<?> clazz) Constructs an instance of a Class.

Methods inherited from class java.lang.Object

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

Method Detail

construct

public java.lang.Object construct(java.lang.Class<?> clazz)
                           throws javax.script.ScriptException

Description copied from interface: ConstructorStrategy

Constructs an instance of a Class.

Specified by:

construct in interface ConstructorStrategy

Parameters:

clazz - the Class

Returns:

the constructed instance or null

Throws:

javax.script.ScriptException - if the instance could not be constructed

byDefaultConstructor

public static DefaultConstructorStrategy byDefaultConstructor()

Creates a DefaultConstructorStrategy that will call the public default no-argument constructor.

Returns:

the created DefaultConstructorStrategy

byArgumentTypes

public static DefaultConstructorStrategy byArgumentTypes(java.lang.Class<?>[] argumentTypes,
                                                         java.lang.Object... arguments)

Creates a DefaultConstructorStrategy that will call the public constructor with the specified argument types and passes the specified argument list.

Parameters:

argumentTypes - the argument types defining the constructor to call

arguments - the arguments to pass to the constructor (may contain null)

Returns:

the created DefaultConstructorStrategy

byMatchingArguments

public static DefaultConstructorStrategy byMatchingArguments(java.lang.Object... arguments)

Creates a DefaultConstructorStrategy that will call a public constructor that matches the specified arguments. A constructor must match all specified arguments, except null values which match any non-primitive type. The conversion from object types into corresponding primitive types (for example Integer into int) is handled automatically. If multiple public constructors match the specified arguments the construct(Class) method will throw a ScriptException.

Parameters:

arguments - the arguments to pass to the constructor (may contain null)

Returns:

the created DefaultConstructorStrategy