Docs: not entirely clear what happens if you inject a bean with an unsatisfied requirement about micronaut-core HOT 2 OPEN

If I want to say "give me this bean if it's available, but, not if it isn't" what am I supposed to do here?

Wrap it in an Optional.

or annotate it with @Nullable.

@Controller
class MyController {
    private final ServiceWhichMayNotBeAvailable service;
    MyController(@Nullable ServiceWhichMayNotBeAvailable service) {
        this.service = service;
    }
}

from micronaut-core.

What's not really clear is what happens if I inject a bean that has an unsatisfied requirement. Is the reference set to null? Is there an exception?

A bean that doesn't match its requirements is never created. There is no such bean, and when trying to inject it elsewhere, you will get... NoSuchBeanException (pun intended 😜).

If I want to say "give me this bean if it's available, but, not if it isn't" what am I supposed to do here?

Wrap it in an Optional.

The docs seem to think this is obvious but for people who haven't worked with Spring or similar frameworks, it isn't especially obvious.

Would you please be so kind to send a PR to the exact parts of the docs where you miss this, given my previous answers?

from micronaut-core.