Patterns: Implementing Self-Service in an SOA Environment

Chapter 10. Web services scenario 335

10.7.3 Create an endpoint listener

Endpoint listeners are required if you want to expose destinations on the bus to

clients connecting over SOAP/HTTP and SOAP/JMS. They are the entry points

to the bus for these protocols, carrying requests between Web services clients

and buses, and are used by both inbound services and gateway services. An

endpoint listener acts as the ultimate receiver of an incoming SOAP message to

the bus and passes on the data and context of that message.

To define a new endpoint listener using the administrative console, perform the

following steps:

3. Expand Servers and click Application Servers.

4. Click the server name.

5. Under Additional Properties click Endpoint Listeners.

6. Click New.

7. For our CreditCheck example using SOAP/HTTP, enter in the following

values:

–Name

This is the name of the endpoint listener. It should have a value of

SOAPHTTPChannel1.

– URL root

This is the base URL for Web service requests into this endpoint listener.

The URLs used for making Web service requests to the service integration

bus will have this at the beginning. Set this to:

http://localhost:9080/wsgwsoaphttp1

Where localhost can be replaced with the server’s host name and 9080

may be replaced with the correct port number for your server setup.

– WSDL serving HTTP URL root

The location of the HTTP URL that is serving your Web service WSDL.

Enter a value of:

http://localhost:9080/sibws/wsdl

8. Click Apply. This saves the General Properties and makes the Additional

Properties available (Figure 10-30 on page 336).

Note: Before creating endpoints, make sure you have the CreditCheck and

DeliverySystem applications deployed and running.

336 Patterns: Implementing Self-Service in an SOA Environment

Figure 10-30 Additional properties of Endpoint

9. From the Additional Properties list, click Connection properties then New.

10.A drop-down list of available buses appears to which you can connect the

endpoint listener. Select the bus you want to use, click OK, and then click

save to save your changes.

This completes the configuration of your endpoint listener. By connecting it to a

bus, we make it available for use with inbound services.

Note: The URL root values supplied for the SOAP/HTTP endpoint listeners

assume that you have used the defaults supplied in the endpoint listener

applications. If you have changed these, you also have to modify the values

you supply when creating the endpoint listener.