Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Improve precision of the bean and event assignability API specification #744

Merged
merged 1 commit into from
Jan 15, 2024
Merged

Improve precision of the bean and event assignability API specification #744

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -258,8 +258,12 @@ public interface BeanContainer {
* Returns {@code true} if a bean with given bean types and qualifiers would be assignable
* to an injection point with given required type and required qualifiers, {@code false} otherwise.
* <p>
* Callers do not need to include implied qualifiers ({@code @Default}, {@code @Any}).
* These will be automatically added where applicable.
* In line with the specification for beans and typesafe resolution, the set of
* {@code beanTypes} is considered to always include {@code java.lang.Object}.
* The set of {@code beanQualifiers} is considered to always include {@code @Any} and
* also include {@code @Default} when it contains no other qualifier but {@code @Any}
* and {@code @Named}. The set of {@code requiredQualifiers} is considered to include
* {@code @Default} when it is empty.
* <p>
* Throws {@link IllegalArgumentException} if any of the arguments is {@code null}.
*
Expand All @@ -277,8 +281,8 @@ boolean isMatchingBean(Set<Type> beanTypes, Set<Annotation> beanQualifiers, Type
* Returns {@code true} if an event object with given type and qualifiers would match
* an observer method with given observed event type and observed event qualifiers, {@code false} otherwise.
* <p>
* Callers do not need to include the implied qualifier ({@code @Any}).
* It will be automatically added where applicable.
* In line with the specification for events and observer resolution, the set of
* {@code eventQualifiers} is considered to always include {@code @Any}.
* <p>
* Throws {@link IllegalArgumentException} if any of the arguments is {@code null}.
*
Expand Down