PARQUET-2382: Remove the deprecated OriginalType

[Fokko]

Make sure you have checked all steps below.

For Iceberg we're adding nanosecond timestamps. During my investigation in Parquet, I noticed that there are two ways of declaring logical types:

1. Through the deprecated OriginalType
2. Using the new LogicalTypeAnnotation API.

The old API does not support nano's but is still used in downstream projects, such as Parquet, where I'm working on migrating to the new API: apache/iceberg#9063

However, since it was five years ago in PARQUET-1452 when it was marked as deprecated, released in Parquet 1.11.0. I would love to remove the old API to make sure that downstream engines migrate to the new API and handle nano's correctly.

Jira

• My PR addresses the following Parquet Jira issues and references them in the PR title. For example, "PARQUET-1234: My Parquet PR"
  • https://issues.apache.org/jira/browse/PARQUET-XXX
  • In case you are adding a dependency, check if the license complies with the ASF 3rd Party License Policy.

Tests

• My PR adds the following unit tests OR does not need testing for this extremely good reason:

Commits

• My commits all reference Jira issues in their subject lines. In addition, my commits follow the guidelines from "How to write a good git commit message":
  1. Subject is separated from body by a blank line
  2. Subject is limited to 50 characters (not including Jira issue reference)
  3. Subject does not end with a period
  4. Subject uses the imperative mood ("add", not "adding")
  5. Body wraps at 72 characters
  6. Body explains "what" and "why", not "how"

Documentation

• In case of new functionality, my PR adds documentation that describes how to use it.
  • All the public functions and the classes in the PR contain Javadoc that explain what it does

[Fokko]

I think there was a 🐛 hidden here. Because we would only compare on the logical type itself, and not its properties (precision/scale for decimal, or adjust-for-utc for time/timestamp). Tests started failing, therefore I added the getAdjustToUtc to retrieve the actual value from the Parquet structure.

[wgtmac]

I am fine with it but I'd like to seek advices from @gszadovszky @shangxinli

[gszadovszky]

I don't think it is a good idea to remove deprecated API in a minor release. That's why we have japicmp to ensure backward compatibility.
I think, there is no harm for Parquet if they use the old OriginalTypes. If we enforce significant code changes in minor releases we would also slow down the upgrades.

[Fokko]

Makes sense. I think it would be good to remove OriginalType at some point. Let's target this PR for 2.0 and leave it for now. I'll create another PR to mark the getOriginalType() deprecated (this one was marked as private by Yetus before, but I think it would be best to mark them as deprecated for 1.14.0).