Class SubjectTypeManager

java.lang.Object
com.sun.identity.policy.SubjectTypeManager

@SupportedAll @Deprecated public class SubjectTypeManager extends Object
Deprecated.
As of OpenSSO Express 8.0, use EntitlementSubject instead as Entitlement has replaced Policy.
The class SubjectTypeManager provides methods to get a list of configured Subject objects, and to obtain a factory object for it.
  • Constructor Details

    • SubjectTypeManager

      protected SubjectTypeManager() throws SSOException
      Deprecated.
      Constructs a SubjectTypeManager object
      Throws:
      SSOException
    • SubjectTypeManager

      protected SubjectTypeManager(PolicyManager pm)
      Deprecated.
      Constructs a SubjectTypeManager object
      Parameters:
      pm - PolicyManager to initialize SubjectTypeManager with
  • Method Details

    • getSubjectTypeNames

      public Set getSubjectTypeNames() throws SSOException, PolicyException
      Deprecated.
      Returns a set of all valid subject type names defined by the policy service. Examples are LDAPRole, LDAPGroup, etc.
      Returns:
      a set of all valid subject type names defined by the policy service.
      Throws:
      SSOException - if the SSOToken used to create the PolicyManager has become invalid
      PolicyException - for any other abnormal condition
    • getSelectedSubjectTypeNames

      public Set getSelectedSubjectTypeNames() throws SSOException, PolicyException
      Deprecated.
      Returns a set of valid subject type names configured for the organization. Examples are LDAPRole, LDAPGroup, etc.
      Returns:
      a set of valid subject type names configured for the organization.
      Throws:
      SSOException - if the SSOToken used to create the PolicyManager has become invalid
      PolicyException - for any other abnormal condition
    • getSubjectTypeName

      public String getSubjectTypeName(Subject subject)
      Deprecated.
      Returns the type of the Subject implementation. For example LDAPGroups etc.
      Parameters:
      subject - Subject for which this method will return its associated type
      Returns:
      type of the Subject, e.g., LDAPGroups, etc. Returns null if not present.
    • getI18NPropertiesFileName

      protected String getI18NPropertiesFileName(String subjectType)
      Deprecated.
      Returns the I18N properties file name that should be used to localize display names for the given subject type.
      Parameters:
      subjectType - subject type name
      Returns:
      i18n properties file name
    • getI18NKey

      public String getI18NKey(String subjectType)
      Deprecated.
      Returns the I18N key to be used to localize the display name for the subject type name.
      Parameters:
      subjectType - subject type name
      Returns:
      i18n key to obtain the display name
    • getDisplayName

      public String getDisplayName(String subjectType)
      Deprecated.
      Returns the display name for the subject type
      Parameters:
      subjectType - subject type
      Returns:
      display name for the subject type
    • getSubject

      public Subject getSubject(String subjectType) throws NameNotFoundException, PolicyException
      Deprecated.
      Returns an instance of the Subject given the subject type name.
      Parameters:
      subjectType - subject type.
      Returns:
      an instance of the Subject given the subject type name.
      Throws:
      NameNotFoundException - if the Subject for the subjectType name is not found
      PolicyException - for any other abnormal condition
    • addSubject

      public void addSubject(String subjectName, Subject subject) throws NameAlreadyExistsException, InvalidNameException, PolicyException, SSOException
      Deprecated.
      Adds a policy subject at realm.
      Parameters:
      subjectName - name of the Subject instance
      subject - Subject object to be added
      Throws:
      NameAlreadyExistsException - if a Subject with the given name already exists at the realm
      InvalidNameException - if the subject name is invalid
      PolicyException - if can not add the Subject
      SSOException
    • removeSubject

      public Subject removeSubject(String subjectName) throws ObjectInUseException, PolicyException, SSOException
      Deprecated.
      Removes the subject with the given name from the realm. This method would throw PolicyException if the subject is being used by any policy.
      Parameters:
      subjectName - name of the Subject
      Returns:
      returns the Subject object being removed, returns null if Subject with the given subjectName is not present
      Throws:
      PolicyException - if can not remove the Subject
      ObjectInUseException
      SSOException
    • removeSubject

      public Subject removeSubject(String subjectName, boolean forcedRemove) throws ObjectInUseException, PolicyException, SSOException
      Deprecated.
      Removes the subject with the given name from the realm. This method would throw PolicyException if the subject is being used by any policy unless forcedRemove argument is set to true. If the forcedRemove argument is set to true policies that are using the subject would be modified to remove the references to the subject
      Parameters:
      subjectName - name of the Subject
      forcedRemove - if set to true, policies that use the subject would be modifed to remove the references to the subject. Otherwise, ObjectInUseException would be thrown if there is any policy using the subject
      Returns:
      returns the Subject object being removed, returns null if Subject with the given subjectName is not present
      Throws:
      PolicyException - if can not remove the Subject
      ObjectInUseException
      SSOException
    • replaceSubject

      public void replaceSubject(String subjectName, Subject subject) throws NameNotFoundException, PolicyException, SSOException
      Deprecated.
      Replaces an existing subject with the same name by the current one at the realm. If a subject with the same name does not exist, it will be added.
      Parameters:
      subjectName - name of the Subject instance
      subject - Subject that will replace an existing Subject with the same name
      Throws:
      NameNotFoundException - if a Subject instance with the given name is not present
      PolicyException - if can not replace the Subject
      SSOException
    • getSubjectNames

      public Set getSubjectNames() throws PolicyException, SSOException
      Deprecated.
      Get the set of names of Subject(s) defined at the realm
      Returns:
      set of subject names
      Throws:
      PolicyException
      SSOException
    • getSubjectByName

      public Subject getSubjectByName(String subjectName) throws NameNotFoundException, PolicyException
      Deprecated.
      Returns the Subject object identified by subjectName defined at the realm
      Parameters:
      subjectName - name of subject.
      Returns:
      Subject object
      Throws:
      NameNotFoundException - if a Subject with the given name does not exist
      PolicyException - if can not get the Subject
    • getViewBeanURL

      public String getViewBeanURL(Subject subject)
      Deprecated.
      Returns the view bean URL given the Subject
      Parameters:
      subject - subject for which to get the view bean URL
      Returns:
      view bean URL defined for the subject plugin in the policy service PluginSchema.