org.apache.cxf.endpoint
Interface EndpointResolver

public interface EndpointResolver

Implementations of this interface are responsible for mapping between abstract and concrete endpoint references, and/or renewing stale references.

An underlying mechanism in the style of the OGSA WS-Naming specification is assumed, where an EPR maybe be fully abstract, or concrete but with sufficient information embedded to enable its renewal if necessary.

resolve

EndpointReferenceType resolve(EndpointReferenceType logical)

Retrieve a concrete EPR corresponding to the given abstract EPR, returning a cached reference if already resolved.

Parameters:

logical - the abstract EPR to resolve

Returns:

the resolved concrete EPR if appropriate, null otherwise

renew

EndpointReferenceType renew(EndpointReferenceType logical,
                            EndpointReferenceType physical)

Force a fresh resolution of the given abstract EPR, discarding any previously cached reference.

Parameters:

logical - the previously resolved abstract EPR

physical - the concrete EPR to refresh

Returns:

the renewed concrete EPR if appropriate, null otherwise

mint

EndpointReferenceType mint(QName serviceName)

Mint a new abstract EPR for a given service name.

Parameters:

serviceName -

Returns:

the newly minted EPR if appropriate, null otherwise

mint

EndpointReferenceType mint(EndpointReferenceType physical)

Mint a new abstract EPR for a given concrete EPR

Parameters:

physical -

Returns:

the newly minted EPR if appropriate, null otherwise