Dies ist ein spezielles Servlet, das für die DLE Kommunikation zwischen Server und Client benötigt wird. Werden in einer DLE Anwendung DLE Dialoge, Nachschlagetabellen oder das Kommando „Script sofort auf Browser ausführen“, bzw. im Parameter „DLE Kommunikation starten“ des <head> Kommandos ein „Ja“ gewählt wurde, ist dieses Servlet zwingend in der web.xml zu definieren.
Auch wenn das Servlet nicht verwendet werden sollte, schlagen wir jedoch vor es grundsätzlich immer zu definieren:
<!--
The client communication handler servlet.
-->
<servlet>
<servlet-name>DLEClientComServlet</servlet-name>
<servlet-class>at.visionflow.dle.dwe.DLEClientCommunicationServlet</servlet-class>
<init-param>
<description>A heartbeat message will be sent to the client every x milliseconds</description>
<param-name>dle.clientCom.HeartbeatMilliseconds</param-name>
<param-value>50000</param-value>
</init-param>
<init-param>
<description>Timeout in milliseconds after which client connections will be dropped</description>
<param-name>dle.clientCom.TimeoutMilliseconds</param-name>
<param-value>180000</param-value>
</init-param>
<init-param>
<description>Default character encoding for the request.</description>
<param-name>dle.request.default.character-encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<description>Default character encoding for the response.</description>
<param-name>dle.response.default.character-encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>DLEClientComServlet</servlet-name>
<url-pattern>/DLEClientCom</url-pattern>
</servlet-mapping>
Die Parameter haben folgende Bedeutung:
| Parameter | Beschreibung |
|---|---|
| dle.clientCom.HeartbeatMilliseconds | Der „Heartbeat“ definiert die Zeitspanne, in der der Browser jeweils mit dem Server neuen Kontakt aufnimmt. Ein typischer Wert von 50000 Millisekunden entspricht 50 Sekunden. |
| dle.clientCom.TimeoutMilliseconds | Zeitspanne, nach der die Verbindung vom Server entfernt wird, falls in dieser Zeit keine Verbindungsaufnahme vom Browser erfolgte. Ein Wert von 180000 Millisekunden entspricht 3 Minuten. |
| dle.request.default.character-encoding | Der Zeichensatz der Anfrage, der als Default verwendet werden soll, wenn keiner beim Aufruf mitgegeben wurde. Z.B. UTF-8. |
| dle.response.default.character-encoding | Der Zeichensatz der Antwort, der als Default verwendet werden soll, wenn keiner bei der Antwort mitgegeben wurde. Z.B. UTF-8. |
Per Default ist das Servlet auf die URL /DLEClientCom gemappt. Dieses Mapping kann auch geändert werden, jedoch ist dazu auch die DLE.JS Variable DLE.dleClientComName auf dem Browser zu ändern. Das kann durch JavaScript nach der Initialisierung der DLE erfolgen.