com.sun.xml.ws.policy

Class PolicyMerger

java.lang.Object

com.sun.xml.ws.policy.PolicyMerger

public final class PolicyMerger
extends java.lang.Object

Merge policies and return the effective policy. WS-PolicyAttachment defines a merge algorithm for WSDL 1.1 policy attachments.

Field Summary

Fields

Modifier and Type	Field and Description
private static PolicyMerger	merger

Constructor Summary

Constructors

Modifier	Constructor and Description
private	PolicyMerger() This private constructor is to avoid direct class instantiation from outsied of the package

Method Summary

Modifier and Type	Method and Description
static PolicyMerger	getMerger() Factory method for obtaining thread-safe policy merger instance.
Policy	merge(java.util.Collection<Policy> policies) Takes collection of policies and merges them into a single policy using algorithm described in WS-PolicyAttachment specification.

Methods inherited from class java.lang.Object

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

Field Detail

merger

private static final PolicyMerger merger

Constructor Detail

PolicyMerger

private PolicyMerger()

This private constructor is to avoid direct class instantiation from outsied of the package

Method Detail

getMerger

public static PolicyMerger getMerger()

Factory method for obtaining thread-safe policy merger instance.

Returns:

policy merger instance.

merge

public Policy merge(java.util.Collection<Policy> policies)

Takes collection of policies and merges them into a single policy using algorithm described in WS-PolicyAttachment specification. None of the original policies in the collection are modified in any way. The newly created policy has an ID that is a concatentation of all merged policy IDs.

Parameters:

policies - collection of policies to be merged. The collection must not contain 'null' elements!

Returns:

merged policy containing combination of policy alternatives stored in all input policies. If provided collection of policies is null or empty, returns null. If provided collection of policies contains only single policy, the policy is returned.