Add missing annotation literals

[BalusC]

Make sure that all @Qualifier @Retention(RUNTIME) public @interface Xyz {} annotation classes in the jakarta.faces package have a corresponding AnnotationLiteral implementation provided by the API.

The pattern is:

With parameters:

@Qualifier
@Retention(RUNTIME)
public @interface Xyz {

    String foo() default "";
    String bar() default "bla";

    /**
     * <p class="changed_added_4_0">
     * Supports inline instantiation of the {@link Xyz} annotation.
     * </p>
     * 
     * @since 4.0
     */
    public static final class Literal extends AnnotationLiteral<Xyz> implements Xyz {

        private static final long serialVersionUID = 1L;

        public static final Literal INSTANCE = of("", "bla");

        private final String foo;
        private final String bar;

        public static Literal of(String foo, String bar) {
            return new Literal(foo, bar);
        }

        private Literal(String foo, String bar) {
            this.foo = foo;
            this.bar = bar;
        }

        @Override
        public String foo() {
            return foo;
        }

        @Override
        public String bar() {
            return bar;
        }
    }
}

Without parameters:

@Qualifier
@Retention(RUNTIME)
@Target({ TYPE, METHOD, FIELD, PARAMETER })
@Documented
public @interface Xyz {
  
    public static final class Literal extends AnnotationLiteral<Any> implements Xyz {
        private static final long serialVersionUID = 1L;
        public static final Literal INSTANCE = new Literal();
    }
}

[arjantijms]

Provided implementation for Mojarra here: eclipse-ee4j/mojarra#4963

[tandraschko]

also implemented in myfaces

[arjantijms]

also implemented in myfaces

Thanks!

[BalusC]

@arjantijms please reopen; during spec verification and cleanup I noticed literals are missing for following qualifiers (which are not in annotation subpackage):

• @FacesBehavior
• @FacesConverter
• @FacesDataModel
• @FacesValidator
• @FlowBuilderParameter
• @FlowDefinition
• @Push
• @WebsocketEvent.Closed
• @WebsocketEvent.Opened

And I also noticed @RequestCookieMap and @SessionMap have an unspecified copy in jakarta.faces.context package (they already exist in jakarta.faces.annotation package). Those apparent accidental copies should be removed or at least be deprecated.

[BalusC]

As confirmed with Arjan, unspecified copies of @RequestCookieMap and @SessionMap in jakarta.faces.context package have been removed.