Skip to content

Commit 0d989d3

Browse files
authored
Create README.md
1 parent 1e08ff9 commit 0d989d3

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed

README.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
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

Comments
 (0)