Package net.ssehub.easy.instantiation.core.model.vilTypes

Class ReflectionConstructorDescriptor

java.lang.Object

net.ssehub.easy.instantiation.core.model.vilTypes.OperationDescriptor

net.ssehub.easy.instantiation.core.model.vilTypes.ReflectionConstructorDescriptor

All Implemented Interfaces:

ILazyDescriptor, IMetaOperation

public class ReflectionConstructorDescriptor
extends OperationDescriptor
implements ILazyDescriptor

Implements a reflection constructor descriptor.

Author:

Holger Eichelberger

Nested Class Summary

Nested classes/interfaces inherited from class net.ssehub.easy.instantiation.core.model.vilTypes.OperationDescriptor

OperationDescriptor.AliasType

Nested classes/interfaces inherited from interface net.ssehub.easy.instantiation.core.model.vilTypes.IMetaOperation

IMetaOperation.CompatibilityResult

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.reflect.Constructor<?>	constructor

Fields inherited from class net.ssehub.easy.instantiation.core.model.vilTypes.OperationDescriptor

CONSTRUCTOR_NAME, EMPTY_PARAMETER

Constructor Summary

Constructors

Constructor	Description
ReflectionConstructorDescriptor(TypeDescriptor<?> declaringType, java.lang.reflect.Constructor<?> constructor)	Creates a reflection constructor descriptor.

Method Summary

Modifier and Type	Method	Description
void	forceInitialization()	Forces the initialization of the typically lazily deferred parameters and return types.
protected java.lang.reflect.Constructor<?>	getConstructor()	Returns the wrapped constructor.
protected java.lang.String	getDeclaringTypeNameFallback()	Returns the name of the declaring type in case that OperationDescriptor.getDeclaringType() is null.
java.lang.String	getJavaSignature()	Returns the Java signature of the method (public for testing).
protected java.lang.Class<?>[]	getParameterGenerics(int index)	Determines the generic type of a parameter.
protected void	initializeParameters()	Initializes the parameters (lazy init).
protected void	initializeReturnType()	Initializes the return type (lazy init).
java.lang.Object	invoke(java.lang.Object... args)	Invokes the specified operation.
IMetaOperation.CompatibilityResult	isCompatible(java.lang.Class<?> retType, java.lang.Object... params)	Returns whether the operation represented by this instance is compatible to the given return type and parameters.
boolean	isFirstParameterOperand()	Returns whether the first parameter is the operand.
boolean	isPlaceholder()	Returns whether this operation is valid or whether it is a placeholder operation in case that the original operation cannot be resolved but the script shall remain executable.
boolean	isStatic()	Returns whether this operation is static.
boolean	storeArtifactsBeforeExecution()	Returns whether artifacts shall be stored before execution of this operation.
int	useGenericParameterAsReturn()	Returns whether a generc parameter of the operand shall be used as return type.
int	useParameterAsReturn()	Returns whether a parameter shall be used as return type.

Methods inherited from class net.ssehub.easy.instantiation.core.model.vilTypes.OperationDescriptor

acceptsImplicitParameters, acceptsNamedParameters, allowsAggregation, composeExceptionMessage, convertVariables, flatten, getAliasType, getDeclaringType, getDeclaringTypeName, getName, getOperationType, getParameter, getParameter, getParameterCount, getParameterType, getRequiredParameterCount, getReturnType, getSignature, getStoredName, isAlias, isConstructor, isConstructor, isConversion, isGenericCollectionOperation, isIteratingCollectionOperation, isOclCompliant, isOperation, isOperationOrConstructor, isSameSignature, isTypeSelect, requiresDynamicExpressionProcessing, setCharacteristics, setParameters, setReturnType, specializeFor, throwIncompatibleParameter, toString, trace, useAny, useOperandTypeAsParameter

Methods inherited from class java.lang.Object

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

Field Detail

constructor

private java.lang.reflect.Constructor<?> constructor

Constructor Detail

ReflectionConstructorDescriptor

public ReflectionConstructorDescriptor(TypeDescriptor<?> declaringType,
                                       java.lang.reflect.Constructor<?> constructor)

Creates a reflection constructor descriptor.

Parameters:

declaringType - the declaring type

constructor - the constructor

Method Detail

isStatic

public boolean isStatic()

Description copied from interface: IMetaOperation

Returns whether this operation is static.

Specified by:

isStatic in interface IMetaOperation

Returns:

true if it is static, false else

isFirstParameterOperand

public boolean isFirstParameterOperand()

Description copied from interface: IMetaOperation

Returns whether the first parameter is the operand.

Specified by:

isFirstParameterOperand in interface IMetaOperation

Returns:

true if the first parameter is the operand, false else

isPlaceholder

public boolean isPlaceholder()

Description copied from interface: IMetaOperation

Returns whether this operation is valid or whether it is a placeholder operation in case that the original operation cannot be resolved but the script shall remain executable.

Specified by:

isPlaceholder in interface IMetaOperation

Returns:

true if this operation is a placeholder, false else

initializeParameters

protected void initializeParameters()

Description copied from class: OperationDescriptor

Initializes the parameters (lazy init). Is called by OperationDescriptor.initialize(). Shall call OperationDescriptor.setParameters(List, boolean, boolean).

Specified by:

initializeParameters in class OperationDescriptor

getParameterGenerics

protected java.lang.Class<?>[] getParameterGenerics(int index)

Determines the generic type of a parameter.

Parameters:

index - the index of the parameter

Returns:

the generics (null if none are specified)

Throws:

java.lang.IndexOutOfBoundsException - if index < 0 || index >= OperationDescriptor.getParameterCount()

initializeReturnType

protected void initializeReturnType()

Description copied from class: OperationDescriptor

Initializes the return type (lazy init). Is called by OperationDescriptor.initialize(). Shall call OperationDescriptor.setReturnType(TypeDescriptor).

Specified by:

initializeReturnType in class OperationDescriptor

getDeclaringTypeNameFallback

protected java.lang.String getDeclaringTypeNameFallback()

Description copied from class: OperationDescriptor

Returns the name of the declaring type in case that OperationDescriptor.getDeclaringType() is null.

Specified by:

getDeclaringTypeNameFallback in class OperationDescriptor

Returns:

the name of the declaring type

getJavaSignature

public java.lang.String getJavaSignature()

Description copied from class: OperationDescriptor

Returns the Java signature of the method (public for testing).

Specified by:

getJavaSignature in interface IMetaOperation

Specified by:

getJavaSignature in class OperationDescriptor

Returns:

the Java signature of the method

isCompatible

public IMetaOperation.CompatibilityResult isCompatible(java.lang.Class<?> retType,
                                                       java.lang.Object... params)

Description copied from interface: IMetaOperation

Returns whether the operation represented by this instance is compatible to the given return type and parameters. This method does not consider possible unnamed parameter rather than the underlying Java parameter.

Specified by:

isCompatible in interface IMetaOperation

Parameters:

retType - the return type (may be null in order to ignore this parameter)

params - the parameters (may be null if there are none, may be classes)

Returns:

an instance of IMetaOperation.CompatibilityResult denoting the actual compatibility level

invoke

public java.lang.Object invoke(java.lang.Object... args)
                        throws VilException

Description copied from interface: IMetaOperation

Invokes the specified operation. This method does not consider possible unnamed parameter rather than the underlying Java parameter. In case of IMetaOperation.acceptsNamedParameters() the caller must ensure that the last parameter is a map<String, Object> containing the named parameters.

Specified by:

invoke in interface IMetaOperation

Parameters:

args - the arguments, in case of non-static operations the first argument must be the object to execute on

Returns:

the result of the execution

Throws:

VilException - if the invocation fails

See Also:

IMetaOperation.isCompatible(java.lang.Class<?>, java.lang.Object...)

useGenericParameterAsReturn

public int useGenericParameterAsReturn()

Description copied from class: OperationDescriptor

Returns whether a generc parameter of the operand shall be used as return type.

Specified by:

useGenericParameterAsReturn in class OperationDescriptor

Returns:

the parameter to be used as index number, negative if none

useParameterAsReturn

public int useParameterAsReturn()

Description copied from class: OperationDescriptor

Returns whether a parameter shall be used as return type.

Specified by:

useParameterAsReturn in class OperationDescriptor

Returns:

the parameter to be used as index number, negative if none

storeArtifactsBeforeExecution

public boolean storeArtifactsBeforeExecution()

Description copied from class: OperationDescriptor

Returns whether artifacts shall be stored before execution of this operation.

Specified by:

storeArtifactsBeforeExecution in class OperationDescriptor

Returns:

true if artifacts shall be stored, false else

forceInitialization

public void forceInitialization()

Description copied from interface: ILazyDescriptor

Forces the initialization of the typically lazily deferred parameters and return types.

Specified by:

forceInitialization in interface ILazyDescriptor

getConstructor

protected java.lang.reflect.Constructor<?> getConstructor()

Returns the wrapped constructor.

Returns:

the wrapped constructor