<![CDATA[
# DeviceAtlas Cloud Client API Installation #
This section deals with installing the DeviceAtlas Cloud API.
### Requirements ###
* Java 6 runtime or higher
### Installation ###
Simply place the "deviceatlas-cloud-java-client-2.2.jar" on your class path to include in your application.
#### Maven ####
```xml
<dependencies>
<dependency>
<groupId>com.deviceatlas</groupId>
<artifactId>cloud.deviceidentification</artifactId>
<version>2.2</version>
<scope>system</scope>
<systemPath>${project.basedir}/path/to/deviceatlas-cloud-java-client-2.2.jar</systemPath>
</dependency>
</dependencies>
```
### Cache providers ###
DeviceAtlas Cloud Client API requires a cache provider to cache device data and
cloud end-point lists. A simple in-memory cache and an alternative file cache are provided.
To use the in-memory cache instantiate the client with the SimpleCacheProvider cache provider.
To use the file cache instantiate the client with the FileCacheProvider cache provider.
The API includes a cache provider interface to allow for custom
caching solutions.
### Java Requirements ###
The API requires at least Java 6. The methods
`getResult(HttpServletRequest request)` and `getDeviceData(HttpServletRequest request)`
must only be used inside a servlet container. The other getResult / getDeviceData methods
may be used outside a servlet container and do not require the JavaEE libraries on the classpath.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
_ Copyright (c) DeviceAtlas Limited 2023. All Rights Reserved. _
_ https://deviceatlas.com _
<!-- HTML+JS for document formatting when opened in browser -->
<div class="btn-group" id="main-menu" style="float:right"><a class="btn dropdown-toggle" data-toggle="dropdown" href="#">Menu<span class="caret"></span></a><ul class="dropdown-menu"><li><a href="README.html">Cloud Client API</a></li><li class="disabled"><a href="README.Installation.html">Cloud Client API Installation</a></li><li><a href="README.Config.html">Cloud Client API Configuration</a></li><li><a href="./Javadoc/index.html">DeviceAtlas Cloud Client API doc</a></li></ul></div>]]>