J2EEAddHeader (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / J2EE functions

Executing the procedure

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

J2EEAddHeader (Function)

In french: J2EEAjouteEntête

Adds a header to the next procedure that will be run on the server. This header contains an additional parameter. This parameter is used to check a specific information on the server (type of security for example).

Note This procedure will be executed by function J2EERun or J2EERunXML.

Example

// Ajout d'un entête à la prochaine procédure J2EE exécutée
// Cet entête permet de vérifier le niveau de sécurité informatique
// utilisée par le serveur
// Si le niveau de sécurité maximum n'est pas utilisé, la prochaine
// procédure J2EE ne sera pas exécutée
J2EEAddHeader("Sécurité", "SécuritéMax", "Sécurité-Niveau", True)

Syntax

J2EEAddHeader(<Parameter name> , <Parameter value> , <Parameter namespace> [, <Procedure execution>])

<Parameter name>: Character string

Name of additional parameter. This additional parameter is used to check an information specific to the server. This parameter is supplied in the documentation of server of J2EE XML web services.
The name of the parameter is case sensitive.

<Parameter value>: Any type

Value of additional parameter. The possible values are supplied in the documentation of the server of J2EE XML web services

<Parameter namespace>: Character string

Namespace of parameter. This parameter is supplied in the documentation of server of J2EE XML web services

<Procedure execution>: Optional boolean

True Procedure should not be executed if the server cannot process the header (header required).
False Procedure execution does not take header into account (optional header).

Remarks

Executing the procedure

You have the ability to run (or not) the next procedure by adding a header. To do so, <Procedure execution> must be initialized to True.

If <Procedure execution> is initialized to True:

J2EERun (or J2EERunXML) returns True if the connection with the server has been established, False otherwise.
If the connection with the server was established and if the server fulfills the conditions requested by the header, the procedure is run.
If the procedure was run, J2EEGetResult returns:
- the result of the procedure if the procedure was successfully run,
- an empty string ("") if the procedure failed.
If the procedure failed or if it was not run, J2EEError returns:
- the "MustUnderstand" error code if the server does not fulfill the conditions requested by the header,
- an error in the other cases.

Component: wd300com.dll