Release XLT 5.2.0

doc/xltdoc/release-notes/5.2.x.textile

@@ -0,0 +1,54 @@
+---
+layout: manual
+title: 5.2.x
+position: 982
+sorted: true
+---
+
+h2. XLT 5.2.0
+
+See "here":https://github.com/Xceptance/XLT/milestone/6?closed=1 for the complete list of improvements and fixes.
+
+h3. Test Framework
+
+h4. Update 3rd-party libraries
+
+The 3rd-party libraries @htmlunit@ and @htmlunit-driver@ have been updated to version 2.43.
+
+h4. Result browser shows strange status message
+
+The result browser shows the status of a response on the _Request Overview_ tab as a pair of status code and status message, for example "200 - OK". When using a Chrome browser via @XltChromeDriver@, the status might sometimes be shown mixed up, such as "200 - HTTP/1.1 200". Fixed now.
+
+Please note that the status may now also be displayed as "200 - n/a". In this case, a status message was not provided by the server, which is typical for HTTP/2 connections.
+
+h4. Result browser fails to load responses
+
+When creating a result browser directory, the names of response content files are now truncated to 80 characters. This reduces the likelihood of the result browser not being able to load a response content file because the full path to the file exceeds the path length limits imposed by your OS.
+
+If you still have issues viewing the content of certain responses, try moving the result browser to a top-level directory with only a short name.
+
+h4. Empty template elements
+
+The result browser also shows the rendered HTML pages as seen by HtmlUnit. While some references/paths may have been rewritten to point to resources on the local disk, the DOM tree of the rendered page typically resembles the original page source closely. However, if there were @<template>@ tags in the page source, the corresponding template elements can still be found in the rendered page, but their content was gone. Now the content is preserved.
+
+h4. Custom user agent replaced when appending a request ID
+
+XLT can be instructed to automatically append a random request ID to the @User-Agent@ request header. However, if a test scenario customized the user agent header for a certain request, that custom user agent was replaced again with the default user agent value when appending the request ID. This is fixed now.
+
+
+h3. Load Testing
+
+h4. Non-interactive mode for the master controller
+
+In order to better fit into highly-automated environments, the master controller has been improved to ease scripting. With the new command line option @-c <commandList>@ (or @--commands <commandList>@) you can now specify which commands the master controller should execute on your behalf in a non-interactive fashion. This way, typical use cases can be scripted quite easily:
+
+* upload the test suite and start the load test (@mastercontroller.sh -c upload,start@)
+* download the results of a running load test and generate a report from them (@mastercontroller.sh -c download,report@)
+* abort a running load test (@mastercontroller.sh -c abort@)
+* abort a running load test, download the final results, and generate a report from them (@mastercontroller.sh -c abort,download,report@)
+
+Please note that the master controller executes the commands exactly as specified on the command line which means in the same order and quantity.
+
+h4. Ignore invalid characters in the test results
+
+During a load test, the load test scenarios generate a lot of data, not only measurements, but also custom strings, such as error and event messages. Typically, those custom strings are displayed somewhere in the load test report as well. In case they contain special characters that are not valid according to the XML 1.0 specification, generating the load test report from this data failed later on. Now such special characters are silently removed.

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.xceptance</groupId>
     <artifactId>xlt</artifactId>
-    <version>5.1.2</version>
+    <version>5.2.0</version>
     <packaging>jar</packaging>
 
     <name>XLT</name>
@@ -67,7 +67,7 @@
         <maven.compiler.target>1.8</maven.compiler.target>
         <asm.version>7.1</asm.version>
         <httpclient.version>4.5.12</httpclient.version>
-        <jetty.version>9.4.27.v20200227</jetty.version>
+        <jetty.version>9.4.31.v20200723</jetty.version>
         <log4j.version>2.13.1</log4j.version>
         <copyright>Copyright (c) ${project.inceptionYear}-2020 ${project.organization.name}</copyright>
     </properties>
@@ -120,12 +120,12 @@
         <dependency>
             <groupId>commons-io</groupId>
             <artifactId>commons-io</artifactId>
-            <version>2.6</version>
+            <version>2.7</version>
         </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
-            <version>3.10</version>
+            <version>3.11</version>
         </dependency>
         <dependency>
             <groupId>commons-logging</groupId>
@@ -135,12 +135,12 @@
         <dependency>
             <groupId>commons-net</groupId>
             <artifactId>commons-net</artifactId>
-            <version>3.6</version>
+            <version>3.7</version>
         </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-text</artifactId>
-            <version>1.8</version>
+            <version>1.9</version>
             <exclusions>
                 <exclusion>
                     <groupId>org.apache.commons</groupId>
@@ -156,7 +156,7 @@
         <dependency>
             <groupId>net.sourceforge.htmlunit</groupId>
             <artifactId>htmlunit-core-js</artifactId>
-            <version>2.39.0</version>
+            <version>2.43.0</version>
         </dependency>
         <dependency>
             <groupId>net.sourceforge.htmlunit</groupId>
@@ -176,14 +176,19 @@
         <dependency>
             <groupId>net.sourceforge.htmlunit</groupId>
             <artifactId>neko-htmlunit</artifactId>
-            <version>2.39.0</version>
+            <version>2.43.0</version>
             <exclusions>
                 <exclusion>
                     <groupId>xerces</groupId>
                     <artifactId>xercesImpl</artifactId>
                 </exclusion>
             </exclusions>
         </dependency>
+        <dependency>
+            <groupId>com.shapesecurity</groupId>
+            <artifactId>salvation</artifactId>
+            <version>2.7.2</version>
+        </dependency>
         <dependency>
             <groupId>org.eclipse.jetty.websocket</groupId>
             <artifactId>websocket-client</artifactId>
@@ -312,7 +317,7 @@
         <dependency>
             <groupId>org.seleniumhq.selenium</groupId>
             <artifactId>htmlunit-driver</artifactId>
-            <version>2.39.0</version>
+            <version>2.43.1</version>
             <exclusions>
                 <exclusion>
                     <groupId>net.sourceforge.htmlunit</groupId>

samples/testsuite-performance/config/default.properties

@@ -139,9 +139,8 @@ com.xceptance.xlt.http.responseId.headerName = X-XLT-ResponseId
 
 ## Indicates the browser to simulate. Possible values are:
 ## - "FF" ...... Firefox 68 (default)
-## - "FF74" .... Firefox 74
+## - "FF79" .... Firefox 79
 ## - "FF68" .... Firefox 68
-## - "FF60" .... Firefox 60
 ## - "IE" ...... Internet Explorer
 ## - "CH" ...... Chrome
 ## This setting is important for the user agent string and for the JavaScript 

samples/testsuite-posters/config/default.properties

@@ -139,9 +139,8 @@ com.xceptance.xlt.http.responseId.headerName = X-XLT-ResponseId
 
 ## Indicates the browser to simulate. Possible values are:
 ## - "FF" ...... Firefox 68 (default)
-## - "FF74" .... Firefox 74
+## - "FF79" .... Firefox 79
 ## - "FF68" .... Firefox 68
-## - "FF60" .... Firefox 60
 ## - "IE" ...... Internet Explorer
 ## - "CH" ...... Chrome
 ## This setting is important for the user agent string and for the JavaScript 

samples/testsuite-showcases/config/default.properties

@@ -139,9 +139,8 @@ com.xceptance.xlt.http.responseId.headerName = X-XLT-ResponseId
 
 ## Indicates the browser to simulate. Possible values are:
 ## - "FF" ...... Firefox 68 (default)
-## - "FF74" .... Firefox 74
+## - "FF79" .... Firefox 79
 ## - "FF68" .... Firefox 68
-## - "FF60" .... Firefox 60
 ## - "IE" ...... Internet Explorer
 ## - "CH" ...... Chrome
 ## This setting is important for the user agent string and for the JavaScript 

samples/testsuite-template/config/default.properties

@@ -139,9 +139,8 @@ com.xceptance.xlt.http.responseId.headerName = X-XLT-ResponseId
 
 ## Indicates the browser to simulate. Possible values are:
 ## - "FF" ...... Firefox 68 (default)
-## - "FF74" .... Firefox 74
+## - "FF79" .... Firefox 79
 ## - "FF68" .... Firefox 68
-## - "FF60" .... Firefox 60
 ## - "IE" ...... Internet Explorer
 ## - "CH" ...... Chrome
 ## This setting is important for the user agent string and for the JavaScript 

samples/testsuite-xlt/config/default.properties

@@ -139,9 +139,8 @@ com.xceptance.xlt.http.responseId.headerName = X-XLT-ResponseId
 
 ## Indicates the browser to simulate. Possible values are:
 ## - "FF" ...... Firefox 68 (default)
-## - "FF74" .... Firefox 74
+## - "FF79" .... Firefox 79
 ## - "FF68" .... Firefox 68
-## - "FF60" .... Firefox 60
 ## - "IE" ...... Internet Explorer
 ## - "CH" ...... Chrome
 ## This setting is important for the user agent string and for the JavaScript 

src/main/java/com/gargoylesoftware/htmlunit/AbstractPage.java

@@ -24,7 +24,7 @@
 public class AbstractPage implements Page {
 
     private final WebResponse webResponse_;
-    private WebWindow enclosingWindow_;
+    private final WebWindow enclosingWindow_;
 
     /**
      * Creates an instance.