com.bea.p13n.controls.ejb.usermgmt.profile
Interface GroupProfileManager

@ControlInterface
public interface GroupProfileManager

ProfileManager is a stateless session bean used to access profile values. It coordinates successor searches and mapping properties to different datasources.

This control has been deprecated. Use the ProfileControl instead. To provide a successor to the methods which take one, use the profile name of the successor profile. Each profile manager uses only one type as the successor type; for example, when specifying a successor to a UserProfileManager, it assumes the name is a group profile name. Property mapping is done through the deployment descriptor of the ProfileManager session bean. First, the default EntityPropertyManager to be used must have an ejb-ref named ejb/EntityPropertyManager. Any other EntityPropertyManager's to be used must also have ejb-refs. To map properties to a non-default EntityPropertyManager:

• To map an entire property set: create an environment entry called PropertyMapping/<property set name> which is a String that holds the name of the ejb-ref to use for that property set. For example, PropertyMapping/Ldap might have the value ejb/LdapPropertyManager, which is an ejb-ref pointing to an EntityPropertyManager that goes to an ldap server.
• To map a single property: create an environment entry called PropertyMapping/<property set name>.<property name> which is a String that holds the name of the ejb-ref to use for that property. For example, PropertyMapping/Ldap.fax might have the value ejb/CustomerPropertyManager, which is an ejb-ref pointing to an EntityPropertyManager that goes to a customer database table.

If a property set is mapped to an EntityPropertyManager, and another entry maps one property of that property set to a different EntityPropertyManager, the single property mapping will override the property set mapping. In the previous examples, the LdapPropertyManager would be used for all properties in the Ldap property set except for "fax", which would be retrieved from the CustomerPropertyManager.

This control requires that the GroupProfileManager EJB has been deployed to the application. The GroupProfileManager EJB is contained in p13n_ejb.jar, and is automatically deployed as part of a Portal application.
Security requirements: The caller must be in the role of "PortalSystemAdministrator" to invoke these methods

See Also

EntityPropertyCache

Method Summary

void	createProfile(String profileName) Deprecated Use ProfileControl.getGroupProfileManager().createProfile(name)
void	deleteProfile(String profileName) Deprecated Use ProfileControl.getGroupProfileManager().deleteProfile(profileName)
String[]	getAllProfileNames() Deprecated Use ProfileControl.getGroupProfileManager().getAllProfileNames()
String	getJndiName() Deprecated Use ProfileControl.getGroupProfileManager().getJNDIName()
String	getProfileName(long profileId) Deprecated Use ProfileControl.getGroupProfileManager().getProfileName(profileId)
EntityPropertyCache	getProperties(String profileName) Deprecated Use ProfileControl.getGroupProfileManager().getProperties(profileName)
EntityPropertyCache	getPropertiesForKeys(String profileName, Set propertyMapKeys) Deprecated Use ProfileControl.getGroupProfileManager().getPropertiesForKeys(profileName, propertyMapKeys)
EntityPropertyCache	getPropertiesInPropertySet(String profileName, String propertySetName) Deprecated Use ProfileControl.getGroupProfileManager().getPropertiesInPropertySet(profileName, propertySetName)
Object	getProperty(String profileName, String propertySet, String propertyName) Deprecated Use ProfileControl.getGroupProfileManager().getProperty(profileName, propertySet, propertyName)
String	getPropertyAsString(String profileName, String propertySet, String propertyName) Deprecated Use ProfileControl.getGroupProfileManager().getPropertyAsString(profileName, propertySet, propertyName)
String	getPropertyAsStringTrySuccessor(String profileName, String propertySet, String propertyName, String successor) Deprecated Use ProfileControl.getGroupProfileManager().getPropertyAsStringTrySuccessor()
Object	getPropertyNoDefault(String profileName, String propertySet, String propertyName, String successor) Deprecated Use ProfileControl.getGroupProfileManager().getPropertyNoDefault()
Object	getPropertyTrySuccessor(String profileName, String propertySet, String propertyName, String successor) Deprecated Use ProfileControl.getGroupProfileManager().getPropertyTrySuccessor()
String	getSuccessor(String profileName, String propertySet) Deprecated Use ProfileControl.getGroupProfileManager().getSuccessor(profileName, propertySet)
long	getUniqueId(String profileName) Deprecated Use ProfileControl.getGroupProfileManager().getUniqueId()
boolean	profileExists(String profileName) Deprecated Use ProfileControl.getGroupProfileManager().profileExists(name)
Object	removeProperty(String profileName, String propertySet, String propertyName) Deprecated Use ProfileControl.getGroupProfileManager().removeProperty()
void	removeSuccessor(String profileName, String propertySet) Deprecated Use ProfileControl.getGroupProfileManager().removeSuccessor()
void	setProperty(String profileName, String propertySet, String propertyName, Object value) Deprecated Use ProfileControl.getGroupProfileManager().setProperty()
void	setSuccessor(String profileName, String propertySet, String successor) Deprecated Use ProfileControl.getGroupProfileManager().setSuccessor()

Method Detail

profileExists

boolean profileExists(String profileName)
                      throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().profileExists(name)

Determine if a profile exists

Parameters

profileName - the name to look for

Returns

true if it exists, false otherwise

Throws

P13nControlException - if errors accessing GroupProfileManager EJB

createProfile

void createProfile(String profileName)
                   throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().createProfile(name)

Create a profile record with the given name.

Parameters

profileName - the name of the profile to create

Throws

P13nControlException - if errors creating profile

deleteProfile

void deleteProfile(String profileName)
                   throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().deleteProfile(profileName)

Remove a profile Caller must be in the role of PortalSystemAdminstrator

Parameters

profileName - the name of the profile to remove

Throws

P13nControlException - if profile not found, or caller is not in allowed role

getAllProfileNames

String[] getAllProfileNames()
                            throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getAllProfileNames()

Return a list of all profiles that this ProfileManager knows about.

Returns

a String array of profile names, or null if none were found

Throws

P13nControlException - if remote errors accessing GroupProfileManager EJB

getJndiName

String getJndiName()
                   throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getJNDIName()

Retrieve the jndi name used by this ProfileManager. A combination of pk string and jndi name is always unique between profiles.

Returns

the jndi name for this profile

Throws

P13nControlException - if remote errors accessing GroupProfileManager EJB

getProfileName

String getProfileName(long profileId)
                      throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getProfileName(profileId)

Get the name of a profile based on its unique identifier.

Parameters

profileId - the unique id to lookup

Returns

the profile's name

Throws

P13nControlException - if the profile does not exist

getProperties

EntityPropertyCache getProperties(String profileName)
                                  throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getProperties(profileName)

Get all properties for this profile

Parameters

profileName - the name of the profile for which properties will be retrieved

Returns

the cache of retrieved properties

Throws

P13nControlException - if profile is not valid

getPropertiesInPropertySet

EntityPropertyCache getPropertiesInPropertySet(String profileName,
                                               String propertySetName)
                                               throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getPropertiesInPropertySet(profileName, propertySetName)

Get all properties for this profile and named property set

Parameters

profileName - the name of the profile for which properties will be retrieved

propertySetName - the name of the property set to be searched

Returns

the cache of retrieved properties

Throws

P13nControlException - if profile is not valid

getPropertiesForKeys

EntityPropertyCache getPropertiesForKeys(String profileName,
                                         Set propertyMapKeys)
                                         throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getPropertiesForKeys(profileName, propertyMapKeys)

Get all properties for this profile and property set/name keys contained in the Set of propertyMapKeys

Parameters

profileName - the name of the profile for which properties will be retrieved

propertyMapKeys - the set of property set/name keys

Returns

the cache of retrieved properties

Throws

P13nControlException - if profile is not valid

See Also

PropertyMapKey

getProperty

Object getProperty(String profileName,
                   String propertySet,
                   String propertyName)
                   throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getProperty(profileName, propertySet, propertyName)

Get a property from the profile. If the property is not found, the default value from the property set will be returned.

Parameters

profileName - the name of the profile to read

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

Returns

the property's value

Throws

P13nControlException - if profile is not valid

getPropertyTrySuccessor

Object getPropertyTrySuccessor(String profileName,
                               String propertySet,
                               String propertyName,
                               String successor)
                               throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getPropertyTrySuccessor()

Get a property from the profile. If the property is not found in the profile, search the profile named in the successor field. If the property is still not found, the default value from the property set will be returned.

Parameters

profileName - the name of the profile to read

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

successor - the name of the successor whose profile will be searched

Returns

the property's value

Throws

P13nControlException - if profile or successor is not valid

getPropertyAsString

String getPropertyAsString(String profileName,
                           String propertySet,
                           String propertyName)
                           throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getPropertyAsString(profileName, propertySet, propertyName)

Get a property from the profile, converted to a String If the property is not found, the default value from the property set will be returned.

Parameters

profileName - the name of the profile to read

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

Returns

the property's value

Throws

P13nControlException - if profile is not valid

getPropertyAsStringTrySuccessor

String getPropertyAsStringTrySuccessor(String profileName,
                                       String propertySet,
                                       String propertyName,
                                       String successor)
                                       throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getPropertyAsStringTrySuccessor()

Get a property from the profile as a String. If the property is not found in the profile, search the profile named in the successor field. If the property is still not found, the default value from the property set will be returned.

Parameters

profileName - the name of the profile to read

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

successor - the name of the successor whose profile will be searched

Returns

the property's value

Throws

P13nControlException - if profile or successor is not valid

getPropertyNoDefault

Object getPropertyNoDefault(String profileName,
                            String propertySet,
                            String propertyName,
                            String successor)
                            throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getPropertyNoDefault()

Get a property from the profile. If the property is not found in the profile, search the profile named in the successor field. This version will not return the default from the property set.

Parameters

profileName - the name of the profile to read

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

successor - the name of the successor whose profile will be searched

Returns

the property's value

Throws

P13nControlException - if profile or successor is not valid

getSuccessor

String getSuccessor(String profileName,
                    String propertySet)
                    throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getSuccessor(profileName, propertySet)

Retrieve the successor for the specified property set. For user and group profiles, this will always be a group name.

Parameters

profileName - the name of the profile to read

propertySet - The name of the property set

Returns

the successor's name

Throws

P13nControlException - if profile is not valid

getUniqueId

long getUniqueId(String profileName)
                 throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().getUniqueId()

Retrieve the unique identifier generated for this profile. The unique identifier is used by the EntityPropertyManager to optimize the foreign keys in the persistent storage.

Parameters

profileName - the name of the profile to read

Returns

this entity's unique id

Throws

P13nControlException - if profile is not valid

removeProperty

Object removeProperty(String profileName,
                      String propertySet,
                      String propertyName)
                      throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().removeProperty()

Remove a property from the profile Caller must be in the role of PortalSystemAdminstrator

Parameters

profileName - the name of the profile to modify

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

Returns

the old value of the property

Throws

P13nControlException - if profile is not valid or caller is not in allowed role

removeSuccessor

void removeSuccessor(String profileName,
                     String propertySet)
                     throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().removeSuccessor()

Remove the successor for the specified property set. Caller must be in the role of PortalSystemAdminstrator

Parameters

profileName - the name of the profile to modify

propertySet - The name of the property set

Throws

P13nControlException - if profile is not valid or caller is not in allowed role

setProperty

void setProperty(String profileName,
                 String propertySet,
                 String propertyName,
                 Object value)
                 throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().setProperty()

Set a property in the profile Caller must be in the role of PortalSystemAdminstrator

Parameters

profileName - the name of the profile to modify

propertySet - the property set containing the property

propertyName - the name of the property to retrieve

value - the new value for the property

Throws

P13nControlException - if profile is not valid or caller is not in allowed role

setSuccessor

void setSuccessor(String profileName,
                  String propertySet,
                  String successor)
                  throws P13nControlException

Deprecated Use ProfileControl.getGroupProfileManager().setSuccessor()

Set the successor for the specified property set Caller must be in the role of PortalSystemAdminstrator

Parameters

profileName - the name of the profile to modify

propertySet - The name of the property set

successor - the name of the successor profile to set

Throws

P13nControlException - if profile or successor is not valid or caller is not in allowed role