org.opencms.security
Class CmsPrincipal

java.lang.Object
  org.opencms.security.CmsPrincipal

All Implemented Interfaces:

Principal, I_CmsPrincipal

Direct Known Subclasses:

CmsGroup, CmsUser

public abstract class CmsPrincipal
extends Object
implements I_CmsPrincipal

Common methods shared among user and group principals, also contains several utility functions to deal with principal instances.

Since:

6.2.0

Version:

$Revision: 1.2 $

Author:

Alexander Kandzior

Field Summary

protected String	m_description The description of this principal.
protected int	m_flags The flags of this principal.
protected CmsUUID	m_id The unique id of this principal.
protected String	m_name The name of this principal.

Fields inherited from interface org.opencms.security.I_CmsPrincipal

FLAG_CORE_LIMIT, FLAG_DISABLED, FLAG_ENABLED, FLAG_GROUP_PROJECT_MANAGER, FLAG_GROUP_PROJECT_USER, FLAG_GROUP_WORKFLOW_ROLE, PRINCIPAL_GROUP, PRINCIPAL_USER

Constructor Summary

protected

CmsPrincipal() Empty constructor for subclassing.

Method Summary

boolean	equals(Object obj) Compares the given object with this principal.
static List	filterCore(List principals) Filters out all principals with flags greater than I_CmsPrincipal.FLAG_CORE_LIMIT.
static List	filterCoreFlag(List principals, int flag) Filters out all principals that do not have the given flag set, but leaving principals with flags less than I_CmsPrincipal.FLAG_CORE_LIMIT untouched.
static List	filterFlag(List principals, int flag) Filters out all principals that do not have the given flag set.
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.
String	getName() Returns the unique name of this principal.
static String	getPrefixedGroup(String name) Returns the provided group name prefixed with I_CmsPrincipal.PRINCIPAL_GROUP..
String	getPrefixedName() Returns this principals unique name prefixed with it's type.
static String	getPrefixedUser(String name) Returns the provided user name prefixed with I_CmsPrincipal.PRINCIPAL_USER..
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.
static I_CmsPrincipal	readPrefixedPrincipal(CmsObject cms, String name) Utility function to read a prefixed principal from the OpenCms database using the provided OpenCms user context.
static I_CmsPrincipal	readPrincipal(CmsObject cms, String type, String name) Utility function to read a principal of the given type from the OpenCms database using the provided OpenCms user context.
void	setDescription(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(String name) Sets the unique name of this principal.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.opencms.security.I_CmsPrincipal

checkName

Methods inherited from interface java.security.Principal

toString

Field Detail

m_description

protected String m_description

The description of this principal.

m_flags

protected int m_flags

The flags of this principal.

m_id

protected CmsUUID m_id

The unique id of this principal.

m_name

protected String m_name

The name of this principal.

Constructor Detail

CmsPrincipal

protected CmsPrincipal()

Empty constructor for subclassing.

Method Detail

filterCore

public static List filterCore(List principals)

Filters out all principals with flags greater than I_CmsPrincipal.FLAG_CORE_LIMIT.

The given parameter list is directly modified, so the returned list is the same object as the input list.

Parameters:

principals - a list of CmsPrincipal objects

Returns:

the filtered principal list

filterCoreFlag

public static List filterCoreFlag(List principals,
                                  int flag)

Filters out all principals that do not have the given flag set, but leaving principals with flags less than I_CmsPrincipal.FLAG_CORE_LIMIT untouched.

The given parameter list is directly modified, so the returned list is the same object as the input list.

Parameters:

principals - a list of CmsPrincipal objects

flag - the flag for filtering

Returns:

the filtered principal list

filterFlag

public static List filterFlag(List principals,
                              int flag)

Filters out all principals that do not have the given flag set.

The given parameter list is directly modified, so the returned list is the same object as the input list.

Parameters:

principals - the list of CmsPrincipal objects

flag - the flag for filtering

Returns:

the filtered principal list

getPrefixedGroup

public static String getPrefixedGroup(String name)

Returns the provided group name prefixed with I_CmsPrincipal.PRINCIPAL_GROUP..

Parameters:

name - the name to add the prefix to

Returns:

the provided group name prefixed with I_CmsPrincipal.PRINCIPAL_GROUP.

getPrefixedUser

public static String getPrefixedUser(String name)

Returns the provided user name prefixed with I_CmsPrincipal.PRINCIPAL_USER..

Parameters:

name - the name to add the prefix to

Returns:

the provided user name prefixed with I_CmsPrincipal.PRINCIPAL_USER.

readPrefixedPrincipal

public static I_CmsPrincipal readPrefixedPrincipal(CmsObject cms,
                                                   String name)
                                            throws CmsException

Utility function to read a prefixed principal from the OpenCms database using the provided OpenCms user context.

The principal must be either prefixed with I_CmsPrincipal.PRINCIPAL_GROUP. or I_CmsPrincipal.PRINCIPAL_USER..

Parameters:

cms - the OpenCms user context to use when reading the principal

name - the prefixed principal name

Returns:

the principal read from the OpenCms database

Throws:

CmsException - in case the principal could not be read

readPrincipal

public static I_CmsPrincipal readPrincipal(CmsObject cms,
                                           String type,
                                           String name)
                                    throws CmsException

Utility function to read a principal of the given type from the OpenCms database using the provided OpenCms user context.

The type must either be I_CmsPrincipal.PRINCIPAL_GROUP or I_CmsPrincipal.PRINCIPAL_USER.

Parameters:

cms - the OpenCms user context to use when reading the principal

type - the principal type

name - the principal name

Returns:

the principal read from the OpenCms database

Throws:

CmsException - in case the principal could not be read

equals

public boolean equals(Object obj)

Description copied from interface: I_CmsPrincipal

Compares the given object with this principal.

Specified by:

equals in interface Principal

Specified by:

equals in interface I_CmsPrincipal

Overrides:

equals in class Object

Parameters:

obj - object to comapre

Returns:

true if the object is equal

See Also:

Object.equals(java.lang.Object)

getDescription

public String getDescription()

Description copied from interface: I_CmsPrincipal

Returns the description of this principal.

Specified by:

getDescription in interface I_CmsPrincipal

Returns:

the description of this principal

See Also:

I_CmsPrincipal.getDescription()

getFlags

public int getFlags()

Description copied from interface: I_CmsPrincipal

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 I_CmsPrincipal.isEnabled() provide a much easier way to access the information contained in the flags.

Specified by:

getFlags in interface I_CmsPrincipal

Returns:

the flags of this principal

See Also:

I_CmsPrincipal.getFlags()

getId

public CmsUUID getId()

Description copied from interface: I_CmsPrincipal

Returns the unique id of this principal.

Specified by:

getId in interface I_CmsPrincipal

Returns:

the unique id of this principal

See Also:

I_CmsPrincipal.getId()

getName

public String getName()

Description copied from interface: I_CmsPrincipal

Returns the unique name of this principal.

Specified by:

getName in interface Principal

Specified by:

getName in interface I_CmsPrincipal

Returns:

the unique name of this principal

See Also:

Principal.getName()

getPrefixedName

public String getPrefixedName()

Description copied from interface: I_CmsPrincipal

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

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

Specified by:

getPrefixedName in interface I_CmsPrincipal

Returns:

this principals unique name prefixed with this principals type

See Also:

I_CmsPrincipal.getPrefixedName()

hashCode

public int hashCode()

Description copied from interface: I_CmsPrincipal

Returns the hash code of this object.

Specified by:

hashCode in interface Principal

Specified by:

hashCode in interface I_CmsPrincipal

Overrides:

hashCode in class Object

Returns:

the hash code

See Also:

Object.hashCode()

isEnabled

public boolean isEnabled()

Description copied from interface: I_CmsPrincipal

Returns true if this principal is enabled.

A principal may be disabled in order to deactivate 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.

Specified by:

isEnabled in interface I_CmsPrincipal

Returns:

true if this principal is enabled

See Also:

I_CmsPrincipal.isEnabled()

isGroup

public boolean isGroup()

Description copied from interface: I_CmsPrincipal

Returns true if this principal is of type CmsGroup.

Specified by:

isGroup in interface I_CmsPrincipal

Returns:

true if this principal is of type CmsGroup

See Also:

I_CmsPrincipal.isGroup()

isUser

public boolean isUser()

Description copied from interface: I_CmsPrincipal

Returns true if this principal is of type CmsUser.

Specified by:

isUser in interface I_CmsPrincipal

Returns:

true if this principal is of type CmsUser

See Also:

I_CmsPrincipal.isUser()

setDescription

public void setDescription(String description)

Description copied from interface: I_CmsPrincipal

Sets the description of this principal.

Specified by:

setDescription in interface I_CmsPrincipal

Parameters:

description - the principal description to set

See Also:

I_CmsPrincipal.setDescription(java.lang.String)

setEnabled

public void setEnabled(boolean enabled)

Description copied from interface: I_CmsPrincipal

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

Specified by:

setEnabled in interface I_CmsPrincipal

Parameters:

enabled - the principal status to set

See Also:

I_CmsPrincipal.setEnabled(boolean)

setFlags

public void setFlags(int value)

Description copied from interface: I_CmsPrincipal

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 int value should not be directly accessed. Utility methods like I_CmsPrincipal.setEnabled(boolean) provide a much easier way to manipulate the information contained in the flags.

Specified by:

setFlags in interface I_CmsPrincipal

Parameters:

value - the value to set this principals flags to

See Also:

I_CmsPrincipal.setFlags(int)

setName

public void setName(String name)

Description copied from interface: I_CmsPrincipal

Sets the unique name of this principal.

Specified by:

setName in interface I_CmsPrincipal

Parameters:

name - the unique name of this principal to set

See Also:

I_CmsPrincipal.setName(java.lang.String)