Maven repository

Introduction

The Maven repository for Restlet is accessible from http://maven.restlet.org and contains all Restlet JARs and third party dependencies that aren't available in the main public Maven repository. It is automatically refreshed once a day if the build succeeds.

Recommended configuration

Here are some instructions about how to configure Maven client to work with the online Maven repository.

  1. Declare the repository for your project or for a parent project by updating the pom.xml file and adding the following code to the <repositories> section: 
    <repository>
   <id>maven-restlet</id>
   <name>Public online Restlet repository</name>
   <url>http://maven.restlet.org</url>
</repository>
  2. As an alternative, you can also declare the repository for all of your projects. Go to the directory on the local computer where you just install Maven. Open and edit conf/settings.xml file. Add to the <profiles> section the following code: 
    <profile>
  <id>restlet</id>
  <repositories>
     <repository>
        <id>maven-restlet</id>
        <name>Public online Restlet repository</name>
        <url>http://maven.restlet.org</url>
     </repository>
  </repositories>
</profile>
    Just after the </profiles> add the following: 
    <activeProfiles>
    <activeProfile>restlet</activeProfile>
</activeProfiles>

Available artifacts

The following table lists the available artifacts and their group and artifact ids. With the introduction of the editions for the Restlet framework, it is necessary to make a distinction between an extension for a given edition and the same extension for another extension simply because the code of the extension may change between each edition. This distinction is reflected in the group id of each artifacts which contains a reference to an edition. They are all set on the same pattern: "org.restlet.<edition>" where "<edition>" is three-letters code of an edition among: jse (Java SE edition), jee (Java EE edition), gae (Google App Engine edition), android (Android edition) and gwt (google Web Toolkit edition). You can find here a full view of the list of extensions and the editions that ship them.
Group id Artifact id Description
org.restlet.<edition> org.restlet Restlet API
org.restlet.<edition> org.restlet.example Examples
org.restlet.<edition> org.restlet.ext.atom Atom extension
org.restlet.<edition> org.restlet.ext.crypto Cryptography extension including Amazon S3 and Windows Azure client authentication.
org.restlet.<edition> org.restlet.ext.fileupload Integration with Apache FileUpload.
org.restlet.<edition> org.restlet.ext.freemarker Integration with FreeMarker.
org.restlet.<edition> org.restlet.ext.grizzly Integration with Grizzly NIO framework.
org.restlet.<edition> org.restlet.ext.gwt Server-side integration with GWT.
org.restlet.<edition> org.restlet.ext.httpclient Integration with Apache HTTP Client.
org.restlet.<edition> org.restlet.ext.jaas Support for JAAS authentication and authorization framework.
org.restlet.<edition> org.restlet.ext.jackson Integration with Jackson.
org.restlet.<edition> org.restlet.ext.javamail Integration with JavaMail (POP3 and SMTP clients)
org.restlet.<edition> org.restlet.ext.jaxb Integration with Java XML Binding (JAXB).
org.restlet.<edition> org.restlet.ext.jaxrs Implementation of JAX-RS.
org.restlet.<edition> org.restlet.ext.jdbc Integration with Java DataBase Connectivity (JDBC).
org.restlet.<edition> org.restlet.ext.jetty Integration with Jetty.
org.restlet.<edition> org.restlet.ext.jibx Integration with JiBX.
org.restlet.<edition> org.restlet.ext.json Support for JSON representations.
org.restlet.<edition> org.restlet.ext.lucene Integration with Apache Lucene.
org.restlet.<edition> org.restlet.ext.net Integration with Java URLConnection class.
org.restlet.<edition> org.restlet.ext.netty Integration with Netty.
org.restlet.<edition> org.restlet.ext.odata Support for the OData Services.
org.restlet.<edition> org.restlet.ext.rdf Support for the RDF parsing and generation.
org.restlet.<edition> org.restlet.ext.rome Integration with ROME.
org.restlet.<edition> org.restlet.ext.servlet Integration with Servlet API.
org.restlet.<edition> org.restlet.ext.simple Integration with Simple Framework.
org.restlet.<edition> org.restlet.ext.slf4j Integration with SLF4J.
org.restlet.<edition> org.restlet.ext.spring Integration with Spring Framework.
org.restlet.<edition> org.restlet.ext.ssl Support for SSL utilities and integration with jSSLutils library.
org.restlet.<edition> org.restlet.ext.velocity Integration with Apache Velocity.
org.restlet.<edition> org.restlet.ext.wadl Support the WADL specification.
org.restlet.<edition> org.restlet.ext.xdb Integration with Oracle 11g XML DB feature.
org.restlet.<edition> org.restlet.ext.xml Support for XML and XSLT representations.
org.restlet.<edition> org.restlet.ext.xstream Integration with XStream.
org.restlet.<edition> org.restlet.test Test module.

Sample dependencies declaration

Each project based on the Restlet framework needs to declare at least one dependency: the Restlet core module. According to your needs, you should complete the list of dependencies with the required extensions and connectors. For example, assuming your project is a Web server delivering static files, you need one HTTP server connector such as Simple. Since your Maven client correctly references the Restlet online repository, just open and edit the pom.xml file for your project and add the following lines of text into the <dependencies> section. 

<dependency>
   <groupId>org.restlet.jse</groupId>
   <artifactId>org.restlet</artifactId>
   <version>2.0.0</version>
</dependency>
<dependency>
   <groupId>org.restlet.jse</groupId>
   <artifactId>org.restlet.ext.simple</artifactId>
   <version>2.0.0</version>
</dependency>