Init

Author: JohannesRabauer

CONTRIBUTING.md

@@ -33,10 +33,10 @@ You should have the following things installed:
   * Ensure that everything is encoded in ``UTF-8``
   * Ensure that the JDK/Java-Version is correct
 
-## Releasing [![Build](https://img.shields.io/github/actions/workflow/status/xdev-software/xdev-swing-framework-template/release.yml?branch=master)](https://github.com/xdev-software/xdev-swing-framework-template/actions/workflows/release.yml)
+## Releasing [![Build](https://img.shields.io/github/actions/workflow/status/xdev-software/xapi-db-sqlite/release.yml?branch=master)](https://github.com/xdev-software/xapi-db-sqlite/actions/workflows/release.yml)
 
 Before releasing:
-* Consider doing a [test-deployment](https://github.com/xdev-software/xdev-swing-framework-template/actions/workflows/test-deploy.yml?query=branch%3Adevelop) before actually releasing.
+* Consider doing a [test-deployment](https://github.com/xdev-software/xapi-db-sqlite/actions/workflows/test-deploy.yml?query=branch%3Adevelop) before actually releasing.
 * Check the [changelog](CHANGELOG.md)
 
 If the ``develop`` is ready for release, create a pull request to the ``master``-Branch and merge the changes.

README.md

@@ -1,9 +1,18 @@
-[![Latest version](https://img.shields.io/maven-central/v/com.xdev-software/xdev-swing-framework-template)](https://mvnrepository.com/artifact/com.xdev-software/xdev-swing-framework-template)
-[![Build](https://img.shields.io/github/actions/workflow/status/xdev-software/xdev-swing-framework-template/checkBuild.yml?branch=develop)](https://github.com/xdev-software/xdev-swing-framework-template/actions/workflows/checkBuild.yml?query=branch%3Adevelop)
-[![javadoc](https://javadoc.io/badge2/com.xdev-software/xdev-swing-framework-template/javadoc.svg)](https://javadoc.io/doc/com.xdev-software/xdev-swing-framework-template) 
-# xdev-swing-framework-template
+[![Latest version](https://img.shields.io/maven-central/v/com.xdev-software/xapi-db-sqlite)](https://mvnrepository.com/artifact/com.xdev-software/xapi-db-sqlite)
+[![Build](https://img.shields.io/github/actions/workflow/status/xdev-software/xapi-db-sqlite/checkBuild.yml?branch=develop)](https://github.com/xdev-software/xapi-db-sqlite/actions/workflows/checkBuild.yml?query=branch%3Adevelop)
+[![javadoc](https://javadoc.io/badge2/com.xdev-software/xapi-db-sqlite/javadoc.svg)](https://javadoc.io/doc/com.xdev-software/xapi-db-sqlite) 
+# SqlEngine Database Adapter SQLite
 
-A XDEV Swing Framework Template
+The XDEV Application Framework provides an abstraction over database dialects as part of its SqlEngine. This module is the Database Adapter for SQLite which includes the SQLite-specific implementation for database access.
+
+## Important Note
+This Adapter only works to read from the database. It is **not** possible to perform the following actions:
+- createTable
+- addColumn
+- alterColumn
+- dropColumn
+- createIndex
+- dropIndex
 
 ## XDEV-IDE
 The [XDEV(-IDE)](https://xdev.software/en/products/swing-builder) is a visual Java development environment for fast and easy application development (RAD - Rapid Application Development). XDEV differs from other Java IDEs such as Eclipse or NetBeans, focusing on programming through a far-reaching RAD concept. The IDE's main components are a Swing GUI builder, the XDEV Application Framework and numerous drag-and-drop tools and wizards with which the functions of the framework can be integrated.
@@ -17,4 +26,4 @@ If you need support as soon as possible and you can't wait for any pull request,
 See the [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to get started with our project.
 
 ## Dependencies and Licenses
-View the [license of the current project](LICENSE) or the [summary including all dependencies](https://xdev-software.github.io/xdev-swing-framework-template/dependencies/)
+View the [license of the current project](LICENSE) or the [summary including all dependencies](https://xdev-software.github.io/xapi-db-sqlite/dependencies/)

SECURITY.md

@@ -2,4 +2,4 @@
 
 ## Reporting a Vulnerability
 
-Please report a security vulnerability [on GitHub Security Advisories](https://github.com/xdev-software/xdev-swing-framework-template/security/advisories/new).
+Please report a security vulnerability [on GitHub Security Advisories](https://github.com/xdev-software/xapi-db-sqlite/security/advisories/new).

pom.xml

@@ -5,20 +5,20 @@
     <modelVersion>4.0.0</modelVersion>
 
     <groupId>com.xdev-software</groupId>
-    <artifactId>xdev-swing-framework-template</artifactId>
+    <artifactId>xapi-db-sqlite</artifactId>
     <version>1.0.0-SNAPSHOT</version>
     <packaging>jar</packaging>
 
-    <name>xdev-swing-framework-template</name>
-    <description>xdev-swing-framework-template</description>
-    <url>https://github.com/xdev-software/xdev-swing-framework-template</url>
+    <name>SqlEngine Database Adapter SQLite</name>
+	<description>XAPI SqlEngine Database Adapter for SQLite</description>
+	<url>https://github.com/xdev-software/xapi-db-sqlite</url>
 
     <scm>
-        <url>https://github.com/xdev-software/xdev-swing-framework-template</url>
-        <connection>https://github.com/xdev-software/xdev-swing-framework-template.git</connection>
-    </scm>
+		<url>https://github.com/xdev-software/xapi-db-sqlite</url>
+		<connection>https://github.com/xdev-software/xapi-db-sqlite.git</connection>
+	</scm>
 
-    <inceptionYear>2023</inceptionYear>
+    <inceptionYear>2003</inceptionYear>
 
     <organization>
         <name>XDEV Software</name>
@@ -48,6 +48,8 @@
 
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        
+        <xdev.xapi.version>6.0.1</xdev.xapi.version>
     </properties>
 
     <repositories>
@@ -87,7 +89,18 @@
     </distributionManagement>
 
     <dependencies>
-
+        <dependency>
+            <groupId>com.xdev-software</groupId>
+            <artifactId>xapi</artifactId>
+            <version>${xdev.xapi.version}</version>
+        </dependency>
+        
+        <!-- https://mvnrepository.com/artifact/org.xerial/sqlite-jdbc -->
+        <dependency>
+            <groupId>org.xerial</groupId>
+            <artifactId>sqlite-jdbc</artifactId>
+            <version>3.7.15-M1</version>
+        </dependency>
     </dependencies>
 
     <build>

src/main/java/sqlite.png

@@ -0,0 +1,105 @@
+/*
+ * SqlEngine Database Adapter SQLite - XAPI SqlEngine Database Adapter for SQLite
+ * Copyright © 2003 XDEV Software (https://xdev.software)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package xdev.db.sqlite.jdbc;
+
+
+
+
+import java.io.File;
+
+import com.xdev.jadoth.sqlengine.dbms.DbmsConnectionInformation;
+
+import xdev.db.ConnectionInformation;
+
+public class SQLiteConnectionInformation extends ConnectionInformation<SQLiteDbms>
+{
+	// /////////////////////////////////////////////////////////////////////////
+	// constructors //
+	// ///////////////////
+	
+	public SQLiteConnectionInformation(final String database, final String urlExtension,
+			final SQLiteDbms dbmsAdaptor)
+	{
+		super("",0,"","",database,urlExtension,dbmsAdaptor);
+	}
+	
+	
+	// /////////////////////////////////////////////////////////////////////////
+	// getters //
+	// ///////////////////
+	/**
+	 * Gets the database.
+	 * 
+	 * @return the database
+	 */
+	public String getDatabase()
+	{
+		return this.getCatalog();
+	}
+	
+	
+	// /////////////////////////////////////////////////////////////////////////
+	// setters //
+	// ///////////////////
+	/**
+	 * Sets the database.
+	 * 
+	 * @param database
+	 *            the database to set
+	 */
+	public void setDatabase(final String database)
+	{
+		this.setCatalog(database);
+	}
+	
+	
+	// /////////////////////////////////////////////////////////////////////////
+	// override methods //
+	// ///////////////////
+	/**
+	 * @see DbmsConnectionInformation#createJdbcConnectionUrl()
+	 */
+	@Override
+	public String createJdbcConnectionUrl()
+	{
+		String db = getDatabase();
+		File file = new File(db).getAbsoluteFile();
+		if(!file.exists())
+		{
+			String projectHome = System.getProperty("project.home",null);
+			if(projectHome != null && projectHome.length() > 0)
+			{
+				file = new File(new File(projectHome),db);
+				db = file.getAbsolutePath();
+			}
+		}
+		
+		String url = "jdbc:sqlite:" + db;
+		return appendUrlExtension(url);
+	}
+	
+	
+	/**
+	 * @see com.xdev.jadoth.sqlengine.dbms.DbmsConnectionInformation#getJdbcDriverClassName()
+	 */
+	@Override
+	public String getJdbcDriverClassName()
+	{
+		return "org.sqlite.JDBC";
+	}
+}

src/main/java/xdev/db/sqlite/jdbc/SQLiteConnectionInformation.java

@@ -0,0 +1,32 @@
+/*
+ * SqlEngine Database Adapter SQLite - XAPI SqlEngine Database Adapter for SQLite
+ * Copyright © 2003 XDEV Software (https://xdev.software)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package xdev.db.sqlite.jdbc;
+
+
+
+
+import com.xdev.jadoth.sqlengine.dbms.standard.StandardDDLMapper;
+
+
+public class SQLiteDDLMapper extends StandardDDLMapper<SQLiteDbms>
+{
+	protected SQLiteDDLMapper(final SQLiteDbms dbmsAdaptor)
+	{
+		super(dbmsAdaptor);
+	}
+}

src/main/java/xdev/db/sqlite/jdbc/SQLiteDDLMapper.java

@@ -0,0 +1,111 @@
+/*
+ * SqlEngine Database Adapter SQLite - XAPI SqlEngine Database Adapter for SQLite
+ * Copyright © 2003 XDEV Software (https://xdev.software)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package xdev.db.sqlite.jdbc;
+
+
+
+
+import static com.xdev.jadoth.sqlengine.internal.QueryPart.ASEXPRESSION;
+import static com.xdev.jadoth.sqlengine.internal.QueryPart.indent;
+import static com.xdev.jadoth.sqlengine.internal.QueryPart.isSingleLine;
+
+import com.xdev.jadoth.sqlengine.SELECT;
+import com.xdev.jadoth.sqlengine.dbms.standard.StandardDMLAssembler;
+import com.xdev.jadoth.sqlengine.internal.SqlExpression;
+import com.xdev.jadoth.sqlengine.internal.SqlFunctionMOD;
+
+public class SQLiteDMLAssembler extends StandardDMLAssembler<SQLiteDbms>
+{
+	public SQLiteDMLAssembler(final SQLiteDbms dbms)
+	{
+		super(dbms);
+	}
+	
+	
+	// /////////////////////////////////////////////////////////////////////////
+	// override methods //
+	// ///////////////////
+	/**
+	 * @see StandardDMLAssembler#assembleSELECT(SELECT, StringBuilder, int, int, String, String)
+	 */
+	@Override
+	protected StringBuilder assembleSELECT(final SELECT query, final StringBuilder sb,
+			final int indentLevel, final int flags, final String clauseSeperator,
+			final String newLine)
+	{
+		indent(sb,indentLevel,isSingleLine(flags)).append(query.keyword());
+		
+		this.assembleSelectDISTINCT(query,sb,indentLevel,flags);
+		this.assembleSelectItems(query,sb,flags,indentLevel,newLine);
+		this.assembleSelectSqlClauses(query,sb,indentLevel,flags | ASEXPRESSION,clauseSeperator, newLine);
+		this.assembleAppendSELECTs(query,sb,indentLevel,flags,clauseSeperator,newLine);
+		this.assembleSelectRowLimit(query,sb,flags,clauseSeperator,newLine,indentLevel);
+		
+		return sb;
+	}
+	
+	
+	/**
+	 * @see StandardDMLAssembler#assembleSelectRowLimit(SELECT, StringBuilder, int, String, String, int)
+	 */
+	@Override
+	protected StringBuilder assembleSelectRowLimit(final SELECT query, final StringBuilder sb,
+			final int flags, final String clauseSeperator, final String newLine,
+			final int indentLevel)
+	{
+		final Integer offset = query.getOffsetSkipCount();
+		final Integer limit = query.getFetchFirstRowCount();
+		
+		if(offset != null && limit != null)
+		{
+			sb.append(newLine)
+				.append(clauseSeperator)
+				.append("LIMIT ")
+				.append(limit)
+				.append(" OFFSET ")
+				.append(offset);
+		}
+		else if(limit != null)
+		{
+			sb.append(newLine)
+				.append(clauseSeperator)
+				.append("LIMIT ")
+				.append(limit);
+		}
+		return sb;
+	}
+	
+	
+	@Override
+	public void assembleExpression(final SqlExpression expression, final StringBuilder sb,
+			final int indentLevel, final int flags)
+	{
+		
+		if(expression instanceof SqlFunctionMOD)
+		{
+			sb.append(((SqlFunctionMOD)expression).getParameters()[0])
+				.append(" % ")
+				.append(((SqlFunctionMOD)expression).getParameters()[1]);
+		}
+		else
+		{
+			super.assembleExpression(expression,sb,indentLevel,flags);
+		}
+	}
+	
+}