Apache CXF API

org.apache.cxf.ws.addressing
Class EndpointReferenceUtils

java.lang.Object
  extended by org.apache.cxf.ws.addressing.EndpointReferenceUtils

public final class EndpointReferenceUtils
extends Object

Provides utility methods for obtaining endpoint references, wsdl definitions, etc.


Field Summary
static String ANONYMOUS_ADDRESS
           
 
Method Summary
static Source convertToXML(EndpointReferenceType epr)
           
static EndpointReferenceType duplicate(EndpointReferenceType ref)
          Create a duplicate endpoint reference sharing all atributes
static String getAddress(EndpointReferenceType ref)
          Get the address from the provided endpoint reference.
static EndpointReferenceType getAnonymousEndpointReference()
          Create an anonymous endpoint reference.
static EndpointReferenceType getEndpointReference(AttributedURIType address)
           
static EndpointReferenceType getEndpointReference(String address)
          Create an endpoint reference for the provided address.
static EndpointReferenceType getEndpointReference(URL wsdlUrl, QName serviceName, String portName)
          Create an endpoint reference for the provided wsdl, service and portname.
static String getEndpointReferenceId(Map<String,Object> messageContext)
          Obtain the id String from the endpoint reference of the current dispatch.
static EndpointReferenceType getEndpointReferenceWithId(QName serviceQName, String portName, String id, Bus bus)
          Obtain a multiplexed endpoint reference for the deployed service that contains the provided id
static QName getInterfaceName(EndpointReferenceType ref, Bus bus)
           
static String getPortName(EndpointReferenceType ref)
          Gets the port name of the provided endpoint reference.
static QName getPortQName(EndpointReferenceType ref, Bus bus)
           
static Schema getSchema(ServiceInfo serviceInfo)
           
static Schema getSchema(ServiceInfo serviceInfo, Bus b)
           
static QName getServiceName(EndpointReferenceType ref, Bus bus)
          Gets the service name of the provided endpoint reference.
static JAXBElement<ServiceNameType> getServiceNameType(QName serviceName, String portName)
           
static MetadataType getSetMetadata(EndpointReferenceType ref)
           
static String getWSDLLocation(EndpointReferenceType ref)
           
static EndpointReferenceType mint(EndpointReferenceType physical, Bus bus)
          Mint logical endpoint reference via the Bus EndpointResolverRegistry.
static EndpointReferenceType mint(QName serviceName, Bus bus)
          Mint logical endpoint reference via the Bus EndpointResolverRegistry.
static EndpointReferenceType renew(EndpointReferenceType logical, EndpointReferenceType physical, Bus bus)
          Renew logical endpoint reference via the Bus EndpointResolverRegistry.
static EndpointReferenceType resolve(EndpointReferenceType logical, Bus bus)
          Resolve logical endpoint reference via the Bus EndpointResolverRegistry.
static void setAddress(EndpointReferenceType ref, String address)
          Set the address of the provided endpoint reference.
static void setInterfaceName(EndpointReferenceType ref, QName portTypeName)
           
static void setMetadata(EndpointReferenceType ref, List<Source> metadata)
          Sets the metadata on the provided endpoint reference.
static void setPortName(EndpointReferenceType ref, String portName)
           
static void setServiceAndPortName(EndpointReferenceType ref, QName serviceName, String portName)
          Sets the service and port name of the provided endpoint reference.
static void setWSDLLocation(EndpointReferenceType ref, String... wsdlLocation)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ANONYMOUS_ADDRESS

public static final String ANONYMOUS_ADDRESS
See Also:
Constant Field Values
Method Detail

setServiceAndPortName

public static void setServiceAndPortName(EndpointReferenceType ref,
                                         QName serviceName,
                                         String portName)
Sets the service and port name of the provided endpoint reference.

Parameters:
ref - the endpoint reference.
serviceName - the name of service.
portName - the port name.

getSetMetadata

public static MetadataType getSetMetadata(EndpointReferenceType ref)

getServiceNameType

public static JAXBElement<ServiceNameType> getServiceNameType(QName serviceName,
                                                              String portName)

getServiceName

public static QName getServiceName(EndpointReferenceType ref,
                                   Bus bus)
Gets the service name of the provided endpoint reference.

Parameters:
ref - the endpoint reference.
Returns:
the service name.

getPortName

public static String getPortName(EndpointReferenceType ref)
Gets the port name of the provided endpoint reference.

Parameters:
ref - the endpoint reference.
Returns:
the port name.

getPortQName

public static QName getPortQName(EndpointReferenceType ref,
                                 Bus bus)

setPortName

public static void setPortName(EndpointReferenceType ref,
                               String portName)

setInterfaceName

public static void setInterfaceName(EndpointReferenceType ref,
                                    QName portTypeName)

getInterfaceName

public static QName getInterfaceName(EndpointReferenceType ref,
                                     Bus bus)

setWSDLLocation

public static void setWSDLLocation(EndpointReferenceType ref,
                                   String... wsdlLocation)

getWSDLLocation

public static String getWSDLLocation(EndpointReferenceType ref)

setMetadata

public static void setMetadata(EndpointReferenceType ref,
                               List<Source> metadata)
                        throws EndpointUtilsException
Sets the metadata on the provided endpoint reference.

Parameters:
ref - the endpoint reference.
metadata - the list of metadata source.
Throws:
EndpointUtilsException

getSchema

public static Schema getSchema(ServiceInfo serviceInfo)

getSchema

public static Schema getSchema(ServiceInfo serviceInfo,
                               Bus b)

getAddress

public static String getAddress(EndpointReferenceType ref)
Get the address from the provided endpoint reference.

Parameters:
ref - - the endpoint reference
Returns:
String the address of the endpoint

setAddress

public static void setAddress(EndpointReferenceType ref,
                              String address)
Set the address of the provided endpoint reference.

Parameters:
ref - - the endpoint reference
address - - the address

getEndpointReference

public static EndpointReferenceType getEndpointReference(URL wsdlUrl,
                                                         QName serviceName,
                                                         String portName)
Create an endpoint reference for the provided wsdl, service and portname.

Parameters:
wsdlUrl - - url of the wsdl that describes the service.
serviceName - - the QName of the service.
portName - - the name of the port.
Returns:
EndpointReferenceType - the endpoint reference

duplicate

public static EndpointReferenceType duplicate(EndpointReferenceType ref)
Create a duplicate endpoint reference sharing all atributes

Parameters:
ref - the reference to duplicate
Returns:
EndpointReferenceType - the duplicate endpoint reference

getEndpointReference

public static EndpointReferenceType getEndpointReference(String address)
Create an endpoint reference for the provided address.

Parameters:
address - - address URI
Returns:
EndpointReferenceType - the endpoint reference

getEndpointReference

public static EndpointReferenceType getEndpointReference(AttributedURIType address)

getAnonymousEndpointReference

public static EndpointReferenceType getAnonymousEndpointReference()
Create an anonymous endpoint reference.

Returns:
EndpointReferenceType - the endpoint reference

resolve

public static EndpointReferenceType resolve(EndpointReferenceType logical,
                                            Bus bus)
Resolve logical endpoint reference via the Bus EndpointResolverRegistry.

Parameters:
logical - the abstract EPR to resolve
Returns:
the resolved concrete EPR if appropriate, null otherwise

renew

public static EndpointReferenceType renew(EndpointReferenceType logical,
                                          EndpointReferenceType physical,
                                          Bus bus)
Renew logical endpoint reference via the Bus EndpointResolverRegistry.

Parameters:
logical - the original abstract EPR (if still available)
physical - the concrete EPR to renew
Returns:
the renewed concrete EPR if appropriate, null otherwise

mint

public static EndpointReferenceType mint(QName serviceName,
                                         Bus bus)
Mint logical endpoint reference via the Bus EndpointResolverRegistry.

Parameters:
serviceName - the given serviceName
Returns:
the newly minted EPR if appropriate, null otherwise

mint

public static EndpointReferenceType mint(EndpointReferenceType physical,
                                         Bus bus)
Mint logical endpoint reference via the Bus EndpointResolverRegistry.

Parameters:
physical - the concrete template EPR
Returns:
the newly minted EPR if appropriate, null otherwise

getEndpointReferenceWithId

public static EndpointReferenceType getEndpointReferenceWithId(QName serviceQName,
                                                               String portName,
                                                               String id,
                                                               Bus bus)
Obtain a multiplexed endpoint reference for the deployed service that contains the provided id

Parameters:
serviceQName - identified the target service
portName - identifies a particular port of the service, may be null
id - that must be embedded in the returned reference
bus - the current bus
Returns:
a new reference or null if the target destination does not support destination mutiplexing

getEndpointReferenceId

public static String getEndpointReferenceId(Map<String,Object> messageContext)
Obtain the id String from the endpoint reference of the current dispatch.

Parameters:
messageContext - the current message context
Returns:
the id embedded in the current endpoint reference or null if not found

convertToXML

public static Source convertToXML(EndpointReferenceType epr)

Apache CXF API

Apache CXF