Check out the latest documentation.

What's Covered

This tutorial illustrates the basic use of the 51Degrees API. It will show you how to create a provider, how to create a dataset and how to obtain a value for the IsMobile property.

Code and Explanation

Example of using 51Degrees Pattern Detection to output a CSV file containing the properties of all hardware devices in the data set being used.

The example illustrates:

  1. Loading a Provider from a Disk-based (Stream) Pattern Dataset
          provider = new Provider(StreamFactory.create
          (Shared.getLitePatternV32(), false));
  2. Getting all hardware profiles as an array
          Component hardwareComponent =
          Profile[] hardwareProfiles = hardwareComponent.getProfiles();
  3. Getting the values for some properties of the device
          Values isMobile = profile.getValues("IsMobile");

    A property may have multiple values. Helper methods convert the list of values into a Boolean, Double etc. For example:

You can run MetadataExample.main(java.lang.String[]) for a listing of which properties are available in the dataset supplied with this distribution.


Full Source File
    // Output file in current working directory.
    public String outputFilePath = "allProfilesOutput.csv";
    // Device detection provider which takes User-Agents and returns matches.
    protected final Provider provider;
    // The profile component relating to all hardware profiles.
    protected final Component hardwareComponent;
    // Array of hardware profiles for all devices.
    protected static Profile[] hardwareProfiles;
    // Array of properties that relate to device hardware.
    protected static Property[] hardwareProperties;

     * Initialises the device detection Provider with the included Lite data
     * file. For more data see: 
     * <a href="">compare data options
     * </a>
     * @throws IOException if there was a problem reading from the data file.
    public AllProfiles() throws IOException {
        provider = new Provider(StreamFactory.create(
                Shared.getLitePatternV32(), false));
        // Get the hardware component, this contains all hardware profiles.
        // There are also SoftwarePlatform, BrowserPlatform and Crawler
        // platforms.
        hardwareComponent = provider.dataSet.getComponent("HardwarePlatform");

        // Get all the hardware properties from the hardware component.
        hardwareProperties = hardwareComponent.getProperties();
        // Get all the hardware profiles from the hardware component.
        hardwareProfiles = hardwareComponent.getProfiles();
     * Writes a CSV file with all properties of all hardware devices in the
     * data set being used.
     * For a full list of properties and the files they are available in please 
     * see: <a href="">
     * Property Dictionary</a>
     * @param outputFilename where to save the file with extra entries.
     * @throws IOException if there was a problem reading from the data file.
        public void run(String outputFilename)
            throws IOException {
            FileWriter fileWriter = new FileWriter(outputFilename);
            try {
                // Write the headers for the CSV file.
                for (Property property : hardwareProperties) {
                // Loop over all devices.
                for (Profile profile : hardwareProfiles) {
                    // Write the device's profile id.
                    for (Property property : hardwareProperties) {
                        // Get some property values from the match
                        Values values = profile.getValues(property.getName());
                        // Prevents big chunks of javascript overrides from
                        // being writen.
                        if (property.getName().startsWith("Javascript")) {
                            values = null;
                        // Write result to file
            } finally {

     * Match values may be null. A helper method to get something displayable
     * @param values a Values to render
     * @return a non-null String
    protected String getValueForDisplay(Values values) {
        return values == null ? "N/A": values.toString();

     * Instantiates this class and starts 
     * {@link #run(java.lang.String)} with default 
     * parameters.
     * @param args command line arguments.
     * @throws IOException if there was a problem accessing the data file.
    public static void main(String[] args) throws IOException {
        System.out.println("Starting All Profiles Example");
        AllProfiles allProfiles = new AllProfiles();
        try {
            System.out.println("Output written to " + 
        } finally {

     * Closes the {@link} by releasing data
     * file readers and freeing the data file from locks. This method should
     * only be used when the {@code Dataset} is no longer required, i.e. when
     * device detection functionality is no longer required, or the data file
     * needs to be freed.
     * @throws IOException if there is a problem accessing the data file.
    public void close() throws IOException {

Full Source File


In this tutorial you have seen how to use the dataset to run through all the devices it contains, and all the properties for each of those devices. The example outputs all the devices and their properties to a CSV file for analysis. For a full list of properties and the data file versions they exist in please see the Property Dictionary .