[YARN-4279] Mark ApplicationId and ApplicationAttemptId static methods as @Public, @Unstable

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.7.1
• Fix Version/s: 2.8.0, 3.0.0-alpha1
• Component/s: client
• Assignee: Steve Loughran
• Reporter: Steve Loughran
• Created: 20/Oct/15 13:05
• Updated: 30/Aug/16 01:15
• Resolved: 18/Nov/15 21:41

Description

The classes ApplicationId and ApplicationAttemptId both have newInstance() methods tagged as @Private. Yet they are useful in testing, as the alternative is to create and configure the PBImpl classes -which are significantly more private.

The fact that mapreduce's MRBuilderUtils uses one of the methods shows that YARN apps do need access to the methods.

Marking them as public would make it clear that other YARN apps were using them for their production or test code, rather than today, where they are used and depended on, yet without the YARN team's knowledge.