javax.xml.soap.SOAPConnectionFactory Maven / Gradle / Ivy
/*
* 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 javax.xml.soap;
/**
* A factory for creating SOAPConnection objects. Implementation of this class is
* optional. If SOAPConnectionFactory.newInstance() throws an
* UnsupportedOperationException then the implementation does not support the SAAJ
* communication infrastructure. Otherwise SOAPConnection objects can be created by
* calling createConnection() on the newly created SOAPConnectionFactory
* object.
*/
public abstract class SOAPConnectionFactory {
public SOAPConnectionFactory() {
}
/**
* Creates an instance of the default SOAPConnectionFactory object.
*
* @return a new instance of a default SOAPConnectionFactory object
* @throws SOAPException if there was an error creating the SOAPConnectionFactory
* @throws UnsupportedOperationException if newInstance is not supported.
*/
public static SOAPConnectionFactory newInstance()
throws SOAPException, UnsupportedOperationException {
try {
return (SOAPConnectionFactory)FactoryFinder.find(SOAPConnectionFactory.class,
DEFAULT_SOAP_CONNECTION_FACTORY);
} catch (Exception exception) {
throw new SOAPException("Unable to create SOAP connection factory: "
+ exception.getMessage());
}
}
/**
* Create a new SOAPConnection.
*
* @return the new SOAPConnection object.
* @throws SOAPException if there was an exception creating the SOAPConnection
* object.
*/
public abstract SOAPConnection createConnection() throws SOAPException;
private static final String DEFAULT_SOAP_CONNECTION_FACTORY =
"org.apache.axis2.saaj.SOAPConnectionFactoryImpl";
}