author | mkos |
Fri, 27 Nov 2015 11:28:43 +0100 | |
changeset 34467 | 024f1ce7da02 |
parent 31746 | 7573de6b8e46 |
permissions | -rw-r--r-- |
12009 | 1 |
/* |
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
2 |
* Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. |
12009 | 3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 |
* |
|
5 |
* This code is free software; you can redistribute it and/or modify it |
|
6 |
* under the terms of the GNU General Public License version 2 only, as |
|
7 |
* published by the Free Software Foundation. Oracle designates this |
|
8 |
* particular file as subject to the "Classpath" exception as provided |
|
9 |
* by Oracle in the LICENSE file that accompanied this code. |
|
10 |
* |
|
11 |
* This code is distributed in the hope that it will be useful, but WITHOUT |
|
12 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
13 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
14 |
* version 2 for more details (a copy is included in the LICENSE file that |
|
15 |
* accompanied this code). |
|
16 |
* |
|
17 |
* You should have received a copy of the GNU General Public License version |
|
18 |
* 2 along with this work; if not, write to the Free Software Foundation, |
|
19 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
20 |
* |
|
21 |
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
22 |
* or visit www.oracle.com if you need additional information or have any |
|
23 |
* questions. |
|
24 |
*/ |
|
25 |
||
26 |
package javax.xml.soap; |
|
27 |
||
28 |
/** |
|
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
29 |
* A factory for creating {@code SOAPConnection} objects. Implementation of this class |
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
30 |
* is optional. If {@code SOAPConnectionFactory.newInstance()} throws an |
12009 | 31 |
* UnsupportedOperationException then the implementation does not support the |
32 |
* SAAJ communication infrastructure. Otherwise {@link SOAPConnection} objects |
|
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
33 |
* can be created by calling {@code createConnection()} on the newly |
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
34 |
* created {@code SOAPConnectionFactory} object. |
25840 | 35 |
* |
36 |
* @since 1.6 |
|
12009 | 37 |
*/ |
38 |
public abstract class SOAPConnectionFactory { |
|
34467
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
39 |
|
12009 | 40 |
/** |
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
41 |
* A constant representing the default value for a {@code SOAPConnection} |
12009 | 42 |
* object. The default is the point-to-point SOAP connection. |
43 |
*/ |
|
34467
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
44 |
private static final String DEFAULT_SOAP_CONNECTION_FACTORY |
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
45 |
= "com.sun.xml.internal.messaging.saaj.client.p2p.HttpSOAPConnectionFactory"; |
12009 | 46 |
|
47 |
/** |
|
48 |
* Creates an instance of the default |
|
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
49 |
* {@code SOAPConnectionFactory} object. |
12009 | 50 |
* |
34467
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
51 |
* This method uses the lookup procedure specified in {@link javax.xml.soap} to locate and load the |
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
52 |
* {@link javax.xml.soap.SOAPConnectionFactory} class. |
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
53 |
* |
12009 | 54 |
* @return a new instance of a default |
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
55 |
* {@code SOAPConnectionFactory} object |
12009 | 56 |
* |
57 |
* @exception SOAPException if there was an error creating the |
|
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
58 |
* {@code SOAPConnectionFactory} |
12009 | 59 |
* |
60 |
* @exception UnsupportedOperationException if newInstance is not |
|
61 |
* supported. |
|
62 |
*/ |
|
63 |
public static SOAPConnectionFactory newInstance() |
|
64 |
throws SOAPException, UnsupportedOperationException |
|
65 |
{ |
|
66 |
try { |
|
34467
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
67 |
return FactoryFinder.find( |
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
68 |
SOAPConnectionFactory.class, |
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
69 |
DEFAULT_SOAP_CONNECTION_FACTORY, |
024f1ce7da02
8131334: SAAJ Plugability Layer: using java.util.ServiceLoader
mkos
parents:
31746
diff
changeset
|
70 |
true); |
12009 | 71 |
} catch (Exception ex) { |
72 |
throw new SOAPException("Unable to create SOAP connection factory: " |
|
73 |
+ex.getMessage()); |
|
74 |
} |
|
75 |
} |
|
76 |
||
77 |
/** |
|
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
78 |
* Create a new {@code SOAPConnection}. |
12009 | 79 |
* |
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
80 |
* @return the new {@code SOAPConnection} object. |
12009 | 81 |
* |
82 |
* @exception SOAPException if there was an exception creating the |
|
31746
7573de6b8e46
8130753: Sync-up javadoc changes in jax-ws area - includes JAX-B API, JAX-WS API, SAAJ-API
mkos
parents:
28326
diff
changeset
|
83 |
* {@code SOAPConnection} object. |
12009 | 84 |
*/ |
85 |
public abstract SOAPConnection createConnection() |
|
86 |
throws SOAPException; |
|
87 |
} |