User guide

This page shows some basic concepts and examples to work with of ODataJClient, Open Source (Apache License 2.0) library that enables Java applications to deal with OData 3.0 services.

Preconditions

• Apache Maven >= 3.0.3
• JDK >= 1.6.0-23

Obtaining ODataJClient

Add the following Maven dependency if you are using the Engine (see options below):

<dependency>
  <groupId>com.msopentech.odatajclient</groupId>
  <artifactId>odatajclient-engine</artifactId>
  <version>0.9.0</version>
</dependency>

or, if you are using the Proxy:

<dependency>
  <groupId>com.msopentech.odatajclient</groupId>
  <artifactId>odatajclient-proxy</artifactId>
  <version>0.9.0</version>
</dependency>

Options available

ODataJClient allows interacting with OData 3.0 services in Java at different levels:

1. Engine
   Low-level communication layer taking care of actual REST communication and OData entity (de)serialization, exposing methods to hook into the OData protocol for manipulating entities and invoking actions and functions.
2. Proxy
   Inspired by JPA, this layer will convert any local change to POJOs and any local invocation of annotated interfaces' methods into actual calls to the Engine layer.