What's Covered
This tutorial illustrates how to append a CSV file containing User-Agent strings with IsMobile, PlatformName and PlatformVersion properties. The following aspects of the API are covered:
- How to perform a User-Agent match.
- How to reuse resources to perform subsequent matching.
- How to retrieve match results for a specific property.
- How to append a property value to a CSV file.
Code and Explanation
Example of using 51Degrees Pattern Detection to process a file containing User-Agent header values and output a CSV file containing the same header values with various properties detected by 51Degrees. The example illustrates:
-
Loading the 51Degrees Hash Trie library
res = FiftyOneDegreesTrieV3.class.getResource("/FiftyOneDegreesTrieV3.so"); System.load(res.getPath());
-
How to instantiate 51Degrees detection provider
provider = new Provider("path/to/51Degrees/data/file.trie");
-
Matching a User-Agent header value
-
By creating a match and using it repeatedly (for efficiency)
Match match;
match = provider.getMatch(userAgentString);
-
By having the provider create a new Match for each detection
Match match = provider.getMatch(userAgentString);
-
By creating a match and using it repeatedly (for efficiency)
-
Getting the values for some properties of the matched User-Agent header
VectorString isMobile = match.getValues("IsMobile");
The 51 Degrees Property Dictionary contains a description of each of the properties and the editions in which they are available.
main assumes it is being run with a working directory at root of project or of this module.
Summary
Offline device detection is frequently required for a variety of reasons such as generating reports. The example is based on an actual support request where several properties had to be added to the CSV file before it could be passed on for another department to use.
This tutorial covered how to use the detector offline to append the first 20 lines of a CSV file with Lite properties: IsMobile , PlatformName and PlatformVersion . Using a Premium or an Enterprise data file gives you access to a far greater number of properties including HardwareVendor , PriceBand , ScreenInchesWidth , IsCrawler and more. A full list of properties and the data file version they are present in can be viewed in the Property Dictionary .