Skip to main content

JavaPOS

JavaPOS for Datalogic Connect, also referred to as SDS JavaPOS, is the Datalogic JavaPOS driver with one additional feature: communication to and from AladdinSDS, the device integration service that is part of Datalogic Connect. Through this integration, the scanners a JavaPOS application uses are the same ones AladdinSDS reports to Datalogic Connect.

This is a preview version of JavaPOS, intended for evaluation only. For more information on the platform and on AladdinSDS, see the Datalogic Connect documentation and the AladdinSDS documentation.

Scope​

This section covers the installation and configuration of SDS JavaPOS on a POS (point of sale) system where AladdinSDS is installed. SDS JavaPOS communicates with AladdinSDS over HTTP and WebSocket, or over HTTPS and secure WebSocket (WSS) with SSL/TLS certificates, on the port that AladdinSDS uses (9000). It runs on Windows and Linux/Ubuntu with a Java 8 or later runtime.

Application integration, the Java platform requirements and the base configuration files follow Datalogic JavaPOS. This section documents only what SDS JavaPOS adds: the AladdinSDS transport, the extra support libraries and the additional configuration attributes. For the platform and application integration guides, see Developing with JavaPOS.

Core concepts​

SDS JavaPOS builds on the following concepts:

  • AladdinSDS transport: The HTTP/WebSocket channel between SDS JavaPOS and AladdinSDS, secured with SSL/TLS when AladdinSDS requires it. Eight support JAR files in the SupportJars directory provide it.
  • dls.properties: The device and connection settings file. Three additional key-value pairs define the CA certificate, the PKCS#12 client certificate and its password for SSL/TLS.
  • jpos.xml: The JavaPOS device registry. Three SDS-specific properties, deviceBus, ipAddress and ipPort, select the AladdinSDS transport and address; a new serialNumber element identifies the device.
  • Device bus: SDS-COM for scanners on the USB-COM interface. See Configuration for the deviceBus values.

For a description of how these parts fit together, see Overview.

Documentation overview​

This documentation is intended for developers and deployment engineers who integrate Datalogic scanners into a JavaPOS application and connect them to Datalogic Connect.

PageContent
OverviewWhat SDS JavaPOS is, how the integration with AladdinSDS works and the configuration model
ConfigurationThe dls.properties SSL/TLS settings and the jpos.xml device registry properties specific to SDS
InstallationPrerequisites and the installer procedure for Windows and Linux/Ubuntu
QuickstartCertificate setup, configuration examples and the required libraries to run a first application
Aladdin SDS API referenceAPI reference of the AladdinSDS service that SDS JavaPOS communicates with
Aladdin SDS (Scanner Events)Event reference of the AladdinSDS service

Read the concept pages to understand the configuration model before changing a production configuration. Use the tutorials when installing or configuring SDS JavaPOS.

Get started​

New users should follow this sequence:

  1. Install AladdinSDS on the POS system. See the AladdinSDS documentation for the installer and the installation procedure.
  2. Install SDS JavaPOS with the setup JAR, as described in Installation.
  3. Configure dls.properties and jpos.xml, then launch your application, following Quickstart.

Use the navigation pane to access the concepts and tutorials that apply to your deployment.