xml spy
Previous  Top  Next
Setting breakpoints in SOAP debugger

The SOAP debugger window is where you set and delete breakpoints. It is separated into two tabs.
43_soap_9b

Functional-Breakpoints tab
The "Functional breakpoints" tab, allows you to set a breakpoint on either Requests and/or Responses to SOAP methods. The debugger highlights the line of the function which triggered a breakpoint.

Data packets to and from the client are analyzed and matched to the corresponding functions from the WSDL file. If a breakpoint is set for a specific method, then this is where the SOAP debugger stops. The toolbar buttons are enabled at this point.

The data is displayed in the "Soap Request" or "Soap Response" document window. The SOAP documents displayed in the SOAP windows can be modified at this point. The data is sent the moment you click one of the toolbar icons (except for the "stop server" icon).

Conditional-Breakpoints
The "Conditional Breakpoints" tab, allows you to use XPath expressions to define breakpoints.

If a SOAP request causes an error, the SOAP response must contain a "faultcode" element. We therefore want to have a breakpoint triggered whenever a faultcode element appears.

43_soap_cond1

To add a conditional breakpoint:
1.Click the Conditional Breakpoints tab, and then the Add button.  

43_soap_cond2  

2.Enter the XPath expression (e.g. .//faultcode) in the XPath field.  
3.Click the "Break when XPath nodes found" radio button.  
4.Click the OK button to confirm the settings.  
The SOAP debugger will stop whenever a .//faultcode element appears in a SOAP request or response.  

In Requests
This option lets you define the specific action to be taken if a breakpoint occurs in a SOAP Request. The rest of the dialog box options relate to the SOAP Request. You can of course use the same settings for the SOAP Responses, if you also activate the "In Responses" check box.

In Responses
This option lets you define the specific action to be taken if a breakpoint occurs in a SOAP Response. The rest of the dialog box options relate to the SOAP Response. You can of course use the same settings for the SOAP Responses, if you also activate the "In Requests" check box.

Global
Selecting the Global option, defines that every method/function is scanned for the condition you define.

Local
Selecting the Local option, forces you to select a specific method/function from the ones supplied by the WSDL file. This method/function is then scanned for the condition you define.

XPath
Enter the specific XPath expression/node here. An XPath has to be entered here, to be able to use any one of the specific radio button options.
Please see the XPATH section for more information.

Break on value
The debugger stops when one of the XPath nodes matches the value you enter in this field.

Break when XPath nodes found
The debugger stops when the specific XPath node, .//faultcode entered in the XPath field, exists in the SOAP Request or Response.

Break when XPath nodes missing
The debugger stops when the specific XPath node , .//faultcode entered in the XPath field, is missing from the SOAP Request or Response.

43_soap_cond3

Operation
The Operation column contains the method the being searched for. If you selected the Global radio button then this field remains empty. If you selected Local, then the method you selected is displayed here.

XPath
This column contains the XPath expression you defined.

Value
This column contains the XPath value against which the XPaths nodes are checked for a match. If you selected "Break on value" the specific string you entered is displayed here. If you selected "Break when XPath nodes found", then <--Exist--> is displayed. If you selected "Break when XPath nodes missing", then <--Missing--> is displayed.

In Requests
The check box displays if the XPath expression is checked in the SOAP request.
You can change the settings by directly clicking the check box in the column.

In Responses
The check box displays if the XPath expression is checked in the SOAP response.
You can change the settings by directly clicking the check box in the column.

To edit the Conditional Breakpoints:
·Double click the respective line in the tab, or  
·Click the Change button.  

To delete a conditional Breakpoint
·Click the line you want to delete, and click the Delete button.  
Previous  Top  Next

⌐ 2002 Altova