Wire listener
The wire listener is a mid-tier gateway server that enables communication between MongoDB, REST API, and MQTT clients and the HCL OneDB™ database server.
The wire listener is a Java™ application and is provided as an executable JAR file, $INFORMIXDIR/bin/jsonListener.jar, that is included with the database server. The JAR file provides access to the MongoDB API, the REST API, and the MQTT protocol.
- MongoDB API access
- The wire listener implements the MongoDB Wire Protocol. This allows you to connect MongoDB applications and client drivers to the HCL OneDB database through the wire listener. The MongoDB applications send MongoDB operations and commands to the wire listener, which automatically translates those commands to SQL which it runs against the HCL OneDB database using JDBC.
- REST API access
- The wire listener provides a REST API to your HCL OneDB JSON/BSON collections, relational tables, or TimeSeries tables. Data from the REST API is return back to the HTTP client in JSON format.
- MQTT protocol access
- The wire lisetner implements the MQTT protocol to allow MQTT clients to publish data to the HCL OneDB database through the wire listener. You can use MQTT to publish to JSON/BSON collections, relational tables, or TimeSeries tables.
The wire listener configuration properties file defines every operational characteristic. By default, when you create a database or a table through the wire listener, automatic location and fragmentation are enabled. Databases are stored in the dbspace that is chosen by the server. Tables are fragmented among dbspaces that are chosen by the server. More fragments are added when tables grow.
The default logging mechanism for the wire listener is Logback. Logback is pre-configured and installed along with the JSON components.