/* *********************************************************************
* This Source Code Form is copyright of 51Degrees Mobile Experts Limited.
* Copyright 2017 51Degrees Mobile Experts Limited, 5 Charlotte Close,
* Caversham, Reading, Berkshire, United Kingdom RG4 7BY
*
* This Source Code Form is the subject of the following patents and patent
* applications, owned by 51Degrees Mobile Experts Limited of 5 Charlotte
* Close, Caversham, Reading, Berkshire, United Kingdom RG4 7BY:
* European Patent No. 2871816;
* European Patent Application No. 17184134.9;
* United States Patent Nos. 9,332,086 and 9,350,823; and
* United States Patent Application No. 15/686,066.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0.
*
* If a copy of the MPL was not distributed with this file, You can obtain
* one at http://mozilla.org/MPL/2.0/.
*
* This Source Code Form is "Incompatible With Secondary Licenses", as
* defined by the Mozilla Public License, v. 2.0.
********************************************************************** */
package Tutorials;
import FiftyOneDegreesTrieV3.Match;
import FiftyOneDegreesTrieV3.Provider;
import FiftyOneDegreesTrieV3.LibLoader;
import java.io.Closeable;
import java.io.IOException;
/**
*
* Strongly Typed example of using 51Degrees device detection. The example
* shows how to:
*
* -
* Load the 51Degrees Hash Trie library
*
*
* res = FiftyOneDegreesTrieV3.class.getResource("/FiftyOneDegreesTrieV3.so");
* System.load(res.getPath());
*
*
*
* - Instantiate 51Degrees detection provider
*
*
* provider = new Provider("path/to/51Degrees/data/file.trie");
*
*
*
* - Pass in a single HTTP User-Agent header
*
*
* Match match = provider.match(userAgent);
*
*
*
* - Extract the value of the IsMobile property as boolean
*
*
* Boolean.parseBoolean(match.getValue("IsMobile"));
*
*
*
*
* main assumes it is being run with a working directory at root of
* project or of this module.
*
*/
public class StronglyTypedValues implements Closeable {
// Snippet Start
// Device detection provider which takes User-Agents and returns matches.
protected final Provider provider;
// User-Agent string of a iPhone mobile device.
protected final String mobileUserAgent = "Mozilla/5.0 (iPhone; CPU iPhone "
+ "OS 7_1 like Mac OS X) AppleWebKit/537.51.2 (KHTML, like Gecko) "
+ "Version/7.0 Mobile/11D167 Safari/9537.53";
// User-Agent string of Firefox Web browser of version 41 used on desktop.
protected final String desktopUserAgent = "Mozilla/5.0 (Windows NT 6.3; " +
"WOW64; rv:41.0) Gecko/20100101 Firefox/41.0";
// User-Agent string of a MediaHub device.
protected final String mediaHubUserAgent = "Mozilla/5.0 (Linux; Android 4.4"
+ ".2; X7 Quad Core Build/KOT49H) AppleWebKit/537.36 (KHTML, like "
+ "Gecko) Version/4.0 Chrome/30.0.0.0 Safari/537.36";
/**
* Loads the 51Degrees Hash Trie library and initialises the device
* detection Provider with the Lite data file. For more data see:
* compare data options
*
*
* @throws IOException can be thrown if there is a problem reading from the
* provided data file.
*/
public StronglyTypedValues() throws IOException {
// Load the C/C++ native library. Uncomment dll line for windows and so line in linux.
LibLoader.load("/FiftyOneDegreesTrieV3.dll");
// LibLoader.load("/FiftyOneDegreesTrieV3.so");
provider = new Provider("../../data/51Degrees-LiteV3.4.trie");
}
/**
* Matches provided User-Agent string and returns the IsMobile property
* value as boolean.
* Detection initiated by invoking {@link Provider#getMatch(java.lang.String)}.
* Detection results are then stored in the {@link Match} object and can be
* accessed using the {@code Match.getValue("PropertyName")} method.
*
* @param userAgent HTTP User-Agent string.
* @return True if the User-Agent is mobile, False otherwise.
* @throws IOException if there is a problem accessing the data file.
*/
public boolean isMobile(String userAgent) throws IOException {
Match match = provider.getMatch(userAgent);
return Boolean.parseBoolean(match.getValue("IsMobile"));
}
/**
* Main entry point for this example. For each of the User-Agents defined
* in this class:
*
* - invokes {@link #isMobile(java.lang.String) } method; and
*
- prints output depending on the boolean value returned by the
* {@code isMobile} method.
*
*
* @param args command line arguments, not used.
* @throws IOException if there is a problem accessing the data file.
*/
public static void main(String[] args) throws IOException {
System.out.println("Starting GettingStartedStronglyTyped example.");
StronglyTypedValues gs = new StronglyTypedValues();
try {
System.out.println("User-Agent: "+gs.mobileUserAgent);
if(gs.isMobile(gs.mobileUserAgent)) {
System.out.println("Mobile");
} else {
System.out.println("Non-Mobile");
}
System.out.println("User-Agent: "+gs.desktopUserAgent);
if(gs.isMobile(gs.desktopUserAgent)) {
System.out.println("Mobile");
} else {
System.out.println("Non-Mobile");
}
System.out.println("User-Agent: "+gs.mediaHubUserAgent);
if(gs.isMobile(gs.mediaHubUserAgent)) {
System.out.println("Mobile");
} else {
System.out.println("Non-Mobile");
}
} finally {
gs.close();
}
}
public void close() throws IOException {
provider.delete();
}
// Snippet End
}