javax.xml.ws.addressing
Class AddressingBuilder

java.lang.Object
  extended by javax.xml.ws.addressing.AddressingBuilder
All Implemented Interfaces:
AddressingType
Direct Known Subclasses:
SOAPAddressingBuilder

public abstract class AddressingBuilder
extends java.lang.Object
implements AddressingType

Factory for AddressingElements. Implementing classes must supply a 0-arguments constructor.

A new instance of AddressingBuilder is created as:

 AddressingBuilder.newInstance();

Version:
JAX-WSA 1.0
Author:
JAX-WSA Development Team

Constructor Summary
protected AddressingBuilder()
          Non-public constructor.
 
Method Summary
abstract  AddressingConstants newAddressingConstants()
          Returns an instance of javax.ws.addressing.AddressingConstants
abstract  AddressingProperties newAddressingProperties()
          Returns an instance of javax.ws.addressing.AddressingProperties
abstract  EndpointReference newEndpointReference(java.lang.String uri)
          Returns an instance of javax.ws.addressing.EndpointReference
abstract  EndpointReference newEndpointReference(java.net.URI uri)
          Returns an instance of javax.ws.addressing.EndpointReference
static AddressingBuilder newInstance()
          Creates a new instance of AddressingBuilder.
abstract  AttributedQName newQName(javax.xml.namespace.QName name)
          Returns an instance of javax.ws.addressing.AttributedQName initialized using the specified QName.
abstract  AttributedQName newQName(java.lang.String namespace, java.lang.String localname)
          Returns an instance of javax.ws.addressing.AttributedQName initialized using the specified QName.
abstract  Relationship newRelationship(java.lang.String uri)
          Returns an instance of javax.ws.addressing.Relationship whose ID property is initialized with the given URI.
abstract  Relationship newRelationship(java.net.URI uri)
          Returns an instance of javax.ws.addressing.Relationship whose ID property is initialized with the given URI.
abstract  AttributedURI newURI(java.lang.String uri)
          Returns an instance of javax.ws.addressing.AttributedURI initialized with the given String.
abstract  AttributedURI newURI(java.net.URI uri)
          Returns an instance of javax.ws.addressing.AttributedURI initialized with the given URI.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.xml.ws.addressing.AddressingType
getNamespaceURI
 

Constructor Detail

AddressingBuilder

protected AddressingBuilder()
Non-public constructor. Base class is non-instantiable.

Method Detail

newInstance

public static final AddressingBuilder newInstance()
Creates a new instance of AddressingBuilder. This method uses the following ordered lookup procedure to determine the AddressingBuilder implementation class to load:
  1. Use the javax.xml.ws.addressing.AddressingBuilder system property.
  2. Use the properties file "lib/jaxwsa.properties" in the JRE directory. This configuration file is in standard java.util.Properties format and contains the fully qualified name of the implementation class with the key being the system property defined above. The jaxwsa.properties file is read only once by the JAXWSA implementation and it's values are then cached for future use. If the file does not exist when the first attempt is made to read from it, no further attempts are made to check for its existence. It is not possible to change the value of any property in jaxwsa.properties after it has been read for the first time.
  3. Use the Services API (as detailed in the JAR specification), to determine the classname. The Services API will look for a classname in the file META-INF/services/javax.xml.ws.addressing.AddressingBuilder in jars available to the runtime.
  4. Platform default AddressingBuilder instance.
Once an application has obtained a reference to a AddressingBuilder it can use it to create other WS-Addressing constructs.


newURI

public abstract AttributedURI newURI(java.net.URI uri)
Returns an instance of javax.ws.addressing.AttributedURI initialized with the given URI.

Parameters:
uri - the specified URI.
Returns:
the new URI.

newURI

public abstract AttributedURI newURI(java.lang.String uri)
Returns an instance of javax.ws.addressing.AttributedURI initialized with the given String.

Parameters:
uri - the specified URI.
Returns:
the new URI.
Throws:
AddressingException - when malformed URI is passed.

newQName

public abstract AttributedQName newQName(javax.xml.namespace.QName name)
Returns an instance of javax.ws.addressing.AttributedQName initialized using the specified QName.

Parameters:
name - the QName.
Returns:
the AttributedQName

newQName

public abstract AttributedQName newQName(java.lang.String namespace,
                                         java.lang.String localname)
Returns an instance of javax.ws.addressing.AttributedQName initialized using the specified QName.

Parameters:
namespace - the namespace URI.
localname - the local name.
Returns:
the AttributedQName

newRelationship

public abstract Relationship newRelationship(java.net.URI uri)
Returns an instance of javax.ws.addressing.Relationship whose ID property is initialized with the given URI.

Parameters:
uri - the specified URI
Returns:
the new Relationship.

newRelationship

public abstract Relationship newRelationship(java.lang.String uri)
Returns an instance of javax.ws.addressing.Relationship whose ID property is initialized with the given URI.

Parameters:
uri - the specified URI
Returns:
the new Relationship.

newEndpointReference

public abstract EndpointReference newEndpointReference(java.net.URI uri)
Returns an instance of javax.ws.addressing.EndpointReference

Parameters:
uri - the URI used to initialize the Address property.
Returns:
the new EndpointReference.

newEndpointReference

public abstract EndpointReference newEndpointReference(java.lang.String uri)
Returns an instance of javax.ws.addressing.EndpointReference

Parameters:
uri - the address used to initialize the Address property.
Returns:
the new EndpointReference.

newAddressingProperties

public abstract AddressingProperties newAddressingProperties()
Returns an instance of javax.ws.addressing.AddressingProperties

Returns:
the new AddressingProperties.

newAddressingConstants

public abstract AddressingConstants newAddressingConstants()
Returns an instance of javax.ws.addressing.AddressingConstants

Returns:
The new AddressingConstants.


Copyright © 2005 Sun Microsystems, Inc. All Rights Reserved.