From 50ca51e41f1445b70aec530558ab04bbd7be6a46 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Sun, 6 Apr 2025 12:08:11 +0200
Subject: [PATCH] Clarify scope of WebServiceMessageSender

Closes gh-1063
---
 .../ws/client/support/WebServiceAccessor.java  | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/spring-ws-core/src/main/java/org/springframework/ws/client/support/WebServiceAccessor.java b/spring-ws-core/src/main/java/org/springframework/ws/client/support/WebServiceAccessor.java
index a0d77bd5..dc3883dd 100644
--- a/spring-ws-core/src/main/java/org/springframework/ws/client/support/WebServiceAccessor.java
+++ b/spring-ws-core/src/main/java/org/springframework/ws/client/support/WebServiceAccessor.java
@@ -55,16 +55,16 @@ public abstract class WebServiceAccessor extends TransformerObjectSupport implem
 		this.messageFactory = messageFactory;
 	}
 
-	/** Returns the message senders used for sending messages. */
+	/**
+	 * Return the {@link WebServiceMessageSender message senders} to consider for sending
+	 * messages.
+	 */
 	public WebServiceMessageSender[] getMessageSenders() {
 		return this.messageSenders;
 	}
 
 	/**
-	 * Sets the single message sender used for sending messages.
-	 * <p>
-	 * This message sender will be used to resolve an URI to a
-	 * {@link WebServiceConnection}.
+	 * Set the {@linkplain WebServiceMessageSender message sender} to use.
 	 * @see #createConnection(URI)
 	 */
 	public void setMessageSender(WebServiceMessageSender messageSender) {
@@ -73,10 +73,10 @@ public abstract class WebServiceAccessor extends TransformerObjectSupport implem
 	}
 
 	/**
-	 * Sets the message senders used for sending messages.
-	 * <p>
-	 * These message senders will be used to resolve an URI to a
-	 * {@link WebServiceConnection}.
+	 * Set the {@linkplain WebServiceMessageSender message senders} to use. The first
+	 * instance that {@linkplain WebServiceMessageSender#supports(URI) supports} a given
+	 * URI is used. This allows for using a singe instance with various transport
+	 * implementations. {@link WebServiceConnection}.
 	 * @see #createConnection(URI)
 	 */
 	public void setMessageSenders(WebServiceMessageSender[] messageSenders) {