SONAR-8716 Deprecate UserSession#checkPermission(String)

diff --git a/server/sonar-server/src/main/java/org/sonar/server/user/UserSession.java b/server/sonar-server/src/main/java/org/sonar/server/user/UserSession.java
index 3e456ca739324430d08d27a4d2587adbdf20eb1e..b2419e2294c20ff1f3ca35eb89f2d96a3604c815 100644 (file)
--- a/server/sonar-server/src/main/java/org/sonar/server/user/UserSession.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/user/UserSession.java
@@ -72,7 +72,12 @@ public interface UserSession {
 
   /**
    * Ensures that permission is granted to user, otherwise throws a {@link org.sonar.server.exceptions.ForbiddenException}.
+   * @deprecated in 6.3 because it doesn't support organizations
+   *
+   * @see #checkIsRoot() for system administrators
+   * @see #checkOrganizationPermission(String, String) for organization members
    */
+  @Deprecated
   UserSession checkPermission(String globalPermission);
 
   /**
@@ -89,6 +94,8 @@ public interface UserSession {
   /**
    * Returns {@code true} if the permission is granted on the organization, else {@code false}.
    * Root status is not verified, so the method may return {@code false} even for root users.
+   *
+   * @see org.sonar.core.permission.GlobalPermissions
    */
   boolean hasOrganizationPermission(String organizationUuid, String permission);