Über den Kontext Parameter dle.sessionPool.factoryClass wird angegeben, auf welche Art die Verbindung zur DLE hergestellt werden soll:
- at.visionflow.dle.dwe.DLELocalDLEServerApiFactory
- at.visionflow.dle.dwe.DLELocalServletApiFactory
- at.visionflow.dle.dwe.DLERemoteServletApiFactory
- at.visionflow.dle.dwe.DLEAutomaticApiFactory
Die DLELocalDLEServerApiFactory wird benutzt, um die Verbindung aus dem im DLE Server integrierten Jetty Webserver zu erstellen. Diese Verbindungsart benötigt keine weiteren Parameter.
Die DLELocalServletApiFactory kann bei einem Apache Tomcat, sowie bei Tomcat basierenden Webservern (z.B. JBoss) eingesetzt werden.
Sie erweitert den (Tomcat) Webserver so, dass er eine bestehende DLE Installation als Subsystem verwendet. Dazu muss in dem Parameter dle.sessionPool.localfactory.home das Installationsverzeichnis der DLE angegeben werden.
Die DLERemoteServletApiFactory kann verwendet werden, um vom Webserver aus, über die DLE Socket Schnittstelle, einen separaten DLE Server zu verwenden. Dazu müssen in den Parametern dle.sessionPool.remotefactory.host und dle.sessionPool.remotefactory.port der Hostname oder die IP Adresse des Servers sowie der Port des dort konfigurierten Adapters angegeben werden.
Alternativ können diese Parameter auch über eine externe Property Datei oder die System Properties gesetzt werden. Eine externe Property Datei kann dabei über das web.xml Kontext Parameter dle.sessionPool.remotefactory.configfile definiert werden. Ist eine Property Datei definiert, wird zuerst darin nach den Parametern für den Host und den Port gesucht, sind diese dort nicht gesetzt, wird in den Java System Properties nach den Parametern gesucht, sind diese auch dort nicht gesetzt, wird die Einstellung aus der web.xml genommen. Im Dateinamen der Property Datei können Java System Properties als Platzhalter verwendet werden, in der Form ${PropertyName}, also z.B.:
<param-name>
dle.sessionPool.remotefactory.configfile
</param-name>
<param-value>
${SAPS_CONFIG_DIR}/Config.properties
</param-value>
Entsprechend der Einstellung erfolgt dann jeweils die Verbindung zur DLE. Dabei werden die Verbindungen gepoolt, d.h. Es existiert schon eine Reihe von vorgefertigten Verbindungen und diese werden je nach Bedarf von der DWE verwendet. Die Poolgröße (Min/Max) lässt sich auch konfigurieren, sowie ein Timeout nach dem inaktive Verbindungen (z.B. durch beenden des Browsers oder verlassen der Webseite) wieder gelöscht und zur neuen Verwendung freigegeben werden.
Die DLEAutomaticApiFactory entscheidet automatisch, ob eine DLERemoteServletApiFactory oder eine DLELocalDLEServerApiFactory verwendet werden soll. Läuft die Webanwendung innerhalb des integrierten Jetty Webservers, wird die DLELocalDLEServerApifactory verwendet, sonst die DLERemoteServletApiFactory. Diese Einstellung erlaubt es ein und dieselbe web.xml Konfiguration sowohl in einem lokalen Server, z.B. zur Entwicklung, als auch eine Remote Variante, z.B. einem Tomcat Produktivsystem, zu verwenden.