Binding a Simple Component to a Web Service Method

See Also

A simple component displays one value. Examples of simple components include Button, Checkbox, Hyperlink, Text Field, or Static Text. For easiest data binding, use components from the Basic category of the Palette.

After you add a web service to the IDE and to a page, you can call a web service method by using either of the following techniques:

• Bind a method to a component. You can use this technique to view the results of the web service method, but you cannot update it. You do not need to write any Java code.
   
  
• Call the web service method in your Java code. You can use this technique to view or update the web service.
   
  

The examples in the following procedures describe how to call the same web service method by using both techniques.

To bind a component to a method:

1. If the web service is not part of the IDE, add the web service to the IDE.
    
   
2. Drag and drop the method onto the component.
    
   
3. Right-click the component and choose Bind to Data.
    
   
4. In the Bind to Data dialog box, click the Data Provider tab.
    
   
5. Choose the method's data provider.
    
   
6. Select the data field to display in the component.
    
   For example, consider the following scenario. You want to use the getPersons method of the TravelWS web service to display the first person's name in a static text field.
   1. Add the TravelWS.wsdl file shipped with the IDE.
       
      
   2. Drag the Basic > Static Text component to the page.
       
      
   3. Drag the getPersons method onto the static text field.
       
      
   4. Right-click the static text and choose Bind to Data.
       
      
   5. Select name from the data field list.
       
      

To call a method in your Java code:

1. If the web service is not part of the IDE, add the web service to the IDE.
    
   
2. If the web service has not been added to the page, add the web service to the page.
    
   
3. If desired, select a method to see its properties in the Properties window.
    
   
4. If desired, test the web service's methods by completing the following steps:
   1. Expand the web-service-name node.
       
      
   2. Right-click the method and choose Test Method.
       
      
   3. Type a test value for the parameters and click Submit.
       
      
   4. View the results and click Close.
       
      
   
    
   
5. Call the methods in your Java code.
    
   For example, consider the following scenario. You want to use the getPersons method of the TravelWS web service to display the first person's name in a static text field.
   1. Add the TravelWS.wsdl file shipped with the IDE.
       
      
   2. Drag TravelWS to the Visual Designer.
       
      
   3. Drag the Basic > Static Text component to the Visual Designer.
       
      
   4. Go to the Page1.java source code by selecting the Java tab.
       
      
   5. In the prerender() method, enter the following code.
       
      

   
         try {
   
              staticText1.setValue( travelWSClient1.getPersons()[0].getName() );
   
         } catch (Exception e) {
   
              log("Page1 Initialization Failure", e);
   
              throw e instanceof FacesException ? (FacesException) e: new FacesException(e);
   
          } 
   
   

   
    
   

See Also

About Web Services

Adding a Web Service to the IDE

Binding a List Component to a Web Service Method

Binding a Table Component to a Web Service Method

About the Projects and Files Windows

About the Java Editor