SOAPConnection (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.xml.soap Class SOAPConnection

java.lang.Object
  extended by javax.xml.soap.SOAPConnection

public abstract class SOAPConnection
extends Object

A point-to-point connection that a client can use for sending messages directly to a remote party (represented by a URL, for instance).

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.

A client can obtain a SOAPConnection object using a SOAPConnectionFactory object as in the following example:

      SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance();
      SOAPConnection con = factory.createConnection();
 
A 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 call, which sends the message and then waits until it gets a reply.


构造器摘要
SOAPConnection()
           
 
方法摘要
abstract  SOAPMessage call(SOAPMessage request, Object to)
          Sends the given message to the specified endpoint and blocks until it has returned the response.
abstract  void close()
          Closes this SOAPConnection object.
 SOAPMessage get(Object to)
          Gets a message from a specific endpoint and blocks until it receives,
 
类方法继承 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造器详细信息

SOAPConnection

public SOAPConnection()
方法详细信息

call

public abstract SOAPMessage call(SOAPMessage request,
                                 Object to)
                          throws SOAPException
Sends the given message to the specified endpoint and blocks until it has returned the response.

参数:
request - the SOAPMessage object to be sent
to - an 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
返回:
the SOAPMessage object that is the response to the message that was sent
抛出异常:
SOAPException - if there is a SOAP error

get

public SOAPMessage get(Object to)
                throws SOAPException
Gets a message from a specific endpoint and blocks until it receives,

参数:
to - an Object that identifies where the request should be sent. Objects of type java.lang.String and java.net.URL must be supported.
返回:
the SOAPMessage object that is the response to the get message request
抛出异常:
SOAPException - if there is a SOAP error
从以下版本开始:
SAAJ 1.3

close

public abstract void close()
                    throws SOAPException
Closes this SOAPConnection object.

抛出异常:
SOAPException - if there is a SOAP error

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.