Re: [jakartaee-platform-dev] Redefine what Priority annotation means acr

["Thomas Bitonti" <bitonti@xxxxxxxxxx>]

The JavaEE7 and JavaEE8 JavaDoc have:

>> The Priority annotation can be applied to classes to indicate in
>> what order the classes should be used. The effect of using the
>> Priority annotation in any particular instance is defined by other
>> specifications that define the use of a specific class.
>>
>> For example, the Interceptors specification defines the use of
>> priorities on interceptors to control the order in which
>> interceptors are called.
>>
>> Priority values should generally be non-negative, with negative
>> values reserved for special meanings such as "undefined" or "not
>> specified". A specification that defines use of the Priority
>> annotation may define the range of allowed priorities and any
>> priority values with special meaning

Here, the meaning is defined by the specification that uses the annotation, not by the priority annotation itself.  Having Priority set the meaning changes the basic definition.

Based on this, I'm thinking that (E) is best, with a modification to document the preferred meaning.

Also:

Allowing the specification that uses the annotation define how the annotation will be used provides the most inclusive definition. Specifications that are to be added to Jakarta won't need to redefine their use of Priority.

Adding a new annotation (@Ranking) seems to add as much confusion as is removed by unifying the way the annotation is used.

"Rank" has particular associations which we perhaps should avoid: Military rank, class rank.  I don't think "Rank" is best for a new annotation.

Thomas F. Bitonti
WebSphere Application Server

"Emily Jiang via jakartaee-platform-dev" ---11/09/2021 07:09:40 AM---As promised in last week's Jakarta EE platform call, I have created this doc <https://urldefense.pro

From: "Emily Jiang via jakartaee-platform-dev" <jakartaee-platform-dev@xxxxxxxxxxx>
To: "jakartaee-platform developer discussions" <jakartaee-platform-dev@xxxxxxxxxxx>, "JakartaEE Spec Project Leadership discussions" <jakartaee-spec-project-leads@xxxxxxxxxxx>
Cc: "Emily Jiang" <emijiang6@xxxxxxxxxxxxxx>
Date: 11/09/2021 07:09 AM
Subject: [EXTERNAL] [jakartaee-platform-dev] Redefine what Priority annotation means across Jakarta EE specifications
Sent by: "jakartaee-platform-dev" <jakartaee-platform-dev-bounces@xxxxxxxxxxx>

---

As promised in last week's Jakarta EE platform call, I have created this doc to list the problem with the annotation of @Priority on Jakarta Annotations specification and proposed a few solutions for further conversation. Please take a ZjQcmQRYFpfptBannerStart 
This Message Is From an External Sender 
This message came from outside your organization. 
ZjQcmQRYFpfptBannerEnd
As promised in last week's Jakarta EE platform call, I have created this doc to list the problem with the annotation of @Priority on Jakarta Annotations specification and proposed a few solutions for further conversation. Please take a look at the doc and comment on this thread on which solution do you prefer. Additionally, if you have other solutions, please add it to the doc.


-- 
Thanks
Emily
_______________________________________________
jakartaee-platform-dev mailing list
jakartaee-platform-dev@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakartaee-platform-dev