org.apache.axis2.jaxws.spi.handler.BaseHandlerResolver Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of axis2-jaxws Show documentation
Show all versions of axis2-jaxws Show documentation
Axis2 JAXWS Implementation
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.axis2.jaxws.spi.handler;
import org.apache.axis2.java.security.AccessController;
import org.apache.axis2.jaxws.ExceptionFactory;
import org.apache.axis2.jaxws.description.impl.DescriptionUtils;
import org.apache.axis2.jaxws.description.xml.handler.HandlerChainType;
import org.apache.axis2.jaxws.description.xml.handler.HandlerChainsType;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import javax.xml.namespace.QName;
import javax.xml.ws.handler.HandlerResolver;
import javax.xml.ws.handler.PortInfo;
import java.io.InputStream;
import java.security.PrivilegedActionException;
import java.security.PrivilegedExceptionAction;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* This class can be subclassed to produce different implementations of {@link HandlerResolver}
*
*/
public abstract class BaseHandlerResolver implements HandlerResolver {
private static Log log = LogFactory.getLog(BaseHandlerResolver.class);
// TODO should probably use constants defined elsewhere
protected static final Map protocolBindingsMap =
new HashMap(5);
protected HandlerChainsType handlerChainsType;
protected BaseHandlerResolver() {
}
protected BaseHandlerResolver(String file) {
ClassLoader classLoader = this.getClass().getClassLoader();
String className = this.getClass().getName();
InputStream is =
DescriptionUtils.openHandlerConfigStream(file, className, classLoader);
if(is == null) {
log.warn("Unable to load handlers from file: " + file);
} else {
handlerChainsType = DescriptionUtils.loadHandlerChains(is, classLoader);
}
}
protected static boolean chainResolvesToPort(HandlerChainType hct, PortInfo portinfo) {
List protocolBindings = hct.getProtocolBindings();
if (protocolBindings != null) {
boolean match = true;
for (Iterator it = protocolBindings.iterator() ; it.hasNext();) {
match = false; // default to false in the protocol bindings until we find a match
String protocolBinding = it.next();
protocolBinding = protocolBinding.startsWith("##") ? protocolBindingsMap.get(protocolBinding) : protocolBinding;
// if the protocolBindingsMap returns null, it would mean someone has some nonsense ##binding
if ((protocolBinding != null) && (protocolBinding.equals(portinfo.getBindingID()))) {
match = true;
break;
}
}
if (match == false) {
// we've checked all the protocolBindings, but didn't find a match, no need to continue
return match;
}
}
/*
* need to figure out how to get the namespace declaration out of the port-name-pattern and service-name-pattern
*/
if (!doesPatternMatch(portinfo.getPortName(), hct.getPortNamePattern())) {
// we've checked the port-name-pattern, and didn't find a match, no need to continue
return false;
}
if (!doesPatternMatch(portinfo.getServiceName(), hct.getServiceNamePattern())) {
// we've checked the service-name-pattern, and didn't find a match, no need to continue
return false;
}
return true;
}
protected static Class loadClass(String clazz) throws ClassNotFoundException {
try {
return forName(clazz, true, getContextClassLoader());
} catch (ClassNotFoundException e) {
throw e;
}
}
/**
* Returns true of the specified qName matches the pattern.
* Some customers may have become dependent on the older
* algorithm. So first the "official" algorithm is used
* and if that fails, the older algorithm is used.
* @param qName QName
* @param pattern QName
* @return true or false
*/
public static boolean doesPatternMatch(QName qName, QName pattern) {
// Validate pattern only generates warnings if the pattern qname
// does not align with the specification.
validatePattern(pattern);
// Try the official pattern match algorithm
boolean match = doesPatternMatch_Official(qName, pattern);
// Customers may be dependent on the old algorithm, so this is retained.
if (!match) {
if (log.isDebugEnabled()) {
log.debug("The offical matching algorithm failed. Re-attempting with the prior algorithm");
}
match = doesPatternMatch_Old(qName, pattern);
if (log.isDebugEnabled()) {
log.debug("The old matching algorithm returns " + match);
}
}
return match;
}
/**
* The old match algorithm combines the namespace and localpart into
* a single string to do the matching. Unfortunately this will cause
* the pure wildcard (*) pattern to fail. And in addition, it may cause
* other patterns to succeed. Prefer the doesPatternMatch_Official algorithm
* @param portInfoQName
* @param pattern
* @return
*/
private static boolean doesPatternMatch_Old(QName portInfoQName, QName pattern) {
if (pattern == null)
return true;
// build up the strings according to the regular expression defined at http://java.sun.com/xml/ns/javaee/javaee_web_services_1_2.xsd
// use the prefix, not the literal namespace
String portInfoPrefix = portInfoQName.getNamespaceURI(); //Prefix();
String portInfoLocalPart = portInfoQName.getLocalPart();
String portInfoString = ((portInfoPrefix == null) || (portInfoPrefix.equals(""))) ? "" : portInfoPrefix + ":";
portInfoString += portInfoLocalPart;
String patternStringPrefix = pattern.getNamespaceURI(); //Prefix();
String patternInfoLocalPart = pattern.getLocalPart();
String patternString = ((patternStringPrefix == null) || (patternStringPrefix.equals(""))) ? "" : patternStringPrefix + ":";
patternString += patternInfoLocalPart;
// now match the portInfoQName to the user pattern
// But first, convert the user pattern to a regular expression. Remember, the only non-QName character allowed is "*", which
// is a wildcard, with obvious restrictions on what characters can match (for example, a .java filename cannot contain perentheses).
// We'll just use part of the above reg ex to form the appropriate restrictions on the user-specified "*" character:
Pattern userp = Pattern.compile(patternString.replace("*", "(\\w|\\.|-|_)*"));
Matcher userm = userp.matcher(portInfoString);
boolean match = userm.matches();
if (log.isDebugEnabled()) {
if (!match) {
log.debug("Pattern match failed: \"" + portInfoString + "\" does not match \"" + patternString + "\"");
} else {
log.debug("Pattern match succeeded: \"" + portInfoString + "\" matches \"" + patternString + "\"");
}
}
return match;
}
/**
* Determine if the indicated qname matches the pattern
* @param qName
* @param pattern
* @return
*/
private static boolean doesPatternMatch_Official(QName qName, QName pattern) {
if (log.isDebugEnabled()) {
log.debug("entry pattern=" + pattern + " qname=" + qName);
}
if (pattern == null) {
if (log.isDebugEnabled()) {
log.debug("Successful Match: Pattern is null");
}
return true;
}
// Do a pattern match on the local part of the qname.
String patternLocalPart = pattern.getLocalPart();
String localPart = qName.getLocalPart();
// Replace the wildcard (*) references in the QName with an appropriate regular expression.
String regEx = patternLocalPart.replace("*", "(\\w|\\.|-|_)*");
Pattern userp = Pattern.compile(regEx);
Matcher userm = userp.matcher(localPart);
boolean match = userm.matches();
if (!match) {
if (log.isDebugEnabled()) {
log.debug("No Match: The local name does not match the regex pattern: " + regEx);
}
return false;
}
// Now do the matching with the namespace.
// If the entire pattern is a wildcard (*), then all namespaces are acceptable.
// For example:
// *
//
// In such cases, the assumption is that the pattern namespace will be empty.
String patternNamespace = pattern.getNamespaceURI();
String namespace = qName.getNamespaceURI();
if (patternNamespace.length() == 0) { // By definition, a namespace will never be null.
if (log.isDebugEnabled()) {
log.debug("Successful Match: The local name matches and the pattern namespace is empty.");
}
return true;
}
// If a namespace is specified, it will be done via a prefix. For example:
// p:MyPortName
// Thus according to the current pattern structure there is no way to
// specify wildcards for the namespace portion of the match
if (patternNamespace.equals(namespace)) {
if (log.isDebugEnabled()) {
log.debug("Successful Match: The local names and namespaces match.");
}
return true;
}
if (log.isDebugEnabled()) {
log.debug("No Match");
}
return false;
}
private static void validatePattern(QName pattern) {
if (pattern == null) {
if (log.isDebugEnabled()) {
log.debug("The pattern qname is null. This is accepted and interpretted as a wildcard");
}
return;
}
String patternStringPrefix = pattern.getPrefix();
String patternInfoLocalPart = pattern.getLocalPart();
String patternString = ((patternStringPrefix == null) || (patternStringPrefix.equals(""))) ? "" : patternStringPrefix + ":";
patternString += patternInfoLocalPart;
/*
* Below pattern is ported from: http://java.sun.com/xml/ns/javaee/javaee_web_services_1_2.xsd
* Schema regular expressions are defined differently from Java regular expressions which are different from Perl regular
* expressions. I've converted the pattern defined in the above linked schema to its Java equivalent, as best as I can.
*
* Schema reg ex: "\*|([\i-[:]][\c-[:]]*:)?[\i-[:]][\c-[:]]*\*?"
* Java reg ex: "\\*|((\\w|_)(\\w|\\.|-|_)*:)?(\\w|_)(\\w|\\.|-|_)*\\*?"
*/
// first, confirm the defined pattern is legal
Pattern p = Pattern.compile("\\*|((\\w|_)(\\w|\\.|-|_)*:)?(\\w|_)(\\w|\\.|-|_)*\\*?");
Matcher m = p.matcher(patternString);
if (!m.matches()) {
// pattern defined by user in handler chain xml file is illegal -- report it but continue
log.warn("Pattern defined by user is illegal: \"" + patternString + "\" does not match regular expression in schema http://java.sun.com/xml/ns/javaee/javaee_web_services_1_2.xsd. Pattern matching should now be considered \"best-effort.\"");
}
}
/**
* Return the class for this name
*
* @return Class
*/
private static Class forName(final String className, final boolean initialize,
final ClassLoader classLoader) throws ClassNotFoundException {
// NOTE: This method must remain protected because it uses AccessController
Class cl = null;
try {
cl = (Class)AccessController.doPrivileged(
new PrivilegedExceptionAction() {
public Object run() throws ClassNotFoundException {
try{
if (log.isDebugEnabled()) {
log.debug("HandlerResolverImpl attempting to load Class: "+className);
}
return Class.forName(className, initialize, classLoader);
} catch (Throwable e) {
// TODO Should the exception be swallowed ?
if (log.isDebugEnabled()) {
log.debug("HandlerResolverImpl cannot load the following class Throwable Exception Occured: " + className);
}
throw new ClassNotFoundException("HandlerResolverImpl cannot load the following class Throwable Exception Occured:" + className);
}
}
}
);
} catch (PrivilegedActionException e) {
if (log.isDebugEnabled()) {
log.debug("Exception thrown from AccessController: " + e);
}
throw (ClassNotFoundException)e.getException();
}
return cl;
}
/** @return ClassLoader */
private static ClassLoader getContextClassLoader() {
// NOTE: This method must remain private because it uses AccessController
ClassLoader cl = null;
try {
cl = (ClassLoader)AccessController.doPrivileged(
new PrivilegedExceptionAction() {
public Object run() throws ClassNotFoundException {
return Thread.currentThread().getContextClassLoader();
}
}
);
} catch (PrivilegedActionException e) {
if (log.isDebugEnabled()) {
log.debug("Exception thrown from AccessController: " + e);
}
throw ExceptionFactory.makeWebServiceException(e.getException());
}
return cl;
}
static {
protocolBindingsMap.put("##SOAP11_HTTP", "http://schemas.xmlsoap.org/wsdl/soap/http");
protocolBindingsMap.put("##SOAP11_HTTP_MTOM", "http://schemas.xmlsoap.org/wsdl/soap/http?mtom=true");
protocolBindingsMap.put("##SOAP12_HTTP", "http://www.w3.org/2003/05/soap/bindings/HTTP/");
protocolBindingsMap.put("##SOAP12_HTTP_MTOM", "http://www.w3.org/2003/05/soap/bindings/HTTP/?mtom=true");
protocolBindingsMap.put("##XML_HTTP", "http://www.w3.org/2004/08/wsdl/http");
}
}