setup SqlGuard, prev. version lived in rdb

- Create `pom.xml` for `guard/api` and `guard/jsqltranspiler`
- Add `SqlGuard` and `SqlGuardFactory` interfaces
- Define `DatabaseCatalog`, `DatabaseSchema`, `DatabaseTable`, and
`DatabaseColumn`
- Implement custom exceptions in `guard/api/exception`
- Add OSGi annotations in `package-info.java` files
- Implement `TranspilerSqlGuard` and `TranspilerSqlGuardFactory` classes
- Add unit tests for `SqlGuard` implementation in `jsqltranspiler`
module
- Create `test.bndrun` for `jsqltranspiler` module
- Add `pom.xml` for `guard` module and update root `pom.xml`
- Set Java version to 17 and include dependencies for SLF4J, Mockito,
and AssertJ

Signed-off-by: Stefan Bischof <[email protected]>

Author: stbischof

guard/api/pom.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0"?>
+<!--
+/*********************************************************************
+* Copyright (c) 2024 Contributors to the Eclipse Foundation.
+*
+* This program and the accompanying materials are made
+* available under the terms of the Eclipse Public License 2.0
+* which is available at https://www.eclipse.org/legal/epl-2.0/
+*
+* SPDX-License-Identifier: EPL-2.0
+**********************************************************************/
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>org.eclipse.daanse</groupId>
+    <artifactId>org.eclipse.daanse.sql.guard</artifactId>
+    <version>${revision}</version>
+  </parent>
+  <artifactId>org.eclipse.daanse.sql.guard.api</artifactId>
+
+
+</project>

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/SqlGuard.java

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2024 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api;
+
+import org.eclipse.daanse.sql.guard.api.exception.GuardException;
+
+public interface SqlGuard {
+
+    String guard(String sql) throws GuardException;
+
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/SqlGuardFactory.java

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2024 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api;
+
+import org.eclipse.daanse.sql.guard.api.elements.DatabaseCatalog;
+
+public interface SqlGuardFactory {
+
+    SqlGuard create(String currentCatalogName, String currentSchemaName, DatabaseCatalog databaseCatalog);
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/elements/DatabaseCatalog.java

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api.elements;
+
+import java.util.List;
+
+public interface DatabaseCatalog {
+
+    String getName();
+
+    List<DatabaseSchema> getDatabaseSchemas();
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/elements/DatabaseColumn.java

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api.elements;
+
+public interface DatabaseColumn {
+
+    String getName();
+
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/elements/DatabaseSchema.java

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api.elements;
+
+import java.util.List;
+
+public interface DatabaseSchema {
+
+    String getName();
+
+    List<DatabaseTable> getDatabaseTables();
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/elements/DatabaseTable.java

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api.elements;
+
+import java.util.List;
+
+public interface DatabaseTable {
+
+    String getName();
+
+    List<DatabaseColumn> getDatabaseColumns();
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/elements/package-info.java

@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2024 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+
+@org.osgi.annotation.bundle.Export
+@org.osgi.annotation.versioning.Version("0.0.1")
+package org.eclipse.daanse.sql.guard.api.elements;

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/exception/EmptyStatementGuardException.java

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2024 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api.exception;
+
+public class EmptyStatementGuardException extends GuardException {
+
+    private static final long serialVersionUID = 1L;
+
+    public EmptyStatementGuardException() {
+        this("The provided Statement must not be empty.");
+    }
+
+    private EmptyStatementGuardException(String message) {
+
+        super(message);
+    }
+
+}

guard/api/src/main/java/org/eclipse/daanse/sql/guard/api/exception/GuardException.java

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024 Contributors to the Eclipse Foundation.
+ *
+ * This program and the accompanying materials are made
+ * available under the terms of the Eclipse Public License 2.0
+ * which is available at https://www.eclipse.org/legal/epl-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ *   SmartCity Jena - initial
+ *   Stefan Bischof (bipolis.org) - initial
+ */
+package org.eclipse.daanse.sql.guard.api.exception;
+
+public class GuardException extends Exception {
+
+    private static final long serialVersionUID = 1L;
+
+    public GuardException() {
+
+    }
+
+    public GuardException(String message) {
+        super(message);
+    }
+
+}