GroupProfileManager Interface
- public interface GroupProfileManager
extends Control
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
Related Topics
EntityPropertyCache
-
All Superinterfaces
-
Control
, Control
, Serializable
public void |
-
createProfile (String profileName)
- Create a profile record with the given name.
|
public void |
-
deleteProfile (String profileName)
- Remove a profile
Caller must be in the role of PortalSystemAdminstrator
|
public String [] |
-
getAllProfileNames ()
- Return a list of all profiles that this ProfileManager
knows about.
|
public String |
-
getJndiName ()
- Retrieve the jndi name used by this ProfileManager.
|
public String |
-
getProfileName (long profileId)
- Get the name of a profile based on its unique identifier.
|
public EntityPropertyCache |
-
getProperties (String profileName)
- Get all properties for this profile
|
public EntityPropertyCache |
-
getPropertiesForKeys (String profileName, Set propertyMapKeys)
- Get all properties for this profile and property set/name keys
contained in the Set of propertyMapKeys
|
public EntityPropertyCache |
-
getPropertiesInPropertySet (String profileName, String propertySetName)
- Get all properties for this profile and named property set
|
public Object |
-
getProperty (String profileName, String propertySet, String propertyName)
- Get a property from the profile.
|
public String |
-
getPropertyAsString (String profileName, String propertySet, String 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.
|
public String |
-
getPropertyAsStringTrySuccessor (String profileName, String propertySet, String propertyName, String successor)
- Get a property from the profile as a String.
|
public Object |
-
getPropertyNoDefault (String profileName, String propertySet, String propertyName, String successor)
- Get a property from the profile.
|
public Object |
-
getPropertyTrySuccessor (String profileName, String propertySet, String propertyName, String successor)
- Get a property from the profile.
|
public String |
-
getSuccessor (String profileName, String propertySet)
- Retrieve the successor for the specified property set.
|
public long |
-
getUniqueId (String profileName)
- Retrieve the unique identifier generated for this profile.
|
public boolean |
-
profileExists (String profileName)
- Determine if a profile exists
|
public Object |
-
removeProperty (String profileName, String propertySet, String propertyName)
- Remove a property from the profile
Caller must be in the role of PortalSystemAdminstrator
|
public void |
-
removeSuccessor (String profileName, String propertySet)
- Remove the successor for the specified property set.
|
public void |
-
setProperty (String profileName, String propertySet, String propertyName, Object value)
- Set a property in the profile
Caller must be in the role of PortalSystemAdminstrator
|
public void |
-
setSuccessor (String profileName, String propertySet, String successor)
- Set the successor for the specified property set
Caller must be in the role of PortalSystemAdminstrator
|
createProfile(String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().createProfile(name)
public void createProfile(String
profileName)
throws P13nControlException
Create a profile record with the given name.
Parameters
-
profileName
- the name of the profile to create
Exceptions
-
P13nControlException
- if errors creating profile
deleteProfile(String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().deleteProfile(profileName)
public void deleteProfile(String
profileName)
throws P13nControlException
Remove a profile
Caller must be in the role of PortalSystemAdminstrator
Parameters
-
profileName
- the name of the profile to remove
Exceptions
-
P13nControlException
- if profile not found, or caller is not in allowed
role
getAllProfileNames() Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getAllProfileNames()
public String
[] getAllProfileNames()
throws P13nControlException
Return a list of all profiles that this ProfileManager
knows about.
Returns
- a String array of profile names, or null if none were found
Exceptions
-
P13nControlException
- if remote errors accessing GroupProfileManager EJB
getJndiName() Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getJndiName()
public String
getJndiName()
throws P13nControlException
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
Exceptions
-
P13nControlException
- if remote errors accessing
GroupProfileManager EJB
getProfileName(long) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getProfileName(profileId)
public String
getProfileName(long profileId)
throws P13nControlException
Get the name of a profile based on its unique identifier.
Parameters
-
profileId
- the unique id to lookup
Returns
- the profile's name
Exceptions
-
P13nControlException
- if the profile does not exist
getProperties(String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getProperties(profileName)
public EntityPropertyCache
getProperties(String
profileName)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
getPropertiesForKeys(String, Set) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getPropertiesForKeys(profileName, propertyMapKeys)
public EntityPropertyCache
getPropertiesForKeys(String
profileName,
Set
propertyMapKeys)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
Related Topics
PropertyMapKey
getPropertiesInPropertySet(String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getPropertiesInPropertySet(profileName, propertySetName)
public EntityPropertyCache
getPropertiesInPropertySet(String
profileName,
String
propertySetName)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
getProperty(String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getProperty(profileName, propertySet, propertyName)
public Object
getProperty(String
profileName,
String
propertySet,
String
propertyName)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
getPropertyAsString(String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getPropertyAsString(profileName, propertySet, propertyName)
public String
getPropertyAsString(String
profileName,
String
propertySet,
String
propertyName)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
getPropertyAsStringTrySuccessor(String, String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getPropertyAsStringTrySuccessor()
public String
getPropertyAsStringTrySuccessor(String
profileName,
String
propertySet,
String
propertyName,
String
successor)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile or successor is not valid
getPropertyNoDefault(String, String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getPropertyNoDefault()
public Object
getPropertyNoDefault(String
profileName,
String
propertySet,
String
propertyName,
String
successor)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile or successor is not valid
getPropertyTrySuccessor(String, String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getPropertyTrySuccessor()
public Object
getPropertyTrySuccessor(String
profileName,
String
propertySet,
String
propertyName,
String
successor)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile or successor is not valid
getSuccessor(String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getSuccessor(profileName, propertySet)
public String
getSuccessor(String
profileName,
String
propertySet)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
getUniqueId(String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().getUniqueId()
public long getUniqueId(String
profileName)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid
profileExists(String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().profileExists(name)
public boolean profileExists(String
profileName)
throws P13nControlException
Determine if a profile exists
Parameters
-
profileName
- the name to look for
Returns
- true if it exists, false otherwise
Exceptions
-
P13nControlException
- if errors accessing GroupProfileManager EJB
removeProperty(String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().removeProperty()
public Object
removeProperty(String
profileName,
String
propertySet,
String
propertyName)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid or caller is not
in allowed role
removeSuccessor(String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().removeSuccessor()
public void removeSuccessor(String
profileName,
String
propertySet)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid or caller is not
in allowed role
setProperty(String, String, String, Object) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().setProperty()
public void setProperty(String
profileName,
String
propertySet,
String
propertyName,
Object
value)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile is not valid or caller is not
in allowed role
setSuccessor(String, String, String) Method
DEPRECATED Use ProfileControl.getGroupProfileManager().setSuccessor()
public void setSuccessor(String
profileName,
String
propertySet,
String
successor)
throws P13nControlException
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
Exceptions
-
P13nControlException
- if profile or successor is not valid or caller is not
in allowed role