Introduction
The 51Degrees Java API is designed to be quick to deploy for even low skill developers, and provide accurate, consistent and fast results for both real time device detection within websites, and for offline analysis of web logs. All the source code, and the free Lite data, is licenced under the Mozilla Public Licence version 2 .
The solution is split into two different JAR files:
| 51Degrees.detection. core .jar | The core JAR file contains the core functionality of the detection solution and is used to make any Java application that is going to utilise 51Degrees to detect devices. It is normally used on its own to make applications that are to be run locally rather than on a Java application server. For instance; for off-line log file analysis. | |
| 51Degrees.detection. webapp .jar | The webapp JAR file is used in conjunction with the core JAR file to provide Java web applications with added functionality, such as additional methods in the Provider Object and the ability to share usage data to help improve our detection solution. |
The following pages explain where to download official distributions, initial deployment instructions, obtaining updates to device data before covering more advanced features such as logging and the Trie detection methods. The Javadocs generated from each of the two packages are also available for browsing.
Chapters
-
Prerequisites
Minimum system requirements and test platform configurations.
-
Getting Started
Explains how to download and test Java device detection from the command line without reference to a specific IDE. Contains links to Ant, Netbeans and Eclipse guides.
-
Distributions
Explains the differences between the core and webapp jar packages with links to download from official distributions.
-
Web Applications
Explains how to create a HTTPServlet based web application in Java using Netbeans with a tomcat compliant application server
-
Offline Application
See example of how 51Degrees Java API can be used in an offline user agent analysis application.
-
Image Optimiser
Use 51Degrees Java API to resize images automatically for the viewing device.
-
Automatic Data Updates
Describes how to update the data files and implement automatic updates of the locally held device data using the 51Degrees.mobi cloud services.
-
Client Side Overrides
Learn how to use 51Degrees client side overrides to enhance device detection for some devices with additional JavaScript.
-
User Performance Monitoring
Learn how 51Degrees allows your website to determine how much bandwidth a client has, allowing you to tailor you tailor their experience.
-
Passing Properties To Client Side
Learn how to get device properties detected on your server in client side JavaScript.
-
Logging
Find out have to enable logging with Simple Logging Facade for Java (SLF4J)
-
Accessing Metadata
Learn how to use 51Degrees Java API to obtain metadata about properties and roperty values.
-
Match Metrics
Match metrics provides useful information related to the current match such as the match method, difference value and signature rank. Use this information for a variety of purposes from detecting false positives to providing more relevant reports.
-
Multi-Threading
Explains how to speed up detection with multiple threads.
-
Trie Matching
Explains how the Trie matching method is implemented for device detection
-
Javadocs
Reference documentation created by Javadocs covering all classes, interfaces, methods and properties.
-
License
License terms for 51Degrees.mobi Java source code and free Lite data
