com.sun.xml.ws.policy.sourcemodel

Class PolicyModelTranslator

java.lang.Object

com.sun.xml.ws.policy.sourcemodel.PolicyModelTranslator

public class PolicyModelTranslator
extends java.lang.Object

This class provides a method for translating a PolicySourceModel structure to a normalized Policy expression. The resulting Policy is disconnected from its model, thus any additional changes in the model will have no effect on the Policy expression.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	PolicyModelTranslator.ContentDecomposition
private static class	PolicyModelTranslator.RawAlternative
private static class	PolicyModelTranslator.RawAssertion
private static class	PolicyModelTranslator.RawPolicy

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<java.lang.String,PolicyAssertionCreator>	assertionCreators
private static PolicyAssertionCreator	defaultCreator
private static PolicyLogger	LOGGER

Constructor Summary

Constructors

Modifier	Constructor and Description
private	PolicyModelTranslator()
protected	PolicyModelTranslator(java.util.Collection<PolicyAssertionCreator> creators)

Method Summary

Modifier and Type	Method and Description
private java.util.Collection<AssertionSet>	createPolicyAlternatives(PolicySourceModel model) Method creates policy alternatives according to provided model.
private PolicyAssertion	createPolicyAssertion(AssertionData data, java.util.Collection<PolicyAssertion> assertionParameters, AssertionSet nestedAlternative)
private PolicyAssertion	createPolicyAssertionParameter(ModelNode parameterNode)
private void	decompose(java.util.Collection<ModelNode> content, PolicyModelTranslator.ContentDecomposition decomposition) Decomposes the unprocessed alternative content into two different collections: Content of 'EXACTLY_ONE' child nodes is expanded and placed in one list and 'ASSERTION' nodes are placed into other list.
private java.util.Collection<ModelNode>	expandsExactlyOneContent(java.util.Collection<ModelNode> content) Expands content of 'EXACTLY_ONE' node.
private static ModelNode	getReferencedModelRootNode(ModelNode policyReferenceNode)
static PolicyModelTranslator	getTranslator() Method returns thread-safe policy model translator instance.
private java.util.List<AssertionSet>	normalizeRawAlternative(PolicyModelTranslator.RawAlternative alternative)
private java.util.List<PolicyAssertion>	normalizeRawAssertion(PolicyModelTranslator.RawAssertion assertion)
Policy	translate(PolicySourceModel model) The method translates PolicySourceModel structure into normalized Policy expression.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOGGER

private static final PolicyLogger LOGGER

defaultCreator

private static final PolicyAssertionCreator defaultCreator

assertionCreators

private final java.util.Map<java.lang.String,PolicyAssertionCreator> assertionCreators

Constructor Detail

PolicyModelTranslator

private PolicyModelTranslator()
                       throws PolicyException

Throws:

PolicyException

PolicyModelTranslator

protected PolicyModelTranslator(java.util.Collection<PolicyAssertionCreator> creators)
                         throws PolicyException

Throws:

PolicyException

Method Detail

getTranslator

public static PolicyModelTranslator getTranslator()
                                           throws PolicyException

Method returns thread-safe policy model translator instance. This method is only intended to be used by code that has no dependencies on JAX-WS. Otherwise use com.sun.xml.ws.policy.api.ModelTranslator.

Returns:

A policy model translator instance.

Throws:

PolicyException - If instantiating a PolicyAssertionCreator failed.

translate

public Policy translate(PolicySourceModel model)
                 throws PolicyException

The method translates PolicySourceModel structure into normalized Policy expression. The resulting Policy is disconnected from its model, thus any additional changes in model will have no effect on the Policy expression.

Parameters:

model - the model to be translated into normalized policy expression. Must not be null.

Returns:

translated policy expression in it's normalized form.

Throws:

PolicyException - in case of translation failure

createPolicyAlternatives

private java.util.Collection<AssertionSet> createPolicyAlternatives(PolicySourceModel model)
                                                             throws PolicyException

Method creates policy alternatives according to provided model. The model structure is modified in the process.

Returns:

created policy alternatives resulting from policy source model.

Throws:

PolicyException

decompose

private void decompose(java.util.Collection<ModelNode> content,
                       PolicyModelTranslator.ContentDecomposition decomposition)
                throws PolicyException

Decomposes the unprocessed alternative content into two different collections:

Content of 'EXACTLY_ONE' child nodes is expanded and placed in one list and 'ASSERTION' nodes are placed into other list. Direct 'ALL' and 'POLICY' child nodes are 'dissolved' in the process. Method reuses precreated ContentDecomposition object, which is reset before reuse.

Throws:

PolicyException

getReferencedModelRootNode

private static ModelNode getReferencedModelRootNode(ModelNode policyReferenceNode)
                                             throws PolicyException

Throws:

PolicyException

expandsExactlyOneContent

private java.util.Collection<ModelNode> expandsExactlyOneContent(java.util.Collection<ModelNode> content)
                                                          throws PolicyException

Expands content of 'EXACTLY_ONE' node. Direct 'EXACTLY_ONE' child nodes are dissolved in the process.

Throws:

PolicyException

normalizeRawAlternative

private java.util.List<AssertionSet> normalizeRawAlternative(PolicyModelTranslator.RawAlternative alternative)
                                                      throws AssertionCreationException,
                                                             PolicyException

Throws:

AssertionCreationException

PolicyException

normalizeRawAssertion

private java.util.List<PolicyAssertion> normalizeRawAssertion(PolicyModelTranslator.RawAssertion assertion)
                                                       throws AssertionCreationException,
                                                              PolicyException

Throws:

AssertionCreationException

PolicyException

createPolicyAssertionParameter

private PolicyAssertion createPolicyAssertionParameter(ModelNode parameterNode)
                                                throws AssertionCreationException,
                                                       PolicyException

Throws:

AssertionCreationException

PolicyException

createPolicyAssertion

private PolicyAssertion createPolicyAssertion(AssertionData data,
                                              java.util.Collection<PolicyAssertion> assertionParameters,
                                              AssertionSet nestedAlternative)
                                       throws AssertionCreationException

Throws:

AssertionCreationException