Connectors

Introduction

A connector in the REST architecture style is a software element that manages network communication for a component, typically by implementing a network protocol (e.g. HTTP). A client connector initiates communication with a server (of any kind) by creating a request. A server connector listens for connections (from clients of any kind), transmits the request to the component that performs the request processing, creates the response and sends it to the client.

All connectors are provided as extensions of the Noelios Restlet Engine, the reference implementation of the Restlet API.

This document will describe how to add a connector to your application, how to configure it and will give you the list of available server and client connectors.

Add a connector to your application

All connectors and their dependencies are shipped with the Restlet distribution by the way of jar files. Adding a connector to your application is as simple as adding the archives of the chosen connector and its dependencies to the classpath.
You can also have a look to the FAQ #4 and FAQ #5 which completes this subject.

Configuration

Each connector looks for its configuration from its context. The latter provides a list of modifiable parameters, which is the right place to set up the connector's configuration. Some parameters are defined by the NRE engine and thus are shared by all clients (in the ClientHelper hierarchy) and server connectors (in the ServerHelper hierarchy), and most of them by the connector's ClientHelper or ServerHelper subclasses.

The list of all parameters are available in the javadocs. Pleaser refer to the rest of this document for references to these documentation.

List of available connectors

Server connectors

Extension	Version	Protocols
AsyncWeb	0.8	HTTP
Jetty	6.1	HTTP, HTTPS, AJP
Simple	3.1	HTTP, HTTPS

Client connectors

Extension	Version	Protocols
Apache HTTP Client	3.1	HTTP, HTTPS
Net	1.0	HTTP, HTTPS
JavaMail	1.4	SMTP, SMTPS
JDBC	1.0	JDBC
NRE Local	1.0	CLAP, FILE, WAR

Note also that Restlet applications can be served from Servlet containers via the ServerServlet adapter. This extension can be viewed as a connector, even if it is more an adapter than a connector. Please check the Integrations section for more details.