Core: Fix Javadoc invalid references and improve clarity

- Update package-info to reference AuthorizationManager instead of AccessDecisionManager
- Improve RoleHierarchyUtils documentation with fromHierarchy() and builder-based alternatives
- Refine AuthenticationTrustResolver return description by removing redundant comma and symbol

Signed-off-by: chanjin-lee <chanjin23@naver.com>
This commit is contained in:
chanjin-lee 2026-01-18 15:46:07 +09:00 committed by Rob Winch
parent e5b934d1a5
commit 021f84b2df
3 changed files with 10 additions and 11 deletions

View File

@ -36,14 +36,14 @@ public final class RoleHierarchyUtils {
/**
* Converts the supplied {@link Map} of role name to implied role name(s) to a string
* representation understood by {@code RoleHierarchyImpl#setHierarchy(String)}. The
* map key is the role name and the map value is a {@link List} of implied role
* name(s).
* @param roleHierarchyMap the mapping(s) of role name to implied role name(s)
* representation understood by the role hierarchy parser.
* The map key is the role name and the map value is a {@link List} of implied role name(s).
* * @param roleHierarchyMap the mapping(s) of role name to implied role name(s)
* @return a string representation of a role hierarchy
* @throws IllegalArgumentException if roleHierarchyMap is null or empty or if a role
* name is null or empty or if an implied role name(s) is null or empty
* @deprecated please see {@code RoleHierarchyImpl#setHierarchy} deprecation notice
* @throws IllegalArgumentException if roleHierarchyMap is null or empty, or if a role
* name/implied role name is null or empty
* @deprecated Use {@link RoleHierarchyImpl#fromHierarchy(String)} or the builder-based
* approach instead of this manual conversion.
*/
@Deprecated
public static String roleHierarchyFromMap(Map<String, List<String>> roleHierarchyMap) {

View File

@ -16,9 +16,8 @@
/**
* Core access-control related code, including security metadata related classes,
* interception code, access control annotations, EL support and voter-based
* implementations of the central
* {@code AccessDecisionManager}
* interception code, access control annotations, EL support, and implementations
* of the central {@link org.springframework.security.authorization.AuthorizationManager AuthorizationManager}
* interface.
*/
@NullMarked

View File

@ -77,7 +77,7 @@ public interface AuthenticationTrustResolver {
* Checks if the {@link Authentication} is not null, authenticated, and not anonymous.
* @param authentication the {@link Authentication} to check.
* @return true if the {@link Authentication} is not null,
* {@link #isAnonymous(Authentication)} returns false, and
* {@link #isAnonymous(Authentication)} returns false and
* {@link Authentication#isAuthenticated()} is true.
* @since 6.1.7
*/