ReqRespListener

   
ReqRespListener javax.xml.messaging

JAXM 1.1; JWSDP 1.0
 public interface ReqRespListener {  // Public Instance Methods  public abstract javax.xml.soap.SOAPMessage onMessage( javax.xml.soap.SOAPMessage message);
} 

The ReqRespListener interface is implemented by a JAXMServlet subclass that receives a SOAP message to which it immediately creates a response. The onMessage( ) method is called whenever a message is received and is provided with a SOAPMessage object created from that message as its only argument. The return value from this method may be either null or a SOAPMessage that is returned to the originator of the request message.

For reasons mentioned in the description of the JAXMServlet class, a JAXM client that implements this interface may not behave as expected in the JAXM reference implementation. Specifically, the reply message returned from the onMessage( ) method is not delivered.


   
   
URLEndpoint javax.xml.messaging

JAXM 1.1; JWSDP 1.0
 public class URLEndpoint extends Endpoint {  // Public Constructors  public URLEndpoint( String url);  // Public Instance Methods  public String getURL(  ); 
} 

URLEndpoint is a subclass of Endpoint in which the URI that represents the endpoint address is expected to be a valid URL.

This class is used internally within the JAXM reference implementation to represent the addresses to which a URI used by a JAXM clients is mapped within the JAXM provider, since each such address must be the URL of the provider that will receive a message with that URI. From the viewpoint of a JAXM client, however, the URLEndpoint class is of no practical use, at least in the reference implementation, since neither of the profiles that it supports will accept a message destination that is a URL.

A URLEndpoint can be used by a SAAJ client in conjunction with the SOAPConnection send( ) method. However, it is simpler to use a string version of the URL instead.


   
   

Chapter 10. The javax.xml.namespace Package

Package javax.xml.namespace

QName


   
   
Package javax.xml.namespace JAX-RPC 1.0; JWSDP 1.0, J2EE 1.4

This package contains only a single class, QName , that represents a namespace-qualified XML element name . Theoretically, many of the XML APIs, including those that are not directly related to web services, could make use of this class. At the present time, however, it is used only by the packages that form the JAX-RPC API.

Classes

  public class  
   QName   
 implements Serializable; 

   
   
QName javax.xml.namespace

JAX-RPC 1.0; JWSDP 1.0, J2EE 1.4 serializable
 public class QName implements java.io.Serializable {  // Public Constructors  public QName( String   localPart   ); 
       public QName( String   namespaceURI   , String   localPart   );  // Public Class Methods  public static QName valueOf( String   s   );  // Public Instance Methods  public String getLocalPart(  ); 
    public String getNamespaceURI(  );  // Public Methods Overriding Object  public final boolean equals( Object   obj   ); 
    public final int hashCode(  ); 
    public String toString(  ); 
} 

This class represents an XML-qualified name . The two-argument constructor creates a QName object with a given local part and namespace URI. The one-argument constructor creates a QName object that does not have an explicitly specified namespace. An XML element associated with a QName that does not have an explicit namespace is considered to be in the default namespace that is in force for that element. The URI for the default namespace is determined by an xmlns attribute with no associated prefix, placed either on that element or on one of its ancestors .

The getLocalPart( ) and getNamespaceURI( ) methods return the local part and the namespace URI associated with the QName . In the case of a QName that does not have a namespace URI, the latter method returns an empty string. The toString( ) method creates a string representation of the QName as follows :

  • If the name does not have a namespace URI, then the value returned by toString( ) is just the local part of the name.

  • Otherwise, the value returned is {URI}localPart .

The static valueOf ( ) method accepts a string representation of a qualified name in the form returned by toString( ) and converts it to a QName object. For example, the result of the call QName.valueOf("{URI}localPart") is the same as using the constructor QName("URI ", " localPart") , whereas QName.valueOf("localPart") produces the same result as QName("localPart") . If the argument cannot be decoded as a QName , then a java.lang.IllegalArgumentException is thrown.

Passed To

Too many methods to list.

Returned By

QName.valueOf( ) , javax.xml.rpc.Call.{getOperationName( ) , getParameterTypeByName( ) , getPortTypeName( ) , getReturnType( )} , javax.xml.rpc.Service.getServiceName( ) , javax.xml.rpc.handler.GenericHandler.getHeaders( ) , javax.xml.rpc.handler.Handler.getHeaders( ) , javax.xml.rpc.handler.HandlerInfo.getHeaders( ) , javax.xml.rpc.soap.SOAPFaultException.getFaultCode( )

Type Of

javax.xml.rpc.encoding.XMLType.{SOAP_ARRAY , SOAP_BASE64 , SOAP_BOOLEAN , SOAP_BYTE , SOAP_DOUBLE , SOAP_FLOAT , SOAP_INT , SOAP_LONG , SOAP_SHORT , SOAP_STRING , XSD_BASE64 , XSD_BOOLEAN , XSD_BYTE , XSD_DATETIME , XSD_DECIMAL , XSD_DOUBLE , XSD_FLOAT , XSD_HEXBINARY , XSD_INT , XSD_INTEGER , XSD_LONG , XSD_QNAME , XSD_SHORT , XSD_STRING} , javax.xml.rpc.holders.QNameHolder.value