PolicyAssertionCreator.java revision 325
325N/A * <a href="http://java.sun.com/j2se/1.5.0/docs/guide/jar/jar.html#Service%20Provider">J2SE JAR File Specification</a>.
325N/A * support by returning the namespace string from the {link #getSupportedDomainNamespaceUri()}
325N/A * input parameters into the {@link #createAssertion(AssertionData, Collection, AssertionSet, PolicyAssertionCreator)} method)
325N/Apublic interface PolicyAssertionCreator {
325N/A * This method returns the namespace URIs of the domains that are supported by the implementation of
325N/A * Supporting domain namespace URI means that particular {@code PolicyAssertionCreator} implementation
325N/A * is able to create assertion instances for the domains identified by the namespace URIs returned from this
325N/A * method. It is required that each {@code PolicyAssertionCreator} implementation handles the policy
325N/A * @return string array representing the namespace URIs of the supported domains. It is expected that multiple calls on this method return the
325N/A * same value each time. <b>Returned string array must be neither {@code null} nor empty. Also each string value in the array must not be {@code null}
325N/A * Creates domain-specific policy assertion instance according to assertion data provided. For the provided
325N/A * assertion data and this policy assertion creator instance, it will allways be true that assertion namespace
325N/A * Additional method parameter (which must not be {@code null}) supplied by the policy framework specifies a default policy
325N/A * assertion creator that might be used to handle creation of unsupported domain assertion in the default way. This is
325N/A * to give policy assertion creator a chance to handle also creation of "unsupported" domain assertions and to encourage
325N/A * @param assertionParameters collection of assertions parameters of this policy assertion. May be {@code null}.
325N/A * @param nestedAlternative assertion set specifying nested policy alternative. May be {@code null}.
325N/A * @param defaultCreator default policy assertion creator implementation that shall be used to handle creation of assertions
325N/A * @return domain specific policy assertion implementation according to assertion data provided.