Features

todo

Component Configuration

todo

Service Configuration

todo

Send a JBI message to an external Web Service

todo

Service Unit descriptor

todo

Send a JBI message from an incoming SOAP message

todo

Service Unit descriptor

todo

REST Services

todo

Introduction

todo

Configuration

todo

Provide mode : Provide access to external REST Service

todo

Consume mode : Expose JBI Service as as REST Service

todo

Samples

todo

Provide mode

todo

Consume mode

todo

Web Service Notifications

todo

Intoduction

todo

Create a WS-N topic

todo

Subscribe to WS-N producer

todo

Send a WS notification from a JBI message

When the petals-bc-soap component receives a JBI message on a topic-activated endpoint, it is transformed into a WS-notification message and published on the linked topic.

As an example of SOAP notification message, if the JBI message payload is :

<text>This is a sample of JBI message payload...</text>

and if it is published on the 'TopicSample' topic, the SOAP body payload of the notification message will be :

<wsnt:Notify>
    <wsnt:NotificationMessage>
        <wsnt:SubscriptionReference>
            <wsa:Address xmlns:wsa="http://www.w3.org/2005/08/addressing">
                http://127.0.0.1:8084/wsn-consumer/services/consumer
            </wsa:Address>
        </wsnt:SubscriptionReference>
        <wsnt:Topic Dialect="xsd:anyURI">TopicSample</wsnt:Topic>
        <wsnt:ProducerReference>
            <wsa:Address xmlns:wsa="http://www.w3.org/2005/08/addressing">
                http://127.0.0.1:8084/wsn-producer/services/producer
            </wsa:Address>
        </wsnt:ProducerReference>
        <wsnt:Message>
            <text>This is a sample of JBI message payload...</text>
        </wsnt:Message>
    </wsnt:NotificationMessage>
</wsnt:Notify>

Security

todo

Introduction

todo

Securing JBI Services

todo

Configuration

todo

Client side

todo

Using WS-Policy

The Apache Rampart module is used to apply policies when calling an external Web Service (ie in consumer mode). The current section explains how to configure the component to use this feature.

Configuration

todo

Usage

Once the Service Unit is deployed on the SOAP Binding Component, all the JBI messages sent to the new activated endpoint are transformed into SOAP messages and the Web Service client will use the Service Unit defined policy to call the Web Service. The Web Service client behaviour is exactly the same as a policy-enabled Axis2 based Web Service client.

An example of WS policy with PEtALS is provided in the PEtALS SOAP usecases at : http://websvn.ow2.org/listing.php?repname=petals&path=/trunk/configurations/petals-soap/petals-soap-policy/.

Samples

The SOAP binding component samples are available as packaged use cases. You can find them on trunk/configurations/petals-soap directory of the Petals ESB forge.

Know problems

"Transport out has not been set"

If the exception message "Transport out has not been set" occurs when invoking an external web-service, using the petals-bc-soap, it can be due to a wrong URL of the external web-service. Please check it and retry your test.