Package io.micronaut.aop

Enum Class Around.ProxyTargetConstructorMode

java.lang.Object

java.lang.Enum<Around.ProxyTargetConstructorMode>

io.micronaut.aop.Around.ProxyTargetConstructorMode

All Implemented Interfaces:

Serializable, Comparable<Around.ProxyTargetConstructorMode>, Constable

Enclosing class:

Around

public static enum Around.ProxyTargetConstructorMode
extends Enum<Around.ProxyTargetConstructorMode>

When using Around.proxyTarget() on a Factory method if the returned bean features constructor arguments this can lead to undefined behaviour since it is expected with factory methods that the developer is responsible for constructing the object.

For example if the type accepts an argument of type String then there is no way for Micronaut to know what to inject as a value for the argument and injecting null is inherently unsafe.

The Around.ProxyTargetConstructorMode allows the developer decide if they wish to allow proxies to be constructed and if a proxy is allowed then Micronaut will either inject a bean if it is found or null if is not. For primitive types Micronaut will inject true for booleans and 0 for number types

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ALLOW	Allow types to be proxied and don't print any warnings.
ERROR	Do not allow types with constructor arguments to be proxied.
WARN	Allow types to be proxied but print a warning when this feature is used.

Method Summary

Modifier and Type	Method	Description
static Around.ProxyTargetConstructorMode	valueOf(String name)	Returns the enum constant of this class with the specified name.
static Around.ProxyTargetConstructorMode[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

ERROR

public static final Around.ProxyTargetConstructorMode ERROR

Do not allow types with constructor arguments to be proxied. This is the default behaviour and compilation will fail.

WARN

public static final Around.ProxyTargetConstructorMode WARN

Allow types to be proxied but print a warning when this feature is used.

In this case if a constructor parameter cannot be injected Micronaut will inject null for objects or false for boolean or 0 for any other primitive.

ALLOW

public static final Around.ProxyTargetConstructorMode ALLOW

Allow types to be proxied and don't print any warnings.

Method Details

values

public static Around.ProxyTargetConstructorMode[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static Around.ProxyTargetConstructorMode valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null