Note: This topic applies to Web - HTTP/HTML and Silverlight Vuser scripts. It also applies to Web - HTTP/HTML steps inside Flex Vuser scripts.
The GWT-DFE support helps to generate Vuser scripts for GWT-based web sites that use the GWT-RPC mechanism. When you record a GWT-RPC based web site without enabling the GWT-DFE support, the resulting Vuser script may contain significant amounts of data that is cryptic and therefore difficult to decipher, as shown in the code segment below:
The cryptic formatting of the data makes it difficult to identify text strings to be used for correlation, parameterization, and verification.
Tip: The presence of numerous pipes in the recorded data indicates that the recorded site may be a GWT-based web site that uses the GWT-RPC mechanism.
When you enable GWT-DFE support, VuGen is able to decode much of the complex data in the HTTP responses and requests. This enables VuGen to generate Vuser scripts that contain data in XML format. In addition, the original coded data contains only values, without the associated names of the data fields. After applying GWT-DFE, the resulting XML-formatted data includes both the names and the values of the data fields. The XML-formatted data in the scripts is therefore easier to decipher, making the scripts easier to correlate, parameterize, and use for verification purposes.
To enable VuGen to decode the complex data in the HTTP communication, you must identify the .war file that is used by the web application. Occasionally, an application uses .jar files. All considerations below about .war files apply equally to .jar files when used instead of a .war file.
The .war file contains the logic used by GWT to encode and decode the information in the HTTP communication. VuGen needs access to the .war file so that VuGen can perform similar encoding and decoding procedures. Typically, these .war files are located on the application server, under the web applications folder.
Note: Make sure that the .war file that you associate with the Vuser script is the most up-to-date .war file for your application. The .war file is changed each time changes are made to the web application. GWT-DFE support will function correctly only if the most up-to-date .war file is available.
- For an introduction to using DFEs in Vuser scripts, see Data Format Extensions (DFEs) - Overview.
- For details on how to implement DFE support, see How to Implement Data Format Extension (DFE) Support.
- For a full list of the supported DFEs, see Data Format Extension List.
Note: GWT- DFE provides an automatic solution for GWT specific (STRONG_NAME_HEADER) correlations.
What do you want to read about now?
|Original Script - without GWT-DFE Support|
|GWT User|inside object|java.util.HashSet/1594477813|java.lang.String/2004016611|add string1|
|Script after applying GWT-DFE Support|
When VuGen generates or regenerates a Vuser script, VuGen scans the HTTP headers in the requests that are sent to the server. If VuGen detects both a x-gwt-module-base text string and a x-gwt-permutation text string in any of these HTTP headers, VuGen displays a warning in the VuGen Error tab. The warning recommends that you enabale GWT DFE for the Vuser script.
Note: VuGen will continue to issue the above warning - each time the script is generated or regenerated - until the GWT DFE is enabled.
To apply GWT-DEF before recording, perform the following actions:
- Open Recording Options (VuGen --> File --> Recording options)
- Go to the "Data Format Extension --> Chain Configuration” tab
Add a new chain (press the green ‘+’ sign)
The following dialog will open,
4. Select “GWT Extension” and press OK
5. A new window will then open.
To add the most recent WAR / JAR files, press the ‘+’ button and add them from the file system.
6. Enable Data Format Extension
7. Record or regenerate the GWT script
After generating the script using GWT DFE, you will get a readable LoadRunner API that includes the request inside an XML.
The exact same versions of the war and jar files that are on the server must be used by LoadRunner during code generation and replay.
If there are differences, LoadRunner will give an indication during Code Generation and Replay:
The follow errors can occur if the war and jar files do not match:
- Class not found
- Failed to handle WAR entry.
- Failed to de-serialize method
- Missing method
- The correct GWT serialization policy could not be found.
To fix issues, ensure that:
- The GWT DFE is enabled and the chains are configured correctly, including all .JAR, .CLASS and .GWT.RPC files used by the GWT application. After configuring the Chain, regenerate the script.
The Data Format Extension is enabled in runtime settings Data Format -> Chain Configuration -> Enable Data Format Extension.