1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/src/share/jaxws_classes/com/sun/xml/internal/ws/policy/spi/AbstractQNameValidator.java Wed Apr 27 01:27:09 2016 +0800
1.3 @@ -0,0 +1,113 @@
1.4 +/*
1.5 + * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
1.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
1.7 + *
1.8 + * This code is free software; you can redistribute it and/or modify it
1.9 + * under the terms of the GNU General Public License version 2 only, as
1.10 + * published by the Free Software Foundation. Oracle designates this
1.11 + * particular file as subject to the "Classpath" exception as provided
1.12 + * by Oracle in the LICENSE file that accompanied this code.
1.13 + *
1.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
1.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
1.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1.17 + * version 2 for more details (a copy is included in the LICENSE file that
1.18 + * accompanied this code).
1.19 + *
1.20 + * You should have received a copy of the GNU General Public License version
1.21 + * 2 along with this work; if not, write to the Free Software Foundation,
1.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
1.23 + *
1.24 + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
1.25 + * or visit www.oracle.com if you need additional information or have any
1.26 + * questions.
1.27 + */
1.28 +
1.29 +package com.sun.xml.internal.ws.policy.spi;
1.30 +
1.31 +import com.sun.xml.internal.ws.policy.PolicyAssertion;
1.32 +import java.util.Collection;
1.33 +import java.util.HashSet;
1.34 +import java.util.Set;
1.35 +import javax.xml.namespace.QName;
1.36 +
1.37 +/**
1.38 + * This abstract policy assertion validator validates assertions by their qualified
1.39 + * name. Server and client side validation methods return {@link Fitness} based on
1.40 + * following schema:
1.41 + *
1.42 + * <ul>
1.43 + * <li>{@link Fitness#SUPPORTED} - if the assertion qualified name is in the list of
1.44 + * supported assertion names on the server/client side</li>
1.45 + * <li>{@link Fitness#UNSUPPORTED} - if the assertion qualified name is not in the list of
1.46 + * supported assertion names on the server/client side, however it is in the list of
1.47 + * assertion names supported on the other side</li>
1.48 + * <li>{@link Fitness#UNKNOWN} - if the assertion qualified name is not present in the any of
1.49 + * the lists of supported assertion names</li>
1.50 + * </ul>
1.51 + *
1.52 + * For some domains such validation may be sufficient enough. Other domains may
1.53 + * use functionality of this base class as a first step validation before any attempts
1.54 + * to validate content of the assertion. To do this one needs to override and reuse
1.55 + * the default behavior of {@link #validateClientSide(PolicyAssertion)} and
1.56 + * {@link #validateServerSide(PolicyAssertion)} methods.
1.57 + *
1.58 + * @author Marek Potociar (marek.potociar at sun.com)
1.59 + */
1.60 +public abstract class AbstractQNameValidator implements PolicyAssertionValidator {
1.61 + private final Set<String> supportedDomains = new HashSet<String>();
1.62 + private final Collection<QName> serverAssertions;
1.63 + private final Collection<QName> clientAssertions;
1.64 +
1.65 + /**
1.66 + * Constructor that takes two collections specifying qualified names of assertions
1.67 + * supported on either server or client side. The set of all assertion namespaces
1.68 + * defines list of all domains supported by the assertion validator
1.69 + * (see {@link PolicyAssertionValidator#declareSupportedDomains}).
1.70 + *
1.71 + * @param serverSideAssertions The server-side assertions.
1.72 + * @param clientSideAssertions The client-side assertions.
1.73 + */
1.74 + protected AbstractQNameValidator(Collection<QName> serverSideAssertions, Collection<QName> clientSideAssertions) {
1.75 + if (serverSideAssertions != null) {
1.76 + this.serverAssertions = new HashSet<QName>(serverSideAssertions);
1.77 + for (QName assertion : this.serverAssertions) {
1.78 + supportedDomains.add(assertion.getNamespaceURI());
1.79 + }
1.80 + } else {
1.81 + this.serverAssertions = new HashSet<QName>(0);
1.82 + }
1.83 +
1.84 + if (clientSideAssertions != null) {
1.85 + this.clientAssertions = new HashSet<QName>(clientSideAssertions);
1.86 + for (QName assertion : this.clientAssertions) {
1.87 + supportedDomains.add(assertion.getNamespaceURI());
1.88 + }
1.89 + } else {
1.90 + this.clientAssertions = new HashSet<QName>(0);
1.91 + }
1.92 + }
1.93 +
1.94 + public String[] declareSupportedDomains() {
1.95 + return supportedDomains.toArray(new String[supportedDomains.size()]);
1.96 + }
1.97 +
1.98 + public Fitness validateClientSide(PolicyAssertion assertion) {
1.99 + return validateAssertion(assertion, clientAssertions, serverAssertions);
1.100 + }
1.101 +
1.102 + public Fitness validateServerSide(PolicyAssertion assertion) {
1.103 + return validateAssertion(assertion, serverAssertions, clientAssertions);
1.104 + }
1.105 +
1.106 + private Fitness validateAssertion(PolicyAssertion assertion, Collection<QName> thisSideAssertions, Collection<QName> otherSideAssertions) {
1.107 + QName assertionName = assertion.getName();
1.108 + if (thisSideAssertions.contains(assertionName)) {
1.109 + return Fitness.SUPPORTED;
1.110 + } else if (otherSideAssertions.contains(assertionName)) {
1.111 + return Fitness.UNSUPPORTED;
1.112 + } else {
1.113 + return Fitness.UNKNOWN;
1.114 + }
1.115 + }
1.116 +}
