<![CDATA[
# DeviceAtlas Enterprise API Installation #
This section deals with installing the DeviceAtlas Enterprise API.
### Dependencies ###
This library does not depend on any third party libraries.
### Library ###
The DeviceAtlas Enterprise API consists of two libraries and each
library has a separate jar file.
#### DeviceAtlas Enterprise API (deviceatlas-enterprise-java-x.x.jar) ####
This library contains the DeviceAtlas Device and Carrier APIs.
Device detection is achieved by passing a set of request headers or a
user-agent along with optional Client-side properties. Carrier detection
is achieved by passing a set of request headers or an IP address.
#### DeviceAtlas Enterprise API Web (deviceatlas-enterprise-java-web-x.x.jar) ####
This is an extension to the above library where Device and Carrier detection
is achieved by passing a `HttpServletRequest` object. This library retrieves the
relevant headers from the `HttpServletRequest` object. Unless the `HttpServletRequest`
object is not available or when processing an off-line user-agent list or
header set, it is strongly recommended to use this library over the above library.
### Configuration ###
The DeviceAtlas Enterprise API can be added as a dependency to a project using either Maven or Gradle.
#### Gradle ####
The following configuration should be added to the build.gradle file in the project:
Replace LICENCE_KEY with your DeviceAtlas Enterprise licence key.
```
...
// DeviceAtlas Enterprise API repository URL
repositories {
maven {
url "https://java-api.deviceatlas.com/LICENCE_KEY/"
}
}
dependencies {
implementation (group: "com.deviceatlas", name: "deviceatlas-enterprise-java", version: "3.1.5")
// OR
implementation (group: "com.deviceatlas", name: "deviceatlas-enterprise-java-web", version: "3.1.5")
}
```
#### Maven ####
Add the DeviceAtlas dependency to the pom.xml file in the project.
Replace LICENCE_KEY with your DeviceAtlas Enterprise licence key.
```xml
<project ... >
...
<!-- DeviceAtlas Enterprise API repository URL -->
<repositories>
<repository>
<id>deviceatlas</id>
<url>https://java-api.deviceatlas.com/LICENCE_KEY/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.deviceatlas</groupId>
<artifactId>deviceatlas-enterprise-java</artifactId>
<version>3.1.5</version>
</dependency>
<!-- Or -->
<dependency>
<groupId>com.deviceatlas</groupId>
<artifactId>deviceatlas-enterprise-java-web</artifactId>
<version>3.1.5</version>
</dependency>
</dependencies>
</project>
```
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
_ 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">Main</a></li><li class="disabled"><a href="README.Installation.html">Enterprise API Installation</a></li><li><a href="README.DataFile.html">Data File Configuration</a></li><li><a href="README.DeviceApi.html">Device API Usage</a></li><li><a href="README.ClientHints.html">Client Hints Support</a></li><li><a href="README.Upgrade.html">Device API Upgrade</a></li><li><a href="README.CarrierApi.html">Carrier Identification API</a></li><li class="divider"></li><li><a href="./Javadoc/index.html">Javadoc</a></li></ul></div>]]>