https://github.com/aaberg/sql2o

sql2o is a small library, which makes it easy to convert the result of your sql-statements into objects. No resultset hacking required. Kind of like an orm, but without the sql-generation capabilities. Supports named parameters.
https://github.com/aaberg/sql2o

Last synced: 6 days ago
JSON representation

sql2o is a small library, which makes it easy to convert the result of your sql-statements into objects. No resultset hacking required. Kind of like an orm, but without the sql-generation capabilities. Supports named parameters.

• Host: GitHub
• URL: https://github.com/aaberg/sql2o
• Owner: aaberg
• License: mit
• Created: 2011-05-18T21:13:57.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2025-03-09T19:27:04.000Z (about 1 month ago)
• Last Synced: 2025-04-10T00:15:35.850Z (6 days ago)
• Language: Java
• Homepage: http://sql2o.org
• Size: 1.78 MB
• Stars: 1,155
• Watchers: 56
• Forks: 230
• Open Issues: 71
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-java - Sql2o

README

        
# sql2o  [![Github Actions Build](https://github.com/aaberg/sql2o/actions/workflows/pipeline.yml/badge.svg)](https://github.com/aaberg/sql2o/actions) [![Maven Central](https://img.shields.io/maven-central/v/org.sql2o/sql2o.svg)](https://search.maven.org/search?q=g:org.sql2o%20a:sql2o)

Sql2o is a lightweight Java library designed to simplify database interaction. It automatically maps query results into POJO objects, providing an easy-to-use alternative to ORMs, without SQL generation capabilities.

## Java versions

* Sql2o **1.9.0** and newer is only compatible with Java 17 or later because it adds support for records.

* If you use Java 11, sql2o 1.8.x is compatible.

* If you are still on Java 8, use sql2o 1.6.x.

## Announcements

- *2024-03-12* | [Sql2o 1.7.0 was released](https://github.com/aaberg/sql2o/discussions/365)

## Quick Start Example

Here's a basic example demonstrating how to use Sql2o to interact with a database:

```java

import org.sql2o.*;

public class Main {

    public static void main(String[] args) {

        String url = "jdbc:h2:mem:test"; // Example using H2 in-memory database

        try (Sql2o sql2o = new Sql2o(url, "username", "password");

             Connection con = sql2o.open()) {

            

            con.createQuery("CREATE TABLE users (id INTEGER PRIMARY KEY, name VARCHAR(50))").executeUpdate();

            con.createQuery("INSERT INTO users (id, name) VALUES (:id, :name)")

                .addParameter("id", 1)

                .addParameter("name", "Alice")

                .executeUpdate();

            

            User user = con.createQuery("SELECT * FROM users WHERE id = :id")

                            .addParameter("id", 1)

                            .executeAndFetchFirst(User.class);

            

            System.out.println("User: " + user.name);

        }

    }

}

class User {

    public int id;

    public String name;

}

```

## Coding Guidelines

When contributing to Sql2o, please follow [these coding guidelines](https://github.com/aaberg/sql2o/wiki/Coding-guidelines).

## Wiki

For additional information, check out the [Sql2o Wiki](https://github.com/aaberg/sql2o/wiki).