Added more javadoc on addInterceptor method
@@ -24,8 +24,13 @@ import io.vertx.ext.web.client.WebClient;
public interface WebClientInternal extends WebClient {
/**
- * Add interceptor.
- * <p>
+ * Add interceptor in the chain.
+ * <p/>
+ * The interceptor can maintain per request state with {@link HttpContext#get(String)}/{@link HttpContext#set(String, Object)}.
+ * <p/>
+ * A request/response can be processed several times (in case of retry) and thus they should use the per request state
+ * to ensure an operation is not done twice.
+ * <p/>
* This API is internal and is subject to change or to be replaced by another one.
*
* @param interceptor the interceptor to add
