Yes, the Java API Compliance Checker allows specifying Annotations to pare down where incompatible changes happen. It was added some time ago based on feedback from the Apache HBase project.
The limitations I've found are: 1) at least earlier versions only supported annotations at the class level (which prevents things like VisibleForTesting), 2) sometimes it will include more restricted classes if they are used in less restrictive APIs (e.g. if a IA.Public class makes use of a IA.Private class in a method signature). At least when we've used it in HBase, these limitations have been very easy to spot an explain in a small amount of text. I expect I will be able to do the same with Hadoop. If we'd like to automate this, the author has been very responsive to feature requests thus far. On Mon, Jul 25, 2016 at 3:47 PM, Vinod Kumar Vavilapalli <vino...@apache.org> wrote: > Actually, I wouldn’t trust this report as it stands today at all. > > I quickly glanced the report, looking for what it highlights as > incompatible. But the ones that I saw have private / visible for testing > annotations. Other than acting as useless evidence for those lashing out on > branch-2, this won’t do much good. > > Whenever we start working towards switching to this tool, it should > incorporate the same exclude-annotations logic that the jdiff code-path does > today. Do you think that is possible? > > Thanks > +Vinod > > On Jul 22, 2016, at 4:53 PM, Vinod Kumar Vavilapalli <vino...@apache.org> > wrote: > > Do you want this check from some particular branch-2 release? It > matters since the releases along branch-2 have themselves had some > noise[2]. > > [1]: https://github.com/lvc/japi-compliance-checker > <https://github.com/lvc/japi-compliance-checker> > [2]: http://abi-laboratory.pro/java/tracker/timeline/hadoop/ > <http://abi-laboratory.pro/java/tracker/timeline/hadoop/> > > -- > busbey > > -- busbey --------------------------------------------------------------------- To unsubscribe, e-mail: common-dev-unsubscr...@hadoop.apache.org For additional commands, e-mail: common-dev-h...@hadoop.apache.org
