root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 8 Packages Projects Releases Wiki Activity

HttpServiceProxyRegistry Javadoc updates 

See gh-33992
This commit is contained in:
rstoyanchev 2025-04-15 17:27:48 +01:00
parent 40853825dc
commit 4599ad4168
1 changed files with 15 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
spring-web/src/main/java/org/springframework/web/service/registry/HttpServiceProxyRegistry.java
View File

@ -19,7 +19,7 @@ package org.springframework.web.service.registry;
import java.util.Set;
/**
* A registry that contains HTTP Service client proxies.
* A registry for HTTP service clients organized by {@link HttpServiceGroup}.
*
* @author Rossen Stoyanchev
* @author Olga Maciaszek-Sharma
@ -30,24 +30,23 @@ import java.util.Set;
public interface HttpServiceProxyRegistry {
/**
* Return an HTTP service client proxy from any group as long as there is
* only one client proxy of the given type across all groups.
* @param httpServiceType the type of client proxy
* @return the proxy, or {@code null} if not found
* @param <P> the type of HTTP Interface client proxy
* @throws IllegalArgumentException if there is no client proxy of the given
* type, or there is more than one client proxy of the given type
* Return an HTTP service client from any group as long as there is only one
* client of this type across all groups.
* @param httpServiceType the type of client
* @param <P> the type of HTTP interface client
* @return the matched client
* @throws IllegalArgumentException if there is no client of the given type,
* or there is more than one client of the given type.
*/
<P> P getClient(Class<P> httpServiceType);
/**
* Return an HTTP service client proxy from the given group.
* Return an HTTP service client from the named group.
* @param groupName the name of the group
* @param httpServiceType the type of client proxy
* @return the proxy, or {@code null} if not found
* @throws IllegalArgumentException if there is no group with the given
* name, or no client proxy of the given type in the group
* @param <P> the type of HTTP Interface client proxy
* @param httpServiceType the type of client
* @param <P> the type of HTTP interface client
* @return the matched client
* @throws IllegalArgumentException if there is no matching client.
*/
<P> P getClient(String groupName, Class<P> httpServiceType);
@ -57,10 +56,10 @@ public interface HttpServiceProxyRegistry {
Set<String> getGroupNames();
/**
* Return the HTTP service types for all client proxies in the given group.
* Return all HTTP service client types in the named group.
* @param groupName the name of the group
* @return the HTTP service types
* @throws IllegalArgumentException if there is no group with the given name
* @throws IllegalArgumentException if there is no matching group.
*/
Set<Class<?>> getClientTypesInGroup(String groupName);