@InterfaceAudience.Public @InterfaceStability.Stable public interface FileSystem { ... } @InterfaceAudience.Private @InterfaceStability.Unstable public interface InternalClass { ... } @Deprecated public void oldMethod() { ... } @SuppressWarnings("unchecked") public List<String> getSomeData() { ... } @InterfaceAudience.Public @InterfaceStability.Stable public class MyHadoopClass { @Deprecated public void oldMethod() { } @SuppressWarnings("unchecked") public List<String> getSomeData() { return new ArrayList<>(); } } <dependency> <groupId>org.apache.hadoop</groupId> <artifactId>hadoop-annotations</artifactId> <version>3.3.1</version> </dependency>