Integrating external webserives into ADF fusion application

Hi,

One of the use cases always comes to desk is to validate that user has entered a valid email address or not? now question is how to verify that the email address is valid? so answer is with the power of webservices we can verify that the email address is valid or not so again....


How to Integrate WebServices in Fusion application? As far as i know there are 2 methods.
1) By creating webservice data control on WSDL document provided by producer.
2) By creating webservice proxy.

Download the completed example 

In this example we will look at the first method Webservice data control:
- We will integrate external web-service which will return result TRUE or FALSE based on email input parameter.
- When user will enter email address in a field the appropriate message will appear with the field.
- On Commit we will also verify the output of the  the method to take further action.

Getting the Web service 
Visit http://www.webservicex.net/WCF/ServiceDetails.aspx?SID=22 and get the address of WSDL document thats all you need to integrate.
 (This can be any site who provides web service)

Test the webservice on the site by entering any email address and press invoke

Webservice will return the boolean value based on input

Lets integrate this webservice into out ADF fusion application

Create a table in HR schema to use in example

create table person_emails
(person_name varchar2(60),
 person_email varchar2(30));

Create Fusion application and Data control
Create Business components from table for person_emails table with application module
Right click Model project and select new follow the slides

Copy and paste the WSDL location and paste into URL field and press Service button to validate.

Select the methods you need to integrate in this service we have only one method

Next Next Next Press Finish

Now we have created a Data control so we can use it on JSF Page

Create a JSF Page
- Drag a collection of PersonEmail1 from data control panel to the page as ADF Form
- Now expand EmailWSDC data control and drag the Boolean Return below the Email field and Formatted output text

- Binding dialog will appear asking you to provide value from email parameter.
expand the expression builder and choose PersonEmail input value as shown in the slide.

as you can see the method is appearing in Page binding section as well

Set AutoSubmit = TRUE of PersonEmail field
Add a partial triggers property of Output text linking to the Email field 


Calling Web service Method
Choose edit from the property inspector in the ValueChangeListener of Email field and create a Managed Bean

Define Bean method by pressing New

In backing bean write code similar to this
The code is executing the Action method which is already linked in the page binding by passing the current value in the email field to the parameter called "Email"

package baigsorcl.view;

import java.util.Map;

import javax.faces.application.FacesMessage;
import javax.faces.context.FacesContext;
import javax.faces.event.ValueChangeEvent;

import oracle.adf.model.BindingContext;

import oracle.binding.AttributeBinding;
import oracle.binding.BindingContainer;
import oracle.binding.OperationBinding;


public class Page1Bean {

    public Page1Bean() {
    }
    
    String emailResult;

    //Method to call webservice Action Method
    public boolean verifyEmail(String email) {
        BindingContainer bindings = getBindings();
        OperationBinding method = bindings.getOperationBinding("IsValidEmail");
        Map paramsMap = method.getParamsMap();
        
        //assigning parameter
        paramsMap.put("Email", email);
        Object result = method.execute();
        
        if (result.equals(true)) {
            emailResult = "Thank you for providing valid email address";
            return true;
        } else {
            emailResult = "Please provide valid email";
            return false;
        }
    }

    //value change listener
    public void verifyEmail(ValueChangeEvent valueChangeEvent) {
        if (valueChangeEvent.getNewValue() != null) {
           boolean result =
verifyEmail(valueChangeEvent.getNewValue().toString());
        }
    }

    public BindingContainer getBindings() {
        return BindingContext.getCurrent().getCurrentBindingsEntry();
    }

    //On commit Action
    public String commit_action() {
      
       //Retreive Attribute value of email id
       BindingContainer attrbindings = getBindings();  
       AttributeBinding attr =
       (AttributeBinding)attrbindings.getControlBinding("PersonEmail");  
       boolean emailExists = verifyEmail(attr.getInputValue().toString());
      
       //if method returns TRUE then commit else error message
       if (emailExists){
        BindingContainer bindings = getBindings();
        OperationBinding operationBinding =
            bindings.getOperationBinding("Commit");
        Object result = operationBinding.execute();
        if (!operationBinding.getErrors().isEmpty()) {
            return null;
        }
        return null;
       }
       else {
         FacesMessage msg = new
FacesMessage(FacesMessage.SEVERITY_ERROR, "Error" , "Please provide valid email to continue...record not saved");
         FacesContext.getCurrentInstance().addMessage(null, msg);
         return null;
       }
  
    }

    public void setEmailResult(String emailResult) {
        this.emailResult = emailResult;
    }

    public String getEmailResult() {
        return emailResult;
    }
}

Assign the emailResult Variable to the Result output text we create for proper message

- Run the Page enter invalid email address and tab out message will appear about invalid email address enter any valid email address and tab out or press commit

Press Commit you will see the alert error if email is invalid

finally enter valid email and all is well

Explore more detail in the example

More reading about Integrating webserives check here

Happy JDeveloping,
Baig