More code cleanup and refactoring

[david-waltermire]

Committer Notes

Adding Javadocs; addressing compile, PMD, and spotbugs warnings; and refactoring code for better organization and easier maintenance.

These changes include:

• Refactoring of the data type and atomic item implementations to move casting operations to the atomic item implementations. This creates a cleaner isolation between the type adapters and Metapath items.

All Submissions:

• Have you selected the correct base branch per Contributing guidance?
• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?
• Have you squashed any non-relevant commits and commit messages? [instructions]
• Have you set "Allow edits and access to secrets by maintainers"?

By submitting a pull request, you are agreeing to provide this contribution under the CC0 1.0 Universal public domain dedication.

Changes to Core Features:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your core changes, as applicable?
• Have you included examples of how to use your new feature(s)?
• Have you updated all website and readme documentation affected by the changes you made?

Summary by CodeRabbit

Summary by CodeRabbit

• New Features

  • Enhanced error handling in various classes for improved robustness.
  • Added new methods and documentation for better clarity on class purposes.
  • Updated existing data types to support additional functionality, including the introduction of AmbiguousDate and AmbiguousDateTime.

• Bug Fixes

  • Improved exception handling in schema validation and type casting methods.

• Documentation

  • Added and updated Javadoc comments across multiple classes to clarify their functionalities and purposes.

• Refactor

  • Restructured package hierarchy for better organization and clarity.
  • Simplified method implementations and improved code readability.
  • Renamed and modified several classes to reflect their updated roles and functionalities.