Passing/Receiving HTTP header in SOA BPEL

In this example we will explore how to pass or receive the parameters from HTTP header.

We will explore below two scenarios,
To receive the HTTP header from SOAP request.
To pass the HTTP header while calling soap service.
SOA version used: 12.1.3c

To receive the HTTP header from SOAP request:

First we need to add the property “oracle.webservices.http.headers” under binding.ws in Service element in composite.xml. This property contains the comma separated parameters that we are expecting in request.
Example,  ENV,VERSION.

<binding.ws port="http://xmlns.oracle.com/SOA_Learning/HTTPHeader/HTTPHeaderTest#wsdl.endpoint(httpheadertest_client_ep/HTTPHeaderTest_pt)">
         <property name="oracle.webservices.http.headers">ENV,VERSION</property>
</binding.ws>

Now in BPEL source under receive activity, we need add <fromProperties> element which will copy the parameters from HTTP header to BPEL variable.

<receive name="receiveInput" partnerLink="httpheadertest_client" portType="client:HTTPHeaderTest" operation="process" variable="inputVariable" createInstance="yes">
    <bpelx:fromProperties >
         <bpelx:fromProperty name=" ENV" variable="var_ENV"></bpelx:fromProperty>
         <bpelx:fromProperty name=" VERSION" variable="var_VERSION"></bpelx:fromProperty>
    </bpelx:fromProperties>
   </receive>

Create two variables name “var_ENV” and “var_VERSION” of type string.



Now for DEMO purpose we will return the parameters from HTTP header to SOAP response.



Now we can test our service from EM or SOAP UI. EM console also allow use to set the HTTP header in request.


RESPONSE:



If we see EM console, we will find below trace logs:

receiveInput
 Mar 13, 2016 5:18:05 PM Received property "VERSION", value is "1.0".
 Mar 13, 2016 5:18:05 PM Received property "ENV", value is "DEV".
 Mar 13, 2016 5:18:05 PM Received "process" call from partner "httpheadertest_client"


Similarly, for passing the parameters in HTTP Header, we need to add,

         <property name="oracle.webservices.http.headers">ENV,VERSION</property>
To binding.ws under reference tag in composite.xml.

In INVOKE activity we need to use toProperties element.

    <bpelx:toProperties >
             <bpelx:toProperty name="ENV" variable="var_ENV">"lllf"</bpelx:toProperty>
             <bpelx:toProperty name="VERSION" variable="ver_VERSION"></bpelx:toProperty>
        </bpelx:toProperties>
   

Note:
The above properties does not work for REPLY activity as SOA does not support returning the parameter in HTTP header.
Ref: https://community.oracle.com/thread/3907803
Ref: http://biemond.blogspot.in/2012/04/retrieve-or-set-http-header-from-oracle.html

Thanks.


Popular posts from this blog

API Design First approach: Implementing quick mock API's using swagger hub and postman

Image
Consider a scenario, where you as a API developer been ask to to implement the API's for a new mobile/web application team. The requirement is to implement a application to allow users to manage orders.         Mobile APP -> API infra->Backend enterprise system While implement a full working API might take days, you also do not want the application team to wait till the API's are ready. Thus, in most case we end up implementing the mock API's with sample scenarios. In this post, we will define an API using swagger openapi 3.0 yaml specification in swaggerhub. We will then use the definition to implement mock API's in postman. Even though postman provide option to define the API's, i liked swagger hub much better, it allow you to view your API on right side.  For this post I implemented API definition in swagger, please find the below link. https://app.swaggerhub.com/apis-docs/lopesrohan1988/ordermanagement/1.0.0 API Definition can be found at below link: h...
Read more

Combine or Merge XML documents in Single XML using Boomi & Groovy

Image
In this small post will try to show how you can merge multiple XML Documents in Boomi.  Consider following scenario where you have to merge Document 1 & 2 in a new Document 3 Document 1: <?xml version="1.0" encoding="UTF-8"?> <tns:OutputParameters xmlns:tns="http://sample.com">    <tns:Book>       <tns:Names>          <tns:Name>XZY World</tns:Name>       </tns:Names>       <tns:Authors>          <tns:AuthorID>12354</tns:AuthorID>       </tns:Authors>    </tns:Book> </tns:OutputParameters>   Document 2: <?xml version="1.0" encoding="UTF-8"?> <tns:OutputParameters xmlns:tns="http://sample.com">    <tns:Book>     ...
Read more

JAVA embedding in Oracle SOA 12c

Image
In this post we will explore how to EMBED Java or call Java API from Oracle SOA BPEL process. In order to demonstrated this, I have created a simple JAVA project with 3 classes. 1.        Account.java -> This class represent Account DTO       2.       Party.java -> This class represent a party (customer) DTO       3.       GetNumber.java -> This class contains the method that takes Party DTO as input and apply some business logic and return party’s AccountDTO in response. public Account getNumber(Party party) The above classes are created to simulate the calling of actual business logic API’s. Account.java Party.java GetNumber.java public class Account {     public Account() {         super();     }     String account;     public v...
Read more