User guide for tapestry-model
|Version status: 0.5.0 for T5.3 and up, 0.3.1 for T5.2.x, used in production|
0.0.x line (for T5.1.x) will not be maintained.
Tapestry-model is the main Tynamo module and the development of it was started in 2004. Tapestry-model allows rapid CRUD development of Tapestry 5 applications by automatically creating list, display and edit pages for POJOs. Tynamo uses introspection to gather information about bean properties and creates representations and editors depending on their type, for example. There's no "scaffolding" generated, the defaults are all built dynamically. The default model is highly customizable, you can change pretty much anything you need, and make the changes specific to type, page or instance - a feature that very few other CRUD frameworks offer. Though your whole user interface can be based on tapestry-model, the sweet spot of it is customizable admin interfaces. You can get a fully functional CRUD interface up and running quickly, but you don't have to throw away the effort, rather you just extend it as your requirements become more clear.
To use the module, you need to add the following dependency to your pom.xml:
However, if you are new to Tynamo and Tapestry, it maybe easier to follow our Quick start to get set up quickly.
This guide is a Wiki and only as good as you make it. Please contribute by adding more helpful explanations, correcting the wording and providing more examples. The guide will never be truly complete but even as is, it covers most aspects of Tynamo's tapestry-model module and is essential reading for anybody starting with Tynamo. If you'd like to suggest bigger re-factoring, structural changes and new sections, please join the discussion on our mailing lists!