com.ibm.itim.dataservices.model.domain
Class AccountEntity

java.lang.Object
  |
  +--com.ibm.itim.dataservices.model.DirectoryObjectEntity
        |
        +--com.ibm.itim.dataservices.model.domain.AccountEntity
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
SystemUserEntity

public class AccountEntity
extends DirectoryObjectEntity

Class that represents an account in the data model.

See Also:
Serialized Form

Field Summary
static java.lang.String OWNER
          Relationship name for an account's owner.
 
Fields inherited from class com.ibm.itim.dataservices.model.DirectoryObjectEntity
ORGANIZATION, PARENT
 
Constructor Summary
AccountEntity(Account account)
          Constructs an AccountEntity with a value object.
AccountEntity(ObjectProfile profile, Account account)
          Constructs an AccountEntity with a profile and value object.
 
Method Summary
 DirectoryObjectEntity addComplianceIssue(ComplianceIssue issue)
          Changes the current compliance issues logged against the account.
 void adopt(PersonEntity person)
          Adopt an orphan account by assigning an owner for the account.
 java.util.Collection getComplianceIssues()
          Returns the current compliance issues logged against the account (if any).
 PersonEntity getOwner()
          Returns the owner of an account.
 ServiceEntity getService()
          Returns a service that hosts the account.
 boolean isOrphan()
          Determines whether the account is an orphan.
 AccountEntity orphan()
          Orphan an account by removing the owner from the account.
 void remove()
          Removes the account from the data store.
 void removeAllIssues()
          Removes all the compliance issues associated with the account.
 void removeComplianceIssue(DistinguishedName dn)
          Remove compliance issue entry by its Distinguished Name.
 void update()
          Updates the attributes of the entity in the data store.
 void update(Account account)
          Deprecated. use update().
 
Methods inherited from class com.ibm.itim.dataservices.model.DirectoryObjectEntity
equals, getDirectoryObject, getDistinguishedName, getEntity, getLifecycle, getParent, getParentDN, getProfile, getRelationship, getSupportedRelationships, hashCode, isSupportedRelationship, remove, setLifecycle, toString, update
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

OWNER

public static final java.lang.String OWNER
Relationship name for an account's owner.

See Also:
Constant Field Values
Constructor Detail

AccountEntity

public AccountEntity(ObjectProfile profile,
                     Account account)
Constructs an AccountEntity with a profile and value object.

Parameters:
profile - Profile identifying the type of this account.
account - Account object holding the attributes of the account.

AccountEntity

public AccountEntity(Account account)
Constructs an AccountEntity with a value object.

Parameters:
account - Account object holding the attributes of the account. Note: the object must have the name of the profile identifying the type of this account (i.e., NTAccount, ExchangeAccount, etc.)
Method Detail

adopt

public void adopt(PersonEntity person)
           throws ModelCommunicationException,
                  ModelIntegrityException
Adopt an orphan account by assigning an owner for the account.

Parameters:
person - PersonEntity object representing a person.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ModelIntegrityException - Thrown if a problem exists with the consistency of the data model preventing the adoption of the account.

getOwner

public PersonEntity getOwner()
                      throws ModelCommunicationException,
                             ModelIntegrityException
Returns the owner of an account.

Returns:
PersonEntity representing the owner, null when there is no owner.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ModelIntegrityException - Thrown if a problem exists with the consistency of the data model preventing the evaluation of the relationship.

getService

public ServiceEntity getService()
                         throws ModelCommunicationException,
                                ObjectNotFoundException
Returns a service that hosts the account.

Returns:
ServiceEntity that hosts the account.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the related service. This may be due to a data integrity problem.

orphan

public AccountEntity orphan()
                     throws ModelCommunicationException,
                            ModelIntegrityException
Orphan an account by removing the owner from the account.

Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ModelIntegrityException - Thrown if a problem exists with the consistency of the data model preventing the adoption of the account.

isOrphan

public boolean isOrphan()
Determines whether the account is an orphan.

Returns:
true if the account is an orphan; else false.

remove

public void remove()
            throws ModelCommunicationException,
                   ObjectNotFoundException,
                   ModelRemoveException
Removes the account from the data store. The object is copied to the recycle bin before being deleted if it's an owned account.

Overrides:
remove in class DirectoryObjectEntity
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the entity in the data store. This may be due to a data integrity problem, or the entity may have already been removed by another client.
ModelRemoveException - Thrown if unable to remove an object of the data store.

update

public void update()
            throws ModelCommunicationException,
                   ObjectNotFoundException
Updates the attributes of the entity in the data store. An DirectoryObject value object is used to obtain the changes that need to be made.

Overrides:
update in class DirectoryObjectEntity
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the entity in the data store. This may be due to a data integrity problem, or the entity may have been removed by another client. Over update() of DirectoryObjectEntity because rename the object if eruid is changed for TIM account.

update

public void update(Account account)
            throws ModelCommunicationException,
                   ObjectNotFoundException
Deprecated. use update().

Updates the attributes of the entity in the data store. An DirectoryObject value object is used to obtain the changes that need to be made.

Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the entity in the data store. This may be due to a data integrity problem, or the entity may have been removed by another client. Over update(DirectoryObject) of DirectoryObjectEntity because rename the object if eruid is changed for TIM account.

getComplianceIssues

public java.util.Collection getComplianceIssues()
                                         throws ModelCommunicationException,
                                                ObjectNotFoundException
Returns the current compliance issues logged against the account (if any).

Returns:
Collection of DirectoryObjectEntity that contains ComplianceIssue object.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the entity in the data store. This may be due to a data integrity problem, or the entity may have already been removed by another client.

addComplianceIssue

public DirectoryObjectEntity addComplianceIssue(ComplianceIssue issue)
                                         throws ModelCommunicationException,
                                                ModelCreationException
Changes the current compliance issues logged against the account. This method replaces the current logged issues so passing an empty collection removes all issues.

Parameters:
issue - Collection of ComplianceIssue objects representing the complete set of issues.
Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store.
ObjectNotFoundException - Thrown if unable to locate the entity in the data store. This may be due to a data integrity problem, or the entity may have already been removed by another client.
ModelCreationException

removeComplianceIssue

public void removeComplianceIssue(DistinguishedName dn)
                           throws ModelCommunicationException,
                                  ModelRemoveException
Remove compliance issue entry by its Distinguished Name.

ModelCommunicationException
ModelRemoveException

removeAllIssues

public void removeAllIssues()
                     throws ModelCommunicationException,
                            ModelRemoveException
Removes all the compliance issues associated with the account.

Throws:
ModelCommunicationException - Thrown if unable to communicate with the data store
ModelRemoveException - Thrown if unable to remove the compliance issues from the data store


IBM Tivoli Identity Manager 4.6
© Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.