ConnectionProvider Module Introduction

The ConnectionProvider module provides an API for providing pluggable network connections objects to Qore. This module can also be used to provide connection objects and URL strings from identifiers from registered connection providers as well.

To use this module, use "%requires ConnectionProvider" in your code.

All the public symbols in the module are defined in the ConnectionProvider namespace.

Classes:

Hashdecls:

Functions:

Connection Provider Modules

This module uses the "QORE_CONNECTION_PROVIDERS" environment variable to load connection provider modules. Each connection provider module must provide two public functions with the following signatures:

# returns a ConnectionProvider::AbstractConnection object for the given identifier or throws an exception
public ConnectionProvider::AbstractConnection sub get_mod_connection(string str) {}
# returns a hash keyed by connection identifiers with values as ConnectionProvider::AbstractConnection objects for all
# connections known to the connection provider
public *hash sub get_mod_connections() {}

Connection provider modules declared in the "QORE_CONNECTION_PROVIDERS" environment variable must be separated by the platform-specific PathSep character as in the following examples:

Unix Example

export QORE_CONNECTION_PROVIDERS=MyConnectionProvider:OtherConnectionProvider

Windows CMD.EXE Example

set QORE_CONNECTION_PROVIDERS=MyConnectionProvider;OtherConnectionProvider

Windows PowerShell Example

$env:QORE_CONNECTION_PROVIDERS="MyConnectionProvider;OtherConnectionProvider"

Release Notes

ConnectionProvider 1.11

added the encode_chars HTTP / REST connection option (issue 4869)
fixed a bug where the I/O thread could stall and no longer ping any connection (issue 4896)
fixed a deadlock issue with connection updates in code using this module (issue 4860)
do not change the connection status based on whether or not a connection can be made (issue 4852)
allow connections to be added, updated, and removed while already holding the connection lock (issue 4849)

ConnectionProvider 1.10

assume connections are up until they are proven to be down (issue 4789)
fixed a bug where the InvalidConnection class would report an invalid url hash (issue 4785)
added a logger interface to the abstract base connection class (issue 4776)
added a connection-defined capability list to connection info (issue 4771)

ConnectionProvider 1.9.2

fixed a bug where the HttpConnection scheme could not be used (issue 4753)
allow connection options designating files to be selected as files (issue 4725)

ConnectionProvider 1.9.1

added a transaction capability flag for data providers to the connection info hash (issue 4722)

ConnectionProvider 1.9

ensure that exception attributes from ping errors are serializable (issue 4708)

ConnectionProvider 1.8

added the headers option to HTTP connections (HttpConnection) (issue 4695)

ConnectionProvider 1.7.4

set connection status to OK after a successful manual ping operation (issue 4685)

ConnectionProvider 1.7.3

support full ping operations, also with polling, using an authenticated request (issue 4677)
fixed bugs handling child capability attributes in connections (issue 4656)

ConnectionProvider 1.7.2

removed unnecessary extraneous inheritance of Serializable from the AbstractConnectionWithInfo class
added support for the pre_encoded_urls option in the HttpConnection class (issue 4656)

ConnectionProvider 1.7.1

non-blocking polling fixes (issue 4595)

ConnectionProvider 1.7

allow multiple connections to be polled from a single thread; added:
fixed a bug acquiring a data provider object from connection objects (issue 4584)

ConnectionProvider 1.6

added data provider capability info to connection info (issue 4579)

ConnectionProvider 1.5

updated the AbstractConnection::getInfo() method
added the AbstractConnection::getExtendedInfo() method

ConnectionProvider 1.4.1

connection path options are subjected to environment variable substitution (issue 4236)

ConnectionProvider 1.4

implemented support for a data provider scheme cache and rich option information for connections (issue 4025)

ConnectionProvider 1.3

implemented support for serializing connections and removed the AbstractConnection::getConstructorInfo() and AbstractConnection::getConstructorInfoImpl() methods (issue 3696)
implemented support for the data provider API (issue 3545)

ConnectionProvider 1.2.1

implemented support for connection tags as the attribute "tags" (issue 3486)

ConnectionProvider 1.2

the AbstractConnection::constructor() refactoring
all connection clases have unified constructor
old constructors and static make() constructors are deprecated
ConnectionProvider::AbstractConnection::parseUrl() is introduced
ConnectionProvider::AbstractConnection::getSafeUrl() is not static anymore
it allows their reimplementation in the inherited class. It can be used to parse strange and unexpected URLs like eg. pure json strings, or Datasource connection strings.

ConnectionProvider 1.1

the AbstractConnection::getConstructorInfo() method (and supporting declarations) was added to allow connections to be created dynamically, potentially in another process from a network call (issue 2628)

ConnectionProvider 1.0.1

removed unnecessary serialization from ConnectionProvider::AbstractConnection::get() "AbstractConnection::get()" (issue 2880)

ConnectionProvider 1.0

the initial version of the ConnectionProvider module

Table of Contents