src/share/jaxws_classes/com/sun/xml/internal/ws/api/policy/PolicyResolver.java

Wed, 12 Jun 2013 14:47:09 +0100

author
mkos
date
Wed, 12 Jun 2013 14:47:09 +0100
changeset 384
8f2986ff0235
parent 368
0989ad8c0860
child 637
9c07ef4934dd
permissions
-rw-r--r--

8013021: Rebase 8005432 & 8003542 against the latest jdk8/jaxws
8003542: Improve processing of MTOM attachments
8005432: Update access to JAX-WS
Reviewed-by: mullan

ohair@286 1 /*
alanb@368 2 * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
ohair@286 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ohair@286 4 *
ohair@286 5 * This code is free software; you can redistribute it and/or modify it
ohair@286 6 * under the terms of the GNU General Public License version 2 only, as
ohair@286 7 * published by the Free Software Foundation. Oracle designates this
ohair@286 8 * particular file as subject to the "Classpath" exception as provided
ohair@286 9 * by Oracle in the LICENSE file that accompanied this code.
ohair@286 10 *
ohair@286 11 * This code is distributed in the hope that it will be useful, but WITHOUT
ohair@286 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ohair@286 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
ohair@286 14 * version 2 for more details (a copy is included in the LICENSE file that
ohair@286 15 * accompanied this code).
ohair@286 16 *
ohair@286 17 * You should have received a copy of the GNU General Public License version
ohair@286 18 * 2 along with this work; if not, write to the Free Software Foundation,
ohair@286 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ohair@286 20 *
ohair@286 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@286 22 * or visit www.oracle.com if you need additional information or have any
ohair@286 23 * questions.
ohair@286 24 */
ohair@286 25
ohair@286 26 package com.sun.xml.internal.ws.api.policy;
ohair@286 27
ohair@286 28 import com.sun.xml.internal.ws.policy.PolicyMap;
ohair@286 29 import com.sun.xml.internal.ws.policy.PolicyMapMutator;
ohair@286 30 import com.sun.xml.internal.ws.api.server.Container;
ohair@286 31 import com.sun.istack.internal.Nullable;
ohair@286 32 import java.util.Arrays;
ohair@286 33 import java.util.Collection;
ohair@286 34 import javax.xml.ws.WebServiceException;
ohair@286 35
ohair@286 36 /**
ohair@286 37 * PolicyResolver will be used to resolve the PolicyMap created by configuration understood by JAX-WS.
ohair@286 38 *
ohair@286 39 * Extensions of this can return effective PolicyMap after merge policies from other configurations.
ohair@286 40 * @author Rama Pulavarthi
ohair@286 41 */
ohair@286 42 public interface PolicyResolver {
ohair@286 43 /**
ohair@286 44 * Creates a PolicyResolver
ohair@286 45 *
ohair@286 46 * @param context
ohair@286 47 * ServerContext that captures information useful for resolving Policy on server-side
ohair@286 48 *
ohair@286 49 * @return
ohair@286 50 * A PolicyMap with single policy alternative that gets created after consulting various configuration models.
ohair@286 51 *
ohair@286 52 * @throws WebServiceException
ohair@286 53 * If resolution failed
ohair@286 54 */
ohair@286 55 PolicyMap resolve(ServerContext context) throws WebServiceException;
ohair@286 56
ohair@286 57 /**
ohair@286 58 * Creates a PolicyResolver
ohair@286 59 *
ohair@286 60 * @param context
ohair@286 61 * ServerContext that captures information useful for resolving Policy on client-side
ohair@286 62 *
ohair@286 63 * @return
ohair@286 64 * A PolicyMap with single policy alternative that gets created after consulting various configuration models.
ohair@286 65 *
ohair@286 66 * @throws WebServiceException
ohair@286 67 * If resolution failed
ohair@286 68 */
ohair@286 69 PolicyMap resolve(ClientContext context) throws WebServiceException;
ohair@286 70
ohair@286 71 public class ServerContext {
ohair@286 72 private final PolicyMap policyMap;
ohair@286 73 private final Class endpointClass;
ohair@286 74 private final Container container;
ohair@286 75 private final boolean hasWsdl;
ohair@286 76 private final Collection<PolicyMapMutator> mutators;
ohair@286 77
ohair@286 78 /**
ohair@286 79 * The abstraction of PolicyMap is not finalized, and will change in few months. It is highly discouraged to use
ohair@286 80 * PolicyMap until it is finalized.
ohair@286 81 *
ohair@286 82 * In presence of WSDL, JAX-WS by default creates PolicyMap from Policy Attachemnts in WSDL.
ohair@286 83 * In absense of WSDL, JAX-WS creates PolicyMap from WebServiceFeatures configured on the endpoint implementation
ohair@286 84 *
ohair@286 85 * @param policyMap
ohair@286 86 * PolicyMap created from PolicyAttachments in WSDL or Feature annotations on endpoint implementation class.
ohair@286 87 * @param container
ohair@286 88 * @param endpointClass
ohair@286 89 * @param mutators
ohair@286 90 * List of PolicyMapMutators that are run eventually when a PolicyMap is created
ohair@286 91 */
ohair@286 92 public ServerContext(@Nullable PolicyMap policyMap, Container container,
ohair@286 93 Class endpointClass, final PolicyMapMutator... mutators) {
ohair@286 94 this.policyMap = policyMap;
ohair@286 95 this.endpointClass = endpointClass;
ohair@286 96 this.container = container;
ohair@286 97 this.hasWsdl = true;
ohair@286 98 this.mutators = Arrays.asList(mutators);
ohair@286 99 }
ohair@286 100
ohair@286 101 /**
ohair@286 102 * The abstraction of PolicyMap is not finalized, and will change in few months. It is highly discouraged to use
ohair@286 103 * PolicyMap until it is finalized.
ohair@286 104 *
ohair@286 105 * In presence of WSDL, JAX-WS by default creates PolicyMap from Policy Attachemnts in WSDL.
ohair@286 106 * In absense of WSDL, JAX-WS creates PolicyMap from WebServiceFeatures configured on the endpoint implementation
ohair@286 107 *
ohair@286 108 * @param policyMap
ohair@286 109 * PolicyMap created from PolicyAttachments in WSDL or Feature annotations on endpoint implementation class.
ohair@286 110 * @param container
ohair@286 111 * @param endpointClass
ohair@286 112 * @param hasWsdl Set to true, if this service is bundled with WSDL, false otherwise
ohair@286 113 * @param mutators
ohair@286 114 * List of PolicyMapMutators that are run eventually when a PolicyMap is created
ohair@286 115 */
ohair@286 116 public ServerContext(@Nullable PolicyMap policyMap, Container container,
ohair@286 117 Class endpointClass, boolean hasWsdl, final PolicyMapMutator... mutators) {
ohair@286 118 this.policyMap = policyMap;
ohair@286 119 this.endpointClass = endpointClass;
ohair@286 120 this.container = container;
ohair@286 121 this.hasWsdl = hasWsdl;
ohair@286 122 this.mutators = Arrays.asList(mutators);
ohair@286 123 }
ohair@286 124
ohair@286 125 public @Nullable PolicyMap getPolicyMap() {
ohair@286 126 return policyMap;
ohair@286 127 }
ohair@286 128
ohair@286 129 public @Nullable Class getEndpointClass() {
ohair@286 130 return endpointClass;
ohair@286 131 }
ohair@286 132
ohair@286 133 public Container getContainer() {
ohair@286 134 return container;
ohair@286 135 }
ohair@286 136
ohair@286 137 /**
ohair@286 138 * Return true, if this service is bundled with WSDL, false otherwise
ohair@286 139 * @return
ohair@286 140 */
ohair@286 141 public boolean hasWsdl() {
ohair@286 142 return hasWsdl;
ohair@286 143 }
ohair@286 144
ohair@286 145 public Collection<PolicyMapMutator> getMutators() {
ohair@286 146 return mutators;
ohair@286 147 }
ohair@286 148 }
ohair@286 149
ohair@286 150 public class ClientContext {
ohair@286 151 private PolicyMap policyMap;
ohair@286 152 private Container container;
ohair@286 153
ohair@286 154 /**
ohair@286 155 * The abstraction of PolicyMap is not finalized, and will change in few months. It is highly discouraged to use
ohair@286 156 * PolicyMap until it is finalized.
ohair@286 157 *
ohair@286 158 * In presence of WSDL, JAX-WS by default creates PolicyMap from Policy Attachemnts in WSDL.
ohair@286 159 *
ohair@286 160 * @param policyMap PolicyMap created from PolicyAttachemnts in WSDL
ohair@286 161 * @param container
ohair@286 162 */
ohair@286 163 public ClientContext(@Nullable PolicyMap policyMap, Container container) {
ohair@286 164 this.policyMap = policyMap;
ohair@286 165 this.container = container;
ohair@286 166 }
ohair@286 167
ohair@286 168 public @Nullable PolicyMap getPolicyMap() {
ohair@286 169 return policyMap;
ohair@286 170 }
ohair@286 171
ohair@286 172 public Container getContainer() {
ohair@286 173 return container;
ohair@286 174 }
ohair@286 175 }
ohair@286 176 }

mercurial