api: stabilize ManagedChannelBuilder.useTransportSecurity (#10244)

sanjaypujare · web-flow · commit 6949b8790afe · 2023-06-02T15:08:25.000-07:00
* api: stabilize ManagedChannelBuilder.useTransportSecurity and add a note in Java doc
diff --git a/api/src/main/java/io/grpc/ManagedChannelBuilder.java b/api/src/main/java/io/grpc/ManagedChannelBuilder.java
@@ -193,14 +193,16 @@ public T usePlaintext() {
   }
 
   /**
-   * Makes the client use TLS.
+   * Makes the client use TLS. Note: this is enabled by default.
+   *
+   * <p>It is recommended to use the {@link ChannelCredentials} API
+   * instead of this method.
    *
    * @return this
    * @throws IllegalStateException if ChannelCredentials were provided when constructing the builder
    * @throws UnsupportedOperationException if transport security is not supported.
    * @since 1.9.0
    */
-  @ExperimentalApi("https://github.com/grpc/grpc-java/issues/3713")
   public T useTransportSecurity() {
     throw new UnsupportedOperationException();
   }

Original file line number	Diff line number	Diff line change
`@@ -193,14 +193,16 @@ public T usePlaintext() {`
`193`	`193`	`}`
`194`	`194`
`195`	`195`	`/**`
`196`		`- * Makes the client use TLS.`
	`196`	`+ * Makes the client use TLS. Note: this is enabled by default.`
	`197`	`+ *`
	`198`	`+ * <p>It is recommended to use the {@link ChannelCredentials} API`
	`199`	`+ * instead of this method.`
`197`	`200`	`*`
`198`	`201`	`* @return this`
`199`	`202`	`* @throws IllegalStateException if ChannelCredentials were provided when constructing the builder`
`200`	`203`	`* @throws UnsupportedOperationException if transport security is not supported.`
`201`	`204`	`* @since 1.9.0`
`202`	`205`	`*/`
`203`		`- @ExperimentalApi("https://github.com/grpc/grpc-java/issues/3713")`
`204`	`206`	`public T useTransportSecurity() {`
`205`	`207`	`throw new UnsupportedOperationException();`
`206`	`208`	`}`