UASparser

A fast User Agent parser library, using data from user-agent-string.info

**NOTE:** As of December 1, 2014, the upstream User Agent database is no longer free and the old update URL is returning *bad data*.

This means that the OnlineUpdater, OnlineUpdateUASparser, and CachingOnlineUpdateUASparser APIs will retrieve an incorrect database and must be disabled immediately. If you were using any of these methods, please update your code as in the example below.

You may continue to use this library with the bundled UA database, as long as updating is disabled.

Install

UASparser is available via Maven Central:

Group ID: cz.mallat.uasparser
Artifact ID: uasparser

View the latest artifact info.

Usage

Simply use UASparser or any of its subclasses like so:

UASparser parser = new UASparser(OnlineUpdater.getVendoredInputStream());
UserAgentInfo info = parser.parse("Mozilla/4.0 (compatible; MSIE 7.0;
Windows NT 5.1; )");

This will create a new parser and initialize it with a bundled copy of the database.

In addition, there are a few different parser classes available:

UASparser - Default parser, thread-safe
MultithreadedUASparser - A faster variant of UASparser, uses a bit more memory
SingleThreadedUASparser - Non-threadsafe variant, ideal for Hadoop and similar use cases
BrowserFamilyParser - UASparser subclass which only returns the browser family string

Building

Building requires Apache buildr:

$ [sudo] gem install buildr

To build UASparser:

$ git clone https://github.com/chetan/UASparser.git
$ cd UASparser
$ buildr package

Binaries will be placed in target.

Dependencies

JRegex

Changelog

0.6.2 - 2014-12-03

Disabled online updates (for now)

0.6.1 - 2014-09-09

Fixed device detection logic (issue #12, #13)

n/a - 2013-11-16

Now available via Maven Central

0.6.0 - 2013-10-08

added support for the [device] and [device_reg] sections

0.5.0 - 2013-05-29

Handle version API errors (issue #3)
Defer initial update on startup (don't block)
Apply jitter after every update

0.4.1 - 2013-05-21

Added UserAgentInfo#getBrowserVersionInfo() method
Documented all UserAgentInfo reader methods

0.4 - 2012-11-08

Added a new, fast, thread-safe MultithreadedUASparser (thanks to Michael Remme)
New OnlineUpdater class replaces the old OnlineUpdateUASparser and CachingOnlineUpdateUASparser classes which are now deprecated
OnlineUpdater will fallback to a vendored copy if no cached version exists and update fails
Minor bugfixes

License

LGPL. See LICENSE file for details.

qizy09/UASparser