Configuring the Endpoints

A route is a path between two endpoints. The endpoints of a route in a Celtix Enterprise router are defined using endpoint elements. The endpoints are configured as part of the inbound and outbound routers.

`endpoint` elements

The endpoint element is a child of both the inbound-router element and the router element. It configures an endpoint using a combination of attributes and property elements.

Table 5.3, “Attributes used to Define an Endpoint” describes the attributes used by the endpoint element.

Table 5.3. Attributes used to Define an Endpoint

Attribute	Description
`address`	Specifies the URI of the WSDL defining the endpoint. If the endpoint being defined is part of an inbound router, the contract will be used to create a mock service implementation. If the endpoint being defined is part of an outbound router, the contract will be used to create a service proxy. For more details on how to specify the URI for a Celtix Enterprise endpoint see Specifying the address of a Celtix Enterprise endpoint.
`synchronous`	Specifies if the endpoint uses synchronous messaging or asynchronous messaging. The Celtix Enterprise router only supports synchronous messaging, so this attribute must always be set to `true`.
`transformers`	An optional attribute that can be used to specify a comma separated list of transformers through which the message data for the endpoint is passed. Request messages are passed through the transformers in the order they appear in the list. Response messages are passed through the transformers in reverse order.

Specifying the address of a Celtix Enterprise endpoint

Celtix Enterprise endpoints are specified using a specific URI syntax. The protocol identifier of the URI is wsdl-cxf. You can then specify the remainder of the URI using one of two methods:

wsdl-cxf:res:///wsdlFile

Using the res:/// syntax you specify the location of the WSDL contract relative to the router's classpath.
wsdl-cxf:file:///wsdlFile

Using the file:/// syntax you specify the location of the WSDL contract using its full file path.

In addition to specifying the location of the WSDL contract for the endpoint, you can also specify the service and port properties for the endpoint using the address attribute. To specify the service and port in this way you append the ?service=serviceName&port=portName to the end of the URI.

Specifying endpoint properties

Each endpoint in a route has one or more properties that need to be configured in addition to the ones specified in the endpoint element. These properties are configured using property elements. property elements are entered as the children of a properties element that is the child of the endpoint element.

The property element has two attributes: name and value. The name attribute specifies the name of the property whose value is being set. The value attribute specifies the value of the property.

Table 5.4, “Route Endpoint Properties” describes the properties that can be set on a route's endpoints.

Table 5.4. Route Endpoint Properties

Property	Description
service	Specifies the QName of the `wsdl:service` element that contains the definition of the endpoint.
port	Specifies the QName of the `wsdl:port` element that defines the endpoint.
dataFormat	Specifies the data mode used by the endpoint. Valid values are `message`, `payload`, or `POJO`.

Example

Example 5.4, “Sample Endpoint” shows a configuration sample defining an endpoint.

Example 5.4. Sample Endpoint

...
<endpoint address="cxf-wsdl:res:///wsdl/myService.wsdl" synchronous="true">
  <properties>
    <property name="service"
              value="{http://demos.org/tests}mySOAPService" />
    <property name="port"
              value="{http://demos.org/tests}mySOAPPort" />
    <property name="dataFormat" value="POJO" />
  </properties>
</endpoint>