2011-08-04 04:01:42 +02:00
iciql
=================
iciql **is** ...
- a model-based, database access wrapper for JDBC
- for modest database schemas and basic statement generation
- for those who want to write code, instead of SQL, using IDE completion and compile-time type-safety
- small (100KB) with no runtime dependencies
- pronounced *icicle* (although it could be French: *ici ql* - here query language)
2011-08-04 15:10:30 +02:00
- a friendly fork of the H2 [JaQu ](http://h2database.com/html/jaqu.html ) project
2011-08-04 04:01:42 +02:00
iciql **is not** ...
- a complete alternative to JDBC
2011-08-04 15:10:30 +02:00
- designed to compete with more powerful database query tools like [jOOQ ](http://jooq.sourceforge.net ) or [Querydsl ](http://source.mysema.com/display/querydsl/Querydsl )
- designed to compete with enterprise ORM tools like [Hibernate ](http://www.hibernate.org ) or [mybatis ](http://www.mybatis.org )
2011-08-04 04:01:42 +02:00
Supported Databases
2011-08-04 04:41:48 +02:00
-------
2011-08-04 04:01:42 +02:00
- [H2 ](http://h2database.com )
- Support for others is planned and should only require creating a simple "dialect" class.
2011-08-04 15:10:30 +02:00
License
-------
iciql is distributed under the terms of the [Apache Software Foundation license, version 2.0 ](http://www.apache.org/licenses/LICENSE-2.0 ).< br />
The text of the license is included in the file LICENSE in the root of the project.
2011-08-04 04:01:42 +02:00
Java Runtime Requirement
2011-08-04 04:41:48 +02:00
-------
2011-08-04 04:01:42 +02:00
iciql requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK).
2011-08-04 15:10:30 +02:00
Getting help
2011-08-04 04:41:48 +02:00
-------
2011-08-04 15:10:30 +02:00
Read the online documentation available at the [iciql website ](http://iciql.com )< br />
Issues, binaries, & sources @ [Google Code ](http://code.google.com/p/iciql )
2011-08-04 04:01:42 +02:00
2011-08-04 15:10:30 +02:00
Building iciql
----------------
[Eclipse ](http://eclipse.org ) is recommended for development as the project settings are preconfigured.
1. Import the iciql project into your Eclipse workspace.< br />
*There will be lots of build errors.*
2. Using Ant, execute the `build.xml` script in the project root.< br />
*This will download all necessary build dependencies.*
3. Select your iciql project root and **Refresh** the project, this should correct all build problems.