Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[SPARK-26055][CORE] InterfaceStability annotations should be retained at runtime #23029

Closed
wants to merge 2 commits into from

Conversation

cloud-fan
Copy link
Contributor

What changes were proposed in this pull request?

It's good to have annotations available at runtime, so that tools like MiMa can detect them and deal with then specially. e.g. we don't want to track compatibility for unstable classes.

This PR makes InterfaceStability annotations to be retained at runtime, to be consistent with Experimental and DeveloperApi

How was this patch tested?

N/A

@cloud-fan
Copy link
Contributor Author

cc @rxin @srowen @vanzin @gatorsmile

Copy link
Member

@srowen srowen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems OK to me. I don't think there are any downsides to retaining them as they can be freely ignored at runtime by tools that don't care. And these annotations are Java 7+

@@ -17,7 +17,7 @@

package org.apache.spark.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.*;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No big deal, but I think we'd usually explicitly import 3 classes.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually we need to import 5 classes, that's why my IDE turned it into * automatically...

@SparkQA
Copy link

SparkQA commented Nov 14, 2018

Test build #98810 has finished for PR 23029 at commit b71dd6d.

  • This patch fails due to an unknown error code, -9.
  • This patch merges cleanly.
  • This patch adds no public classes.

@cloud-fan
Copy link
Contributor Author

retest this please

@SparkQA
Copy link

SparkQA commented Nov 14, 2018

Test build #98822 has finished for PR 23029 at commit b71dd6d.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@vanzin
Copy link
Contributor

vanzin commented Nov 14, 2018

Since you're here do you want to add @Documented to Private too?

@SparkQA
Copy link

SparkQA commented Nov 15, 2018

Test build #98854 has finished for PR 23029 at commit f43d409.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@cloud-fan
Copy link
Contributor Author

thanks, merging to master!

@asfgit asfgit closed this in 9610efc Nov 15, 2018
jackylee-ch pushed a commit to jackylee-ch/spark that referenced this pull request Feb 18, 2019
… at runtime

## What changes were proposed in this pull request?

It's good to have annotations available at runtime, so that tools like MiMa can detect them and deal with then specially. e.g. we don't want to track compatibility for unstable classes.

This PR makes `InterfaceStability` annotations to be retained at runtime, to be consistent with `Experimental` and `DeveloperApi`

## How was this patch tested?
N/A

Closes apache#23029 from cloud-fan/annotation.

Authored-by: Wenchen Fan <wenchen@databricks.com>
Signed-off-by: Wenchen Fan <wenchen@databricks.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
4 participants