Java Useragent ANalyzer

A fast, thread-safe and dependency-free user agent parser for Java 8+.

Usage

Simply add the library to the dependency section of your pom.xml (if you’re using Maven):

<dependency>
  <groupId>com.github.codesorcery</groupId>
  <artifactId>juan</artifactId>
  <version>0.2.0</version>
</dependency>

Or add it to your build.gradle (if you’re using Gradle):

dependencies {
  compile('com.github.codesorcery:juan:0.2.0')
}

The library can then be used as follows:

import com.github.codesorcery.juan.UserAgentParser;
import com.github.codesorcery.juan.ParsedUserAgent;
import java.io.IOException;
import java.net.URL;
import java.nio.charset.Charset;
public class UserAgentParserExample {
    private final UserAgentParser userAgentParser;
    public UserAgentParserExample() throws IOException {
        // To detect the device name and vendor for Android devices, we use Google's device list:
        URL deviceList =
                new URL("http://storage.googleapis.com/play_public/supported_devices.csv");
        userAgentParser =
                UserAgentParser.withPlayStoreDeviceList(deviceList, Charset.forName("UTF-16"));
        // If you do not need Android device info, you can use the parser without the device list:
        // userAgentParser = UserAgentParser.withoutPlayStoreDeviceList();
    }
    public void parsingExample() {
        String userAgentString =
                "Mozilla/5.0 (Linux; Android 7.0; SM-G892A Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/60.0.3112.107 Mobile Safari/537.36";
        ParsedUserAgent parsed =
                userAgentParser.parse(userAgentString);
        parsed.agent().getVendor(); // => Google
        parsed.agent().getName(); // => Chrome Mobile
        parsed.agent().getVersion(); // => 60.0.3112.107
        parsed.agent().getType(); // => Browser (mobile)
        parsed.agent().isCrawler(); // => false
        parsed.os().getVendor(); // => Google
        parsed.os().getName(); // => Android
        parsed.os().getVersion(); // => 7.0
        parsed.os().getType(); // => Mobile
        parsed.device().getVendor(); // => Samsung
        parsed.device().getName(); // => Galaxy S8 Active
    }
}

Benchmark

Benchmark performed on an Intel® Core™ 2 Duo P8600 CPU @ 2.4GHz: