Pilote JDBC SQLite

SQLite JDBC est une bibliothèque pour accéder et créer des fichiers de base de données SQLite en Java.

Notre bibliothèque SQLiteJDBC ne nécessite aucune configuration car les bibliothèques natives pour les principaux systèmes d'exploitation, y compris Windows, macOS, Linux, etc., sont assemblées en un seul fichier JAR (archive Java).

Utilisation

➡️ D'autres exemples d'utilisation et de configuration sont disponibles dans USAGE.md

SQLite JDBC est une bibliothèque pour accéder aux bases de données SQLite via l'API JDBC. Pour l'utilisation générale de JDBC, consultez le Tutoriel JDBC ou la Documentation Oracle JDBC.

1. Téléchargez sqlite-jdbc-(VERSION).jar puis ajoutez ce fichier jar à votre classpath.
2. Ouvrez une connexion à la base de données SQLite depuis votre code. (voir l'exemple ci-dessous)

Exemple d'utilisation

En supposant que sqlite-jdbc-(VERSION).jar se trouve dans le répertoire courant.

> javac Sample.java
> java -classpath ".;sqlite-jdbc-(VERSION).jar" Sample   # in Windows
or
> java -classpath ".:sqlite-jdbc-(VERSION).jar" Sample   # in macOS or Linux
name = leo
id = 1
name = yui
id = 2

Sample.java

    import java.sql.Connection;
    import java.sql.DriverManager;
    import java.sql.ResultSet;
    import java.sql.SQLException;
    import java.sql.Statement;

    public class Sample
    {
      public static void main(String[] args)
      {
        Connection connection = null;
        try
        {
          // create a database connection
          connection = DriverManager.getConnection("jdbc:sqlite:sample.db");
          Statement statement = connection.createStatement();
          statement.setQueryTimeout(30);  // set timeout to 30 sec.

          statement.executeUpdate("drop table if exists person");
          statement.executeUpdate("create table person (id integer, name string)");
          statement.executeUpdate("insert into person values(1, 'leo')");
          statement.executeUpdate("insert into person values(2, 'yui')");
          ResultSet rs = statement.executeQuery("select * from person");
          while(rs.next())
          {
            // read the result set
            System.out.println("name = " + rs.getString("name"));
            System.out.println("id = " + rs.getInt("id"));
          }
        }
        catch(SQLException e)
        {
          // if the error message is "out of memory",
          // it probably means no database file is found
          System.err.println(e.getMessage());
        }
        finally
        {
          try
          {
            if(connection != null)
              connection.close();
          }
          catch(SQLException e)
          {
            // connection close failed.
            System.err.println(e.getMessage());
          }
        }
      }
    }

Comment fonctionne SQLiteJDBC ?

Notre paquet du pilote JDBC SQLite (c'est-à-dire sqlite-jdbc-(VERSION).jar) contient trois types de bibliothèques SQLite natives (sqlite-jdbc.dll, sqlite-jdbc.jnilib, sqlite-jdbc.so), chacune étant compilée pour Windows, macOS et Linux. Un fichier de bibliothèque native approprié est automatiquement extrait dans le dossier temporaire de votre système d'exploitation lorsque votre programme charge le pilote org.sqlite.JDBC.

Systèmes d'exploitation pris en charge

Depuis sqlite-jdbc-3.6.19, les moteurs SQLite compilés nativement seront utilisés pour les systèmes d'exploitation suivants :

	x86	x86_64	armv5	armv6	armv7	arm64	ppc64
Windows	✔	✔			✔	✔
macOS		✔				✔
Linux (libc)	✔	✔	✔	✔	✔	✔	✔
Linux (musl)	✔	✔				✔
Android	✔	✔	✔			✔
FreeBSD	✔	✔				✔

Dans les autres systèmes d'exploitation non listés ci-dessus, le SQLite pur Java est utilisé. (S'applique aux versions antérieures à la 3.7.15)

Si vous souhaitez utiliser la bibliothèque native pour votre système d'exploitation, construisez la source à partir de zéro.

Téléchargement

Téléchargez depuis Maven Central ou depuis la page des versions.

<dependencies>
    <dependency>
      <groupId>org.xerial</groupId>
      <artifactId>sqlite-jdbc</artifactId>
      <version>(version)</version>
    </dependency>
</dependencies>

Les instantanés de la version de développement sont disponibles dans le référentiel d'instantanés de Sonatype.

Explication du versionnage du projet

La version du projet suit la version de la bibliothèque SQLite qui est incluse dans le jar, avec un chiffre supplémentaire pour indiquer l'incrément du projet.

Par exemple, si la version de SQLite est 3.39.2, la version du projet sera 3.39.2.x, où x commence à 0 et s'incrémente à chaque version qui ne change pas la version de SQLite.

Si la version de SQLite est mise à jour vers 3.40.0, la version du projet sera mise à jour vers 3.40.0.0.

Astuce pour maven-shade-plugin

Vous devrez peut-être ajouter le transformer du plugin shade pour résoudre le problème No suitable driver found for jdbc:sqlite:.

<transformer
	implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
	<resource>META-INF/services/java.sql.Driver</resource>
</transformer>

<dependency>
    <groupId>org.xerial</groupId>
    <artifactId>sqlite-jdbc</artifactId>
    <version>(version)</version>
</dependency>

Comment puis-je aider ?

Nous recherchons toujours :

• Reviewers pour les issues ou les PRs, vous pouvez consulter https://github.com/xerial/sqlite-jdbc/labels/review%20wanted
• Contributeurs pour soumettre des PRs, vous pouvez consulter https://github.com/xerial/sqlite-jdbc/labels/help%20wanted et https://github.com/xerial/sqlite-jdbc/labels/good%20first%20issue

Veuillez lire notre guide de contribution.