Wire listener

The wire listener is a mid-tier gateway server that enables communication between MongoDB, REST API, and MQTT clients and the Informix® 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
You can connect to a JSON collection with the MongoDB API by using the MongoDB Wire Protocol.
When a MongoDB client is connected to the wire listener and requests a connection to a database, the wire listener creates a connection.
REST API access
You can connect to a JSON collection by using the REST API.
When a client is connected to the wire listener through the REST API, each database is registered. The wire listener registers to receive session events such as create or drop a database. If a REST request refers to a database that exists but is not registered, the database is registered and a redirect to the root of the database is returned.
MQTT protocol access
You can connect to a JSON collection by using the MQTT protocol.
When an MQTT client publishes data to the wire listener, the wire listener creates a connection to the database for inserting the data.

The wire listener connection properties file, named jsonListener.properties by default, defines every operational characteristic.

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.