|
| 1 | +# JDXAndroidSimpleExample |
| 2 | +### A Simple Example Project using JDXA ORM |
| 3 | + |
| 4 | +This project shows a simple Android app using JDXA ORM to exchange object data with an on-device SQLite relational database. Some highlights: |
| 5 | +* The object model consists of one POJO class (AClass). |
| 6 | +* The mapping specification is succinct. |
| 7 | +* API calls for CRUD operations are simple. |
| 8 | +* JDXA provides handy utility methods for displaying an object or a list of objects. |
| 9 | + |
| 10 | +#### This project is also presented in a video format on YouTube at https://youtu.be/g9pE6ocTDvU |
| 11 | + |
| 12 | +To run this app in your own setup, please do the following: |
| 13 | +* Clone this project on your desktop. |
| 14 | +* Get the JDXA SDK download instructions from [this link](http://softwaretree.com/v1/products/jdxa/download-jdxa.php). |
| 15 | +* You may download just the mini version of the SDK. |
| 16 | +* Add the libraries (JDXAndroid-nn.n.jar and sqldroid.jar) from the SDK to the app/libs directory and build the project. |
| 17 | +* Run the app. |
| 18 | + |
| 19 | +### About JDXA ORM |
| 20 | +JDXA is a simple yet powerful, non-intrusive, flexible, and lightweight Object-Relational Mapping (ORM) product that simplifies and accelerates the development of Android apps by providing intuitive, object-oriented access to on-device relational (e.g., SQLite) data. |
| 21 | + |
| 22 | +Adhering to some well thought-out [KISS (Keep It Simple and Straightforward) principles](http://softwaretree.com/v1/KISSPrinciples.html), JDXA boosts developer productivity and reduces maintenance hassles by eliminating endless lines of tedious SQL code. |
| 23 | + |
| 24 | +Some of the powerful and practical features of JDXA include: |
| 25 | +* Declarative mapping specification between an object model and a relational model is done textually using a simple grammar (no XML complexity). |
| 26 | +* Full flexibility in domain object modeling – one-to-one, one-to-many, and many-to-many relationships as well as class-hierarchies supported. |
| 27 | +* POJO (Plain Old Java Objects) friendly non-intrusive programming model, which does not require you to change your Java classes in any way: |
| 28 | + |
| 29 | + - No need to subclass your domain model classes from any base class |
| 30 | + - No need to clutter your source code with annotations |
| 31 | + - No source code generation (No need for DAO classes) |
| 32 | + - No pre-processing or post-processing of your code |
| 33 | + |
| 34 | +* Support for persistence of JSON objects. |
| 35 | +* A small set of intuitive APIs for object persistence. |
| 36 | +* Automatic generation of relational schema from an object model. |
| 37 | +* A highly optimized metadata-driven ORM engine that is lightweight, dynamic, and flexible. |
| 38 | + |
| 39 | +JDXA ORM is a product of Software Tree. To get more information and a free trial version of JDXA SDK, please visit http://www.softwaretree.com. |
| 40 | + |
| 41 | +JDXA is used with the SQLDroid open source library. SQLDroid is provided under the licensing terms mentioned [here](https://github.com/SQLDroid/SQLDroid/blob/master/LICENSE). |
| 42 | + |
| 43 | + |
| 44 | + |
0 commit comments