@PublicApi public abstract @interface


implements Annotation


This @interface is designed for plugins to consume (call its methods).

Clients of @PublicApi can expect that programs compiled against a given version will remain binary compatible with later versions of the @PublicApi as per each product's API policy as long as the client does not implement/extend @PublicApi interfaces or classes (refer to each product's API policy for the exact guarantee---usually binary compatibility is guaranteed at least across minor versions).

Note: since @PublicApi interfaces and classes are not designed to be implemented or extended by clients, we may perform certain types of binary-incompatible changes to these classes and interfaces, but these will not affect well-behaved clients that do not extend/implement these types (in general, only classes and interfaces annotated with @PublicSpi are safe to extend/implement).

Class Overview

Marker annotation to indicate that an item, such as a cache, is cluster safe, even though it uses a pattern, e.g. ConcurrentHashMap, that would not normally be so.

This would typically be used for something that is safely cached independently on each node of the cluster, such as a Velocity Template Cache.


Inherited Methods
From interface java.lang.annotation.Annotation