How to Include Warnings/Error messages in Return Service Data Object

Question

Hello All,
I am using Jdeveloper 11.1.1.3.0, ADF BC. and want to publish Service-Enabled application modules, specifically I want to publish a custome method in the application module as a web service.
While going through Enable support for Service Interface wizard as explained in developer guide, in step 7 I read this
>
7. To expose service information messages such as warnings and exceptions for a custom method or warnings for process operation methods, select Include Warnings in Return Service Data Object. For example, you might want display an informational message when a method returns the total employee compensation and the total is outside of the desired range.
If Include Warnings is not selected, no informational messages will be returned with the service response. This option is only enabled when the method does not return a view row or a list
of view rows. When the method returns view rows, the underlying view object determines whether the method supports warnings, as described Section 11.2.4, "How to Service-Enable Individual View Objects." The informational messages (and warnings) are reported as part of the return object. JDeveloper generates appropriate wrappers as the return objects, and the wrappers contain the actual method return and the informational messages.
>
I am interested in this part: For example, you might want display an informational message when a method returns the total employee compensation and the total is outside of the desired range.
To do this, I write a method in the application module
public Number getEmpSal(Number empId){
        EmployeesViewImpl employeesView1 = this.getEmployeesView1();
        //this is the bind variable setter
        employeesView1.setEmpId(empId);
        employeesView1.executeQuery();
        EmployeesViewRowImpl first = (EmployeesViewRowImpl)employeesView1.first();
       return first!=null ? first.getSalary() : null;
}and I selected the Include Warnings in Return Service Data Object check box. but how and where can I expose the error or warning message?
Note:
I tried to throw an exception in the method
public Number getEmpSal(Number empId){
        EmployeesViewImpl employeesView1 = this.getEmployeesView1();
        //this is the bind variable setter
        employeesView1.setEmpId(empId);
        employeesView1.executeQuery();
        EmployeesViewRowImpl first = (EmployeesViewRowImpl)employeesView1.first();
        if(first!=null && (first.getSalary()!=null || first.getSalary().compareTo(1000)==1))
            throw new JboException("out of range salary");
         return first!=null ? first.getSalary() : null;
}and when I test the web service for some employee I get this response:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
     <env:Body>
          <env:Fault>
               <faultcode>env:Server</faultcode>
               <faultstring>out of range salary</faultstring>
               <detail><tns:ServiceErrorMessage xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/" xmlns:xsi=      "http://www.w3.org/2001/XMLSchema-instance"><tns:code/><tns:message>out of range  salary</tns:message><tns:severity>SEVERITY_ERROR</tns:severity><tns:exceptionClassName>oracle.jbo.JboException</tns:exceptionClassName></tns:ServiceErrorMessage>
               </detail>
          </env:Fault>
     </env:Body>
</env:Envelope>but is this the right approach or there is another place to show error/warning messages?
Edited by: Mohammad Jabr on Apr 16, 2012 1:17 PM

Answer 1

This is fine if you raise exception from your code. It will be raised as a server fault only.