Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Swordfish Documentation: Architecture: Dynamic Endpoint Resolution

Revision as of 10:26, 28 October 2009 by Juergen.kindler.sopera.de (Talk | contribs) (Overview)

Overview

In Swordfish the relationship between components using a service (consumers) and components providing a service (providers) need not be static. Using dynamic endpoint resolution a consumer can look up a provider based on a service interface and a policy (a list of non-functional capabilities and requirements) from a service registry (a database of existing service providers and their policies).

Design

Swordfish supports the connection to different service registries in order to allow dynamic endpoint resolution. This flexibility is realized through the service registry plugin. The Service Registry Plugin consists of the following components:

  • ServiceResolver - resolves information about the service endpoints for specified service using endpoint document providers and endpoint extractors
  • EndpointDocumentProvider - is responsible for retrieval of service description from different kinds of location. Different implementations of the EndpointDocumentProvider can be used to get the service descriptions from local filesystem or from a remote registry.
  • EndpointExtractor - extracts endpoint parts (e.g. endpoint address, transport protocol) from the service description representation. At the same time multiple endpoint extractors can be registered in the system, each suitable for processing one type of service description document (e.g. extractor for WSDL 1.1 based service descriptions, extractor for WSDL 2.0 and so on).


API

(To do: have to adjust the package names of the interfaces)

RegistryAPIPackage.png

Main component classes

(To do: have to adjust the package names of the interfaces)

ServiceRegistryCommunicationComponents.png

Processing sequence

The endpoint resolution process is described by the following scenario:

  1. ServiceResolver gets all EndpointDocumentProviders registered at runtime and chooses one with the highest priority. The chosen provider is then queried for service description documents corresponding to the specified service interface. All found documents are returned from provider as collection of the ServiceDescription objects where each ServiceDescription represents one raw description document.
  2. ServiceResolver gets all registered EndpointExtractors and uses them to extract endpoint description information from received ServiceDescriptions. At this step it also performs policy trading which allows to exclude non-matching service descriptions from the extraction process. Extracted endpoint descriptions are grouped as collection of EndpointDescription objects and returned to caller.

EndpointResolution.png

Implementation

Involved bundles

See also

Eclipse Swordfish – an Open Source SOA Runtime Framework for the Enterprise

Description of Swordfish policy trading

Back to the top