Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rainbowdashlabs/sadu
Sql and damn utilitites. The successor of the sql-util.
https://github.com/rainbowdashlabs/sadu
database hacktoberfest java mariadb mysql postgresql sql sqlite utility-library
Last synced: 2 days ago
JSON representation
Sql and damn utilitites. The successor of the sql-util.
- Host: GitHub
- URL: https://github.com/rainbowdashlabs/sadu
- Owner: rainbowdashlabs
- License: lgpl-3.0
- Created: 2022-08-17T19:25:46.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T10:55:11.000Z (26 days ago)
- Last Synced: 2024-09-09T13:00:04.131Z (26 days ago)
- Topics: database, hacktoberfest, java, mariadb, mysql, postgresql, sql, sqlite, utility-library
- Language: Java
- Homepage: https://sadu.docs.chojo.dev/
- Size: 3.24 MB
- Stars: 33
- Watchers: 2
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
[][nexus_releases]
[][nexus_snapshots]
### [Javadocs](https://rainbowdashlabs.github.io/sadu/)
# SADU - Sql and damn utilitites
This project contains serveral things I use for working with sql.
The project is divided in several subprojects which allow to only import what you need.
It is by far not a replacement for large Frameworks like Hibernate, but a solid ground to reduce boilerplate code when
you work with plain SQL like I do most of the time.
# Dependency
If you want to use all projects simply import the whole thing.
```gradle
implementation("de.chojo.sadu", "sadu", "version")
```
## Database dependencies
SADU offers support for four different databases at the moment. To use them simply import:
- `sadu-postgresql`
- `sadu-mariadb`
- `sadu-mysql`
- `sadu-sqlite`
## Querybuilder
SADU offers a query builder to manage resources, error handling, result set reading and dispatching of queries.
to use it import: `sadu-queries`
Learn how to use the query builder [here](https://sadu.docs.chojo.dev/queries/)
### But why should I use it?
Before I give you a long talk about how much nicer the syntax and code is let me simple show you a comparison.
Without the query builder your code would ideally look like this:
```java
class MyQueries {
DataSource dataSource;
MyQueries(DataSource dataSource) {
this.dataSource = dataSource;
}
public CompletableFuture> getResultOld(int id) {
return CompletableFuture.supplyAsync(() -> {
try (Connection conn = source().getConnection(); PreparedStatement stmt = conn.prepareStatement("SELECT result FROM results WHERE id = ?")) {
stmt.setInt(id);
ResultSet rs = stmt.executeQuery();
if (rs.next()) {
return Optional.of(new Result(rs.getString("result")));
}
} catch (SQLException e) {
logger.error("Something went wrong", e);
}
return Optional.empty();
});
}
}
```
But using the query builder your code becomes this:
```java
class MyQueries {
public Optional getResultNew(int id) {
return Query.query("SELECT result FROM results WHERE id = ?")
.single(Call.of().bind(id))
.map(row -> new Result(rs.getString("result")))
.first();
}
}
```
Beautiful isnt it? The query builder will enforce try with resources, set parameters in the order defined by you,
read the result set and additionally handle the exceptions for you.
[How does it work?](https://sadu.docs.chojo.dev/queries/)
## Datasource Builder
SADU offsers a data source builder to create data sources for the databases listed above.
to use it import: `sadu-datasource`
Note that in order to use this, you need at least one of the listed databases from above.
Learn how to use the datasource builder [here](https://sadu.docs.chojo.dev/data_source/)
## Updater
SADU offers a simple sql updater which deploys upgrade and migration scripts to your database.
to use it import: `sadu-updater`
Learn how to use it [here](https://sadu.docs.chojo.dev/updater/)
[nexus_releases]: https://search.maven.org/search?q=de.chojo.sadu
[nexus_snapshots]: https://s01.oss.sonatype.org/#nexus-search;quick~de.chojo.sadu