[jwrosewell]

This moves the examples, tests and CI from the two old data submodules of cxx,
cxx/device-detection-data and cxx/ip-intelligence-data, to the
data repository, which cxx now includes
at cxx/data. It is the Java part of step 3 of the plan in
51Degrees/data#1.

Why

The data repository holds both old data repositories, in the folders
device-detection and ip-intelligence. Each free data file is a
<file>.link holding the address it is downloaded from, and the repository's
get-data-files.ps1 and get-data-files.sh download them. cxx keeps the old
submodules for one release, so that each language moves when it is ready, in
one change and with no fallback code.

What changed

1. Paths. Every cxx/device-detection-data path is now
   cxx/data/device-detection, and every cxx/ip-intelligence-data path is
   cxx/data/ip-intelligence. The paths that FileFinder matches by their
   end, such as device-detection-data/20000 Evidence Records.yml, now start
   with device-detection/ or ip-intelligence/. This covers the example XML
   configs, OnPremDataFileOptionTest, the example classes, both
   DataFileHelper classes and ip-intelligence.translation/pom.xml.
2. The free Device Detection files are found by folder and name.
   The FileUtils test helper of device-detection.shared gains
   LITE_HASH_DATA_FILE_PATH, UA_FILE_PATH and EVIDENCE_FILE_PATH, each
   the file's name under the device-detection/ folder. Every search that
   used the names now uses these, as do the defaults of GettingStartedOnPrem
   and MetadataOnPrem. The published LITE_HASH_DATA_FILE_NAME,
   UA_FILE_NAME and EVIDENCE_FILE_NAME keep their values, so code that
   uses them is unchanged. FileFinder returns the first file whose path ends
   in the name it is given. CI still checks out the old device-detection-data
   inside cxx, where 51Degrees-LiteV4.1.hash, 20000 User Agents.csv and
   20000 Evidence Records.yml are Git LFS pointers. With the bare names a
   test such as EngineTests.Engine_Hash_GetDataSourceTier_Lite could open a
   pointer rather than the file. The licensed TAC-HashV41.hash and
   Enterprise-HashV41.hash are still found by name alone, so a file of your
   own can be anywhere in the project.
3. The examples download a free file that is missing. Both
   DataFileHelper classes have a new findDataFile method. When a file is
   missing and <file>.link is in the data repository, it runs
   powershell -NoProfile -ExecutionPolicy Bypass -File <data>\get-data-files.ps1 <file> -Source examples-51degrees-java
   on Windows, or sh <data>/get-data-files.sh -s examples-51degrees-java <file>
   elsewhere, and logs the command. It then looks again, and if the file is
   still missing it fails with a message that names the command.
   getDataFileLocation and getEvidenceFile use it, and so do the examples
   that looked up their files with FileFinder directly. Those are the Device
   Detection GettingStartedOnPrem, MetadataOnPrem, OfflineProcessing and
   ShareUsageExample, and the Device Detection file of GettingStartedMixed
   and GettingStartedWebMixed. MatchMetrics now uses
   getDataFileLocation(null), which falls back to the Lite file when no data
   file is found. The Device Detection on-premise web example looks for the
   data file its configuration names before the server starts, so a missing
   Lite file is downloaded first.
4. CI. ci/fetch-assets.ps1 links the assets into
   cxx/data/device-detection and cxx/data/ip-intelligence, then runs
   cxx/data/get-data-files.ps1. The script keeps a file that is already
   there, so the linked Enterprise and Lite files stay. It downloads the Asn
   file, which was committed in ip-intelligence-data and is now a link. The
   job fails if a download fails. The IP Intelligence evidence files are still
   generated in the new folder.
5. Translations. ip-intelligence.translation/pom.xml copies
   countrycodes.en_GB.yml and the countries.*.yml files from
   cxx/data/ip-intelligence/Translations.
6. Messages, links and docs. The log messages, the web page warning and
   the doc comments that pointed at device-detection-data or
   ip-intelligence-data now point at the data repository and its scripts.
   README.md replaces the Git LFS steps with the download script, and tells
   existing clones to delete the old folders once cxx no longer includes them.
   AGENTS.md, ci/README.md, the Device Detection and IP Intelligence
   READMEs and both example READMEs are updated. The device-detection-data/
   rule in examples/ip-intelligence/.gitignore is removed, because the mixed
   examples now use the file in cxx/data, which the data repository's own
   .gitignore covers.
7. The cxx pointer moves to f03dbfd6, the head of the cxx
   feature/data-submodule
   branch, which adds the data submodule beside the two old ones
   (Add the data repository as a submodule and move the examples, tests and CI to it 51degrees-cxx#96). The pointer returns
   to cxx main through the nightly submodule update once that change is
   released.
   rc is merged in at 70fe7bc0. It had moved cxx to 1bec7b57 (4.5.102),
   which f03dbfd6 already contains, so the merge keeps f03dbfd6.

How the full build shows the translations are in the jar

The copy step skips a folder that is not there, without an error. The jar is
packed from target/classes, and TranslationTests read the files from there
through the classpath. countryNamesFromCodes expects "United Kingdom" from
countrycodes.en_GB.yml, translatedCountry expects "Royaume-Uni" from
countries.fr_FR.yml, and allListsProducedCorrectlySorted expects all 250
countries. Those tests fail if the copy found nothing. The build log also
shows how many files the copy-translation-data step copied.

What was checked

• Every file was searched for device-detection-data, ip-intelligence-data,
  Git LFS and get-lite-file-from-azure. What remains is the two notes in
  AGENTS.md and FileUtils.java on why the free files are found by folder,
  and the advice in README.md to delete the old folders.
• The data repository's tree was read at e448dcf0, the commit the cxx branch
  points at. The links, the scripts and the Translations files are where
  these paths expect them.
• ci/fetch-assets.ps1 parses in PowerShell 7. The new step checks $?
  after calling the script, because $LASTEXITCODE can still hold an older
  value. A test script confirmed that $? is false after a script's
  exit 1.
• Windows PowerShell binds the file name and -Source of the download command
  as intended, for a name with spaces too. That was checked with a script
  that has the same parameters as get-data-files.ps1.
• The UTM link lint is clean for the campaign 51degrees-java.
• Each changed file keeps its line endings.
• Nothing was built or run locally. The full build runs on GitHub's runners
  and has not passed yet.

Still to check

• The full build passes, with no more tests skipped than on rc.
• From a clean git clone --recurse-submodules, with the data files deleted,
  the getting-started examples download them.
• Each CI job downloads the Asn file from the Distributor itself, until
  common-ci's fetch-assets step gets the free files through the data
  repository and caches them (Get the free data files from the data repository common-ci#300).