Top Description Methods
io.grpc

public @Interface ExperimentalApi

extends Annotation
Annotations
@Retention:CLASS
@Target:ANNOTATION_TYPE, CONSTRUCTOR, FIELD, METHOD, PACKAGE, TYPE
@Documented
Imports
java.lang.annotation.Documented, .ElementType, .Retention, .RetentionPolicy, .Target
Indicates a public API that can change at any time, and has no guarantee of API stability and backward-compatibility. If users want stabilization or signature change of a specific API that is currently annotated @ExperimentalApi, please comment on its tracking issue on github with rationale, usecase, and so forth, so that the gRPC team may prioritize the process toward stabilization of the API.

Usage guidelines:

  1. This annotation is used only on public API. Internal interfaces should not use it.
  2. After gRPC has gained API stability, this annotation can only be added to new API. Adding it to an existing API is considered API-breaking.
  3. Removing this annotation from an API gives it stable status.

Note

This annotation is intended only for gRPC library code. Users should not attach this annotation to their own code.

See: grpc-java-api-checker, an Error Prone plugin to automatically check for usages of this API.

Method Summary

Modifier and TypeMethod and Description
public String
value()

Context information such as links to discussion thread, tracking issue etc.

Inherited from java.lang.annotation.Annotation:
annotationTypeequalshashCodetoString

Method Detail

valueback to summary
public String value()

Context information such as links to discussion thread, tracking issue etc.