- Parameters of procedure to run
- Type of parameter
- Call to J2EERun
J2EERun (Function) In french: J2EEExécute
 Not available
Runs a procedure on a server of J2EE XML Web services. Remark: The procedure parameters must be specified before using J2EERun via the J2EE structure (see the Notes).
// This example is based on the presence of Text2Image Webservice
// on the dwdemos.alphaworks.ibm.com site.
// If the module was no longer available on the site,
// the example would not operate anymore
// Parameters to pass to the service
// Width of the image
J2EE.Value[1] = EDT_WIDTH
J2EE.Name[1] = "ImageWidth"
J2EE.Type[1] = J2EEIntType
...
// Interrogate the Webservice on the Web server
IF J2EERun(...
"http://dwdemos.alphaworks.ibm.com:8085/soap/servlet/rpcrouter", ...
"createImage", "urn:text2image", ...
"http://alphaworks.ibm.com/alphabeans/text2image/createImage/") THEN
// The result is an image, it will be changed into a temporary file
nFileID is int
nFileID = fOpen(fExeDir() + "\temp.gif", foCreate)
fWrite(nFileID, J2EEGetResult(J2EEResult))
fClose(nFileID)
// Display
IMG_GEN = ""
IMG_GEN = fExeDir() + "\temp.gif"
// Delete the temporary file
fDelete(IMG_GEN)
ELSE
// If the service returns no error (ex: Server not accessible)
IF J2EEError(J2EEErrMessage) ~= "" THEN
Error(ErrorInfo())
// If the service returned an error (service error)
ELSE
Error("J2EE error: " + J2EEError(J2EEErrMessage))
END
END
Syntax
<Result> = J2EERun(<Server URL> , <Procedure name> [, <Procedure Namespace> [, <Procedure action> [, <Encoding style>]]])
<Result>: Boolean - True if the communication was established with the server,
- False otherwise (no communication was established). To get more details on the error, use ErrorInfo with the errMessage constant.
<Server URL>: Character string URL of server to contact. This parameter is supplied in the documentation of server of J2EE XML Web services. <Procedure name>: Character string Name of the procedure that will be run on the specified server. This parameter is supplied in the documentation of server of J2EE XML Web services.
Make sure to respect the case (lowercase/uppercase characters) in the name of the procedure. <Procedure Namespace>: Optional character string Namespace of procedure to run. This parameter is supplied in the documentation of server of J2EE XML Web services. <Procedure action>: Optional character string Action of procedure (also called "J2EEAction"). This parameter is supplied in the documentation of server of J2EE XML Web services. <Encoding style>: Optional character string Encoding style of procedure (also called "EncodingStyle"). This parameter is supplied in the documentation of server of J2EE XML Web services. Remarks Parameters of procedure to run To pass parameters to a procedure run on a server of J2EE XML Web services, the following structure is used by WINDEV: | | | | Variable | Type | Details |
|---|
| J2EE.NameSpace | Optional character string | "NameSpace" of parameter. | | J2EE.Name | Character string | Name of parameter. | | J2EE.XMLParam | Optional character string | Full parameter description in XML format. The other parameters (Value, Name, Type, NameSpace and EncodingStyle) are ignored if this parameter is specified. | | J2EE.EncodingStyle | Optional character string | Encoding style of parameter. | | J2EE.Type | Constant | Type of parameter | | J2EE.Value | Any type | Value of parameter. |
This structure must be used for each parameter. For example:
J2EE.Value[1] = 94010
J2EE.Name[1] = "ZipCode"
J2EE.Type[1] = J2EEStringType
This structure is equivalent to:
J2EE.XMLParam[1] = <ZipCode xsi:type="xsd:string">94010</ZipCode>
The type of parameter can be: | | | Constant | Type |
|---|
| J2EEBase64BinaryType | Binary | | J2EEHexBinaryType | Hexadecimal binary | | J2EEBooleanType | Boolean | | J2EEStringType | Character string | | J2EENormalizedStringType | Character string without carriage return (CR) and without tabulation (TAB) | | J2EEDecimalType | Any number without limit | | J2EEIntType | Integer included between - 2 147 483 648 and + 2 147 483 647) | | J2EEShortType | Short integer | | J2EEUnsignedShortType | Unsigned short integer | | J2EEIntegerType | Integer (no limit) | | J2EELongType | Long integer | | J2EEUnsignedLongType | Long unsigned integer | | J2EENegativeIntegerType | Negative integer (except 0) | | J2EENonNegativeIntegerType | Non-negative integer | | J2EENonPositiveIntegerType | Non-positive integer | | J2EEUnsignedIntType | Unsigned integer | | J2EEPositiveIntegerType | Positive integer (except 0) | | J2EEByteType | Byte | | J2EEUnsignedByteType | Unsigned byte | | J2EEFloatType | Real | | J2EEDoubleType | Double real | | J2EEAnyURIType | URL address |
After the call to J2EERun: - The procedure parameters are deleted.
- The structure of the header specified with J2EEAddHeader is deleted.
- J2EEGetResult returns the result of the procedure run.
- J2EEError returns the error message of the procedure run.
This page is also available for…
|
|
|
|