/**
* 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.cxf.transport.http;
import java.io.IOException;
import java.net.MalformedURLException;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Set;
import javax.annotation.PostConstruct;
import javax.annotation.Resource;
import javax.wsdl.Port;
import javax.wsdl.extensions.http.HTTPAddress;
import javax.wsdl.extensions.soap.SOAPAddress;
import javax.xml.namespace.QName;
import org.apache.cxf.Bus;
import org.apache.cxf.configuration.Configurer;
import org.apache.cxf.configuration.jsse.TLSClientParameters;
import org.apache.cxf.service.Service;
import org.apache.cxf.service.model.BindingInfo;
import org.apache.cxf.service.model.EndpointInfo;
import org.apache.cxf.service.model.ServiceInfo;
import org.apache.cxf.transport.AbstractTransportFactory;
import org.apache.cxf.transport.Conduit;
import org.apache.cxf.transport.ConduitInitiator;
import org.apache.cxf.transport.ConduitInitiatorManager;
import org.apache.cxf.transport.https.HttpsURLConnectionFactory;
import org.apache.cxf.ws.addressing.EndpointReferenceType;
import org.apache.cxf.wsdl11.WSDLEndpointFactory;
import org.xmlsoap.schemas.wsdl.http.AddressType;
/**
* As a ConduitInitiator, this class sets up new HTTPConduits for particular
* endpoints.
*
* TODO: Document WSDLEndpointFactory
*
*/
public abstract class AbstractHTTPTransportFactory
extends AbstractTransportFactory
implements ConduitInitiator, WSDLEndpointFactory {
/**
* This constant holds the prefixes served by this factory.
*/
private static final Set<String> URI_PREFIXES = new HashSet<String>();
static {
URI_PREFIXES.add("http://");
URI_PREFIXES.add("https://");
}
/**
* The CXF Bus which this HTTPTransportFactory
* is governed.
*/
protected Bus bus;
/**
* This collection contains "activationNamespaces" which is synominous
* with "transportId"s.
*/
protected Collection<String> activationNamespaces;
/**
* This method is used by Spring to inject the bus.
* @param b The CXF bus.
*/
@Resource(name = "bus")
public void setBus(Bus b) {
bus = b;
}
/**
* This method returns the CXF Bus under which this HTTPTransportFactory
* is governed.
*/
public Bus getBus() {
return bus;
}
/**
* This call is used by CXF ExtensionManager to inject the activationNamespaces
* @param ans The transport ids.
*/
public void setActivationNamespaces(Collection<String> ans) {
activationNamespaces = ans;
}
/**
* This call gets called after this class is instantiated by Spring.
* It registers itself as a ConduitInitiator and DestinationFactory under
* the many names that are considered "transportIds" (which are currently
* named "activationNamespaces").
*/
@PostConstruct
public void registerWithBindingManager() {
if (null == bus) {
return;
}
if (getTransportIds() == null) {
setTransportIds(new ArrayList<String>(activationNamespaces));
} else if (activationNamespaces == null) {
activationNamespaces = getTransportIds();
}
ConduitInitiatorManager cim = bus.getExtension(ConduitInitiatorManager.class);
//Note, activationNamespaces can be null
if (null != cim && null != activationNamespaces) {
for (String ns : activationNamespaces) {
cim.registerConduitInitiator(ns, this);
}
}
}
/**
* This call creates a new HTTPConduit for the endpoint. It is equivalent
* to calling getConduit without an EndpointReferenceType.
*/
public Conduit getConduit(EndpointInfo endpointInfo) throws IOException {
return getConduit(endpointInfo, endpointInfo.getTarget());
}
/**
* This call creates a new HTTP Conduit based on the EndpointInfo and
* EndpointReferenceType.
* TODO: What are the formal constraints on EndpointInfo and
* EndpointReferenceType values?
*/
public Conduit getConduit(
EndpointInfo endpointInfo,
EndpointReferenceType target
) throws IOException {
HTTPConduit conduit = target == null
? new HTTPConduit(bus, endpointInfo)
: new HTTPConduit(bus, endpointInfo, target);
// Spring configure the conduit.
configure(conduit);
conduit.finalizeConfig();
return conduit;
}
public EndpointInfo createEndpointInfo(
ServiceInfo serviceInfo,
BindingInfo b,
Port port
) {
if (port != null) {
List ees = port.getExtensibilityElements();
for (Iterator itr = ees.iterator(); itr.hasNext();) {
Object extensor = itr.next();
if (extensor instanceof HTTPAddress) {
final HTTPAddress httpAdd = (HTTPAddress)extensor;
EndpointInfo info = new HttpEndpointInfo(serviceInfo,
"http://schemas.xmlsoap.org/wsdl/http/");
info.setAddress(httpAdd.getLocationURI());
info.addExtensor(httpAdd);
return info;
} else if (extensor instanceof AddressType) {
final AddressType httpAdd = (AddressType)extensor;
EndpointInfo info =
new HttpEndpointInfo(serviceInfo,
"http://schemas.xmlsoap.org/wsdl/http/");
info.setAddress(httpAdd.getLocation());
info.addExtensor(httpAdd);
return info;
}
}
}
HttpEndpointInfo hei = new HttpEndpointInfo(serviceInfo,
"http://schemas.xmlsoap.org/wsdl/http/");
AddressType at = new HttpAddressType();
hei.addExtensor(at);
return hei;
}
public void createPortExtensors(EndpointInfo ei, Service service) {
// TODO
}
public Set<String> getUriPrefixes() {
return URI_PREFIXES;
}
/**
* This call uses the Configurer from the bus to configure
* a bean.
*
* @param bean
*/
protected void configure(Object bean) {
Configurer configurer = bus.getExtension(Configurer.class);
if (null != configurer) {
configurer.configureBean(bean);
}
}
/**
* This static call creates a connection factory based on
* the existence of the SSL (TLS) client side configuration.
*/
static HttpURLConnectionFactory getConnectionFactory(
HTTPConduit configuredConduit
) {
HttpURLConnectionFactory fac = null;
boolean useHttps = false;
try {
String address = configuredConduit.getAddress();
if (address != null
&& address.startsWith(HttpsURLConnectionFactory.HTTPS_URL_PROTOCOL_ID + ":/")) {
useHttps = true;
}
} catch (MalformedURLException e) {
//ignore, just use info based on Tls
}
if (useHttps
|| configuredConduit.getTlsClientParameters() != null) {
TLSClientParameters params = configuredConduit.getTlsClientParameters();
if (params == null) {
params = new TLSClientParameters(); //use defaults
}
fac = new HttpsURLConnectionFactory(params);
} else {
fac = new HttpURLConnectionFactoryImpl();
}
return fac;
}
private static class HttpEndpointInfo extends EndpointInfo {
AddressType saddress;
HttpEndpointInfo(ServiceInfo serv, String trans) {
super(serv, trans);
}
public void setAddress(String s) {
super.setAddress(s);
if (saddress != null) {
saddress.setLocation(s);
}
}
public void addExtensor(Object el) {
super.addExtensor(el);
if (el instanceof AddressType) {
saddress = (AddressType)el;
}
}
}
private static class HttpAddressType extends AddressType
implements HTTPAddress, SOAPAddress {
public HttpAddressType() {
super();
setElementType(new QName("http://schemas.xmlsoap.org/wsdl/soap/", "address"));
}
public String getLocationURI() {
return getLocation();
}
public void setLocationURI(String locationURI) {
setLocation(locationURI);
}
}
}