Class BeanTypes

java.lang.Object

org.microbean.assign.Types

org.microbean.bean.BeanTypes

All Implemented Interfaces:

Constable

public final class BeanTypes
extends Types

A utility for working with bean types.

Author:

Laird Nelson

See Also:

• beanTypes(TypeMirror)
• legalBeanType(TypeMirror)

Constructor Summary

Constructors

Constructor	Description
BeanTypes(Domain domain)	Creates a new BeanTypes.

Method Summary

Modifier and Type	Method	Description
final BeanTypeList	beanTypes(TypeMirror t)	Returns a BeanTypeList of legal bean types that the supplied TypeMirror bears.
final void	clearCaches()	Clears caches that may be used internally by this BeanTypes.
static final boolean	legalBeanType(TypeMirror t)	Returns true if and only if the supplied TypeMirror is a legal bean type as defined by the CDI specification.
static final boolean	proxiableBeanType(TypeMirror t)	Returns true if and only if the supplied TypeMirror is a legal, declared, proxiable bean type as defined by the CDI specification.

Methods inherited from class org.microbean.assign.Types

describeConstable, domain, equals, erasedName, hashCode, supertypes, supertypes

Methods inherited from class java.lang.Object

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

Constructor Details

BeanTypes

public BeanTypes(Domain domain)

Creates a new BeanTypes.

Parameters:

domain - a Domain; must not be null

Throws:

NullPointerException - if domain is null

Method Details

beanTypes

public final BeanTypeList beanTypes(TypeMirror t)

Returns a BeanTypeList of legal bean types that the supplied TypeMirror bears.

The returned BeanTypeList may be empty.

Parameters:

t - a TypeMirror; must not be null

Returns:

a BeanTypeList of legal bean types that the supplied TypeMirror bears; never null

Throws:

NullPointerException - if t is null

See Also:

• Types.supertypes(TypeMirror, java.util.function.Predicate)

Idempotency:

This method is idempotent and returns determinate values.

Nullability:

This method never returns null.

Thread Safety:

This method is safe for concurrent use by multiple threads.

clearCaches

public final void clearCaches()

Clears caches that may be used internally by this BeanTypes.

Idempotency:

This method may clear internal state but otherwise has no side effects.

Thread Safety:

This method is safe for concurrent use by multiple threads.

legalBeanType

public static final boolean legalBeanType(TypeMirror t)

Returns true if and only if the supplied TypeMirror is a legal bean type as defined by the CDI specification.

Legal bean types are, exactly:

1. Array types whose component types are legal bean types
2. Primitive types
3. Declared types that contain no wildcard types for every interpretation and level of containment

Parameters:

t - a TypeMirror; must not be null

Returns:

true if and only if t is a legal bean type; false otherwise

Throws:

NullPointerException - if t is null

See Also:

• CDI-502
• CDI issue 823
• WELD-1492

External Specifications

• CDI Specification, version 4.1, section 2.2.1

Idempotency:

This method is idempotent and deterministic.

Thread Safety:

This method itself is safe for concurrent use by multiple threads, but TypeMirror implementations and Domain implementations may not be safe for such use.

proxiableBeanType

public static final boolean proxiableBeanType(TypeMirror t)

Returns true if and only if the supplied TypeMirror is a legal, declared, proxiable bean type as defined by the CDI specification.

Parameters:

t - a TypeMirror; must not be null

Returns:

true if and only if the supplied TypeMirror is a proxiable bean type

Throws:

NullPointerException - if t is null

See Also:

• proxiableElement(Element)

External Specifications

• CDI Specification, version 4.1, section 3.10

Idempotency:

This method is idempotent and deterministic.

Thread Safety:

This method itself is safe for concurrent use by multiple threads, but TypeMirror implementations and Domain implementations may not be safe for such use.