com.iplanet.am.sdk
インタフェース AMObject

すべてのスーパーインタフェース:

AMConstants

既知のサブインタフェースの一覧:

AMAssignableDynamicGroup, AMDynamicGroup, AMFilteredRole, AMGroup, AMGroupContainer, AMOrganization, AMOrganizationalUnit, AMPeopleContainer, AMResource, AMRole, AMStaticGroup, AMTemplate, AMUser

推奨されていません。 As of Sun Java System Access Manager 7.1.

public interface AMObject
extends AMConstants

The AMObject interface provides methods to manage various Sun Java System Access Manager objects and their attributes.

フィールドの概要

static int	ACTIVE 推奨されていません。 Represents the status of an object as active
static String	ACTIVE_VALUE 推奨されていません。 String representation of the "active" state
static int	ASSIGNABLE_DYNAMIC_GROUP 推奨されていません。 Represents a Dynamic Group object type
static int	DELETED 推奨されていません。 Represents the status of an object as "deleted"
static String	DELETED_VALUE 推奨されていません。 String representation of the "deleted" state
static int	DYNAMIC_GROUP 推奨されていません。 Represents a Dynamic Group object type
static int	FILTERED_ROLE 推奨されていません。 Represents a Filtered Role object type
static int	GROUP 推奨されていません。 Represents a Group object type
static int	GROUP_CONTAINER 推奨されていません。 Represents a group container object type
static int	GROUP_PROFILE 推奨されていません。 Represents group profile Information
static int	INACTIVE 推奨されていません。 Represents the status of an object as inactive
static String	INACTIVE_VALUE 推奨されていません。 String representation of the "inactive" state
static int	MANAGED_ROLE 推奨されていません。 Represents a Managed Role object type
static int	ORGANIZATION 推奨されていません。 Represents an Organization object type
static int	ORGANIZATIONAL_UNIT 推奨されていません。 Represents a Organizational Unit object type
static int	PEOPLE_CONTAINER 推奨されていません。 Represents a People Container object type
static int	POLICY 推奨されていません。 Represents Policy Information
static int	RESOURCE 推奨されていません。 Represents resource object type
static int	ROLE 推奨されていません。 Represents a Role object type
static int	ROLE_PROFILE 推奨されていません。 Represents role profile Information
static int	SERVICE 推奨されていません。 Represents Service Information
static int	STATIC_GROUP 推奨されていません。 Represents a Static Group object type
static int	TEMPLATE 推奨されていません。 Represents a Template object type
static int	UNDETERMINED_OBJECT_TYPE 推奨されていません。 Used to indicate the object type has not yet determined.
static int	UNKNOWN_OBJECT_TYPE 推奨されていません。 Represents an object type that cannot be identified
static int	USER 推奨されていません。 Represents a User object type

インタフェース com.iplanet.am.sdk.AMConstants から継承されたフィールド

ADD_MEMBER, ADMIN_GROUPS_ENABLED_ATTR, ADMIN_ROLE_ATTR, ADMINISTRATION_SERVICE, CACHE_ENABLED_DISABLED_KEY, CACHE_MAX_SIZE_KEY, COMPLIANCE_SPECIAL_FILTER_ATTR, COMPLIANCE_USER_DELETION_ATTR, CONTAINER_DEFAULT_TEMPLATE_ROLE, CONTAINER_SUPPORTED_TYPES_ATTRIBUTE, DCT_ATTRIBUTE_LIST_ATTR, DCT_ENABLED_ATTR, DOMAIN_ADMINISTRATORS, DOMAIN_HELP_DESK_ADMINISTRATORS, EMAIL_ATTRIBUTE, FILTER_ATTR_NAME, INET_ADMIN_OBJECT_CLASS, INET_DOMAIN_STATUS_ATTR, INET_DOMAIN_STATUS_ATTRIBUTE, INVALID_USERID_CHARACTERS, OTHER_COSATTR_TYPE, POLICY_COSATTR_TYPE, POLICY_SUFFIX, PRE_POST_PROCESSING_MODULES_ATTR, REMOVE_ATTRIBUTE, REMOVE_MEMBER, REQUIRED_SERVICES_ATTR, ROLE_MANAGED_CONTAINER_DN_ATTRIBUTE, SCOPE_BASE, SCOPE_ONE, SCOPE_SUB, SERVICE_STATUS_ATTRIBUTE, STATIC_GROUP_DN_ATTRIBUTE, SUBSCRIBABLE_ATTRIBUTE, UNIQUE_ATTRIBUTE_LIST_ATTRIBUTE, UNIQUE_MEMBER_ATTRIBUTE, USER_CREATE_NOTIFICATION_LIST, USER_DELETE_NOTIFICATION_LIST, USER_ENCRYPTED_PASSWORD_ATTRIBUTE, USER_ENTRY_PROCESSING_IMPL, USER_MODIFY_NOTIFICATION_LIST, USER_PASSWORD_ATTRIBUTE, USER_SEARCH_RETURN_ATTR, USERID_PASSWORD_VALIDATION_CLASS

メソッドの概要

void	addEventListener(AMEventListener listener) 推奨されていません。 Registers a event listener that needs to be invoked when a relevant event occurs.
void	assignPolicies(String serviceName, Set policyDNs) 推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.
void	assignServices(Map serviceNameAndAttrs) 推奨されていません。 Assign services to the entity (user/group/organization/organization unit).
AMTemplate	createPolicyTemplate(String serviceName, Map attributes) 推奨されていません。 use com.sun.identity.policy package for creating and managing policies.
AMTemplate	createPolicyTemplate(String serviceName, Map attributes, int priority) 推奨されていません。 use com.sun.identity.policy package for creating and managing policies.
AMTemplate	createTemplate(int templateType, String serviceName, Map attributes) 推奨されていません。 Creates a Template with no priority for the given service associated with this AMObject.
AMTemplate	createTemplate(int templateType, String serviceName, Map attributes, int priority) 推奨されていません。 Creates a Template with a priority for the given service associated with this AMObject.
void	delete() 推奨されていません。 Deletes the object.
void	delete(boolean recursive) 推奨されていません。 Deletes object(s).
Set	getAssignedServices() 推奨されていません。 Returns all service names that are assigned to the user/group/organization/organizational unit.
Set	getAttribute(String attributeName) 推奨されていません。 Returns attribute value.
byte[][]	getAttributeByteArray(String attributeName) 推奨されていません。 Returns attribute value.
Map	getAttributes() 推奨されていません。 Returns Map of all attributes.
Map	getAttributes(Set attributeNames) 推奨されていません。 Returns Map of specified attributes.
Map	getAttributesByteArray() 推奨されていません。 Returns Map of all attributes.
Map	getAttributesByteArray(Set attributeNames) 推奨されていません。 Returns Map of specified attributes.
Map	getAttributesFromDataStore() 推奨されていません。 Returns Map of all attributes directly from data store.
Map	getAttributesFromDataStore(Set attributeNames) 推奨されていません。 Returns Map of specified attributes directly from data store.
String	getDN() 推奨されていません。 Returns the DN of the entry.
String	getOrganizationDN() 推奨されていません。 Returns the object's organization.
String	getParentDN() 推奨されていません。 Returns the parent DN of the entry.
Map	getPolicy(String serviceName) 推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.
AMTemplate	getPolicyTemplate(String serviceName) 推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.
Map	getServiceAttributes(String serviceName) 推奨されていません。 This method has been deprecated. Please use service template objects to obtain service attributes.
String	getServiceStatus(String serviceName) 推奨されていません。 Get the status of the service for this entity (user/group/organization/ organizational unit).
String	getStringAttribute(String attributeName) 推奨されていません。 Returns string type attribute value.
AMTemplate	getTemplate(String serviceName, int templateType) 推奨されていません。 Returns the Template for the given service associated with this AMObject.
boolean	isExists() 推奨されていません。 Checks if the entry exists in the directory or not.
void	modifyService(String serviceName, Map attrMap) 推奨されていません。 Modify the service attributes of a service assigned to a entity (user/group/organization/organizational unit).
void	purge(boolean recursive, int graceperiod) 推奨されていません。 This method will physically delete the entry from the data store.
void	removeAttributes(Set attributes) 推奨されていません。 Removes attributes in this AMObject.
void	removeEventListener(AMEventListener listener) 推奨されていません。 Unregisters a previously registered event listener.
Set	search(int level, String filter) 推奨されていません。 Search objects based on specified level and filter.
void	setAttributeByteArray(String attrName, byte[][] byteValues) 推奨されていません。 Sets byte attribute values in this AMObject.
void	setAttributes(Map attributes) 推奨されていません。 Sets attribute values in this AMObject.
void	setAttributesByteArray(Map attributes) 推奨されていません。 Sets byte attribute values in this AMObject.
void	setServiceStatus(String serviceName, String status) 推奨されていません。 Set the status of the service for this entity (User/Organization /Group/Organizational Unit).
void	setStringAttribute(String attributeName, String value) 推奨されていません。 Sets string type attribute value.
void	store() 推奨されていません。 Stores the change to directory server.
void	store(boolean addValues) 推奨されていません。 Stores the change to directory server.
void	unassignPolicies(String serviceName, Set policyDNs) 推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.
void	unassignServices(Set serviceNames) 推奨されていません。 Unassigns services from the user/group/organization/ organizational unit.

フィールドの詳細

USER

static final int USER

推奨されていません。

Represents a User object type

関連項目:

定数フィールド値

ORGANIZATION

static final int ORGANIZATION

推奨されていません。

Represents an Organization object type

関連項目:

定数フィールド値

ORGANIZATIONAL_UNIT

static final int ORGANIZATIONAL_UNIT

推奨されていません。

Represents a Organizational Unit object type

関連項目:

定数フィールド値

GROUP_CONTAINER

static final int GROUP_CONTAINER

推奨されていません。

Represents a group container object type

関連項目:

定数フィールド値

PEOPLE_CONTAINER

static final int PEOPLE_CONTAINER

推奨されていません。

Represents a People Container object type

関連項目:

定数フィールド値

ROLE

static final int ROLE

推奨されていません。

Represents a Role object type

関連項目:

定数フィールド値

MANAGED_ROLE

static final int MANAGED_ROLE

推奨されていません。

Represents a Managed Role object type

関連項目:

定数フィールド値

FILTERED_ROLE

static final int FILTERED_ROLE

推奨されていません。

Represents a Filtered Role object type

関連項目:

定数フィールド値

GROUP

static final int GROUP

推奨されていません。

Represents a Group object type

関連項目:

定数フィールド値

STATIC_GROUP

static final int STATIC_GROUP

推奨されていません。

Represents a Static Group object type

関連項目:

定数フィールド値

DYNAMIC_GROUP

static final int DYNAMIC_GROUP

推奨されていません。

Represents a Dynamic Group object type

関連項目:

定数フィールド値

ASSIGNABLE_DYNAMIC_GROUP

static final int ASSIGNABLE_DYNAMIC_GROUP

推奨されていません。

Represents a Dynamic Group object type

関連項目:

定数フィールド値

TEMPLATE

static final int TEMPLATE

推奨されていません。

Represents a Template object type

関連項目:

定数フィールド値

POLICY

static final int POLICY

推奨されていません。

Represents Policy Information

関連項目:

定数フィールド値

SERVICE

static final int SERVICE

推奨されていません。

Represents Service Information

関連項目:

定数フィールド値

ROLE_PROFILE

static final int ROLE_PROFILE

推奨されていません。

Represents role profile Information

関連項目:

定数フィールド値

GROUP_PROFILE

static final int GROUP_PROFILE

推奨されていません。

Represents group profile Information

関連項目:

定数フィールド値

RESOURCE

static final int RESOURCE

推奨されていません。

Represents resource object type

関連項目:

定数フィールド値

ACTIVE

static final int ACTIVE

推奨されていません。

Represents the status of an object as active

関連項目:

定数フィールド値

ACTIVE_VALUE

static final String ACTIVE_VALUE

推奨されていません。

String representation of the "active" state

関連項目:

定数フィールド値

INACTIVE

static final int INACTIVE

推奨されていません。

Represents the status of an object as inactive

関連項目:

定数フィールド値

INACTIVE_VALUE

static final String INACTIVE_VALUE

推奨されていません。

String representation of the "inactive" state

関連項目:

定数フィールド値

DELETED

static final int DELETED

推奨されていません。

Represents the status of an object as "deleted"

関連項目:

定数フィールド値

DELETED_VALUE

static final String DELETED_VALUE

推奨されていません。

String representation of the "deleted" state

関連項目:

定数フィールド値

UNKNOWN_OBJECT_TYPE

static final int UNKNOWN_OBJECT_TYPE

推奨されていません。

Represents an object type that cannot be identified

関連項目:

定数フィールド値

UNDETERMINED_OBJECT_TYPE

static final int UNDETERMINED_OBJECT_TYPE

推奨されていません。

Used to indicate the object type has not yet determined. Mainly used in caching. Local to this package

関連項目:

定数フィールド値

メソッドの詳細

getDN

String getDN()

推奨されていません。

Returns the DN of the entry.

戻り値:

String DN

getParentDN

String getParentDN()

推奨されていません。

Returns the parent DN of the entry.

戻り値:

String DN

store

void store()
           throws AMException,
                  SSOException

推奨されていません。

Stores the change to directory server. This method should be called after doing setAttributes so that the changes that are made can be permanently committed to the LDAP data store.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

store

void store(boolean addValues)
           throws AMException,
                  SSOException

推奨されていません。

Stores the change to directory server. This method should be called after doing setAttributes or any other set methods provided. so that the changes that are made can be permanently committed to the LDAP data store.

パラメータ:

addValues - If addValues is true, then the attribute values as set in the setAttributes method are added to any existing values for the same attribute in the directory. Otherwise, the attribute values replace existing values in the data store.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

isExists

boolean isExists()
                 throws SSOException

推奨されていません。

Checks if the entry exists in the directory or not. First a syntax check is done on the DN string corresponding to the entry. If the DN syntax is valid, a directory call will be made to check for the existence of the entry.

NOTE: This method internally invokes a call to the directory to verify the existence of the entry. There could be a performance overhead. Hence, please use your discretion while using this method.

戻り値:

false if the entry does not have a valid DN syntax or if the entry does not exists in the Directory. False otherwise.

例外:

SSOException - if the single sign on token is no longer valid.

getAttributes

Map getAttributes()
                  throws AMException,
                         SSOException

推奨されていません。

Returns Map of all attributes. Map key is the attribute name and value is the attribute value.

戻り値:

Map of all attributes.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

getAttributesFromDataStore

Map getAttributesFromDataStore()
                               throws AMException,
                                      SSOException

推奨されていません。

Returns Map of all attributes directly from data store. Map key is the attribute name and value is the attribute value.

戻り値:

Map of all attributes.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getAttributesByteArray

Map getAttributesByteArray()
                           throws AMException,
                                  SSOException

推奨されていません。

Returns Map of all attributes. Map key is the attribute name and value is the attribute value in byte[][] format.

戻り値:

Map of all attributes.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getAttributes

Map getAttributes(Set attributeNames)
                  throws AMException,
                         SSOException

推奨されていません。

Returns Map of specified attributes. Map key is the attribute name and value is the attribute value.

パラメータ:

attributeNames - The Set of attribute names.

戻り値:

Map of specified attributes.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getAttributesFromDataStore

Map getAttributesFromDataStore(Set attributeNames)
                               throws AMException,
                                      SSOException

推奨されていません。

Returns Map of specified attributes directly from data store. Map key is the attribute name and value is the attribute value.

パラメータ:

attributeNames - The Set of attribute names.

戻り値:

Map of specified attributes.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getAttributesByteArray

Map getAttributesByteArray(Set attributeNames)
                           throws AMException,
                                  SSOException

推奨されていません。

Returns Map of specified attributes. Map key is the attribute name and value is the attribute value in byte[][] format.

パラメータ:

attributeNames - The Set of attribute names.

戻り値:

Map of specified attributes. The key of the map is the attribute name and the values in byte[][] format.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getAttribute

Set getAttribute(String attributeName)
                 throws AMException,
                        SSOException

推奨されていません。

Returns attribute value.

パラメータ:

attributeName - Attribute name

戻り値:

Set of attribute values.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getAttributeByteArray

byte[][] getAttributeByteArray(String attributeName)
                               throws AMException,
                                      SSOException

推奨されていません。

Returns attribute value.

パラメータ:

attributeName - Attribute name

戻り値:

attribute values in byte[][] format or null if the attribute does not exist.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getStringAttribute

String getStringAttribute(String attributeName)
                          throws AMException,
                                 SSOException

推奨されていません。

Returns string type attribute value.

パラメータ:

attributeName - Attribute name

戻り値:

String value of attribute

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

getServiceAttributes

Map getServiceAttributes(String serviceName)
                         throws AMException,
                                SSOException

推奨されていません。 This method has been deprecated. Please use service template objects to obtain service attributes.

Returns Map of all attributes of specified service. Map key is the attribute name and value is the attribute value.

パラメータ:

serviceName - Service name

戻り値:

Map of all attributes of specified service, an empty Map will be returned if no service attribute is defined in the specified service.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

関連項目:

AMObject.getTemplate(java.lang.String, int)

createTemplate

AMTemplate createTemplate(int templateType,
                          String serviceName,
                          Map attributes)
                          throws AMException,
                                 SSOException

推奨されていません。

Creates a Template with no priority for the given service associated with this AMObject.

パラメータ:

templateType - the template type. Can be one of the following:

• AMTemplate.DYNAMIC_TEMPLATE
• AMTemplate.ORGANIZATION_TEMPLATE

serviceName - service name

attributes - Map of attributes name-value pairs. if it is null default values will be used.

戻り値:

AMTemplate the service template for this AMObject.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

UnsupportedOperationException - if the class implementing this interface does not support this method.

createTemplate

AMTemplate createTemplate(int templateType,
                          String serviceName,
                          Map attributes,
                          int priority)
                          throws AMException,
                                 SSOException

推奨されていません。

Creates a Template with a priority for the given service associated with this AMObject.

パラメータ:

templateType - the template type. Can be one of the following:

• AMTemplate.DYNAMIC_TEMPLATE
• AMTemplate.ORGANIZATION_TEMPLATE

serviceName - service name.

attributes - Map of attributes name-value pairs

priority - template priority (0 is the highest priority)

戻り値:

AMTemplate the service template for this AMObject.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

UnsupportedOperationException - if the class implementing this interface does not support this method

getTemplate

AMTemplate getTemplate(String serviceName,
                       int templateType)
                       throws AMException,
                              SSOException

推奨されていません。

Returns the Template for the given service associated with this AMObject.

パラメータ:

serviceName - service name.

templateType - the template type. Can be one of the following:

• AMTemplate.DYNAMIC_TEMPLATE
• AMTemplate.ORGANIZATION_TEMPLATE

戻り値:

AMTemplate the service template for this AMObject.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

UnsupportedOperationException - if the class implementing this interface does not support this method

assignPolicies

void assignPolicies(String serviceName,
                    Set policyDNs)
                    throws AMException,
                           SSOException

推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.

Assigns the given policies to this object.

パラメータ:

serviceName - service name.

policyDNs - Set of policy DN string

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

unassignPolicies

void unassignPolicies(String serviceName,
                      Set policyDNs)
                      throws AMException,
                             SSOException

推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.

Unassigns the given policies from this object.

パラメータ:

serviceName - service name.

policyDNs - Set of policy DN string

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

setAttributeByteArray

void setAttributeByteArray(String attrName,
                           byte[][] byteValues)
                           throws AMException,
                                  SSOException

推奨されていません。

Sets byte attribute values in this AMObject. Note that this method sets or replaces the attribute value with the new value supplied. Also, the attributes changed by this method are not committed to the LDAP data store unless the method store() is called explicitly.

パラメータ:

attrName - the attribute name

byteValues - attribute values in byte[][] format

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

setAttributesByteArray

void setAttributesByteArray(Map attributes)
                            throws AMException,
                                   SSOException

推奨されていません。

Sets byte attribute values in this AMObject. Note that this method sets or replaces the attribute value with the new value supplied. Also, the attributes changed by this method are not committed to the LDAP data store unless the method store() is called explicitly.

パラメータ:

attributes - Map where key is the attribute name and values are in byte[][] format.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

setAttributes

void setAttributes(Map attributes)
                   throws AMException,
                          SSOException

推奨されていません。

Sets attribute values in this AMObject. Note that this method sets or replaces the attribute value with the new value supplied. Also, the attributes changed by this method are not committed to the LDAP data store unless the method store() is called explicitly.

パラメータ:

attributes - Map where key is the attribute name and value is a Set of attribute values. Each of the attribute value must be a string value.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

removeAttributes

void removeAttributes(Set attributes)
                      throws AMException,
                             SSOException

推奨されていません。

Removes attributes in this AMObject. The attributes are removed from the LDAP data store

パラメータ:

attributes - The Set of attribute names

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

setStringAttribute

void setStringAttribute(String attributeName,
                        String value)
                        throws AMException,
                               SSOException

推奨されていません。

Sets string type attribute value.

パラメータ:

attributeName - attribute name

value - value to be set for the attribute names.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

delete

void delete()
            throws AMException,
                   SSOException

推奨されていません。

Deletes the object.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

関連項目:

AMObject.delete(boolean), AMObject.purge(boolean, int)

delete

void delete(boolean recursive)
            throws AMException,
                   SSOException

推奨されていません。

Deletes object(s). This method takes a boolean parameter, if its value is true, will remove the object and any objects under it, otherwise, will try to remove the object only. Two notes on recursive delete. First, be aware of the PERFORMANCE hit when large amount of child objects present. In the soft-delete mode, this method will mark the following objects for deletion: Organization, Group, User purge() should be used to physically delete this object.

パラメータ:

recursive - if true delete the object and any objects under it, otherwise, delete the object only.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

関連項目:

AMObject.purge(boolean, int)

search

Set search(int level,
           String filter)
           throws AMException,
                  SSOException

推奨されていません。

Search objects based on specified level and filter.

パラメータ:

level - The search level starting from the object

filter - The search filter

戻り値:

Set of object DN's matching the search

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

addEventListener

void addEventListener(AMEventListener listener)
                      throws SSOException

推奨されていません。

Registers a event listener that needs to be invoked when a relevant event occurs. If the listener was already registered, then it is registered only once; no duplicate registration is allowed.

Object.equals() method on the listener object is used to determine duplicates.

パラメータ:

listener - listener object that will be called upon when an event occurs.

例外:

SSOException - if errors were encountered in adding a new SSOTokenListener instance

removeEventListener

void removeEventListener(AMEventListener listener)

推奨されていません。

Unregisters a previously registered event listener. If the listener was not registered previously, the method simply returns without doing anything.

パラメータ:

listener - listener object that will be removed or unregistered.

createPolicyTemplate

AMTemplate createPolicyTemplate(String serviceName,
                                Map attributes)
                                throws AMException,
                                       SSOException

推奨されていません。 use com.sun.identity.policy package for creating and managing policies.

Creates a Policy Template with no priority for the given service associated with this AMObject. This is a convenience method and is equivalent to createTemplate( AMTemplate.POLICY_TEMPLATE, serviceName, attributes).

パラメータ:

serviceName - service name.

attributes - Map of attributes name-value pairs.

戻り値:

AMTemplate the service template for this AMObject.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid.

UnsupportedOperationException - if the class implementing this interface does not support this method.

createPolicyTemplate

AMTemplate createPolicyTemplate(String serviceName,
                                Map attributes,
                                int priority)
                                throws AMException,
                                       SSOException

推奨されていません。 use com.sun.identity.policy package for creating and managing policies.

Creates a Policy Template with a priority for the given service associated with this AMObject. This is a convenience method and is equivalent to createTemplate(AMTemplate.POLICY_TEMPLATE, serviceName, attributes, priority).

パラメータ:

serviceName - service name.

attributes - Map of attributes name-value pairs.

priority - template priority (0 is the highest priority).

戻り値:

AMTemplate the service template for this AMObject.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid.

UnsupportedOperationException - if the class implementing this interface does not support this method.

getPolicyTemplate

AMTemplate getPolicyTemplate(String serviceName)
                             throws AMException,
                                    SSOException

推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.

Returns the policy template for a service defined for this object ignoring any inheritance. This is a convenience method and is equivalent to getTemplate(serviceName, AMTemplate.POLICY_TEMPLATE). AMUser object will throw UnsupportedOperationException because this method is not relevant for AMUser.

パラメータ:

serviceName - service name.

戻り値:

AMTemplate the policy template of the service for this object.

例外:

UnsupportedOperationException - if the class implementing this interface does not support this method.

AMException - if an error is encountered when trying to access/retrieve data from the data store.

SSOException - if the single sign on token is no longer valid

getPolicy

Map getPolicy(String serviceName)
              throws AMException,
                     SSOException

推奨されていません。 This method has been deprecated. Please use: com.sun.identity.policy package for creating and managing policies.

Returns the effective service policy defined at this object after considering any inheritance from any policy templates.

パラメータ:

serviceName - service name.

戻り値:

Map the effective service policy for the object after inheritance; key is the attribute name and value is attribute value. An empty Map will be returned if no policy attribute is defined in the specified service.

例外:

UnsupportedOperationException - if the class implementing this interface does not support this method

AMException - if an error is encountered when trying to access/retrieve data from the data store

SSOException - if the single sign on token is no longer valid

getOrganizationDN

String getOrganizationDN()
                         throws AMException,
                                SSOException

推奨されていません。

Returns the object's organization. NOTE: Obtaining an organization DN involves considerable overhead. Hence after obtaining the organization DN, each object saves this information. Consecutives method calls on this object fetch the value stored in the object. Creating a new AMObject instance every time to obtain the organization DN is not recommended.

戻り値:

The object's organization DN.

例外:

AMException - if an error is encountered when trying to access/retrieve data from the data store or the object does not have organization DN.

SSOException - if the single sign on token is no longer valid.

assignServices

void assignServices(Map serviceNameAndAttrs)
                    throws AMException,
                           SSOException

推奨されていません。

Assign services to the entity (user/group/organization/organization unit). Also sets the attributes as provided in the map serviceNameAndAttrs. serviceNameAndAttrs is a map of keys which are service names and values which are attribute-value maps. Attribute values are validated against the respective service schemas before being set. Any required attributes (as defined in the service schema) not provided in the attribute Map, will be included and set to default values (picked up from the service schema). Only services which have been registered with the parent organization of the entity (the organization itself, in case the entity is an organization) will be assigned to the entity. So before assigning a service to an entity, registerService() should be used on the parent organization.

パラメータ:

serviceNameAndAttrs - Map of Service name with Map of Attribute-Value pairs

例外:

AMException - if an error is encounters when trying to access/retrieve data from the data store

SSOException - if the token is no longer valid

関連項目:

AMOrganization.registerService(java.lang.String, boolean, boolean)

modifyService

void modifyService(String serviceName,
                   Map attrMap)
                   throws AMException,
                          SSOException

推奨されていません。

Modify the service attributes of a service assigned to a entity (user/group/organization/organizational unit). It replaces existing service attribute values with the ones provided. If new attribute values are provided, those are set too. Values of the attribute are validated against the service schema. Before the values are replaced in the entry, the ServiceCallback classes, if any, are instantiated and the validateAttribute() method is called.

パラメータ:

serviceName - Name of the service which has to be modified

attrMap - Map of attribute names and set of attribute values.

例外:

AMException - if an error occurs during validation or storing

SSOException - if the single sign on token is no longer valid.

setServiceStatus

void setServiceStatus(String serviceName,
                      String status)
                      throws AMException,
                             SSOException

推奨されていません。

Set the status of the service for this entity (User/Organization /Group/Organizational Unit). The valid values for the status attribute are defined in the SMS DTD. Before the status attribute is set, it is verified to see if the service is first assigned to the user or not, and that the value for the status is valid per the DTD.

パラメータ:

serviceName - Name of service whose status attribute has to be changed

status - One of the status values as defined in the service schema

例外:

AMException - if a data store exception is encountered.

SSOException - if the single sign on token is no longer valid.

getServiceStatus

String getServiceStatus(String serviceName)
                        throws AMException,
                               SSOException

推奨されていません。

Get the status of the service for this entity (user/group/organization/ organizational unit). Returns null, if service is not assigned to the entity.

パラメータ:

serviceName - Name of service

戻り値:

status Value of the status attribute

例外:

AMException - if a data store exception is encountered

SSOException - if single sign on token is no longer valid.

unassignServices

void unassignServices(Set serviceNames)
                      throws AMException,
                             SSOException

推奨されていません。

Unassigns services from the user/group/organization/ organizational unit.

パラメータ:

serviceNames - Set of service names

例外:

AMException - if there is an internal error in the access management data store.

SSOException - if the single sign on token is no longer valid

getAssignedServices

Set getAssignedServices()
                        throws AMException,
                               SSOException

推奨されていません。

Returns all service names that are assigned to the user/group/organization/organizational unit.

戻り値:

The Set of service names that are assigned to the user.

例外:

AMException - if there is an internal error in the access management data store.

SSOException - if the single sign on token is no longer valid

purge

void purge(boolean recursive,
           int graceperiod)
           throws AMException,
                  SSOException

推奨されていません。

This method will physically delete the entry from the data store. This method will override the soft-delete option, which the method delete() will not. There is a big PERFORMANCE hit if this method is used to delete a large Organization in the recursive mode.

パラメータ:

recursive - If true, then recursively delete the whole subtree.

graceperiod - If set to an integer greater than -1, it will verify if the object was last modified at least that many days ago before physically deleting it. Pre/Post Callback plugins as registered in the Administration Service, will be called upon object deletion. If any of the pre-callback classes throw an exception, then the operation is aborted.

例外:

AMException - if there is an internal error in the access management data store.

SSOException - if the single sign on token is no longer valid

関連項目:

AMObject.delete()