com.adobe.idp.um.api.infomodel
Interface PrincipalReference


public interface PrincipalReference

This class contains reference information for a Principal. A principal contains a union of information found in a User and a Group.


Field Summary
static java.lang.String PRINCIPALTYPE_GROUP
          Group principal type.
static java.lang.String PRINCIPALTYPE_SERVICE
          Service principal type.
static java.lang.String PRINCIPALTYPE_SPECIAL
          Deprecated. Use PrincipalReference.PRINCIPALTYPE_SYSTEM or PrincipalReference.PRINCIPALTYPE_SERVICE instead.
static java.lang.String PRINCIPALTYPE_SYSTEM
          System principal type.
static java.lang.String PRINCIPALTYPE_USER
          User principal type.
static java.lang.String STATUS_CURRENT
          The principal is current (active in the system).
static java.lang.String STATUS_OBSOLETE
          The principal is obsolete (deleted from the system).
 
Method Summary
 java.lang.String getCanonicalName()
          Retrieves the canonical name of this principal.
 java.lang.String getCommonName()
          Retrieves the common (display) name of this principal.
 java.lang.String getDomainCommonName()
          Retrieves the common (display) name of the domain associated with this principal.
 java.lang.String getDomainName()
          Retrieves the canonical name of the domain associated with this principal.
 java.lang.String getEmail()
          Retrieves the primary email identifier associated with this principal.
 java.lang.String getOid()
          Retrieves the principal identifier.
 java.lang.String getOrg()
          Retrieves the organization to which the principal belongs.
 java.lang.String getPrincipalType()
          Retrieves the principal type.
 java.lang.String getStatus()
          Retrieves the principal's status.
 int getVisibility()
          Retrieves the visibility level of the Principal.
 boolean isSystem()
          Determines whether this is a system principal.
 void setCanonicalName(java.lang.String canonicalName)
          Sets the principal's canonical name.
 void setCommonName(java.lang.String commonName)
          Sets the principal's common name.
 void setDomainName(java.lang.String domainName)
          Sets the principal's domain name.
 void setEmail(java.lang.String email)
          Sets the principal's email identifier.
 void setOid(java.lang.String oid)
          Sets the principal's identifier.
 void setOrg(java.lang.String org)
          Sets the principal's organization.
 void setPrincipalType(java.lang.String principalType)
          Sets the principal's type.
 void setStatus(java.lang.String status)
          Sets the principal's status.
 

Field Detail

STATUS_CURRENT

static final java.lang.String STATUS_CURRENT
The principal is current (active in the system).


STATUS_OBSOLETE

static final java.lang.String STATUS_OBSOLETE
The principal is obsolete (deleted from the system).


PRINCIPALTYPE_GROUP

static final java.lang.String PRINCIPALTYPE_GROUP
Group principal type.


PRINCIPALTYPE_SERVICE

static final java.lang.String PRINCIPALTYPE_SERVICE
Service principal type. Service accounts are for services that are expected to run continually.


PRINCIPALTYPE_SPECIAL

static final java.lang.String PRINCIPALTYPE_SPECIAL
Deprecated. Use PrincipalReference.PRINCIPALTYPE_SYSTEM or PrincipalReference.PRINCIPALTYPE_SERVICE instead.
Do not use.


PRINCIPALTYPE_SYSTEM

static final java.lang.String PRINCIPALTYPE_SYSTEM
System principal type. The system type can be used for hidden accounts that will not run as a service.


PRINCIPALTYPE_USER

static final java.lang.String PRINCIPALTYPE_USER
User principal type.

Method Detail

getCanonicalName

java.lang.String getCanonicalName()
Retrieves the canonical name of this principal. This string is unique within the scope of the domain. Thus the pair {getCanonicalName(), getDomainName()} uniquely identifies the principal.

Returns:
The canonical name of this principal.

getCommonName

java.lang.String getCommonName()
Retrieves the common (display) name of this principal.

Returns:
The common (display) name of this principal.

getDomainName

java.lang.String getDomainName()
Retrieves the canonical name of the domain associated with this principal.

Returns:
The canonical name of the domain associated with this principal.

getDomainCommonName

java.lang.String getDomainCommonName()
Retrieves the common (display) name of the domain associated with this principal.

Returns:
The common (display) name of the domain associated with this principal.

getOid

java.lang.String getOid()
Retrieves the principal identifier.

Returns:
The principal identifier.

getPrincipalType

java.lang.String getPrincipalType()
Retrieves the principal type.

Returns:
The principal type.

getStatus

java.lang.String getStatus()
Retrieves the principal's status.

Returns:
The principal's status.

getEmail

java.lang.String getEmail()
Retrieves the primary email identifier associated with this principal.

Returns:
The primary email identifier associated with this principal.

getOrg

java.lang.String getOrg()
Retrieves the organization to which the principal belongs.

Returns:
The organization to which the principal belongs.

getVisibility

int getVisibility()
Retrieves the visibility level of the Principal. INVISIBLE : The principal is invisible. value: 0 SEARCHES : The principal can be found with searches. value:1 GUI : The principal can appear in the user interface. value: 2

Returns:
The visibility level of the Principal.

setCommonName

void setCommonName(java.lang.String commonName)
Sets the principal's common name.

Parameters:
commonName - The principal's common name.

setStatus

void setStatus(java.lang.String status)
Sets the principal's status.

Parameters:
status - The principal's status.

setDomainName

void setDomainName(java.lang.String domainName)
Sets the principal's domain name.

Parameters:
domainName - The principal's domain name.

setCanonicalName

void setCanonicalName(java.lang.String canonicalName)
Sets the principal's canonical name.

Parameters:
canonicalName - The principal's canonical name.

setOid

void setOid(java.lang.String oid)
Sets the principal's identifier.

Parameters:
oid - The principal's identifier.

setPrincipalType

void setPrincipalType(java.lang.String principalType)
Sets the principal's type.

Parameters:
principalType - The principal's type.

setEmail

void setEmail(java.lang.String email)
Sets the principal's email identifier.

Parameters:
email - The principal's email identifier.

setOrg

void setOrg(java.lang.String org)
Sets the principal's organization.

Parameters:
org - The principal's organization.

isSystem

boolean isSystem()
Determines whether this is a system principal.

Returns:
true if this is a system principal, false otherwise.