This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Remote Registry

The <registry> element is used to define the remote Registry used by the configuration. The <registry provider> specifies an implementation class for the Registry implementation used, and optionally a number of configuration parameters as may be required for the configuration of the connection to the Registry.

<registry provider="string"/>
<parameter name="string">text | xml</parameter>*
</registry>

Registry entries loaded from a Remote Registry may be cached as dictated by the Registry, and reloaded after the cache periods expires if a newer version is found. Hence, it is possible to define configuration elements such as (dynamic) sequences and endpoints, as well as resources such as XSLT's, Scripts or XSDs off the registry, and update the configuration as these are allowed to dynamically change over time.

WSO2 ESB ships with a built-in file system based Registry implementation called "FileSystemRegistry" and this can be configured as follows:

<registry provider="org.wso2.carbon.mediation.registry.ESBRegistry">
<parameter name="root">[file:./repository/samples/resources/]</parameter>
<parameter name="cachableDuration">15000</parameter>
</registry>
  • The root parameter specifies the root directory of the Registry for loaded resources.
  • The FileSystemBasedRegistry keys are path fragments, that when combined with the root prefix would form the full URL for the referenced resource.
  • The cachableDuration parameter specifies the number of milliseconds for which resources loaded from the Registry should be cached.

More advanced Registry implementations allows different cacheable durations to be specified for different resources, or mark some resources as never expires.

By default, WSO2 ESB uses the WSO2 Governance Registry for storing resources. It is configured as follows:

<registry provider="org.wso2.carbon.mediation.registry.WSO2Registry">
<parameter name="cachableDuration">15000</parameter>
</registry>

By default, the above bit of configuration is in the top level registry.xml file in the synapse-config directory.