ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / J2EE functions
  • Parameters of procedure to run
  • Type of parameter
  • Call to J2EERun
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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).
Example
// 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:
VariableTypeDetails
J2EE.NameSpaceOptional character string"NameSpace" of parameter.
J2EE.NameCharacter stringName of parameter.
J2EE.XMLParamOptional character stringFull parameter description in XML format. The other parameters (Value, Name, Type, NameSpace and EncodingStyle) are ignored if this parameter is specified.
J2EE.EncodingStyleOptional character stringEncoding style of parameter.
J2EE.TypeConstantType of parameter
J2EE.ValueAny typeValue 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>

Type of parameter

The type of parameter can be:
ConstantType
J2EEBase64BinaryTypeBinary
J2EEHexBinaryTypeHexadecimal binary
J2EEBooleanTypeBoolean
J2EEStringTypeCharacter string
J2EENormalizedStringTypeCharacter string without carriage return (CR) and without tabulation (TAB)
J2EEDecimalTypeAny number without limit
J2EEIntTypeInteger included between - 2 147 483 648 and + 2 147 483 647)
J2EEShortTypeShort integer
J2EEUnsignedShortTypeUnsigned short integer
J2EEIntegerTypeInteger (no limit)
J2EELongTypeLong integer
J2EEUnsignedLongTypeLong unsigned integer
J2EENegativeIntegerTypeNegative integer (except 0)
J2EENonNegativeIntegerTypeNon-negative integer
J2EENonPositiveIntegerTypeNon-positive integer
J2EEUnsignedIntTypeUnsigned integer
J2EEPositiveIntegerTypePositive integer (except 0)
J2EEByteTypeByte
J2EEUnsignedByteTypeUnsigned byte
J2EEFloatTypeReal
J2EEDoubleTypeDouble real
J2EEAnyURITypeURL address

Call to J2EERun

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.
Component: wd290com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help