blob: 29c2c868a2f9e67d92aa3db23a89eddc2053f9e4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
iciql
=================
[](http://search.maven.org/#search|ga|1|com.gitblit.iciql)
[](http://www.apache.org/licenses/LICENSE-2.0.txt)
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 (<250KB with debug symbols) with no runtime dependencies
- pronounced *icicle* (although it could be French: *ici ql* - here query language)
- a friendly fork of the H2 [JaQu](http://h2database.com/html/jaqu.html) project
iciql **is not**...
- a complete alternative to JDBC
- 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)
Supported Databases (Unit-Tested)
-------
- [H2](http://h2database.com) 1.4
- [HSQLDB](http://hsqldb.org) 2.3
- [Derby](http://db.apache.org/derby) 10.12
- [MySQL](http://mysql.com) 5.6
- [PostgreSQL](http://postgresql.org) 9.5
- [SQLite](http://www.sqlite.org) 3.8
Support for others is possible and may only require creating a simple "dialect" class.
Downloading
-----------
As of 2.0.0 iciql is now distributed through Maven Central and it's coordinates have changed slightly.
```xml
<dependencies>
<dependency>
<groupId>com.gitblit.iciql</groupId>
<artifactId>iciql</artifactId>
<version>2.1.1</version>
</dependency>
</dependencies>
```
Older releases are available from the [Iciql Maven Repository](http://gitblit.github.io/iciql/maven/).
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.
Java Runtime Requirement
-------
iciql requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK).
Getting help
-------
Read the online documentation available at the [iciql website](http://iciql.com)<br/>
Issues & source code @ [GitHub](http://github.com/gitblit/iciql)
Building iciql
----------------
You may use Maven to build the project:
mvn clean package
You may use Maven to run the test suite on the default database:
mvn clean test
You may use Maven to run the test suite on all tested databases:
mvn clean test-compile exec:exec
|
