--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnection.java 2015-07-09 12:13:56.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnection.java 2015-07-09 12:13:56.000000000 +0200 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -32,18 +32,18 @@ *
* The SOAPConnection class is optional. Some implementations may
* not implement this interface in which case the call to
- * SOAPConnectionFactory.newInstance()
(see below) will
- * throw an UnsupportedOperationException
.
+ * {@code SOAPConnectionFactory.newInstance()} (see below) will
+ * throw an {@code UnsupportedOperationException}.
*
- * A client can obtain a SOAPConnection
object using a
+ * A client can obtain a {@code SOAPConnection} object using a
* {@link SOAPConnectionFactory} object as in the following example:
- *
+ *+ * A {@code SOAPConnection} object can be used to send messages * directly to a URL following the request/response paradigm. That is, - * messages are sent using the method{@code * SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance(); * SOAPConnection con = factory.createConnection(); - *- * ASOAPConnection
object can be used to send messages + * }
call
, which sends the
+ * messages are sent using the method {@code call}, which sends the
* message and then waits until it gets a reply.
*
* @since 1.6
@@ -54,15 +54,15 @@
* Sends the given message to the specified endpoint and blocks until
* it has returned the response.
*
- * @param request the SOAPMessage
object to be sent
- * @param to an Object
that identifies
+ * @param request the {@code SOAPMessage} object to be sent
+ * @param to an {@code Object} that identifies
* where the message should be sent. It is required to
* support Objects of type
- * java.lang.String
,
- * java.net.URL
, and when JAXM is present
- * javax.xml.messaging.URLEndpoint
+ * {@code java.lang.String},
+ * {@code java.net.URL}, and when JAXM is present
+ * {@code javax.xml.messaging.URLEndpoint}
*
- * @return the SOAPMessage
object that is the response to the
+ * @return the {@code SOAPMessage} object that is the response to the
* message that was sent
* @throws SOAPException if there is a SOAP error
*/
@@ -72,12 +72,12 @@
/**
* Gets a message from a specific endpoint and blocks until it receives,
*
- * @param to an Object
that identifies where
+ * @param to an {@code Object} that identifies where
* the request should be sent. Objects of type
- * java.lang.String
and
- * java.net.URL
must be supported.
+ * {@code java.lang.String} and
+ * {@code java.net.URL} must be supported.
*
- * @return the SOAPMessage
object that is the response to the
+ * @return the {@code SOAPMessage} object that is the response to the
* get message request
* @throws SOAPException if there is a SOAP error
* @since 1.6, SAAJ 1.3
@@ -88,7 +88,7 @@
}
/**
- * Closes this SOAPConnection
object.
+ * Closes this {@code SOAPConnection} object.
*
* @throws SOAPException if there is a SOAP error
*/