Package com.sun.identity.sm

Class ServiceSchema

  • public class ServiceSchema
extends Object
    The class ServiceSchema provides interfaces to manage the schema information of a service. The schema for a service can be one of the following types: GLOBAL, ORGANIZATION, DYNAMIC, USER, and POLICY.

    • Method Detail

      • getServiceName

        public String getServiceName()
        Returns the name of the service.
        Returns:
        the name of the schema

      • getVersion

        public String getVersion()
        Returns the version of the service.
        Returns:
        version of the service schema

      • getName

        public String getName()
        Returns the name of the schema.
        Returns:
        the name of the schema

      • getServiceType

        public SchemaType getServiceType()
        Returns the schema type.
        Returns:
        the schema type.

      • getI18NKey

        public String getI18NKey()
        Returns the I18N key that points to the description of the service.
        Returns:
        the I18N key that points to the description of the service

      • supportsMultipleConfigurations

        public boolean supportsMultipleConfigurations()
        Returns true if service schema supports multiple configurations; false otherwise
        Returns:
        true if service schema supports multiple configurations; false otherwise

      • setI18Nkey

        public void setI18Nkey​(String key)
                throws SMSException,
                       SSOException
        Sets the value of the I18N key in the service schema.
        Parameters:
        key - Value to be set for the I18N key of the service schema.
        Throws:
        SMSException - if there is a problem setting the value in the data store.
        SSOException - If the user has an invalid SSO token.

      • setInheritance

        public void setInheritance​(String value)
                    throws SMSException,
                           SSOException
        Set the value of inheritance attribute in service schema.
        Parameters:
        value - New value of inheritance attribute.
        Throws:
        SMSException - if there is a problem setting the value in the data store.
        SSOException - if the user has an invalid single sign on token.

      • getPropertiesViewBeanURL

        public String getPropertiesViewBeanURL()
        Returns the view bean URL for this service
        Returns:
        file name that contains I18N messages

      • getStatusAttribute

        public String getStatusAttribute()
        Returns the name of the status attribute, as defined in the Service schema
        Returns:
        String name of status attribute

      • isExportable

        public boolean isExportable()
        Returns true if the service configuration created can be exported to other organizations.
        Returns:
        true if service configurations for this schema can be exported to other organizations; false otherwise.

      • setExportable

        public void setExportable​(boolean exportable)
        Sets the exportable nature of the service configurations created for this schema. Setting it to true allows the configurations to be exported to other organizations and a value of false disables exporting of configuration data.
        Parameters:
        exportable - true if service configurations for this schema can be exported to other organizations; false otherwise.

      • getI18NFileName

        public String getI18NFileName()
        Returns the I18N properties file name for the service schema.
        Returns:
        the I18N properties file name for the service schema

      • setI18NFileName

        public void setI18NFileName​(String url)
                     throws SMSException,
                            SSOException
        Sets the I18N properties file name for the service schema
        Parameters:
        url - properties file name
        Throws:
        SMSException - if an error occurred while trying to perform the operation
        SSOException - if the single sign on token is invalid or expired

      • getResourceName

        public String getResourceName()
        Returns the name for the service schema when used in a CREST representation.

      • isHiddenInConfigUI

        public boolean isHiddenInConfigUI()
        Should this service schema be hidden in the Configuration UI.
        Returns:
        True if it should be hidden.

      • isRealmCloneable

        public boolean isRealmCloneable()
        During the creation of a new organisation/realm the services assigned to the parent realm are copied to the child realm. This will include the sub configs for that service, which in some cases are realm specific and will fail validation if copied. The schemas of these sub configs should set realmCloneable to no to avoid being copied.
        Returns:
        true if the config is cloneable between realms.

      • setResourceName

        public void setResourceName​(String name)
                     throws SMSException,
                            SSOException
        Sets the CREST resource name for the service schema.
        Parameters:
        name - resource name.
        Throws:
        SMSException - if an error occurred while trying to perform the operation
        SSOException - if the single sign on token is invalid or expired

      • getAttributeSchemaNames

        public Set getAttributeSchemaNames()
        Returns the names of the schema attributes defined for the service. It does not return the schema attributes defined for the sub-schema.
        Returns:
        the names of schema attributes defined for the service

      • getSearchableAttributeNames

        protected Set getSearchableAttributeNames()
        Returns the names of the schema attributes defined for the service which are searchable. It does not return the schema attributes defined for the sub-schema.
        Returns:
        the names of schema attributes defined for the service which are searchable attributes.

      • getAttributeSchema

        public AttributeSchema getAttributeSchema​(String attributeName)
        Returns the schema for an attribute given the name of the attribute, defined for this service. It returns only the attribute schema defined at the top level for the service and not from the sub-schema.
        Parameters:
        attributeName - the name of the schema attribute
        Returns:
        the schema for the attribute

      • getAttributeSchemas

        public Set<AttributeSchema> getAttributeSchemas()
        Returns the attribute schemas defined for the service. It does not return the schema attributes defined for the sub-schema.
        Returns:
        attribute schemas defined for the service

      • getServiceAttributeNames

        public Set getServiceAttributeNames()
        Returns the attribute schemas defined for the service that is not a status attribute and is not a service attribute. It does not return the schema attributes defined for the sub-schema.
        Returns:
        attribute schemas defined for the service

      • validateAndInheritDefaults

        public Map validateAndInheritDefaults​(Map attrMap,
                                      boolean inherit)
                               throws SMSException
        Validates the attrMap against the attributes defined in this schema of the service. It will throw an exception if the map contains any attribute not listed in the schema. It will also pick up default values for any attributes not in the map but which are listed in the schema, if the boolean inherit is set to true.
        Parameters:
        attrMap - map of attributes
        inherit - if true, then inherit the default values
        Returns:
        Map of validated attributes with default values
        Throws:
        SMSException - if invalid attribute names are present in the attrMap.

      • validateAndInheritDefaults

        public Map validateAndInheritDefaults​(Map attrMap,
                                      String orgName,
                                      boolean inherit)
                               throws SMSException
        Validates the attrMap against the attributes defined in this schema of the service for the given organization. It will throw an exception if the map contains any attribute not listed in the schema. It will also pick up default values for any attributes not in the map but which are listed in the schema, if the boolean inherit is set to true.
        Parameters:
        attrMap - map of attributes
        inherit - if true, then inherit the default values
        Returns:
        Map of validated attributes with default values
        Throws:
        SMSException - if invalid attribute names are present in the attrMap.

      • addAttributeSchema

        public void addAttributeSchema​(InputStream xmlAttrSchema)
                        throws SSOException,
                               SMSException
        Adds the attribute schema to this service. The schema is defined in XML input stream that follows the SMS DTD.
        Parameters:
        xmlAttrSchema - the XML format of the attribute schema
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • removeAttributeSchema

        public void removeAttributeSchema​(String attrName)
                           throws SSOException,
                                  SMSException
        Removes the attribute schema from this service.
        Parameters:
        attrName - the name of the attribute schema
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • getAttributeDefaults

        public Map<String,​Set<String>> getAttributeDefaults()
        Returns a map of all the attribute and their default values in this schema.
        Returns:
        Map of Attribute Names and Sets of their default values as defined in the Schema

      • getAttributeExamples

        public Map<String,​Set<String>> getAttributeExamples()
        Returns a map of all the attribute and their example values in this schema.
        Returns:
        Map of Attribute Names and Sets of their example values as defined in the Schema

      • getReadOnlyAttributeDefaults

        public Map getReadOnlyAttributeDefaults()
        Returns an unmodifiable map of all the attribute and their default values in this schema.
        Returns:
        Map of Attribute Names and Sets of their default values as defined in the Schema

      • setAttributeDefaults

        public void setAttributeDefaults​(Map attrs)
                          throws SSOException,
                                 SMSException
        Method to change the default values of attributes in the schema.
        Parameters:
        attrs - A map of the names of AttributeSchema to modify, and a Set of Values which should replace the default values of the current schema.
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • setAttributeDefaults

        public void setAttributeDefaults​(String attrName,
                                 Set values)
                          throws SchemaException,
                                 SMSException,
                                 SSOException
        Method to change default value for a specific attribute.
        Parameters:
        attrName - Name of the attribute for which defaults values need to be replaced.
        values - Set of new values to replace the old ones.
        Throws:
        SchemaException - if an error occurred while parsing the XML
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • removeAttributeDefaults

        public void removeAttributeDefaults​(Set attrs)
                             throws SMSException,
                                    SSOException
        Removes the default values of attributes in the schema.
        Parameters:
        attrs - A set of the names of AttributeSchema.
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • getSubSchemaNames

        public Set<String> getSubSchemaNames()
        Returns the names of sub-schemas for the service.
        Returns:
        the names of service's sub-schemas

      • getSubSchema

        public ServiceSchema getSubSchema​(String subSchemaName)
                           throws SMSException
        Returns ServiceSchema object given the name of the service's sub-schema.
        Parameters:
        subSchemaName - the name of the service's sub-schema
        Returns:
        ServiceSchema object
        Throws:
        SMSException - if an error occurred while performing the operation

      • addSubSchema

        public void addSubSchema​(InputStream xmlSubSchema)
                  throws SSOException,
                         SMSException
        Adds the service's sub-schema given the XML input stream that follows the SMS DTD.
        Parameters:
        xmlSubSchema - the XML format of the sub-schema
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • removeSubSchema

        public void removeSubSchema​(String subSchemaName)
                     throws SSOException,
                            SMSException
        Removes the service's sub-schema from the service.
        Parameters:
        subSchemaName - the name of the service's sub-schema
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired

      • validateAttributes

        public boolean validateAttributes​(Map attributeSet)
                           throws SMSException
        Determines whether each attribute in the attribute set is valid. Iterates though the set checking each element to see if there is a validator that needs to execute.
        Parameters:
        attributeSet - the Map where key is the attribute name and value is the Set of attribute values
        Returns:
        true if all attributes are valid
        Throws:
        SMSException - if an error occurred while performing the operation

      • validateAttributes

        public boolean validateAttributes​(Map attributeSet,
                                  String orgName)
                           throws SMSException
        Determines whether each attribute in the attribute set is valid for the given organization. Iterates though the set checking each element to see if there is a validator that needs to execute.
        Parameters:
        attributeSet - the Map where key is the attribute name and value is the Set of attribute values
        orgName - organization name
        Returns:
        true if all attributes are valid
        Throws:
        SMSException - if an error occurred while performing the operation

      • toString

        public String toString()
        Returns string representation of the schema.
        Overrides:
        toString in class Object
        Returns:
        string representation of the schema.

      • getSchemaNode

        public Node getSchemaNode()
        Returns the Node of this schema element. Used by Policy component's ServiceType to get ActionSchema.
        Returns:
        the Node of this schema element. Used by Policy component's ServiceType to get ActionSchema.

      • replaceAttributeSchema

        public void replaceAttributeSchema​(String attrName,
                                   Node attributeSchemaNode)
                            throws SSOException,
                                   SMSException
        Removes the attribute schema from this service.
        Parameters:
        attrName - the name of the attribute schema
        Throws:
        SMSException - if an error occurred while performing the operation
        SSOException - if the single sign on token is invalid or expired