Refine SimpleGrantedAuthority

1. Rename field `role` to `authority` since role is specific authority, this change breaks JDK deserialization, it should be merged into major release.
2. Add Javadoc to state that role should be prefixed.

Signed-off-by: Yanming Zhou <[email protected]>

Author: quaff

core/src/main/java/org/springframework/security/core/authority/SimpleGrantedAuthority.java

@@ -27,21 +27,26 @@
  * {@link org.springframework.security.core.Authentication Authentication} object.
  *
  * @author Luke Taylor
+ * @author Yanming Zhou
  */
 public final class SimpleGrantedAuthority implements GrantedAuthority {
 
 	private static final long serialVersionUID = 620L;
 
-	private final String role;
+	private final String authority;
 
-	public SimpleGrantedAuthority(String role) {
-		Assert.hasText(role, "A granted authority textual representation is required");
-		this.role = role;
+	/**
+	 * Constructs a {@code SimpleGrantedAuthority} using the provided authority.
+	 * @param authority The provided authority such as prefixed role
+	 */
+	public SimpleGrantedAuthority(String authority) {
+		Assert.hasText(authority, "A granted authority textual representation is required");
+		this.authority = authority;
 	}
 
 	@Override
 	public String getAuthority() {
-		return this.role;
+		return this.authority;
 	}
 
 	@Override
@@ -50,19 +55,19 @@ public boolean equals(Object obj) {
 			return true;
 		}
 		if (obj instanceof SimpleGrantedAuthority sga) {
-			return this.role.equals(sga.getAuthority());
+			return this.authority.equals(sga.getAuthority());
 		}
 		return false;
 	}
 
 	@Override
 	public int hashCode() {
-		return this.role.hashCode();
+		return this.authority.hashCode();
 	}
 
 	@Override
 	public String toString() {
-		return this.role;
+		return this.authority;
 	}
 
 }