Murq: Java Persistence Made Easy

Introduction

Your first question might rightly be: What is a Murq?

Glad you asked.

My father-in-law coined his own word, Murquincho, loosely based on the Kichwa language of Ecuador. His definition: "to perform a trick." This seemed to describe exactly what I wanted this piece of software to do - a trick. There was only one problem. I was too lazy to type 'Murquincho' over and over. Thus, Murq was born.

The trick I designed Murq to perform was multifaceted. I wanted software that would:

• Easily persist java objects without complex configuration or imposing superclasses
• Be capable of storing arbitrary binary data and metadata that described it
• Enable searching these objects without reliance upon a RDBMS backend
• Allow for easy migration from one form of persistence to another
• Make internationalization seamless
• Lastly: Make easy things easy!

Documentation

User documentation is available, both as Javadoc API documents and in the form of a brief User Guide.

The Release Notes section documents the new features and bug fixes that have been included in the current release.

Dependencies

Murq requires Java 5 and the following libraries:

Dependency	Version	Download
BFX	(Included)	(Included)
Commons-BeanUtils	1.7	HERE
Commons-IO	1.2	HERE
Commons-Lang	2.1	HERE
Commons-Logging	1.1	HERE
Commons-Codec	1.3	HERE
Commons-DBCP**	1.2	HERE
Commons-Collections**	3.2	HERE
Commons-Pool**	1.3	HERE
Lucene	2.0	HERE
XStream	1.2	HERE
XPP3*	1.1.3.4.O	HERE
HSQLDB***	1.8	HERE
JUnit***	4.1	HERE

^* Optional dependency for performance only.

^** Optional dependency required only if a database is to be used or if building from source.

^*** Optional dependency for running source unit tests.

Release Notes

murq-1.1.1-beta [23 February 2007]

• Added method getLocales to the Murq class as a convent way to discover what locales a content item is already available in.
• Now incrementally optimizes the content index.
• Fixed minor bug that caused an NPE when new content was persisted using a contentId not assigned by Murq and the creationDate had not been set.
• Renamed the typoed class name DSSourceMurqTest to the correct DBSourceMurqTest.

murq-1.0.2-beta [08 January 2007]

This is the initial public release. While it has been well tested, it has not been used in the wild. As such, it is not suggested for use in a production setting.

Support

You can find the support email address in the README file of the distribution to submit bugs, suggestions, complaints and complements.