strolch/xmlpers
Robert von Burg dc93800fd1
[Project] Set new version 2.3.0-SNAPSHOT
2024-04-23 14:46:57 +02:00
..
src [Fix] Always use SAXParserFactory feature disallow-doctype-decl=true 2023-11-30 12:16:28 +01:00
.gitignore [Major] Strolch version 2.x: renamed modules 2022-12-16 15:03:14 +01:00
LICENSE [Major] Strolch version 2.x: renamed modules 2022-12-16 15:03:14 +01:00
README.md [Major] Strolch version 2.x: renamed modules 2022-12-16 15:03:14 +01:00
pom.xml [Project] Set new version 2.3.0-SNAPSHOT 2024-04-23 14:46:57 +02:00

README.md

li.strolch.java.xmlpers

Generic Java XML persistence layer. Implemented to be light-weight and simple to use

Dependencies

XmlPers is built by Maven3 and has very few external dependencies. The current dependencies are:

  • the Java Runtime Environment 8
  • li.strolch.utils
  • slf4j 1.7.2
  • slf4j-log4j bindings (only during tests)
  • JUnit 4.10 (only during tests)

Features

The idea behind XmlPers is to have a very lightweight database where each object is saved in its own XML file.

The model for XmlPers is that for each persistable class the following information is available:

  • Type (e.g. the class name)
  • Optional Sub Type (e.g. some type in your class)
  • Id

This is not forced on the model itself, but in the DAO. Persisting changes is done by delegating to XmlFilePersister and the DAO must convert the object to a XML Document.

See the tests for a reference implementation.

Building

*Prerequisites:

  • JDK 8 is installed and JAVA_HOME is properly set and ../bin is in path
  • Maven 3 is installed and MAVEN_HOME is properly set and ../bin is in path
  • li.strolch.utils is installed in your local Maven Repository
  • Clone repository and change path to root
  • Run maven:
    • mvn clean install