FileDocCategorySizeDatePackage
PolicyAssertionValidator.javaAPI DocExample6424Tue May 29 16:56:40 BST 2007com.sun.xml.ws.policy.spi

PolicyAssertionValidator

public interface PolicyAssertionValidator
author
Marek Potociar (marek.potociar at sun.com)

Fields Summary
Constructors Summary
Methods Summary
public java.lang.String[]declareSupportedDomains()
Each service provider that implements this SPI must make sure to identify all possible domains it supports. This operation must be implemented as idempotent (must return same values on multiple calls).

It is legal for two or more {@code PolicyAssertionValidator}s to support the same domain. In such case, the most significant result returned from validation methods will be eventually assigned to the assertion. The significance of validation results is as follows (from most to least significant):

  1. SUPPORTED
  2. UNSUPPORTED
  3. INVALID
  4. UNKNOWN

return
{@code String} array holding {@code String} representations of identifiers of all supported domains. Usually a domain identifier is represented by a namespace.

public com.sun.xml.ws.policy.spi.PolicyAssertionValidator$FitnessvalidateClientSide(com.sun.xml.ws.policy.PolicyAssertion assertion)
An implementation of this method must return:
  • {@code Fitness.UNKNOWN} if the policy assertion type is not recognized
  • {@code Fitness.SUPPORTED} if the policy assertion is supported in the client-side context
  • {@code Fitness.UNSUPPORTED} if the policy assertion is recognized however it's content is not supported. For each assetion that will be eventually marked with this validation value, the policy processor will log a WARNING message however an attempt to call the web service will be made.
  • {@code Fitness.INVALID} if the policy assertion is recognized however its content (value, parameters, nested assertions) is invalid. For each assetion that will be eventually marked with this validation value, the policy processor will log a SEVERE error and throw an exception. No further attempts to call the web service will be made.

param
assertion A policy asssertion (See {@link com.sun.xml.ws.policy.PolicyAssertion PolicyAssertion}). May contain nested policies and assertions.
return
fitness of the {@code assertion} on in the client-side context. Must not be {@code null}.

public com.sun.xml.ws.policy.spi.PolicyAssertionValidator$FitnessvalidateServerSide(com.sun.xml.ws.policy.PolicyAssertion assertion)
An implementation of this method must return:
  • {@code Fitness.UNKNOWN} if the policy assertion type is not recognized
  • {@code Fitness.SUPPORTED} if the policy assertion is supported in the server-side context
  • {@code Fitness.UNSUPPORTED} if the policy assertion is recognized however it's content is not supported.
  • {@code Fitness.INVALID} if the policy assertion is recognized however its content (value, parameters, nested assertions) is invalid.
For each assetion that will be eventually marked with validation value of UNKNOWN, UNSUPPORTED or INVALID, the policy processor will log a SEVERE error and throw an exception.

param
assertion A policy asssertion (See {@link com.sun.xml.ws.policy.PolicyAssertion PolicyAssertion}). May contain nested policies and assertions.
return
fitness of the {@code assertion} on in the server-side context. Must not be {@code null}.