Enhancements: Fix doc error, add method placeholder, rename function.

Author: nbayati

cab-token-generator/java/com/google/auth/credentialaccessboundary/ClientSideCredentialAccessBoundaryFactory.java

@@ -38,6 +38,7 @@
 import com.google.auth.Credentials;
 import com.google.auth.http.HttpTransportFactory;
 import com.google.auth.oauth2.AccessToken;
+import com.google.auth.oauth2.CredentialAccessBoundary;
 import com.google.auth.oauth2.GoogleCredentials;
 import com.google.auth.oauth2.OAuth2Utils;
 import com.google.auth.oauth2.StsRequestHandler;
@@ -60,7 +61,7 @@ private ClientSideCredentialAccessBoundaryFactory(Builder builder) {
     this.tokenExchangeEndpoint = builder.tokenExchangeEndpoint;
   }
 
-  private void refreshIntermediateCredentials() throws IOException {
+  private void refreshCredentials() throws IOException {
     try {
       this.sourceCredential.refreshIfExpired();
     } catch (IOException e) {
@@ -100,6 +101,16 @@ private void refreshIntermediateCredentials() throws IOException {
     }
   }
 
+  private void refreshCredentialsIfRequired() {
+    // TODO(negarb): Implement refreshCredentialsIfRequired
+    throw new UnsupportedOperationException("refreshCredentialsIfRequired is not yet implemented.");
+  }
+
+  public AccessToken generateToken(CredentialAccessBoundary accessBoundary) {
+    // TODO(negarb/jiahuah): Implement generateToken
+    throw new UnsupportedOperationException("generateToken is not yet implemented.");
+  }
+
   public static Builder newBuilder() {
     return new Builder();
   }
@@ -113,11 +124,12 @@ public static class Builder {
     private Builder() {}
 
     /**
-     * Sets the required source credential used to acquire the intermediary credential.
+     * Sets the required source credential.
      *
      * @param sourceCredential the {@code GoogleCredentials} to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setSourceCredential(GoogleCredentials sourceCredential) {
       this.sourceCredential = sourceCredential;
       return this;

oauth2_http/java/com/google/auth/oauth2/StsTokenExchangeResponse.java

@@ -40,14 +40,16 @@
 import javax.annotation.Nullable;
 
 /**
- * Represents an OAuth 2.0 token exchange request to the Google Security Token Service (STS), as
- * defined in <a href="https://tools.ietf.org/html/rfc8693#section-2.1">RFC 8693, Section 2.1</a>.
+ * Represents a successful OAuth 2.0 token exchange response from the Google Security Token Service
+ * (STS), as defined in <a href="https://tools.ietf.org/html/rfc8693#section-2.2.1">RFC 8693,
+ * Section 2.2.1</a>.
  *
- * <p>This class encapsulates the parameters for the request, including the subject token and its
- * type, along with optional parameters like acting party, scopes, resource, audience, requested
- * token type, and internal options.
+ * <p>This class provides access to the exchanged access token, issued token type, token type,
+ * expiration time, refresh token (optional), scopes (optional), and the access boundary session key
+ * (optional).
  *
- * <p>Instances are immutable. Use {@link #newBuilder(String, String, String)} to create a builder.
+ * <p>Instances are immutable. Use {@link #newBuilder(String, String, String)} to create an
+ * instance.
  */
 public final class StsTokenExchangeResponse {
   private final AccessToken accessToken;