|
|
JSONXML library is implemented trying to keep it as generic as possible.
It uses hierarchy of classes providing generalized functionality most of which are used both in parsing and in formatting process.
briefly these are:
- Path - hierarchical structure elements may be accessed using simple path syntax: "name/name[idx]/name[idx]/name".
Path allows numeric and textual indexes and provides set of methods to simplify its analysis and conversions.
- Formats - locale/time-zone specific formatter/parser of scalar values (numbers, dates). Provides possibility to try several format variants on parsing.
By overriding it context-specific (e.g. depending on path) conversions may be applied.
- ObjectsRegistry - tool used to accumulate processed items and resolve cross-referencing problems.
- ReflectiveBuilder - tool used to access Java object data reflectively on formatting and to restore objects on parsing.
Also it resolves problem of Map serialization/deserialization by applying special lossless formatting.
Default implementation uses getters/setters only. Any other strategy (e.g. fields, annotations, serialization-based etc. may be easily applied via extension(s)).
- StructureProcessingContext - collect previously mentioned and other tools to provide single access point AND to allow replacement with user-defined extensions.
- Utilities - place to gather any non-specific static methods/classes.
Notice Utilities.NonResizableListForArray class that provides list-like access to any array (object or primitive).
NOTE: this class is available starting from version 1.1 only.
Actual entry point to JSONXML library are basic classes:
- Formatter - formatter implementation with shortcut methods for XML and JSON outputs.
- Parser - shortcut methods to parse JSON and XML texts into Java objects.
- Comparer - implementation of comparator of 2 java objects. Uses same structure scanning mechanisms as parser/formatter.
As example there're provided command-line tools:
- converter - accepts file or URL, tries to parse it as XML or JSON and writes it to standard output in desired format (JSON, XML, Dump)
- diff - accepts 2 input sources (file or URL, may be mixed), parses as XML or JSON and compares them. the difference is written to standard output in desired format.
|