Fix code formatting

Author: tzolov

mcp/src/main/java/org/springframework/ai/mcp/client/McpClient.java

@@ -34,33 +34,37 @@
 import org.springframework.ai.mcp.util.Assert;
 
 /**
- * Factory class for creating Model Context Protocol (MCP) clients. MCP is a protocol that enables
- * AI models to interact with external tools and resources through a standardized interface.
- * 
- * <p>This class serves as the main entry point for establishing connections with MCP servers,
- * implementing the client-side of the MCP specification. The protocol follows a client-server
- * architecture where:
+ * Factory class for creating Model Context Protocol (MCP) clients. MCP is a protocol that
+ * enables AI models to interact with external tools and resources through a standardized
+ * interface.
+ *
+ * <p>
+ * This class serves as the main entry point for establishing connections with MCP
+ * servers, implementing the client-side of the MCP specification. The protocol follows a
+ * client-server architecture where:
  * <ul>
  * <li>The client (this implementation) initiates connections and sends requests
  * <li>The server responds to requests and provides access to tools and resources
- * <li>Communication occurs through a transport layer (e.g., stdio, SSE) using JSON-RPC 2.0
+ * <li>Communication occurs through a transport layer (e.g., stdio, SSE) using JSON-RPC
+ * 2.0
  * </ul>
  *
- * <p>The class provides factory methods to create either:
+ * <p>
+ * The class provides factory methods to create either:
  * <ul>
  * <li>{@link McpAsyncClient} for non-blocking operations with CompletableFuture responses
  * <li>{@link McpSyncClient} for blocking operations with direct responses
  * </ul>
  *
- * <p>Example of creating a basic client:
- * <pre>{@code
+ * <p>
+ * Example of creating a basic client: <pre>{@code
  * McpClient.using(transport)
  *     .requestTimeout(Duration.ofSeconds(5))
  *     .sync(); // or .async()
  * }</pre>
  *
- * <p>Example with advanced configuration:
- * <pre>{@code
+ * <p>
+ * Example with advanced configuration: <pre>{@code
  * McpClient.using(transport)
  *     .requestTimeout(Duration.ofSeconds(10))
  *     .capabilities(new ClientCapabilities(...))
@@ -70,7 +74,8 @@
  *     .async();
  * }</pre>
  *
- * <p>The client supports:
+ * <p>
+ * The client supports:
  * <ul>
  * <li>Tool discovery and invocation
  * <li>Resource access and management
@@ -88,14 +93,12 @@
 public interface McpClient {
 
 	/**
-	 * Start building an MCP client with the specified transport layer.
-	 * The transport layer handles the low-level communication between
-	 * client and server using protocols like stdio or Server-Sent Events (SSE).
-	 *
-	 * @param transport The transport layer implementation for MCP communication.
-	 *                  Common implementations include {@code StdioClientTransport}
-	 *                  for stdio-based communication and {@code SseClientTransport}
-	 *                  for SSE-based communication.
+	 * Start building an MCP client with the specified transport layer. The transport
+	 * layer handles the low-level communication between client and server using protocols
+	 * like stdio or Server-Sent Events (SSE).
+	 * @param transport The transport layer implementation for MCP communication. Common
+	 * implementations include {@code StdioClientTransport} for stdio-based communication
+	 * and {@code SseClientTransport} for SSE-based communication.
 	 * @return A new builder instance for configuring the client
 	 * @throws IllegalArgumentException if transport is null
 	 */
@@ -104,11 +107,12 @@ public static Builder using(McpTransport transport) {
 	}
 
 	/**
-	 * Builder class for creating and configuring MCP clients. This class follows
-	 * the builder pattern to provide a fluent API for setting up clients with
-	 * custom configurations.
+	 * Builder class for creating and configuring MCP clients. This class follows the
+	 * builder pattern to provide a fluent API for setting up clients with custom
+	 * configurations.
 	 *
-	 * <p>The builder supports configuration of:
+	 * <p>
+	 * The builder supports configuration of:
 	 * <ul>
 	 * <li>Transport layer for client-server communication
 	 * <li>Request timeouts for operation boundaries
@@ -145,12 +149,11 @@ private Builder(McpTransport transport) {
 		}
 
 		/**
-		 * Sets the duration to wait for server responses before timing out requests.
-		 * This timeout applies to all requests made through the client, including
-		 * tool calls, resource access, and prompt operations.
-		 *
-		 * @param requestTimeout The duration to wait before timing out requests.
-		 *                       Must not be null.
+		 * Sets the duration to wait for server responses before timing out requests. This
+		 * timeout applies to all requests made through the client, including tool calls,
+		 * resource access, and prompt operations.
+		 * @param requestTimeout The duration to wait before timing out requests. Must not
+		 * be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if requestTimeout is null
 		 */
@@ -162,9 +165,8 @@ public Builder requestTimeout(Duration requestTimeout) {
 
 		/**
 		 * Sets the client capabilities that will be advertised to the server during
-		 * connection initialization. Capabilities define what features the client supports,
-		 * such as tool execution, resource access, and prompt handling.
-		 *
+		 * connection initialization. Capabilities define what features the client
+		 * supports, such as tool execution, resource access, and prompt handling.
 		 * @param capabilities The client capabilities configuration. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if capabilities is null
@@ -179,9 +181,8 @@ public Builder capabilities(ClientCapabilities capabilities) {
 		 * Sets the client implementation information that will be shared with the server
 		 * during connection initialization. This helps with version compatibility and
 		 * debugging.
-		 *
 		 * @param clientInfo The client implementation details including name and version.
-		 *                   Must not be null.
+		 * Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if clientInfo is null
 		 */
@@ -192,10 +193,9 @@ public Builder clientInfo(Implementation clientInfo) {
 		}
 
 		/**
-		 * Sets the root URIs that this client can access. Roots define the base URIs
-		 * for resources that the client can request from the server. For example,
-		 * a root might be "file://workspace" for accessing workspace files.
-		 *
+		 * Sets the root URIs that this client can access. Roots define the base URIs for
+		 * resources that the client can request from the server. For example, a root
+		 * might be "file://workspace" for accessing workspace files.
 		 * @param roots A list of root definitions. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if roots is null
@@ -209,9 +209,8 @@ public Builder roots(List<Root> roots) {
 		}
 
 		/**
-		 * Sets the root URIs that this client can access, using a varargs parameter
-		 * for convenience. This is an alternative to {@link #roots(List)}.
-		 *
+		 * Sets the root URIs that this client can access, using a varargs parameter for
+		 * convenience. This is an alternative to {@link #roots(List)}.
 		 * @param roots An array of root definitions. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if roots is null
@@ -226,12 +225,11 @@ public Builder roots(Root... roots) {
 		}
 
 		/**
-		 * Sets a custom sampling handler for processing message creation requests.
-		 * The sampling handler can modify or validate messages before they are sent
-		 * to the server, enabling custom processing logic.
-		 *
+		 * Sets a custom sampling handler for processing message creation requests. The
+		 * sampling handler can modify or validate messages before they are sent to the
+		 * server, enabling custom processing logic.
 		 * @param samplingHandler A function that processes message requests and returns
-		 *                        results. Must not be null.
+		 * results. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if samplingHandler is null
 		 */
@@ -242,12 +240,11 @@ public Builder sampling(Function<CreateMessageRequest, CreateMessageResult> samp
 		}
 
 		/**
-		 * Adds a consumer to be notified when the available tools change. This allows
-		 * the client to react to changes in the server's tool capabilities, such as
-		 * tools being added or removed.
-		 *
+		 * Adds a consumer to be notified when the available tools change. This allows the
+		 * client to react to changes in the server's tool capabilities, such as tools
+		 * being added or removed.
 		 * @param toolsChangeConsumer A consumer that receives the updated list of
-		 *                           available tools. Must not be null.
+		 * available tools. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if toolsChangeConsumer is null
 		 */
@@ -261,9 +258,8 @@ public Builder toolsChangeConsumer(Consumer<List<McpSchema.Tool>> toolsChangeCon
 		 * Adds a consumer to be notified when the available resources change. This allows
 		 * the client to react to changes in the server's resource availability, such as
 		 * files being added or removed.
-		 *
 		 * @param resourcesChangeConsumer A consumer that receives the updated list of
-		 *                               available resources. Must not be null.
+		 * available resources. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if resourcesChangeConsumer is null
 		 */
@@ -275,11 +271,10 @@ public Builder resourcesChangeConsumer(Consumer<List<McpSchema.Resource>> resour
 
 		/**
 		 * Adds a consumer to be notified when the available prompts change. This allows
-		 * the client to react to changes in the server's prompt templates, such as
-		 * new templates being added or existing ones being modified.
-		 *
+		 * the client to react to changes in the server's prompt templates, such as new
+		 * templates being added or existing ones being modified.
 		 * @param promptsChangeConsumer A consumer that receives the updated list of
-		 *                             available prompts. Must not be null.
+		 * available prompts. Must not be null.
 		 * @return This builder instance for method chaining
 		 * @throws IllegalArgumentException if promptsChangeConsumer is null
 		 */
@@ -290,25 +285,22 @@ public Builder promptsChangeConsumer(Consumer<List<McpSchema.Prompt>> promptsCha
 		}
 
 		/**
-		 * Builds a synchronous MCP client that provides blocking operations.
-		 * Synchronous clients wait for each operation to complete before returning,
-		 * making them simpler to use but potentially less performant for
-		 * concurrent operations.
-		 *
-		 * @return A new instance of {@link McpSyncClient} configured with this
-		 *         builder's settings
+		 * Builds a synchronous MCP client that provides blocking operations. Synchronous
+		 * clients wait for each operation to complete before returning, making them
+		 * simpler to use but potentially less performant for concurrent operations.
+		 * @return A new instance of {@link McpSyncClient} configured with this builder's
+		 * settings
 		 */
 		public McpSyncClient sync() {
 			return new McpSyncClient(async());
 		}
 
 		/**
 		 * Builds an asynchronous MCP client that provides non-blocking operations.
-		 * Asynchronous clients return CompletableFuture objects immediately,
-		 * allowing for concurrent operations and reactive programming patterns.
-		 *
-		 * @return A new instance of {@link McpAsyncClient} configured with this
-		 *         builder's settings
+		 * Asynchronous clients return CompletableFuture objects immediately, allowing for
+		 * concurrent operations and reactive programming patterns.
+		 * @return A new instance of {@link McpAsyncClient} configured with this builder's
+		 * settings
 		 */
 		public McpAsyncClient async() {
 			return new McpAsyncClient(transport, requestTimeout, clientInfo, capabilities, roots, toolsChangeConsumers,