SoapException
Description
The SoapException class is a PBNI class that inherits from the
PowerBuilder RuntimeError class. When an exception occurs in a Web service
method call, it is converted into a SoapException and thrown. The methods
of the classes in PBSoapClient180.pbx and PBWSClient180.pbx can also throw
SoapException.
Properties
|
Exception property |
Data type |
Description |
|---|---|---|
|
Text |
String |
Contains the text of the error message |
Methods
The following table defines methods inherited by a SoapException
object from the RuntimeError class.
|
Exception method |
Data type returned |
Description |
|---|---|---|
|
GetMessage |
String |
Returns the error message from objects of type |
|
SetMessage |
– |
Sets an error message for an object of type |
Usage
The following example demonstrates how to use the SoapException
class. The ServiceProxy fails to be invoked and returns the error message.
The code has three catch clauses: for SoapException, PBXRuntimeError, and
RuntimeError. PBXRuntimeError is an exception class that inherits from
RuntimeError and is thrown when a PowerBuilder extension raises an error
that is not caught by the extension.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
string s1,s2 s1 = "abcd" SoapConnection conn long ret ServiceProxy proxy //ServiceProxy is a proxy generated by Web service //wizard try conn = create SoapConnection ret = conn.CreateInstance(proxy, "ServiceProxy") if (ret <> 0)then MessageBox("Fail", "Cannot create proxy " & + "ServiceProxy") return end if s2 = proxy.EchoString(s1) MessageBox("Successful", "The return string is '" & + s2 + "'") catch (SoapException e1) MessageBox("Fail", "Can’t invoke service 'EchoString'") catch (PBXRuntimeError e2) MessageBox("Fail", "There is a runtime error when" & + "invoking Web service") catch (RuntimeError e3) MessageBox("Fail", "There is an unknown error when"& + "invoking Web service") end try |
See also
GetMessage in the section called “GetMessage” in PowerScript Reference
RuntimeError object in the section called “RuntimeError object” in Objects and Controls
SetMessage in the section called “SetMessage” in PowerScript Reference