org.opencms.security

接口 I_CmsPrincipal

所有超级接口:

java.security.Principal

所有已知实现类:

CmsGroup, CmsHistoryPrincipal, CmsPrincipal, CmsUser

public interface I_CmsPrincipal
extends java.security.Principal

Representation of an identity in the cms (currently user or group), used to define permissions on a resource.

从以下版本开始:

6.0.0

字段概要

字段

限定符和类型	字段和说明
static int	FLAG_CORE_LIMIT Upper limit for core flags, any principal object with flags greater than this value will be filtered out.
static int	FLAG_DISABLED This flag is set for disabled principals in the database.
static int	FLAG_ENABLED This flag is set for enabled principals in the database.
static int	FLAG_GROUP_PROJECT_MANAGER Flag to indicate a group is a potential project manager group.
static int	FLAG_GROUP_PROJECT_USER Flag to indicate a group is a potential project user group.
static int	FLAG_GROUP_ROLE Flag to indicate a role group.
static int	FLAG_GROUP_VIRTUAL Flag to indicate a virtual group role, after this bit we need to encode a number between 0 and CmsRole.getSystemRoles().size()-1 so we will need up to 4 more bits.
static int	FLAG_USER_MANAGED Flag to indicate a user is not able to manage himself.
static int	FLAG_USER_WEBUSER Flag to indicate a user is a webuser.
static java.lang.String	PRINCIPAL_GROUP Identifier for group principals.
static java.lang.String	PRINCIPAL_USER Identifier for user principals.

方法概要

方法

限定符和类型	方法和说明
void	checkName(java.lang.String name) Checks if the provided principal name is valid and can be used as an argument value for setName(String).
boolean	equals(java.lang.Object obj) Compares the given object with this principal.
java.lang.String	getDescription() Returns the description of this principal.
int	getFlags() Returns the flags of this principal.
CmsUUID	getId() Returns the unique id of this principal.
java.lang.String	getName() Returns the unique name of this principal.
java.lang.String	getOuFqn() Returns the fully qualified name of the associated organizational unit.
java.lang.String	getPrefixedName() Returns this principals unique name prefixed with it's type.
java.lang.String	getSimpleName() Returns the simple name of this organizational unit.
int	hashCode() Returns the hash code of this object.
boolean	isEnabled() Returns true if this principal is enabled.
boolean	isGroup() Returns true if this principal is of type CmsGroup.
boolean	isUser() Returns true if this principal is of type CmsUser.
void	setDescription(java.lang.String description) Sets the description of this principal.
void	setEnabled(boolean enabled) Enables (or disables) this principal, depending on the given status.
void	setFlags(int value) Sets this principals flags to the specified value.
void	setName(java.lang.String name) Sets the unique name of this principal.

从接口继承的方法 java.security.Principal

toString

字段详细资料

FLAG_CORE_LIMIT

static final int FLAG_CORE_LIMIT

Upper limit for core flags, any principal object with flags greater than this value will be filtered out.

另请参阅:

常量字段值

FLAG_DISABLED

static final int FLAG_DISABLED

This flag is set for disabled principals in the database.

另请参阅:

常量字段值

FLAG_ENABLED

static final int FLAG_ENABLED

This flag is set for enabled principals in the database.

另请参阅:

常量字段值

FLAG_GROUP_PROJECT_MANAGER

static final int FLAG_GROUP_PROJECT_MANAGER

Flag to indicate a group is a potential project manager group.

另请参阅:

常量字段值

FLAG_GROUP_PROJECT_USER

static final int FLAG_GROUP_PROJECT_USER

Flag to indicate a group is a potential project user group.

另请参阅:

常量字段值

FLAG_GROUP_ROLE

static final int FLAG_GROUP_ROLE

Flag to indicate a role group.

另请参阅:

常量字段值

FLAG_GROUP_VIRTUAL

static final int FLAG_GROUP_VIRTUAL

Flag to indicate a virtual group role, after this bit we need to encode a number between 0 and CmsRole.getSystemRoles().size()-1 so we will need up to 4 more bits.

另请参阅:

常量字段值

FLAG_USER_MANAGED

static final int FLAG_USER_MANAGED

Flag to indicate a user is not able to manage himself.

另请参阅:

常量字段值

FLAG_USER_WEBUSER

static final int FLAG_USER_WEBUSER

Flag to indicate a user is a webuser.

另请参阅:

常量字段值

PRINCIPAL_GROUP

static final java.lang.String PRINCIPAL_GROUP

Identifier for group principals.

另请参阅:

常量字段值

PRINCIPAL_USER

static final java.lang.String PRINCIPAL_USER

Identifier for user principals.

另请参阅:

常量字段值

方法详细资料

checkName

void checkName(java.lang.String name)

Checks if the provided principal name is valid and can be used as an argument value for setName(String).

参数:

name - the principal name to check

equals

boolean equals(java.lang.Object obj)

Compares the given object with this principal.

指定者:

equals 在接口中 java.security.Principal

覆盖:

equals 在类中 java.lang.Object

参数:

obj - object to compare

返回:

true if the object is equal

getDescription

java.lang.String getDescription()

Returns the description of this principal.

返回:

the description of this principal

getFlags

int getFlags()

Returns the flags of this principal.

The principal flags are used to store special information about the principals state encoded bitwise. Usually the flags int value should not be directly accessed. Utility methods like isEnabled() provide a much easier way to access the information contained in the flags.

返回:

the flags of this principal

getId

CmsUUID getId()

Returns the unique id of this principal.

返回:

the unique id of this principal

getName

java.lang.String getName()

Returns the unique name of this principal.

指定者:

getName 在接口中 java.security.Principal

返回:

the unique name of this principal

getOuFqn

java.lang.String getOuFqn()

Returns the fully qualified name of the associated organizational unit.

返回:

the fully qualified name of the associated organizational unit

getPrefixedName

java.lang.String getPrefixedName()

Returns this principals unique name prefixed with it's type.

The type prefix can either be PRINCIPAL_GROUP. (for groups) or PRINCIPAL_USER. (for users).

返回:

this principals unique name prefixed with this principals type

getSimpleName

java.lang.String getSimpleName()

Returns the simple name of this organizational unit.

返回:

the simple name of this organizational unit.

hashCode

int hashCode()

Returns the hash code of this object.

指定者:

hashCode 在接口中 java.security.Principal

覆盖:

hashCode 在类中 java.lang.Object

返回:

the hash code

isEnabled

boolean isEnabled()

Returns true if this principal is enabled.

A principal may be disabled in order to disable it, for example to prevent logins of a user. If a principal is just disabled but not deleted, the credentials of the principal in the VFS are still valid.

返回:

true if this principal is enabled

isGroup

boolean isGroup()

Returns true if this principal is of type CmsGroup.

返回:

true if this principal is of type CmsGroup

isUser

boolean isUser()

Returns true if this principal is of type CmsUser.

返回:

true if this principal is of type CmsUser

setDescription

void setDescription(java.lang.String description)

Sets the description of this principal.

参数:

description - the principal description to set

setEnabled

void setEnabled(boolean enabled)

Enables (or disables) this principal, depending on the given status.

参数:

enabled - the principal status to set

setFlags

void setFlags(int value)

Sets this principals flags to the specified value.

The principal flags are used to store special information about the principals state encoded bitwise. Usually the flags integer value should not be directly accessed. Utility methods like setEnabled(boolean) provide a much easier way to manipulate the information contained in the flags.

参数:

value - the value to set this principals flags to

setName

void setName(java.lang.String name)

Sets the unique name of this principal.

参数:

name - the unique name of this principal to set