[SQOOP-1926] Sqoop2: Add annotations for visibilty and compatibility guarantees

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 1.99.5
• Assignee: Abraham Elmahrek
• Reporter: Abraham Elmahrek
• Created: 18/Dec/14 18:52
• Updated: 21/Jan/15 16:46
• Resolved: 21/Jan/15 15:44

Description

In Hadoop, there are annotations that describe the visibility of an API and its compatibility story:

https://github.com/apache/hadoop/blob/branch-2.6/hadoop-mapreduce-project/hadoop-mapreduce-client/hadoop-mapreduce-client-core/src/main/java/org/apache/hadoop/mapreduce/Job.java#L76

@InterfaceAudience.Public
@InterfaceStability.Evolving

It would be nice to use some thing similar to this (if not the same thing) and define our own (or same) compatibility story.

This lock down the connector APIs and define a better contract about what can be modified.

Reference:

1. http://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-common/Compatibility.html
2. http://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-common/InterfaceClassification.html

Issue Links

• is related to: SQOOP-1870 Sqoop2: Merge SPI and connector-sdk packages
• links to: RB