diff --git a/pom.xml b/pom.xml
index de49e349..2ae886df 100644
--- a/pom.xml
+++ b/pom.xml
@@ -33,6 +33,7 @@
qqq-backend-module-api
qqq-backend-module-filesystem
qqq-backend-module-rdbms
+ qqq-language-support-javascript
qqq-middleware-picocli
qqq-middleware-javalin
qqq-middleware-lambda
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/ExecuteCodeAction.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/ExecuteCodeAction.java
new file mode 100644
index 00000000..2715060e
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/ExecuteCodeAction.java
@@ -0,0 +1,94 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.Log4jCodeExecutionLogger;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.QCodeExecutionLoggerInterface;
+import com.kingsrook.qqq.backend.core.exceptions.QCodeException;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeOutput;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ExecuteCodeAction
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @SuppressWarnings("checkstyle:indentation")
+ public void run(ExecuteCodeInput input, ExecuteCodeOutput output) throws QException, QCodeException
+ {
+ QCodeReference codeReference = input.getCodeReference();
+
+ QCodeExecutionLoggerInterface executionLogger = input.getExecutionLogger();
+ if(executionLogger == null)
+ {
+ executionLogger = getDefaultExecutionLogger();
+ }
+ executionLogger.acceptExecutionStart(input);
+
+ try
+ {
+ String languageExecutor = switch(codeReference.getCodeType())
+ {
+ case JAVA -> "com.kingsrook.qqq.backend.core.actions.scripts.QJavaExecutor";
+ case JAVA_SCRIPT -> "com.kingsrook.qqq.languages.javascript.QJavaScriptExecutor";
+ };
+
+ @SuppressWarnings("unchecked")
+ Class executorClass = (Class) Class.forName(languageExecutor);
+ QCodeExecutor qCodeExecutor = executorClass.getConstructor().newInstance();
+
+ Serializable codeOutput = qCodeExecutor.execute(codeReference, input.getContext(), executionLogger);
+ output.setOutput(codeOutput);
+ executionLogger.acceptExecutionEnd(codeOutput);
+ }
+ catch(QCodeException qCodeException)
+ {
+ executionLogger.acceptException(qCodeException);
+ throw (qCodeException);
+ }
+ catch(Exception e)
+ {
+ executionLogger.acceptException(e);
+ throw (new QException("Error executing code [" + codeReference + "]", e));
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QCodeExecutionLoggerInterface getDefaultExecutionLogger()
+ {
+ return (new Log4jCodeExecutionLogger());
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/QCodeExecutor.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/QCodeExecutor.java
new file mode 100644
index 00000000..9ea44224
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/QCodeExecutor.java
@@ -0,0 +1,43 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.Map;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.QCodeExecutionLoggerInterface;
+import com.kingsrook.qqq.backend.core.exceptions.QCodeException;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public interface QCodeExecutor
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ Serializable execute(QCodeReference codeReference, Map context, QCodeExecutionLoggerInterface executionLogger) throws QCodeException;
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/QJavaExecutor.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/QJavaExecutor.java
new file mode 100644
index 00000000..82d303c6
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/QJavaExecutor.java
@@ -0,0 +1,68 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.function.Function;
+import com.kingsrook.qqq.backend.core.actions.customizers.QCodeLoader;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.QCodeExecutionLoggerInterface;
+import com.kingsrook.qqq.backend.core.exceptions.QCodeException;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class QJavaExecutor implements QCodeExecutor
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public Serializable execute(QCodeReference codeReference, Map input, QCodeExecutionLoggerInterface executionLogger) throws QCodeException
+ {
+ Map context = new HashMap<>(input);
+ if(!context.containsKey("logger"))
+ {
+ context.put("logger", executionLogger);
+ }
+
+ Serializable output;
+ try
+ {
+ Function, Serializable> function = QCodeLoader.getFunction(codeReference);
+ output = function.apply(context);
+ }
+ catch(Exception e)
+ {
+ QCodeException qCodeException = new QCodeException("Error executing script", e);
+ throw (qCodeException);
+ }
+
+ return (output);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/RunAssociatedScriptAction.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/RunAssociatedScriptAction.java
new file mode 100644
index 00000000..7a14cfb3
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/RunAssociatedScriptAction.java
@@ -0,0 +1,113 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.HashMap;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.HeaderAndDetailTableCodeExecutionLogger;
+import com.kingsrook.qqq.backend.core.actions.tables.GetAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeOutput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.RunAssociatedScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.RunAssociatedScriptOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.get.GetInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.get.GetOutput;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeType;
+import com.kingsrook.qqq.backend.core.model.scripts.Script;
+import com.kingsrook.qqq.backend.core.model.scripts.ScriptRevision;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class RunAssociatedScriptAction
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public void run(RunAssociatedScriptInput input, RunAssociatedScriptOutput output) throws QException
+ {
+ Serializable scriptId = getScriptId(input);
+ Script script = getScript(input, scriptId);
+ ScriptRevision scriptRevision = getCurrentScriptRevision(input, script.getCurrentScriptRevisionId());
+
+ ExecuteCodeInput executeCodeInput = new ExecuteCodeInput(input.getInstance());
+ executeCodeInput.setSession(input.getSession());
+ executeCodeInput.setContext(new HashMap<>(input.getInputValues()));
+ executeCodeInput.setCodeReference(new QCodeReference().withInlineCode(scriptRevision.getContents()).withCodeType(QCodeType.JAVA_SCRIPT));
+ executeCodeInput.setExecutionLogger(new HeaderAndDetailTableCodeExecutionLogger(scriptRevision.getScriptId(), scriptRevision.getId()));
+ ExecuteCodeOutput executeCodeOutput = new ExecuteCodeOutput();
+ new ExecuteCodeAction().run(executeCodeInput, executeCodeOutput);
+
+ output.setOutput(executeCodeOutput.getOutput());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private ScriptRevision getCurrentScriptRevision(RunAssociatedScriptInput input, Serializable scriptRevisionId) throws QException
+ {
+ GetInput getInput = new GetInput(input.getInstance());
+ getInput.setSession(input.getSession());
+ getInput.setTableName("scriptRevision");
+ getInput.setPrimaryKey(scriptRevisionId);
+ GetOutput getOutput = new GetAction().execute(getInput);
+ return (new ScriptRevision(getOutput.getRecord()));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private Script getScript(RunAssociatedScriptInput input, Serializable scriptId) throws QException
+ {
+ GetInput getInput = new GetInput(input.getInstance());
+ getInput.setSession(input.getSession());
+ getInput.setTableName("script");
+ getInput.setPrimaryKey(scriptId);
+ GetOutput getOutput = new GetAction().execute(getInput);
+ return (new Script(getOutput.getRecord()));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private Serializable getScriptId(RunAssociatedScriptInput input) throws QException
+ {
+ GetInput getInput = new GetInput(input.getInstance());
+ getInput.setSession(input.getSession());
+ getInput.setTableName(input.getCodeReference().getRecordTable());
+ getInput.setPrimaryKey(input.getCodeReference().getRecordPrimaryKey());
+ GetOutput getOutput = new GetAction().execute(getInput);
+ return (getOutput.getRecord().getValue(input.getCodeReference().getFieldName()));
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/StoreAssociatedScriptAction.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/StoreAssociatedScriptAction.java
new file mode 100644
index 00000000..aad454cd
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/StoreAssociatedScriptAction.java
@@ -0,0 +1,206 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Optional;
+import com.kingsrook.qqq.backend.core.actions.tables.GetAction;
+import com.kingsrook.qqq.backend.core.actions.tables.InsertAction;
+import com.kingsrook.qqq.backend.core.actions.tables.QueryAction;
+import com.kingsrook.qqq.backend.core.actions.tables.UpdateAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.get.GetInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.get.GetOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QCriteriaOperator;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterOrderBy;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.update.UpdateInput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.AssociatedScript;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.utils.StringUtils;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class StoreAssociatedScriptAction
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public void run(StoreAssociatedScriptInput input, StoreAssociatedScriptOutput output) throws QException
+ {
+ QTableMetaData table = input.getTable();
+ Optional optAssociatedScript = table.getAssociatedScripts().stream().filter(as -> as.getFieldName().equals(input.getFieldName())).findFirst();
+ if(optAssociatedScript.isEmpty())
+ {
+ throw (new QException("Field to update associated script for is not an associated script field."));
+ }
+ AssociatedScript associatedScript = optAssociatedScript.get();
+
+ /////////////////////////////////////////////////////////////
+ // get the record that the script is to be associated with //
+ /////////////////////////////////////////////////////////////
+ QRecord associatedRecord;
+ {
+ GetInput getInput = new GetInput(input.getInstance());
+ getInput.setSession(input.getSession());
+ getInput.setTableName(input.getTableName());
+ getInput.setPrimaryKey(input.getRecordPrimaryKey());
+ GetOutput getOutput = new GetAction().execute(getInput);
+ associatedRecord = getOutput.getRecord();
+ }
+ if(associatedRecord == null)
+ {
+ throw (new QException("Record to associated with script was not found."));
+ }
+
+ //////////////////////////////////////////////////////////////////
+ // check if there's currently a script referenced by the record //
+ //////////////////////////////////////////////////////////////////
+ Serializable existingScriptId = associatedRecord.getValueString(input.getFieldName());
+ QRecord script;
+ Integer nextSequenceNo = 1;
+ if(existingScriptId == null)
+ {
+ ////////////////////////////////////////////////////////////////////
+ // get the script type - that'll be part of the new script's name //
+ ////////////////////////////////////////////////////////////////////
+ GetInput getInput = new GetInput(input.getInstance());
+ getInput.setSession(input.getSession());
+ getInput.setTableName("scriptType");
+ getInput.setPrimaryKey(associatedScript.getScriptTypeId());
+ GetOutput getOutput = new GetAction().execute(getInput);
+ QRecord scriptType = getOutput.getRecord();
+
+ /////////////////////////
+ // insert a new script //
+ /////////////////////////
+ script = new QRecord();
+ script.setValue("scriptTypeId", associatedScript.getScriptTypeId());
+ script.setValue("name", associatedRecord.getRecordLabel() + " - " + scriptType.getRecordLabel());
+ InsertInput insertInput = new InsertInput(input.getInstance());
+ insertInput.setSession(input.getSession());
+ insertInput.setTableName("script");
+ insertInput.setRecords(List.of(script));
+ InsertOutput insertOutput = new InsertAction().execute(insertInput);
+ script = insertOutput.getRecords().get(0);
+
+ /////////////////////////////////////////////////////////////
+ // update the associated record to point at the new script //
+ /////////////////////////////////////////////////////////////
+ UpdateInput updateInput = new UpdateInput(input.getInstance());
+ updateInput.setSession(input.getSession());
+ updateInput.setTableName(input.getTableName());
+ updateInput.setRecords(List.of(new QRecord()
+ .withValue(table.getPrimaryKeyField(), associatedRecord.getValue(table.getPrimaryKeyField()))
+ .withValue(input.getFieldName(), script.getValue("id"))
+ ));
+ new UpdateAction().execute(updateInput);
+ }
+ else
+ {
+ ////////////////////////////////////////
+ // get the existing script, to update //
+ ////////////////////////////////////////
+ GetInput getInput = new GetInput(input.getInstance());
+ getInput.setSession(input.getSession());
+ getInput.setTableName("script");
+ getInput.setPrimaryKey(existingScriptId);
+ GetOutput getOutput = new GetAction().execute(getInput);
+ script = getOutput.getRecord();
+
+ QueryInput queryInput = new QueryInput(input.getInstance());
+ queryInput.setSession(input.getSession());
+ queryInput.setTableName("scriptRevision");
+ queryInput.setFilter(new QQueryFilter()
+ .withCriteria(new QFilterCriteria("scriptId", QCriteriaOperator.EQUALS, List.of(script.getValue("id"))))
+ .withOrderBy(new QFilterOrderBy("sequenceNo", false))
+ );
+ queryInput.setLimit(1);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ if(!queryOutput.getRecords().isEmpty())
+ {
+ nextSequenceNo = queryOutput.getRecords().get(0).getValueInteger("sequenceNo") + 1;
+ }
+ }
+
+ //////////////////////////////////
+ // insert a new script revision //
+ //////////////////////////////////
+ String commitMessage = input.getCommitMessage();
+ if(!StringUtils.hasContent(commitMessage))
+ {
+ if(nextSequenceNo == 1)
+ {
+ commitMessage = "Initial version";
+ }
+ else
+ {
+ commitMessage = "No commit message given";
+ }
+ }
+
+ QRecord scriptRevision = new QRecord()
+ .withValue("scriptId", script.getValue("id"))
+ .withValue("contents", input.getCode())
+ .withValue("commitMessage", commitMessage)
+ .withValue("sequenceNo", nextSequenceNo);
+
+ try
+ {
+ scriptRevision.setValue("author", input.getSession().getUser().getFullName());
+ }
+ catch(Exception e)
+ {
+ scriptRevision.setValue("author", "Unknown");
+ }
+
+ InsertInput insertInput = new InsertInput(input.getInstance());
+ insertInput.setSession(input.getSession());
+ insertInput.setTableName("scriptRevision");
+ insertInput.setRecords(List.of(scriptRevision));
+ InsertOutput insertOutput = new InsertAction().execute(insertInput);
+ scriptRevision = insertOutput.getRecords().get(0);
+
+ ////////////////////////////////////////////////////
+ // update the script to point at the new revision //
+ ////////////////////////////////////////////////////
+ script.setValue("currentScriptRevisionId", scriptRevision.getValue("id"));
+ UpdateInput updateInput = new UpdateInput(input.getInstance());
+ updateInput.setSession(input.getSession());
+ updateInput.setTableName("script");
+ updateInput.setRecords(List.of(script));
+ new UpdateAction().execute(updateInput);
+ }
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/TestScriptAction.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/TestScriptAction.java
new file mode 100644
index 00000000..3b651907
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/TestScriptAction.java
@@ -0,0 +1,44 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.TestScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.TestScriptOutput;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class TestScriptAction
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public void run(TestScriptInput input, TestScriptOutput output) throws QException
+ {
+ QTableMetaData table = input.getTable();
+ }
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/HeaderAndDetailTableCodeExecutionLogger.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/HeaderAndDetailTableCodeExecutionLogger.java
new file mode 100644
index 00000000..315a6680
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/HeaderAndDetailTableCodeExecutionLogger.java
@@ -0,0 +1,221 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts.logging;
+
+
+import java.io.Serializable;
+import java.time.Instant;
+import java.time.temporal.ChronoUnit;
+import java.util.ArrayList;
+import java.util.List;
+import com.kingsrook.qqq.backend.core.actions.tables.InsertAction;
+import com.kingsrook.qqq.backend.core.actions.tables.UpdateAction;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.update.UpdateInput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.utils.CollectionUtils;
+import com.kingsrook.qqq.backend.core.utils.StringUtils;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+
+/*******************************************************************************
+ ** Implementation of a code execution logger that logs into a header and child
+ ** table
+ *******************************************************************************/
+public class HeaderAndDetailTableCodeExecutionLogger implements QCodeExecutionLoggerInterface
+{
+ private static final Logger LOG = LogManager.getLogger(HeaderAndDetailTableCodeExecutionLogger.class);
+
+ private QRecord header;
+ private List children = new ArrayList<>();
+ private ExecuteCodeInput executeCodeInput;
+
+ private Serializable scriptId;
+ private Serializable scriptRevisionId;
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public HeaderAndDetailTableCodeExecutionLogger(Serializable scriptId, Serializable scriptRevisionId)
+ {
+ this.scriptId = scriptId;
+ this.scriptRevisionId = scriptRevisionId;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QRecord buildHeaderRecord(ExecuteCodeInput executeCodeInput)
+ {
+ return (new QRecord()
+ .withValue("scriptId", scriptId)
+ .withValue("scriptRevisionId", scriptRevisionId)
+ .withValue("startTimestamp", Instant.now())
+ .withValue("input", truncate(executeCodeInput.getContext().toString())));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ protected QRecord buildDetailLogRecord(String logLine)
+ {
+ return (new QRecord()
+ .withValue("scriptLogId", header.getValue("id"))
+ .withValue("timestamp", Instant.now())
+ .withValue("text", truncate(logLine)));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private String truncate(String logLine)
+ {
+ return StringUtils.safeTruncate(logLine, 1000, "...");
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private void updateHeaderAtEnd(Serializable output, Exception exception)
+ {
+ Instant startTimestamp = (Instant) header.getValue("startTimestamp");
+ Instant endTimestamp = Instant.now();
+ header.setValue("endTimestamp", endTimestamp);
+ header.setValue("runTimeMillis", startTimestamp.until(endTimestamp, ChronoUnit.MILLIS));
+
+ if(exception != null)
+ {
+ header.setValue("hadError", true);
+ header.setValue("error", exception.getMessage());
+ }
+ else
+ {
+ header.setValue("hadError", false);
+ header.setValue("output", truncate(String.valueOf(output)));
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptExecutionStart(ExecuteCodeInput executeCodeInput)
+ {
+ try
+ {
+ this.executeCodeInput = executeCodeInput;
+ QRecord scriptLog = buildHeaderRecord(executeCodeInput);
+
+ InsertInput insertInput = new InsertInput(executeCodeInput.getInstance());
+ insertInput.setSession(executeCodeInput.getSession());
+ insertInput.setTableName("scriptLog");
+ insertInput.setRecords(List.of(scriptLog));
+ InsertOutput insertOutput = new InsertAction().execute(insertInput);
+ this.header = insertOutput.getRecords().get(0);
+ }
+ catch(Exception e)
+ {
+ LOG.warn("Error starting storage of script log", e);
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptLogLine(String logLine)
+ {
+ children.add(buildDetailLogRecord(logLine));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptException(Exception exception)
+ {
+ store(null, exception);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptExecutionEnd(Serializable output)
+ {
+ store(output, null);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private void store(Serializable output, Exception exception)
+ {
+ try
+ {
+ updateHeaderAtEnd(output, exception);
+ UpdateInput updateInput = new UpdateInput(executeCodeInput.getInstance());
+ updateInput.setSession(executeCodeInput.getSession());
+ updateInput.setTableName("scriptLog");
+ updateInput.setRecords(List.of(header));
+ new UpdateAction().execute(updateInput);
+
+ if(CollectionUtils.nullSafeHasContents(children))
+ {
+ InsertInput insertInput = new InsertInput(executeCodeInput.getInstance());
+ insertInput.setSession(executeCodeInput.getSession());
+ insertInput.setTableName("scriptLogLine");
+ insertInput.setRecords(children);
+ new InsertAction().execute(insertInput);
+ }
+ }
+ catch(Exception e)
+ {
+ LOG.warn("Error storing script log", e);
+ }
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/Log4jCodeExecutionLogger.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/Log4jCodeExecutionLogger.java
new file mode 100644
index 00000000..af914b38
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/Log4jCodeExecutionLogger.java
@@ -0,0 +1,93 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts.logging;
+
+
+import java.io.Serializable;
+import java.util.UUID;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+import com.kingsrook.qqq.backend.core.utils.StringUtils;
+import com.kingsrook.qqq.backend.core.utils.ValueUtils;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+
+
+/*******************************************************************************
+ ** Implementation of a code execution logger that just logs to LOG 4j
+ *******************************************************************************/
+public class Log4jCodeExecutionLogger implements QCodeExecutionLoggerInterface
+{
+ private static final Logger LOG = LogManager.getLogger(Log4jCodeExecutionLogger.class);
+
+ private QCodeReference qCodeReference;
+ private String uuid = UUID.randomUUID().toString();
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptExecutionStart(ExecuteCodeInput executeCodeInput)
+ {
+ this.qCodeReference = executeCodeInput.getCodeReference();
+
+ String contextString = StringUtils.safeTruncate(ValueUtils.getValueAsString(executeCodeInput.getContext()), 250, "...");
+ LOG.info("Starting script execution: " + qCodeReference.getName() + ", uuid: " + uuid + ", with context: " + contextString);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptLogLine(String logLine)
+ {
+ LOG.info("Script log: " + uuid + ": " + logLine);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptException(Exception exception)
+ {
+ LOG.info("Script Exception: " + uuid, exception);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptExecutionEnd(Serializable output)
+ {
+ String outputString = StringUtils.safeTruncate(ValueUtils.getValueAsString(output), 250, "...");
+ LOG.info("Finished script execution: " + qCodeReference.getName() + ", uuid: " + uuid + ", with output: " + outputString);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/NoopCodeExecutionLogger.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/NoopCodeExecutionLogger.java
new file mode 100644
index 00000000..d2e9e56d
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/NoopCodeExecutionLogger.java
@@ -0,0 +1,74 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts.logging;
+
+
+import java.io.Serializable;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+
+
+/*******************************************************************************
+ ** Implementation of a code execution logger that just noop's every action.
+ *******************************************************************************/
+public class NoopCodeExecutionLogger implements QCodeExecutionLoggerInterface
+{
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptExecutionStart(ExecuteCodeInput executeCodeInput)
+ {
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptLogLine(String logLine)
+ {
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptException(Exception exception)
+ {
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public void acceptExecutionEnd(Serializable output)
+ {
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/QCodeExecutionLoggerInterface.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/QCodeExecutionLoggerInterface.java
new file mode 100644
index 00000000..caafd906
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/actions/scripts/logging/QCodeExecutionLoggerInterface.java
@@ -0,0 +1,63 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts.logging;
+
+
+import java.io.Serializable;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public interface QCodeExecutionLoggerInterface
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ void acceptExecutionStart(ExecuteCodeInput executeCodeInput);
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ void acceptLogLine(String logLine);
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ default void log(String message)
+ {
+ acceptLogLine(message);
+ }
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ void acceptException(Exception exception);
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ void acceptExecutionEnd(Serializable output);
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/exceptions/QCodeException.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/exceptions/QCodeException.java
new file mode 100644
index 00000000..0bbbc0b3
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/exceptions/QCodeException.java
@@ -0,0 +1,77 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.exceptions;
+
+
+/*******************************************************************************
+ * Exception thrown while generating reports
+ *
+ *******************************************************************************/
+public class QCodeException extends QException
+{
+ private String context;
+
+
+
+ /*******************************************************************************
+ ** Constructor of message
+ **
+ *******************************************************************************/
+ public QCodeException(String message)
+ {
+ super(message);
+ }
+
+
+
+ /*******************************************************************************
+ ** Constructor of message & cause
+ **
+ *******************************************************************************/
+ public QCodeException(String message, Throwable cause)
+ {
+ super(message, cause);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for context
+ **
+ *******************************************************************************/
+ public String getContext()
+ {
+ return context;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for context
+ **
+ *******************************************************************************/
+ public void setContext(String context)
+ {
+ this.context = context;
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/instances/QInstanceEnricher.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/instances/QInstanceEnricher.java
index 6f11bd5b..078c7843 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/instances/QInstanceEnricher.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/instances/QInstanceEnricher.java
@@ -608,7 +608,7 @@ public class QInstanceEnricher
** TLAAndAnotherTLA -> tla_and_another_tla
**
*******************************************************************************/
- static String inferBackendName(String fieldName)
+ public static String inferBackendName(String fieldName)
{
////////////////////////////////////////////////////////////////////////////////////////
// build a list of words in the name, then join them with _ and lower-case the result //
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/ExecuteCodeInput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/ExecuteCodeInput.java
new file mode 100644
index 00000000..6514e797
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/ExecuteCodeInput.java
@@ -0,0 +1,172 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.HashMap;
+import java.util.Map;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.QCodeExecutionLoggerInterface;
+import com.kingsrook.qqq.backend.core.model.actions.AbstractActionInput;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ExecuteCodeInput extends AbstractActionInput
+{
+ private QCodeReference codeReference;
+ private Map context;
+ private QCodeExecutionLoggerInterface executionLogger;
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public ExecuteCodeInput(QInstance qInstance)
+ {
+ super(qInstance);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for codeReference
+ **
+ *******************************************************************************/
+ public QCodeReference getCodeReference()
+ {
+ return codeReference;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for codeReference
+ **
+ *******************************************************************************/
+ public void setCodeReference(QCodeReference codeReference)
+ {
+ this.codeReference = codeReference;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for codeReference
+ **
+ *******************************************************************************/
+ public ExecuteCodeInput withCodeReference(QCodeReference codeReference)
+ {
+ this.codeReference = codeReference;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for context
+ **
+ *******************************************************************************/
+ public Map getContext()
+ {
+ return context;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for context
+ **
+ *******************************************************************************/
+ public void setContext(Map context)
+ {
+ this.context = context;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for context
+ **
+ *******************************************************************************/
+ public ExecuteCodeInput withContext(Map context)
+ {
+ this.context = context;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for context
+ **
+ *******************************************************************************/
+ public ExecuteCodeInput withContext(String key, Serializable value)
+ {
+ if(this.context == null)
+ {
+ context = new HashMap<>();
+ }
+ this.context.put(key, value);
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for executionLogger
+ **
+ *******************************************************************************/
+ public QCodeExecutionLoggerInterface getExecutionLogger()
+ {
+ return executionLogger;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for executionLogger
+ **
+ *******************************************************************************/
+ public void setExecutionLogger(QCodeExecutionLoggerInterface executionLogger)
+ {
+ this.executionLogger = executionLogger;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for executionLogger
+ **
+ *******************************************************************************/
+ public ExecuteCodeInput withExecutionLogger(QCodeExecutionLoggerInterface executionLogger)
+ {
+ this.executionLogger = executionLogger;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/ExecuteCodeOutput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/ExecuteCodeOutput.java
new file mode 100644
index 00000000..bb66522f
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/ExecuteCodeOutput.java
@@ -0,0 +1,69 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import java.io.Serializable;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ExecuteCodeOutput
+{
+ private Serializable output;
+
+
+
+ /*******************************************************************************
+ ** Getter for output
+ **
+ *******************************************************************************/
+ public Serializable getOutput()
+ {
+ return output;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for output
+ **
+ *******************************************************************************/
+ public void setOutput(Serializable output)
+ {
+ this.output = output;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for output
+ **
+ *******************************************************************************/
+ public ExecuteCodeOutput withOutput(Serializable output)
+ {
+ this.output = output;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/RunAssociatedScriptInput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/RunAssociatedScriptInput.java
new file mode 100644
index 00000000..96dbbb82
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/RunAssociatedScriptInput.java
@@ -0,0 +1,117 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import java.util.Map;
+import com.kingsrook.qqq.backend.core.model.actions.AbstractTableActionInput;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.code.AssociatedScriptCodeReference;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class RunAssociatedScriptInput extends AbstractTableActionInput
+{
+ private AssociatedScriptCodeReference codeReference;
+ private Map inputValues;
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public RunAssociatedScriptInput(QInstance qInstance)
+ {
+ super(qInstance);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for codeReference
+ **
+ *******************************************************************************/
+ public AssociatedScriptCodeReference getCodeReference()
+ {
+ return codeReference;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for codeReference
+ **
+ *******************************************************************************/
+ public void setCodeReference(AssociatedScriptCodeReference codeReference)
+ {
+ this.codeReference = codeReference;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for codeReference
+ **
+ *******************************************************************************/
+ public RunAssociatedScriptInput withCodeReference(AssociatedScriptCodeReference codeReference)
+ {
+ this.codeReference = codeReference;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for inputValues
+ **
+ *******************************************************************************/
+ public Map getInputValues()
+ {
+ return inputValues;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for inputValues
+ **
+ *******************************************************************************/
+ public void setInputValues(Map inputValues)
+ {
+ this.inputValues = inputValues;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for inputValues
+ **
+ *******************************************************************************/
+ public RunAssociatedScriptInput withInputValues(Map inputValues)
+ {
+ this.inputValues = inputValues;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/RunAssociatedScriptOutput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/RunAssociatedScriptOutput.java
new file mode 100644
index 00000000..1b80a54f
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/RunAssociatedScriptOutput.java
@@ -0,0 +1,70 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import java.io.Serializable;
+import com.kingsrook.qqq.backend.core.model.actions.AbstractActionOutput;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class RunAssociatedScriptOutput extends AbstractActionOutput
+{
+ private Serializable output;
+
+
+
+ /*******************************************************************************
+ ** Getter for output
+ **
+ *******************************************************************************/
+ public Serializable getOutput()
+ {
+ return output;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for output
+ **
+ *******************************************************************************/
+ public void setOutput(Serializable output)
+ {
+ this.output = output;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for output
+ **
+ *******************************************************************************/
+ public RunAssociatedScriptOutput withOutput(Serializable output)
+ {
+ this.output = output;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/StoreAssociatedScriptInput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/StoreAssociatedScriptInput.java
new file mode 100644
index 00000000..4f3915b4
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/StoreAssociatedScriptInput.java
@@ -0,0 +1,188 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import java.io.Serializable;
+import com.kingsrook.qqq.backend.core.model.actions.AbstractTableActionInput;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class StoreAssociatedScriptInput extends AbstractTableActionInput
+{
+ private String fieldName;
+ private Serializable recordPrimaryKey;
+
+ private String code;
+ private String commitMessage;
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public StoreAssociatedScriptInput(QInstance instance)
+ {
+ super(instance);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for fieldName
+ **
+ *******************************************************************************/
+ public String getFieldName()
+ {
+ return fieldName;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for fieldName
+ **
+ *******************************************************************************/
+ public void setFieldName(String fieldName)
+ {
+ this.fieldName = fieldName;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for fieldName
+ **
+ *******************************************************************************/
+ public StoreAssociatedScriptInput withFieldName(String fieldName)
+ {
+ this.fieldName = fieldName;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public Serializable getRecordPrimaryKey()
+ {
+ return recordPrimaryKey;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public void setRecordPrimaryKey(Serializable recordPrimaryKey)
+ {
+ this.recordPrimaryKey = recordPrimaryKey;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public StoreAssociatedScriptInput withRecordPrimaryKey(Serializable recordPrimaryKey)
+ {
+ this.recordPrimaryKey = recordPrimaryKey;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for code
+ **
+ *******************************************************************************/
+ public String getCode()
+ {
+ return code;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for code
+ **
+ *******************************************************************************/
+ public void setCode(String code)
+ {
+ this.code = code;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for code
+ **
+ *******************************************************************************/
+ public StoreAssociatedScriptInput withCode(String code)
+ {
+ this.code = code;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for commitMessage
+ **
+ *******************************************************************************/
+ public String getCommitMessage()
+ {
+ return commitMessage;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for commitMessage
+ **
+ *******************************************************************************/
+ public void setCommitMessage(String commitMessage)
+ {
+ this.commitMessage = commitMessage;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for commitMessage
+ **
+ *******************************************************************************/
+ public StoreAssociatedScriptInput withCommitMessage(String commitMessage)
+ {
+ this.commitMessage = commitMessage;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/StoreAssociatedScriptOutput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/StoreAssociatedScriptOutput.java
new file mode 100644
index 00000000..12549e0d
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/StoreAssociatedScriptOutput.java
@@ -0,0 +1,33 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import com.kingsrook.qqq.backend.core.model.actions.AbstractActionOutput;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class StoreAssociatedScriptOutput extends AbstractActionOutput
+{
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/TestScriptInput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/TestScriptInput.java
new file mode 100644
index 00000000..33871f38
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/TestScriptInput.java
@@ -0,0 +1,187 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.Map;
+import com.kingsrook.qqq.backend.core.model.actions.AbstractTableActionInput;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class TestScriptInput extends AbstractTableActionInput
+{
+ private Serializable recordPrimaryKey;
+ private String code;
+ private Serializable scriptTypeId;
+ private Map inputValues;
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public TestScriptInput(QInstance qInstance)
+ {
+ super(qInstance);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public Serializable getRecordPrimaryKey()
+ {
+ return recordPrimaryKey;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public void setRecordPrimaryKey(Serializable recordPrimaryKey)
+ {
+ this.recordPrimaryKey = recordPrimaryKey;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public TestScriptInput withRecordPrimaryKey(Serializable recordPrimaryKey)
+ {
+ this.recordPrimaryKey = recordPrimaryKey;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for inputValues
+ **
+ *******************************************************************************/
+ public Map getInputValues()
+ {
+ return inputValues;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for inputValues
+ **
+ *******************************************************************************/
+ public void setInputValues(Map inputValues)
+ {
+ this.inputValues = inputValues;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for inputValues
+ **
+ *******************************************************************************/
+ public TestScriptInput withInputValues(Map inputValues)
+ {
+ this.inputValues = inputValues;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for code
+ **
+ *******************************************************************************/
+ public String getCode()
+ {
+ return code;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for code
+ **
+ *******************************************************************************/
+ public void setCode(String code)
+ {
+ this.code = code;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for code
+ **
+ *******************************************************************************/
+ public TestScriptInput withCode(String code)
+ {
+ this.code = code;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptTypeId
+ **
+ *******************************************************************************/
+ public Serializable getScriptTypeId()
+ {
+ return scriptTypeId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptTypeId
+ **
+ *******************************************************************************/
+ public void setScriptTypeId(Serializable scriptTypeId)
+ {
+ this.scriptTypeId = scriptTypeId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptTypeId
+ **
+ *******************************************************************************/
+ public TestScriptInput withScriptTypeId(Serializable scriptTypeId)
+ {
+ this.scriptTypeId = scriptTypeId;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/TestScriptOutput.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/TestScriptOutput.java
new file mode 100644
index 00000000..d6da9222
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/actions/scripts/TestScriptOutput.java
@@ -0,0 +1,33 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.actions.scripts;
+
+
+import com.kingsrook.qqq.backend.core.model.actions.AbstractActionOutput;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class TestScriptOutput extends AbstractActionOutput
+{
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/data/QRecordEnum.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/data/QRecordEnum.java
new file mode 100644
index 00000000..28b6198c
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/data/QRecordEnum.java
@@ -0,0 +1,175 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.data;
+
+
+import java.io.Serializable;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.math.BigDecimal;
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.LocalTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+import java.util.Optional;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.utils.ListingHash;
+
+
+/*******************************************************************************
+ ** Base class for enums that are interoperable with QRecords.
+ *******************************************************************************/
+public interface QRecordEnum
+{
+ ListingHash, QRecordEntityField> fieldMapping = new ListingHash<>();
+
+
+ /*******************************************************************************
+ ** Convert this entity to a QRecord.
+ **
+ *******************************************************************************/
+ default QRecord toQRecord() throws QException
+ {
+ try
+ {
+ QRecord qRecord = new QRecord();
+
+ List fieldList = getFieldList(this.getClass());
+ for(QRecordEntityField qRecordEntityField : fieldList)
+ {
+ qRecord.setValue(qRecordEntityField.getFieldName(), (Serializable) qRecordEntityField.getGetter().invoke(this));
+ }
+
+ return (qRecord);
+ }
+ catch(Exception e)
+ {
+ throw (new QException("Error building qRecord from entity.", e));
+ }
+ }
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static List getFieldList(Class c)
+ {
+ if(!fieldMapping.containsKey(c))
+ {
+ List fieldList = new ArrayList<>();
+ for(Method possibleGetter : c.getMethods())
+ {
+ if(isGetter(possibleGetter))
+ {
+ String fieldName = getFieldNameFromGetter(possibleGetter);
+ Optional fieldAnnotation = getQFieldAnnotation(c, fieldName);
+ fieldList.add(new QRecordEntityField(fieldName, possibleGetter, null, possibleGetter.getReturnType(), fieldAnnotation.orElse(null)));
+ }
+ }
+ fieldMapping.put(c, fieldList);
+ }
+ return (fieldMapping.get(c));
+ }
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static Optional getQFieldAnnotation(Class c, String fieldName)
+ {
+ try
+ {
+ Field field = c.getDeclaredField(fieldName);
+ return (Optional.ofNullable(field.getAnnotation(QField.class)));
+ }
+ catch(NoSuchFieldException e)
+ {
+ //////////////////////////////////////////
+ // ok, we just won't have an annotation //
+ //////////////////////////////////////////
+ }
+ return (Optional.empty());
+ }
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static String getFieldNameFromGetter(Method getter)
+ {
+ String nameWithoutGet = getter.getName().replaceFirst("^get", "");
+ if(nameWithoutGet.length() == 1)
+ {
+ return (nameWithoutGet.toLowerCase(Locale.ROOT));
+ }
+ return (nameWithoutGet.substring(0, 1).toLowerCase(Locale.ROOT) + nameWithoutGet.substring(1));
+ }
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean isGetter(Method method)
+ {
+ if(method.getParameterTypes().length == 0 && method.getName().matches("^get[A-Z].*"))
+ {
+ if(isSupportedFieldType(method.getReturnType()))
+ {
+ return (true);
+ }
+ else
+ {
+ if(!method.getName().equals("getClass"))
+ {
+ System.err.println("Method [" + method.getName() + "] looks like a getter, but its return type, [" + method.getReturnType() + "], isn't supported.");
+ }
+ }
+ }
+ return (false);
+ }
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean isSupportedFieldType(Class returnType)
+ {
+ // todo - more types!!
+ return (returnType.equals(String.class)
+ || returnType.equals(Integer.class)
+ || returnType.equals(int.class)
+ || returnType.equals(Boolean.class)
+ || returnType.equals(boolean.class)
+ || returnType.equals(BigDecimal.class)
+ || returnType.equals(Instant.class)
+ || returnType.equals(LocalDate.class)
+ || returnType.equals(LocalTime.class));
+ /////////////////////////////////////////////
+ // note - this list has implications upon: //
+ // - QFieldType.fromClass //
+ // - QRecordEntityField.convertValueType //
+ /////////////////////////////////////////////
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/AssociatedScriptCodeReference.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/AssociatedScriptCodeReference.java
new file mode 100644
index 00000000..716b4063
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/AssociatedScriptCodeReference.java
@@ -0,0 +1,139 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.metadata.code;
+
+
+import java.io.Serializable;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class AssociatedScriptCodeReference extends QCodeReference
+{
+ private String recordTable;
+ private Serializable recordPrimaryKey;
+ private String fieldName;
+
+
+
+ /*******************************************************************************
+ ** Getter for recordTable
+ **
+ *******************************************************************************/
+ public String getRecordTable()
+ {
+ return recordTable;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for recordTable
+ **
+ *******************************************************************************/
+ public void setRecordTable(String recordTable)
+ {
+ this.recordTable = recordTable;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for recordTable
+ **
+ *******************************************************************************/
+ public AssociatedScriptCodeReference withRecordTable(String recordTable)
+ {
+ this.recordTable = recordTable;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public Serializable getRecordPrimaryKey()
+ {
+ return recordPrimaryKey;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public void setRecordPrimaryKey(Serializable recordPrimaryKey)
+ {
+ this.recordPrimaryKey = recordPrimaryKey;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for recordPrimaryKey
+ **
+ *******************************************************************************/
+ public AssociatedScriptCodeReference withRecordPrimaryKey(Serializable recordPrimaryKey)
+ {
+ this.recordPrimaryKey = recordPrimaryKey;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for fieldName
+ **
+ *******************************************************************************/
+ public String getFieldName()
+ {
+ return fieldName;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for fieldName
+ **
+ *******************************************************************************/
+ public void setFieldName(String fieldName)
+ {
+ this.fieldName = fieldName;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for fieldName
+ **
+ *******************************************************************************/
+ public AssociatedScriptCodeReference withFieldName(String fieldName)
+ {
+ this.fieldName = fieldName;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeReference.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeReference.java
index 62f7f7d2..4e7998e5 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeReference.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeReference.java
@@ -38,6 +38,8 @@ public class QCodeReference implements Serializable
private QCodeType codeType;
private QCodeUsage codeUsage;
+ private String inlineCode;
+
/*******************************************************************************
@@ -212,4 +214,38 @@ public class QCodeReference implements Serializable
return (this);
}
+
+
+ /*******************************************************************************
+ ** Getter for inlineCode
+ **
+ *******************************************************************************/
+ public String getInlineCode()
+ {
+ return inlineCode;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for inlineCode
+ **
+ *******************************************************************************/
+ public void setInlineCode(String inlineCode)
+ {
+ this.inlineCode = inlineCode;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for inlineCode
+ **
+ *******************************************************************************/
+ public QCodeReference withInlineCode(String inlineCode)
+ {
+ this.inlineCode = inlineCode;
+ return (this);
+ }
+
}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeType.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeType.java
index 6aa9099b..e3f98270 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeType.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/code/QCodeType.java
@@ -28,5 +28,6 @@ package com.kingsrook.qqq.backend.core.model.metadata.code;
*******************************************************************************/
public enum QCodeType
{
- JAVA
+ JAVA,
+ JAVA_SCRIPT
}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/AssociatedScript.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/AssociatedScript.java
new file mode 100644
index 00000000..1645e470
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/AssociatedScript.java
@@ -0,0 +1,104 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.metadata.tables;
+
+
+import java.io.Serializable;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class AssociatedScript implements Serializable
+{
+ private String fieldName;
+ private Serializable scriptTypeId;
+
+
+
+ /*******************************************************************************
+ ** Getter for fieldName
+ **
+ *******************************************************************************/
+ public String getFieldName()
+ {
+ return fieldName;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for fieldName
+ **
+ *******************************************************************************/
+ public void setFieldName(String fieldName)
+ {
+ this.fieldName = fieldName;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for fieldName
+ **
+ *******************************************************************************/
+ public AssociatedScript withFieldName(String fieldName)
+ {
+ this.fieldName = fieldName;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptTypeId
+ **
+ *******************************************************************************/
+ public Serializable getScriptTypeId()
+ {
+ return scriptTypeId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptTypeId
+ **
+ *******************************************************************************/
+ public void setScriptTypeId(Serializable scriptTypeId)
+ {
+ this.scriptTypeId = scriptTypeId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptTypeId
+ **
+ *******************************************************************************/
+ public AssociatedScript withScriptTypeId(Serializable scriptTypeId)
+ {
+ this.scriptTypeId = scriptTypeId;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/QTableMetaData.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/QTableMetaData.java
index 7c1f0571..7cfc0efe 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/QTableMetaData.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/metadata/tables/QTableMetaData.java
@@ -78,7 +78,8 @@ public class QTableMetaData implements QAppChildMetaData, Serializable
private List sections;
- private List widgets;
+ private List widgets;
+ private List associatedScripts;
@@ -754,6 +755,56 @@ public class QTableMetaData implements QAppChildMetaData, Serializable
+ /*******************************************************************************
+ ** Getter for associatedScripts
+ **
+ *******************************************************************************/
+ public List getAssociatedScripts()
+ {
+ return associatedScripts;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for associatedScripts
+ **
+ *******************************************************************************/
+ public void setAssociatedScripts(List associatedScripts)
+ {
+ this.associatedScripts = associatedScripts;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for associatedScripts
+ **
+ *******************************************************************************/
+ public QTableMetaData withAssociatedScripts(List associatedScripts)
+ {
+ this.associatedScripts = associatedScripts;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for associatedScripts
+ **
+ *******************************************************************************/
+ public QTableMetaData withAssociatedScript(AssociatedScript associatedScript)
+ {
+ if(this.associatedScripts == null)
+ {
+ this.associatedScripts = new ArrayList();
+ }
+ this.associatedScripts.add(associatedScript);
+ return (this);
+ }
+
+
+
/*******************************************************************************
** Getter for uniqueKeys
**
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/Script.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/Script.java
new file mode 100644
index 00000000..4c412dcb
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/Script.java
@@ -0,0 +1,282 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.scripts;
+
+
+import java.time.Instant;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.data.QField;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEntity;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class Script extends QRecordEntity
+{
+ public static final String TABLE_NAME = "script";
+
+ @QField()
+ private Integer id;
+
+ @QField()
+ private Instant createDate;
+
+ @QField()
+ private Instant modifyDate;
+
+ @QField()
+ private String name;
+
+ @QField()
+ private Integer scriptTypeId;
+
+ @QField()
+ private Integer currentScriptRevisionId;
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public Script()
+ {
+ }
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public Script(QRecord qRecord) throws QException
+ {
+ populateFromQRecord(qRecord);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for id
+ **
+ *******************************************************************************/
+ public Integer getId()
+ {
+ return id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for id
+ **
+ *******************************************************************************/
+ public void setId(Integer id)
+ {
+ this.id = id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for id
+ **
+ *******************************************************************************/
+ public Script withId(Integer id)
+ {
+ this.id = id;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for createDate
+ **
+ *******************************************************************************/
+ public Instant getCreateDate()
+ {
+ return createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for createDate
+ **
+ *******************************************************************************/
+ public void setCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for createDate
+ **
+ *******************************************************************************/
+ public Script withCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for modifyDate
+ **
+ *******************************************************************************/
+ public Instant getModifyDate()
+ {
+ return modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for modifyDate
+ **
+ *******************************************************************************/
+ public void setModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for modifyDate
+ **
+ *******************************************************************************/
+ public Script withModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for name
+ **
+ *******************************************************************************/
+ public String getName()
+ {
+ return name;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for name
+ **
+ *******************************************************************************/
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for name
+ **
+ *******************************************************************************/
+ public Script withName(String name)
+ {
+ this.name = name;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptTypeId
+ **
+ *******************************************************************************/
+ public Integer getScriptTypeId()
+ {
+ return scriptTypeId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptTypeId
+ **
+ *******************************************************************************/
+ public void setScriptTypeId(Integer scriptTypeId)
+ {
+ this.scriptTypeId = scriptTypeId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptTypeId
+ **
+ *******************************************************************************/
+ public Script withScriptTypeId(Integer scriptTypeId)
+ {
+ this.scriptTypeId = scriptTypeId;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for currentScriptRevisionId
+ **
+ *******************************************************************************/
+ public Integer getCurrentScriptRevisionId()
+ {
+ return currentScriptRevisionId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for currentScriptRevisionId
+ **
+ *******************************************************************************/
+ public void setCurrentScriptRevisionId(Integer currentScriptRevisionId)
+ {
+ this.currentScriptRevisionId = currentScriptRevisionId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for currentScriptRevisionId
+ **
+ *******************************************************************************/
+ public Script withCurrentScriptRevisionId(Integer currentScriptRevisionId)
+ {
+ this.currentScriptRevisionId = currentScriptRevisionId;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptLog.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptLog.java
new file mode 100644
index 00000000..1f297c75
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptLog.java
@@ -0,0 +1,481 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.scripts;
+
+
+import java.time.Instant;
+import com.kingsrook.qqq.backend.core.model.data.QField;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEntity;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ScriptLog extends QRecordEntity
+{
+ public static final String TABLE_NAME = "scriptLog";
+
+ @QField()
+ private Integer id;
+
+ @QField()
+ private Instant createDate;
+
+ @QField()
+ private Instant modifyDate;
+
+ @QField()
+ private Integer scriptId;
+
+ @QField()
+ private Integer scriptRevisionId;
+
+ @QField()
+ private Instant startTimestamp;
+
+ @QField()
+ private Instant endTimestamp;
+
+ @QField()
+ private Integer runTimeMillis;
+
+ @QField()
+ private Boolean hadError;
+
+ @QField()
+ private String input;
+
+ @QField()
+ private String output;
+
+ @QField()
+ private String error;
+
+
+
+ /*******************************************************************************
+ ** Getter for id
+ **
+ *******************************************************************************/
+ public Integer getId()
+ {
+ return id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for id
+ **
+ *******************************************************************************/
+ public void setId(Integer id)
+ {
+ this.id = id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for id
+ **
+ *******************************************************************************/
+ public ScriptLog withId(Integer id)
+ {
+ this.id = id;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for createDate
+ **
+ *******************************************************************************/
+ public Instant getCreateDate()
+ {
+ return createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for createDate
+ **
+ *******************************************************************************/
+ public void setCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for createDate
+ **
+ *******************************************************************************/
+ public ScriptLog withCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for modifyDate
+ **
+ *******************************************************************************/
+ public Instant getModifyDate()
+ {
+ return modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for modifyDate
+ **
+ *******************************************************************************/
+ public void setModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for modifyDate
+ **
+ *******************************************************************************/
+ public ScriptLog withModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptId
+ **
+ *******************************************************************************/
+ public Integer getScriptId()
+ {
+ return scriptId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptId
+ **
+ *******************************************************************************/
+ public void setScriptId(Integer scriptId)
+ {
+ this.scriptId = scriptId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptId
+ **
+ *******************************************************************************/
+ public ScriptLog withScriptId(Integer scriptId)
+ {
+ this.scriptId = scriptId;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptRevisionId
+ **
+ *******************************************************************************/
+ public Integer getScriptRevisionId()
+ {
+ return scriptRevisionId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptRevisionId
+ **
+ *******************************************************************************/
+ public void setScriptRevisionId(Integer scriptRevisionId)
+ {
+ this.scriptRevisionId = scriptRevisionId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptRevisionId
+ **
+ *******************************************************************************/
+ public ScriptLog withScriptRevisionId(Integer scriptRevisionId)
+ {
+ this.scriptRevisionId = scriptRevisionId;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for startTimestamp
+ **
+ *******************************************************************************/
+ public Instant getStartTimestamp()
+ {
+ return startTimestamp;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for startTimestamp
+ **
+ *******************************************************************************/
+ public void setStartTimestamp(Instant startTimestamp)
+ {
+ this.startTimestamp = startTimestamp;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for startTimestamp
+ **
+ *******************************************************************************/
+ public ScriptLog withStartTimestamp(Instant startTimestamp)
+ {
+ this.startTimestamp = startTimestamp;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for endTimestamp
+ **
+ *******************************************************************************/
+ public Instant getEndTimestamp()
+ {
+ return endTimestamp;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for endTimestamp
+ **
+ *******************************************************************************/
+ public void setEndTimestamp(Instant endTimestamp)
+ {
+ this.endTimestamp = endTimestamp;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for endTimestamp
+ **
+ *******************************************************************************/
+ public ScriptLog withEndTimestamp(Instant endTimestamp)
+ {
+ this.endTimestamp = endTimestamp;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for runTimeMillis
+ **
+ *******************************************************************************/
+ public Integer getRunTimeMillis()
+ {
+ return runTimeMillis;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for runTimeMillis
+ **
+ *******************************************************************************/
+ public void setRunTimeMillis(Integer runTimeMillis)
+ {
+ this.runTimeMillis = runTimeMillis;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for runTimeMillis
+ **
+ *******************************************************************************/
+ public ScriptLog withRunTimeMillis(Integer runTimeMillis)
+ {
+ this.runTimeMillis = runTimeMillis;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for hadError
+ **
+ *******************************************************************************/
+ public Boolean getHadError()
+ {
+ return hadError;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for hadError
+ **
+ *******************************************************************************/
+ public void setHadError(Boolean hadError)
+ {
+ this.hadError = hadError;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for hadError
+ **
+ *******************************************************************************/
+ public ScriptLog withHadError(Boolean hadError)
+ {
+ this.hadError = hadError;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for input
+ **
+ *******************************************************************************/
+ public String getInput()
+ {
+ return input;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for input
+ **
+ *******************************************************************************/
+ public void setInput(String input)
+ {
+ this.input = input;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for input
+ **
+ *******************************************************************************/
+ public ScriptLog withInput(String input)
+ {
+ this.input = input;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for output
+ **
+ *******************************************************************************/
+ public String getOutput()
+ {
+ return output;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for output
+ **
+ *******************************************************************************/
+ public void setOutput(String output)
+ {
+ this.output = output;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for output
+ **
+ *******************************************************************************/
+ public ScriptLog withOutput(String output)
+ {
+ this.output = output;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for error
+ **
+ *******************************************************************************/
+ public String getError()
+ {
+ return error;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for error
+ **
+ *******************************************************************************/
+ public void setError(String error)
+ {
+ this.error = error;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for error
+ **
+ *******************************************************************************/
+ public ScriptLog withError(String error)
+ {
+ this.error = error;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptLogLine.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptLogLine.java
new file mode 100644
index 00000000..48accdc8
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptLogLine.java
@@ -0,0 +1,259 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.scripts;
+
+
+import java.time.Instant;
+import com.kingsrook.qqq.backend.core.model.data.QField;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEntity;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ScriptLogLine extends QRecordEntity
+{
+ public static final String TABLE_NAME = "scriptLogLine";
+
+ @QField()
+ private Integer id;
+
+ @QField()
+ private Instant createDate;
+
+ @QField()
+ private Instant modifyDate;
+
+ @QField()
+ private Integer scriptLogId;
+
+ @QField()
+ private Instant timestamp;
+
+ @QField()
+ private String text;
+
+
+
+ /*******************************************************************************
+ ** Getter for id
+ **
+ *******************************************************************************/
+ public Integer getId()
+ {
+ return id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for id
+ **
+ *******************************************************************************/
+ public void setId(Integer id)
+ {
+ this.id = id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for id
+ **
+ *******************************************************************************/
+ public ScriptLogLine withId(Integer id)
+ {
+ this.id = id;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for createDate
+ **
+ *******************************************************************************/
+ public Instant getCreateDate()
+ {
+ return createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for createDate
+ **
+ *******************************************************************************/
+ public void setCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for createDate
+ **
+ *******************************************************************************/
+ public ScriptLogLine withCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for modifyDate
+ **
+ *******************************************************************************/
+ public Instant getModifyDate()
+ {
+ return modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for modifyDate
+ **
+ *******************************************************************************/
+ public void setModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for modifyDate
+ **
+ *******************************************************************************/
+ public ScriptLogLine withModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptLogId
+ **
+ *******************************************************************************/
+ public Integer getScriptLogId()
+ {
+ return scriptLogId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptLogId
+ **
+ *******************************************************************************/
+ public void setScriptLogId(Integer scriptLogId)
+ {
+ this.scriptLogId = scriptLogId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptLogId
+ **
+ *******************************************************************************/
+ public ScriptLogLine withScriptLogId(Integer scriptLogId)
+ {
+ this.scriptLogId = scriptLogId;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for timestamp
+ **
+ *******************************************************************************/
+ public Instant getTimestamp()
+ {
+ return timestamp;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for timestamp
+ **
+ *******************************************************************************/
+ public void setTimestamp(Instant timestamp)
+ {
+ this.timestamp = timestamp;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for timestamp
+ **
+ *******************************************************************************/
+ public ScriptLogLine withTimestamp(Instant timestamp)
+ {
+ this.timestamp = timestamp;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for text
+ **
+ *******************************************************************************/
+ public String getText()
+ {
+ return text;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for text
+ **
+ *******************************************************************************/
+ public void setText(String text)
+ {
+ this.text = text;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for text
+ **
+ *******************************************************************************/
+ public ScriptLogLine withText(String text)
+ {
+ this.text = text;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptRevision.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptRevision.java
new file mode 100644
index 00000000..76824409
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptRevision.java
@@ -0,0 +1,356 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.scripts;
+
+
+import java.time.Instant;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.data.QField;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEntity;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ScriptRevision extends QRecordEntity
+{
+ public static final String TABLE_NAME = "scriptRevision";
+
+ @QField()
+ private Integer id;
+
+ @QField()
+ private Instant createDate;
+
+ @QField()
+ private Instant modifyDate;
+
+ @QField()
+ private Integer scriptId;
+
+ @QField()
+ private String contents;
+
+ @QField()
+ private Integer sequenceNo;
+
+ @QField()
+ private String commitMessage;
+
+ @QField()
+ private String author;
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public ScriptRevision()
+ {
+ }
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public ScriptRevision(QRecord qRecord) throws QException
+ {
+ populateFromQRecord(qRecord);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for id
+ **
+ *******************************************************************************/
+ public Integer getId()
+ {
+ return id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for id
+ **
+ *******************************************************************************/
+ public void setId(Integer id)
+ {
+ this.id = id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for id
+ **
+ *******************************************************************************/
+ public ScriptRevision withId(Integer id)
+ {
+ this.id = id;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for createDate
+ **
+ *******************************************************************************/
+ public Instant getCreateDate()
+ {
+ return createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for createDate
+ **
+ *******************************************************************************/
+ public void setCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for createDate
+ **
+ *******************************************************************************/
+ public ScriptRevision withCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for modifyDate
+ **
+ *******************************************************************************/
+ public Instant getModifyDate()
+ {
+ return modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for modifyDate
+ **
+ *******************************************************************************/
+ public void setModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for modifyDate
+ **
+ *******************************************************************************/
+ public ScriptRevision withModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for scriptId
+ **
+ *******************************************************************************/
+ public Integer getScriptId()
+ {
+ return scriptId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for scriptId
+ **
+ *******************************************************************************/
+ public void setScriptId(Integer scriptId)
+ {
+ this.scriptId = scriptId;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for scriptId
+ **
+ *******************************************************************************/
+ public ScriptRevision withScriptId(Integer scriptId)
+ {
+ this.scriptId = scriptId;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for contents
+ **
+ *******************************************************************************/
+ public String getContents()
+ {
+ return contents;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for contents
+ **
+ *******************************************************************************/
+ public void setContents(String contents)
+ {
+ this.contents = contents;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for contents
+ **
+ *******************************************************************************/
+ public ScriptRevision withContents(String contents)
+ {
+ this.contents = contents;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for sequenceNo
+ **
+ *******************************************************************************/
+ public Integer getSequenceNo()
+ {
+ return sequenceNo;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for sequenceNo
+ **
+ *******************************************************************************/
+ public void setSequenceNo(Integer sequenceNo)
+ {
+ this.sequenceNo = sequenceNo;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for sequenceNo
+ **
+ *******************************************************************************/
+ public ScriptRevision withSequenceNo(Integer sequenceNo)
+ {
+ this.sequenceNo = sequenceNo;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for commitMessage
+ **
+ *******************************************************************************/
+ public String getCommitMessage()
+ {
+ return commitMessage;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for commitMessage
+ **
+ *******************************************************************************/
+ public void setCommitMessage(String commitMessage)
+ {
+ this.commitMessage = commitMessage;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for commitMessage
+ **
+ *******************************************************************************/
+ public ScriptRevision withCommitMessage(String commitMessage)
+ {
+ this.commitMessage = commitMessage;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for author
+ **
+ *******************************************************************************/
+ public String getAuthor()
+ {
+ return author;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for author
+ **
+ *******************************************************************************/
+ public void setAuthor(String author)
+ {
+ this.author = author;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for author
+ **
+ *******************************************************************************/
+ public ScriptRevision withAuthor(String author)
+ {
+ this.author = author;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptType.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptType.java
new file mode 100644
index 00000000..6b50d26e
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptType.java
@@ -0,0 +1,259 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.scripts;
+
+
+import java.time.Instant;
+import com.kingsrook.qqq.backend.core.model.data.QField;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEntity;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ScriptType extends QRecordEntity
+{
+ public static final String TABLE_NAME = "scriptType";
+
+ @QField()
+ private Integer id;
+
+ @QField()
+ private Instant createDate;
+
+ @QField()
+ private Instant modifyDate;
+
+ @QField()
+ private String name;
+
+ @QField()
+ private String helpText;
+
+ @QField()
+ private String sampleCode;
+
+
+
+ /*******************************************************************************
+ ** Getter for id
+ **
+ *******************************************************************************/
+ public Integer getId()
+ {
+ return id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for id
+ **
+ *******************************************************************************/
+ public void setId(Integer id)
+ {
+ this.id = id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for id
+ **
+ *******************************************************************************/
+ public ScriptType withId(Integer id)
+ {
+ this.id = id;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for createDate
+ **
+ *******************************************************************************/
+ public Instant getCreateDate()
+ {
+ return createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for createDate
+ **
+ *******************************************************************************/
+ public void setCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for createDate
+ **
+ *******************************************************************************/
+ public ScriptType withCreateDate(Instant createDate)
+ {
+ this.createDate = createDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for modifyDate
+ **
+ *******************************************************************************/
+ public Instant getModifyDate()
+ {
+ return modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for modifyDate
+ **
+ *******************************************************************************/
+ public void setModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for modifyDate
+ **
+ *******************************************************************************/
+ public ScriptType withModifyDate(Instant modifyDate)
+ {
+ this.modifyDate = modifyDate;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for name
+ **
+ *******************************************************************************/
+ public String getName()
+ {
+ return name;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for name
+ **
+ *******************************************************************************/
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for name
+ **
+ *******************************************************************************/
+ public ScriptType withName(String name)
+ {
+ this.name = name;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for helpText
+ **
+ *******************************************************************************/
+ public String getHelpText()
+ {
+ return helpText;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for helpText
+ **
+ *******************************************************************************/
+ public void setHelpText(String helpText)
+ {
+ this.helpText = helpText;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for helpText
+ **
+ *******************************************************************************/
+ public ScriptType withHelpText(String helpText)
+ {
+ this.helpText = helpText;
+ return (this);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for sampleCode
+ **
+ *******************************************************************************/
+ public String getSampleCode()
+ {
+ return sampleCode;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for sampleCode
+ **
+ *******************************************************************************/
+ public void setSampleCode(String sampleCode)
+ {
+ this.sampleCode = sampleCode;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for sampleCode
+ **
+ *******************************************************************************/
+ public ScriptType withSampleCode(String sampleCode)
+ {
+ this.sampleCode = sampleCode;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptsMetaDataProvider.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptsMetaDataProvider.java
new file mode 100644
index 00000000..b81e60b1
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/scripts/ScriptsMetaDataProvider.java
@@ -0,0 +1,150 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.model.scripts;
+
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Consumer;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEntity;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class ScriptsMetaDataProvider
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public void defineStandardScriptsTables(QInstance instance, String backendName, Consumer backendDetailEnricher) throws QException
+ {
+ for(QTableMetaData tableMetaData : defineStandardScriptsTables(backendName, backendDetailEnricher))
+ {
+ instance.addTable(tableMetaData);
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public List defineStandardScriptsTables(String backendName, Consumer backendDetailEnricher) throws QException
+ {
+ List rs = new ArrayList<>();
+ rs.add(enrich(backendDetailEnricher, defineScriptTypeTable(backendName)));
+ rs.add(enrich(backendDetailEnricher, defineScriptTable(backendName)));
+ rs.add(enrich(backendDetailEnricher, defineScriptRevisionTable(backendName)));
+ rs.add(enrich(backendDetailEnricher, defineScriptLogTable(backendName)));
+ rs.add(enrich(backendDetailEnricher, defineScriptLogLineTable(backendName)));
+ return (rs);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData enrich(Consumer backendDetailEnricher, QTableMetaData table)
+ {
+ if(backendDetailEnricher != null)
+ {
+ backendDetailEnricher.accept(table);
+ }
+ return (table);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData defineStandardTable(String backendName, String name, Class fieldsFromEntity) throws QException
+ {
+ return new QTableMetaData()
+ .withName(name)
+ .withBackendName(backendName)
+ .withRecordLabelFormat("%s")
+ .withRecordLabelFields("name")
+ .withPrimaryKeyField("id")
+ .withFieldsFromEntity(fieldsFromEntity);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData defineScriptTable(String backendName) throws QException
+ {
+ return (defineStandardTable(backendName, Script.TABLE_NAME, Script.class));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData defineScriptTypeTable(String backendName) throws QException
+ {
+ return (defineStandardTable(backendName, ScriptType.TABLE_NAME, ScriptType.class));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData defineScriptRevisionTable(String backendName) throws QException
+ {
+ return (defineStandardTable(backendName, ScriptRevision.TABLE_NAME, ScriptRevision.class)
+ .withRecordLabelFields(List.of("id")));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData defineScriptLogTable(String backendName) throws QException
+ {
+ return (defineStandardTable(backendName, ScriptLog.TABLE_NAME, ScriptLog.class)
+ .withRecordLabelFields(List.of("id")));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QTableMetaData defineScriptLogLineTable(String backendName) throws QException
+ {
+ return (defineStandardTable(backendName, ScriptLogLine.TABLE_NAME, ScriptLogLine.class)
+ .withRecordLabelFields(List.of("id")));
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleDispatcher.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleDispatcher.java
index ca95e65e..619dd5d4 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleDispatcher.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleDispatcher.java
@@ -73,6 +73,7 @@ public class QBackendModuleDispatcher
// e.g., backend-core shouldn't need to "know" about the modules.
"com.kingsrook.qqq.backend.core.modules.backend.implementations.mock.MockBackendModule",
"com.kingsrook.qqq.backend.core.modules.backend.implementations.memory.MemoryBackendModule",
+ "com.kingsrook.qqq.backend.core.modules.backend.implementations.enumeration.EnumerationBackendModule",
"com.kingsrook.qqq.backend.module.rdbms.RDBMSBackendModule",
"com.kingsrook.qqq.backend.module.filesystem.local.FilesystemBackendModule",
"com.kingsrook.qqq.backend.module.filesystem.s3.S3BackendModule",
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleInterface.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleInterface.java
index 3c3c0eb6..70d51742 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleInterface.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/QBackendModuleInterface.java
@@ -49,7 +49,10 @@ public interface QBackendModuleInterface
/*******************************************************************************
** Method to identify the class used for backend meta data for this module.
*******************************************************************************/
- Class getBackendMetaDataClass();
+ default Class getBackendMetaDataClass()
+ {
+ return (QBackendMetaData.class);
+ }
/*******************************************************************************
** Method to identify the class used for table-backend details for this module.
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationBackendModule.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationBackendModule.java
new file mode 100644
index 00000000..324c5aaa
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationBackendModule.java
@@ -0,0 +1,67 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.modules.backend.implementations.enumeration;
+
+
+import com.kingsrook.qqq.backend.core.actions.interfaces.QueryInterface;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableBackendDetails;
+import com.kingsrook.qqq.backend.core.modules.backend.QBackendModuleInterface;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class EnumerationBackendModule implements QBackendModuleInterface
+{
+
+ /*******************************************************************************
+ ** Method where a backend module must be able to provide its type (name).
+ *******************************************************************************/
+ @Override
+ public String getBackendType()
+ {
+ return ("enum");
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public Class getTableBackendDetailsClass()
+ {
+ return (EnumerationTableBackendDetails.class);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public QueryInterface getQueryInterface()
+ {
+ return new EnumerationQueryAction();
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationQueryAction.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationQueryAction.java
new file mode 100644
index 00000000..039e0123
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationQueryAction.java
@@ -0,0 +1,84 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.modules.backend.implementations.enumeration;
+
+
+import java.util.ArrayList;
+import java.util.List;
+import com.kingsrook.qqq.backend.core.actions.interfaces.QueryInterface;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEnum;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.modules.backend.implementations.utils.BackendQueryFilterUtils;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class EnumerationQueryAction implements QueryInterface
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public QueryOutput execute(QueryInput queryInput) throws QException
+ {
+ try
+ {
+ QTableMetaData table = queryInput.getTable();
+ EnumerationTableBackendDetails backendDetails = (EnumerationTableBackendDetails) table.getBackendDetails();
+ Class enumClass = backendDetails.getEnumClass();
+ QRecordEnum[] values = (QRecordEnum[]) enumClass.getMethod("values").invoke(null);
+
+ //////////////////////////////////////////////
+ // note - not good streaming behavior here. //
+ //////////////////////////////////////////////
+
+ List recordList = new ArrayList<>();
+ for(QRecordEnum value : values)
+ {
+ QRecord record = value.toQRecord();
+ boolean recordMatches = BackendQueryFilterUtils.doesRecordMatch(queryInput.getFilter(), record);
+ if(recordMatches)
+ {
+ recordList.add(record);
+ }
+ }
+
+ BackendQueryFilterUtils.sortRecordList(queryInput.getFilter(), recordList);
+ recordList = BackendQueryFilterUtils.applySkipAndLimit(queryInput, recordList);
+
+ QueryOutput queryOutput = new QueryOutput(queryInput);
+ queryOutput.addRecords(recordList);
+ return queryOutput;
+ }
+ catch(Exception e)
+ {
+ throw (new QException("Error executing query", e));
+ }
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationTableBackendDetails.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationTableBackendDetails.java
new file mode 100644
index 00000000..ee92f8ce
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationTableBackendDetails.java
@@ -0,0 +1,82 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.modules.backend.implementations.enumeration;
+
+
+import com.kingsrook.qqq.backend.core.model.data.QRecordEnum;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableBackendDetails;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class EnumerationTableBackendDetails extends QTableBackendDetails
+{
+ private Class enumClass;
+
+
+
+ /*******************************************************************************
+ ** Constructor
+ **
+ *******************************************************************************/
+ public EnumerationTableBackendDetails()
+ {
+ super();
+ setBackendType(EnumerationBackendModule.class);
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for enumClass
+ **
+ *******************************************************************************/
+ public Class getEnumClass()
+ {
+ return enumClass;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for enumClass
+ **
+ *******************************************************************************/
+ public void setEnumClass(Class enumClass)
+ {
+ this.enumClass = enumClass;
+ }
+
+
+
+ /*******************************************************************************
+ ** Fluent setter for enumClass
+ **
+ *******************************************************************************/
+ public EnumerationTableBackendDetails withEnumClass(Class enumClass)
+ {
+ this.enumClass = enumClass;
+ return (this);
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModule.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModule.java
index 30346a7f..cb423dc5 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModule.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModule.java
@@ -27,7 +27,6 @@ import com.kingsrook.qqq.backend.core.actions.interfaces.DeleteInterface;
import com.kingsrook.qqq.backend.core.actions.interfaces.InsertInterface;
import com.kingsrook.qqq.backend.core.actions.interfaces.QueryInterface;
import com.kingsrook.qqq.backend.core.actions.interfaces.UpdateInterface;
-import com.kingsrook.qqq.backend.core.model.metadata.QBackendMetaData;
import com.kingsrook.qqq.backend.core.modules.backend.QBackendModuleInterface;
@@ -53,17 +52,6 @@ public class MemoryBackendModule implements QBackendModuleInterface
- /*******************************************************************************
- ** Method to identify the class used for backend meta data for this module.
- *******************************************************************************/
- @Override
- public Class getBackendMetaDataClass()
- {
- return (QBackendMetaData.class);
- }
-
-
-
/*******************************************************************************
**
*******************************************************************************/
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryRecordStore.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryRecordStore.java
index 54370e6f..153699a2 100644
--- a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryRecordStore.java
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryRecordStore.java
@@ -23,27 +23,21 @@ package com.kingsrook.qqq.backend.core.modules.backend.implementations.memory;
import java.io.Serializable;
-import java.time.LocalDate;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
-import java.util.concurrent.atomic.AtomicBoolean;
import com.kingsrook.qqq.backend.core.model.actions.tables.count.CountInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.delete.DeleteInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertInput;
-import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
-import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.update.UpdateInput;
import com.kingsrook.qqq.backend.core.model.data.QRecord;
import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldMetaData;
import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldType;
import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
-import com.kingsrook.qqq.backend.core.utils.CollectionUtils;
-import com.kingsrook.qqq.backend.core.utils.ValueUtils;
-import org.apache.commons.lang.NotImplementedException;
+import com.kingsrook.qqq.backend.core.modules.backend.implementations.utils.BackendQueryFilterUtils;
/*******************************************************************************
@@ -126,7 +120,7 @@ public class MemoryRecordStore
for(QRecord qRecord : tableData.values())
{
- boolean recordMatches = doesRecordMatch(input.getFilter(), qRecord);
+ boolean recordMatches = BackendQueryFilterUtils.doesRecordMatch(input.getFilter(), qRecord);
if(recordMatches)
{
@@ -139,349 +133,6 @@ public class MemoryRecordStore
- /*******************************************************************************
- **
- *******************************************************************************/
- @SuppressWarnings("checkstyle:indentation")
- private boolean doesRecordMatch(QQueryFilter filter, QRecord qRecord)
- {
- if(filter == null || !filter.hasAnyCriteria())
- {
- return (true);
- }
-
- /////////////////////////////////////////////////////////////////////////////////////
- // for an AND query, default to a TRUE answer, and we'll &= each criteria's value. //
- // for an OR query, default to FALSE, and |= each criteria's value. //
- /////////////////////////////////////////////////////////////////////////////////////
- AtomicBoolean recordMatches = new AtomicBoolean(filter.getBooleanOperator().equals(QQueryFilter.BooleanOperator.AND) ? true : false);
-
- ///////////////////////////////////////
- // if there are criteria, apply them //
- ///////////////////////////////////////
- for(QFilterCriteria criterion : CollectionUtils.nonNullList(filter.getCriteria()))
- {
- String fieldName = criterion.getFieldName();
- Serializable value = qRecord.getValue(fieldName);
-
- boolean criterionMatches = switch(criterion.getOperator())
- {
- case EQUALS -> testEquals(criterion, value);
- case NOT_EQUALS -> !testEquals(criterion, value);
- case IN -> testIn(criterion, value);
- case NOT_IN -> !testIn(criterion, value);
- case IS_BLANK -> testBlank(criterion, value);
- case IS_NOT_BLANK -> !testBlank(criterion, value);
- case CONTAINS -> testContains(criterion, fieldName, value);
- case NOT_CONTAINS -> !testContains(criterion, fieldName, value);
- case STARTS_WITH -> testStartsWith(criterion, fieldName, value);
- case NOT_STARTS_WITH -> !testStartsWith(criterion, fieldName, value);
- case ENDS_WITH -> testEndsWith(criterion, fieldName, value);
- case NOT_ENDS_WITH -> !testEndsWith(criterion, fieldName, value);
- case GREATER_THAN -> testGreaterThan(criterion, value);
- case GREATER_THAN_OR_EQUALS -> testGreaterThan(criterion, value) || testEquals(criterion, value);
- case LESS_THAN -> !testGreaterThan(criterion, value) && !testEquals(criterion, value);
- case LESS_THAN_OR_EQUALS -> !testGreaterThan(criterion, value);
- case BETWEEN ->
- {
- QFilterCriteria criteria0 = new QFilterCriteria().withValues(criterion.getValues());
- QFilterCriteria criteria1 = new QFilterCriteria().withValues(new ArrayList<>(criterion.getValues()));
- criteria1.getValues().remove(0);
- yield (testGreaterThan(criteria0, value) || testEquals(criteria0, value)) && (!testGreaterThan(criteria1, value) || testEquals(criteria1, value));
- }
- case NOT_BETWEEN ->
- {
- QFilterCriteria criteria0 = new QFilterCriteria().withValues(criterion.getValues());
- QFilterCriteria criteria1 = new QFilterCriteria().withValues(criterion.getValues());
- criteria1.getValues().remove(0);
- yield !(testGreaterThan(criteria0, value) || testEquals(criteria0, value)) && (!testGreaterThan(criteria1, value) || testEquals(criteria1, value));
- }
- };
-
- ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
- // add this new value to the existing recordMatches value - and if we can short circuit the remaining checks, do so. //
- ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
- Boolean shortCircuitValue = applyBooleanOperator(recordMatches, criterionMatches, filter.getBooleanOperator());
- if(shortCircuitValue != null)
- {
- return (shortCircuitValue);
- }
- }
-
- ////////////////////////////////////////
- // apply sub-filters if there are any //
- ////////////////////////////////////////
- for(QQueryFilter subFilter : CollectionUtils.nonNullList(filter.getSubFilters()))
- {
- boolean subFilterMatches = doesRecordMatch(subFilter, qRecord);
-
- ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
- // add this new value to the existing recordMatches value - and if we can short circuit the remaining checks, do so. //
- ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
- Boolean shortCircuitValue = applyBooleanOperator(recordMatches, subFilterMatches, filter.getBooleanOperator());
- if(shortCircuitValue != null)
- {
- return (shortCircuitValue);
- }
- }
-
- return (recordMatches.getPlain());
- }
-
-
-
- /*******************************************************************************
- ** Based on an incoming boolean value (accumulator), a new value, and a boolean
- ** operator, update the accumulator, and if we can then short-circuit remaining
- ** operations, return a true or false. Returning null means to keep going.
- *******************************************************************************/
- private Boolean applyBooleanOperator(AtomicBoolean accumulator, boolean newValue, QQueryFilter.BooleanOperator booleanOperator)
- {
- boolean accumulatorValue = accumulator.getPlain();
- if(booleanOperator.equals(QQueryFilter.BooleanOperator.AND))
- {
- accumulatorValue &= newValue;
- if(!accumulatorValue)
- {
- return (false);
- }
- }
- else
- {
- accumulatorValue |= newValue;
- if(accumulatorValue)
- {
- return (true);
- }
- }
-
- accumulator.set(accumulatorValue);
- return (null);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testBlank(QFilterCriteria criterion, Serializable value)
- {
- if(value == null)
- {
- return (true);
- }
-
- if("".equals(ValueUtils.getValueAsString(value)))
- {
- return (true);
- }
-
- return (false);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testGreaterThan(QFilterCriteria criterion, Serializable value)
- {
- Serializable criterionValue = criterion.getValues().get(0);
- if(criterionValue == null)
- {
- throw (new IllegalArgumentException("Missing criterion value in query"));
- }
-
- if(value == null)
- {
- /////////////////////////////////////////////////////////////////////////////////////
- // a database would say 'false' for if a null column is > a value, so do the same. //
- /////////////////////////////////////////////////////////////////////////////////////
- return (false);
- }
-
- if(value instanceof LocalDate valueDate && criterionValue instanceof LocalDate criterionValueDate)
- {
- return (valueDate.isAfter(criterionValueDate));
- }
-
- if(value instanceof Number valueNumber && criterionValue instanceof Number criterionValueNumber)
- {
- return (valueNumber.doubleValue() > criterionValueNumber.doubleValue());
- }
-
- if(value instanceof LocalDate || criterionValue instanceof LocalDate)
- {
- LocalDate valueDate;
- if(value instanceof LocalDate ld)
- {
- valueDate = ld;
- }
- else
- {
- valueDate = ValueUtils.getValueAsLocalDate(value);
- }
-
- LocalDate criterionDate;
- if(criterionValue instanceof LocalDate ld)
- {
- criterionDate = ld;
- }
- else
- {
- criterionDate = ValueUtils.getValueAsLocalDate(criterionValue);
- }
-
- return (valueDate.isAfter(criterionDate));
- }
-
- throw (new NotImplementedException("Greater/Less Than comparisons are not (yet?) implemented for the supplied types [" + value.getClass().getSimpleName() + "][" + criterionValue.getClass().getSimpleName() + "]"));
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testIn(QFilterCriteria criterion, Serializable value)
- {
- if(!criterion.getValues().contains(value))
- {
- return (false);
- }
- return (true);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testEquals(QFilterCriteria criterion, Serializable value)
- {
- if(value == null)
- {
- return (false);
- }
-
- Serializable criteriaValue = criterion.getValues().get(0);
- if(value instanceof String && criteriaValue instanceof Number)
- {
- criteriaValue = String.valueOf(criteriaValue);
- }
- else if(criteriaValue instanceof String && value instanceof Number)
- {
- value = String.valueOf(value);
- }
-
- if(!value.equals(criteriaValue))
- {
- return (false);
- }
- return (true);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testContains(QFilterCriteria criterion, String fieldName, Serializable value)
- {
- String stringValue = getStringFieldValue(value, fieldName, criterion);
- String criterionValue = getFirstStringCriterionValue(criterion);
-
- if(!stringValue.contains(criterionValue))
- {
- return (false);
- }
-
- return (true);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testStartsWith(QFilterCriteria criterion, String fieldName, Serializable value)
- {
- String stringValue = getStringFieldValue(value, fieldName, criterion);
- String criterionValue = getFirstStringCriterionValue(criterion);
-
- if(!stringValue.startsWith(criterionValue))
- {
- return (false);
- }
-
- return (true);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private boolean testEndsWith(QFilterCriteria criterion, String fieldName, Serializable value)
- {
- String stringValue = getStringFieldValue(value, fieldName, criterion);
- String criterionValue = getFirstStringCriterionValue(criterion);
-
- if(!stringValue.endsWith(criterionValue))
- {
- return (false);
- }
-
- return (true);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private String getFirstStringCriterionValue(QFilterCriteria criteria)
- {
- if(CollectionUtils.nullSafeIsEmpty(criteria.getValues()))
- {
- throw new IllegalArgumentException("Missing value for [" + criteria.getOperator() + "] criteria on field [" + criteria.getFieldName() + "]");
- }
- Serializable value = criteria.getValues().get(0);
- if(value == null)
- {
- return "";
- }
-
- if(!(value instanceof String stringValue))
- {
- throw new ClassCastException("Value [" + value + "] for criteria [" + criteria.getFieldName() + "] is not a String, which is required for the [" + criteria.getOperator() + "] operator.");
- }
-
- return (stringValue);
- }
-
-
-
- /*******************************************************************************
- **
- *******************************************************************************/
- private String getStringFieldValue(Serializable value, String fieldName, QFilterCriteria criterion)
- {
- if(value == null)
- {
- return "";
- }
-
- if(!(value instanceof String stringValue))
- {
- throw new ClassCastException("Value [" + value + "] in field [" + fieldName + "] is not a String, which is required for the [" + criterion.getOperator() + "] operator.");
- }
-
- return (stringValue);
- }
-
-
-
/*******************************************************************************
**
*******************************************************************************/
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/utils/BackendQueryFilterUtils.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/utils/BackendQueryFilterUtils.java
new file mode 100644
index 00000000..75d78bb9
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/utils/BackendQueryFilterUtils.java
@@ -0,0 +1,471 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.modules.backend.implementations.utils;
+
+
+import java.io.Serializable;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+import java.util.concurrent.atomic.AtomicBoolean;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterOrderBy;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.utils.CollectionUtils;
+import com.kingsrook.qqq.backend.core.utils.ValueUtils;
+import org.apache.commons.lang.NotImplementedException;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class BackendQueryFilterUtils
+{
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @SuppressWarnings("checkstyle:indentation")
+ public static boolean doesRecordMatch(QQueryFilter filter, QRecord qRecord)
+ {
+ if(filter == null || !filter.hasAnyCriteria())
+ {
+ return (true);
+ }
+
+ /////////////////////////////////////////////////////////////////////////////////////
+ // for an AND query, default to a TRUE answer, and we'll &= each criteria's value. //
+ // for an OR query, default to FALSE, and |= each criteria's value. //
+ /////////////////////////////////////////////////////////////////////////////////////
+ AtomicBoolean recordMatches = new AtomicBoolean(filter.getBooleanOperator().equals(QQueryFilter.BooleanOperator.AND) ? true : false);
+
+ ///////////////////////////////////////
+ // if there are criteria, apply them //
+ ///////////////////////////////////////
+ for(QFilterCriteria criterion : CollectionUtils.nonNullList(filter.getCriteria()))
+ {
+ String fieldName = criterion.getFieldName();
+ Serializable value = qRecord.getValue(fieldName);
+
+ boolean criterionMatches = switch(criterion.getOperator())
+ {
+ case EQUALS -> testEquals(criterion, value);
+ case NOT_EQUALS -> !testEquals(criterion, value);
+ case IN -> testIn(criterion, value);
+ case NOT_IN -> !testIn(criterion, value);
+ case IS_BLANK -> testBlank(criterion, value);
+ case IS_NOT_BLANK -> !testBlank(criterion, value);
+ case CONTAINS -> testContains(criterion, fieldName, value);
+ case NOT_CONTAINS -> !testContains(criterion, fieldName, value);
+ case STARTS_WITH -> testStartsWith(criterion, fieldName, value);
+ case NOT_STARTS_WITH -> !testStartsWith(criterion, fieldName, value);
+ case ENDS_WITH -> testEndsWith(criterion, fieldName, value);
+ case NOT_ENDS_WITH -> !testEndsWith(criterion, fieldName, value);
+ case GREATER_THAN -> testGreaterThan(criterion, value);
+ case GREATER_THAN_OR_EQUALS -> testGreaterThan(criterion, value) || testEquals(criterion, value);
+ case LESS_THAN -> !testGreaterThan(criterion, value) && !testEquals(criterion, value);
+ case LESS_THAN_OR_EQUALS -> !testGreaterThan(criterion, value);
+ case BETWEEN ->
+ {
+ QFilterCriteria criteria0 = new QFilterCriteria().withValues(criterion.getValues());
+ QFilterCriteria criteria1 = new QFilterCriteria().withValues(new ArrayList<>(criterion.getValues()));
+ criteria1.getValues().remove(0);
+ yield (testGreaterThan(criteria0, value) || testEquals(criteria0, value)) && (!testGreaterThan(criteria1, value) || testEquals(criteria1, value));
+ }
+ case NOT_BETWEEN ->
+ {
+ QFilterCriteria criteria0 = new QFilterCriteria().withValues(criterion.getValues());
+ QFilterCriteria criteria1 = new QFilterCriteria().withValues(criterion.getValues());
+ criteria1.getValues().remove(0);
+ yield !(testGreaterThan(criteria0, value) || testEquals(criteria0, value)) && (!testGreaterThan(criteria1, value) || testEquals(criteria1, value));
+ }
+ };
+
+ ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+ // add this new value to the existing recordMatches value - and if we can short circuit the remaining checks, do so. //
+ ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+ Boolean shortCircuitValue = applyBooleanOperator(recordMatches, criterionMatches, filter.getBooleanOperator());
+ if(shortCircuitValue != null)
+ {
+ return (shortCircuitValue);
+ }
+ }
+
+ ////////////////////////////////////////
+ // apply sub-filters if there are any //
+ ////////////////////////////////////////
+ for(QQueryFilter subFilter : CollectionUtils.nonNullList(filter.getSubFilters()))
+ {
+ boolean subFilterMatches = doesRecordMatch(subFilter, qRecord);
+
+ ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+ // add this new value to the existing recordMatches value - and if we can short circuit the remaining checks, do so. //
+ ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+ Boolean shortCircuitValue = applyBooleanOperator(recordMatches, subFilterMatches, filter.getBooleanOperator());
+ if(shortCircuitValue != null)
+ {
+ return (shortCircuitValue);
+ }
+ }
+
+ return (recordMatches.getPlain());
+ }
+
+
+
+ /*******************************************************************************
+ ** Based on an incoming boolean value (accumulator), a new value, and a boolean
+ ** operator, update the accumulator, and if we can then short-circuit remaining
+ ** operations, return a true or false. Returning null means to keep going.
+ *******************************************************************************/
+ private static Boolean applyBooleanOperator(AtomicBoolean accumulator, boolean newValue, QQueryFilter.BooleanOperator booleanOperator)
+ {
+ boolean accumulatorValue = accumulator.getPlain();
+ if(booleanOperator.equals(QQueryFilter.BooleanOperator.AND))
+ {
+ accumulatorValue &= newValue;
+ if(!accumulatorValue)
+ {
+ return (false);
+ }
+ }
+ else
+ {
+ accumulatorValue |= newValue;
+ if(accumulatorValue)
+ {
+ return (true);
+ }
+ }
+
+ accumulator.set(accumulatorValue);
+ return (null);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testBlank(QFilterCriteria criterion, Serializable value)
+ {
+ if(value == null)
+ {
+ return (true);
+ }
+
+ if("".equals(ValueUtils.getValueAsString(value)))
+ {
+ return (true);
+ }
+
+ return (false);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testGreaterThan(QFilterCriteria criterion, Serializable value)
+ {
+ Serializable criterionValue = criterion.getValues().get(0);
+ if(criterionValue == null)
+ {
+ throw (new IllegalArgumentException("Missing criterion value in query"));
+ }
+
+ if(value == null)
+ {
+ /////////////////////////////////////////////////////////////////////////////////////
+ // a database would say 'false' for if a null column is > a value, so do the same. //
+ /////////////////////////////////////////////////////////////////////////////////////
+ return (false);
+ }
+
+ return isGreaterThan(criterionValue, value);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean isGreaterThan(Serializable a, Serializable b)
+ {
+ if(Objects.equals(a, b))
+ {
+ return false;
+ }
+
+ if(b instanceof LocalDate valueDate && a instanceof LocalDate criterionValueDate)
+ {
+ return (valueDate.isAfter(criterionValueDate));
+ }
+
+ if(b instanceof Number valueNumber && a instanceof Number criterionValueNumber)
+ {
+ return (valueNumber.doubleValue() > criterionValueNumber.doubleValue());
+ }
+
+ if(b instanceof String valueString && a instanceof String criterionValueString)
+ {
+ return (valueString.compareTo(criterionValueString) > 0);
+ }
+
+ if(b instanceof LocalDate || a instanceof LocalDate)
+ {
+ LocalDate valueDate;
+ if(b instanceof LocalDate ld)
+ {
+ valueDate = ld;
+ }
+ else
+ {
+ valueDate = ValueUtils.getValueAsLocalDate(b);
+ }
+
+ LocalDate criterionDate;
+ if(a instanceof LocalDate ld)
+ {
+ criterionDate = ld;
+ }
+ else
+ {
+ criterionDate = ValueUtils.getValueAsLocalDate(a);
+ }
+
+ return (valueDate.isAfter(criterionDate));
+ }
+
+ throw (new NotImplementedException("Greater/Less Than comparisons are not (yet?) implemented for the supplied types [" + b.getClass().getSimpleName() + "][" + a.getClass().getSimpleName() + "]"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testIn(QFilterCriteria criterion, Serializable value)
+ {
+ if(!criterion.getValues().contains(value))
+ {
+ return (false);
+ }
+ return (true);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testEquals(QFilterCriteria criterion, Serializable value)
+ {
+ if(value == null)
+ {
+ return (false);
+ }
+
+ Serializable criteriaValue = criterion.getValues().get(0);
+ if(value instanceof String && criteriaValue instanceof Number)
+ {
+ criteriaValue = String.valueOf(criteriaValue);
+ }
+ else if(criteriaValue instanceof String && value instanceof Number)
+ {
+ value = String.valueOf(value);
+ }
+
+ if(!value.equals(criteriaValue))
+ {
+ return (false);
+ }
+ return (true);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testContains(QFilterCriteria criterion, String fieldName, Serializable value)
+ {
+ String stringValue = getStringFieldValue(value, fieldName, criterion);
+ String criterionValue = getFirstStringCriterionValue(criterion);
+
+ if(!stringValue.contains(criterionValue))
+ {
+ return (false);
+ }
+
+ return (true);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testStartsWith(QFilterCriteria criterion, String fieldName, Serializable value)
+ {
+ String stringValue = getStringFieldValue(value, fieldName, criterion);
+ String criterionValue = getFirstStringCriterionValue(criterion);
+
+ if(!stringValue.startsWith(criterionValue))
+ {
+ return (false);
+ }
+
+ return (true);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static boolean testEndsWith(QFilterCriteria criterion, String fieldName, Serializable value)
+ {
+ String stringValue = getStringFieldValue(value, fieldName, criterion);
+ String criterionValue = getFirstStringCriterionValue(criterion);
+
+ if(!stringValue.endsWith(criterionValue))
+ {
+ return (false);
+ }
+
+ return (true);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static String getFirstStringCriterionValue(QFilterCriteria criteria)
+ {
+ if(CollectionUtils.nullSafeIsEmpty(criteria.getValues()))
+ {
+ throw new IllegalArgumentException("Missing value for [" + criteria.getOperator() + "] criteria on field [" + criteria.getFieldName() + "]");
+ }
+ Serializable value = criteria.getValues().get(0);
+ if(value == null)
+ {
+ return "";
+ }
+
+ if(!(value instanceof String stringValue))
+ {
+ throw new ClassCastException("Value [" + value + "] for criteria [" + criteria.getFieldName() + "] is not a String, which is required for the [" + criteria.getOperator() + "] operator.");
+ }
+
+ return (stringValue);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static String getStringFieldValue(Serializable value, String fieldName, QFilterCriteria criterion)
+ {
+ if(value == null)
+ {
+ return "";
+ }
+
+ if(!(value instanceof String stringValue))
+ {
+ throw new ClassCastException("Value [" + value + "] in field [" + fieldName + "] is not a String, which is required for the [" + criterion.getOperator() + "] operator.");
+ }
+
+ return (stringValue);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static void sortRecordList(QQueryFilter filter, List recordList)
+ {
+ if(filter == null || CollectionUtils.nullSafeIsEmpty(filter.getOrderBys()))
+ {
+ return;
+ }
+
+ recordList.sort((a, b) ->
+ {
+ for(QFilterOrderBy orderBy : filter.getOrderBys())
+ {
+ Serializable valueA = a.getValue(orderBy.getFieldName());
+ Serializable valueB = b.getValue(orderBy.getFieldName());
+ if(Objects.equals(valueA, valueB))
+ {
+ continue;
+ }
+ else if(isGreaterThan(valueA, valueB) && orderBy.getIsAscending())
+ {
+ return (-1);
+ }
+ else
+ {
+ return (1);
+ }
+ }
+
+ return (0);
+ });
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static List applySkipAndLimit(QueryInput queryInput, List recordList)
+ {
+ Integer skip = queryInput.getSkip();
+ if(skip != null && skip > 0)
+ {
+ if(skip < recordList.size())
+ {
+ recordList = recordList.subList(skip, recordList.size());
+ }
+ else
+ {
+ recordList.clear();
+ }
+ }
+
+ Integer limit = queryInput.getLimit();
+ if(limit != null && limit >= 0 && limit < recordList.size())
+ {
+ recordList = recordList.subList(0, limit);
+ }
+ return recordList;
+ }
+
+}
diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/utils/GeneralProcessUtils.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/utils/GeneralProcessUtils.java
new file mode 100644
index 00000000..8782acf4
--- /dev/null
+++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/utils/GeneralProcessUtils.java
@@ -0,0 +1,226 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.processes.utils;
+
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import com.kingsrook.qqq.backend.core.actions.tables.QueryAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.AbstractActionInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QCriteriaOperator;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.utils.ListingHash;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class GeneralProcessUtils
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static Map getForeignRecordMap(AbstractActionInput parentActionInput, List sourceRecords, String sourceTableForeignKeyFieldName, String foreignTableName, String foreignTablePrimaryKeyName) throws QException
+ {
+ Map foreignRecordMap = new HashMap<>();
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(foreignTableName);
+ List foreignIds = new ArrayList<>(sourceRecords.stream().map(r -> r.getValue(sourceTableForeignKeyFieldName)).toList());
+
+ queryInput.setFilter(new QQueryFilter().withCriteria(new QFilterCriteria(foreignTablePrimaryKeyName, QCriteriaOperator.IN, foreignIds)));
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ for(QRecord foreignRecord : queryOutput.getRecords())
+ {
+ foreignRecordMap.put(foreignRecord.getValue(foreignTablePrimaryKeyName), foreignRecord);
+ }
+ return foreignRecordMap;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static ListingHash getForeignRecordListingHashMap(AbstractActionInput parentActionInput, List sourceRecords, String sourceTableForeignKeyFieldName, String foreignTableName, String foreignTablePrimaryKeyName) throws QException
+ {
+ ListingHash foreignRecordMap = new ListingHash<>();
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(foreignTableName);
+ List foreignIds = new ArrayList<>(sourceRecords.stream().map(r -> r.getValue(sourceTableForeignKeyFieldName)).toList());
+
+ queryInput.setFilter(new QQueryFilter().withCriteria(new QFilterCriteria(foreignTablePrimaryKeyName, QCriteriaOperator.IN, foreignIds)));
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ for(QRecord foreignRecord : queryOutput.getRecords())
+ {
+ foreignRecordMap.add(foreignRecord.getValue(foreignTablePrimaryKeyName), foreignRecord);
+ }
+ return foreignRecordMap;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static void addForeignRecordsToRecordList(AbstractActionInput parentActionInput, List sourceRecords, String sourceTableForeignKeyFieldName, String foreignTableName, String foreignTablePrimaryKeyName) throws QException
+ {
+ Map foreignRecordMap = getForeignRecordMap(parentActionInput, sourceRecords, sourceTableForeignKeyFieldName, foreignTableName, foreignTablePrimaryKeyName);
+ for(QRecord sourceRecord : sourceRecords)
+ {
+ QRecord foreignRecord = foreignRecordMap.get(sourceRecord.getValue(sourceTableForeignKeyFieldName));
+ sourceRecord.setValue(foreignTableName, foreignRecord);
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static void addForeignRecordsListToRecordList(AbstractActionInput parentActionInput, List sourceRecords, String sourceTableForeignKeyFieldName, String foreignTableName, String foreignTablePrimaryKeyName) throws QException
+ {
+ ListingHash foreignRecordMap = getForeignRecordListingHashMap(parentActionInput, sourceRecords, sourceTableForeignKeyFieldName, foreignTableName, foreignTablePrimaryKeyName);
+ for(QRecord sourceRecord : sourceRecords)
+ {
+ List foreignRecordList = foreignRecordMap.get(sourceRecord.getValue(sourceTableForeignKeyFieldName));
+ if(foreignRecordList != null)
+ {
+ if(foreignRecordList instanceof Serializable s)
+ {
+ sourceRecord.setValue(foreignTableName, s);
+ }
+ else
+ {
+ sourceRecord.setValue(foreignTableName, new ArrayList<>(foreignRecordList));
+ }
+ }
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static List getRecordListByField(AbstractActionInput parentActionInput, String tableName, String fieldName, Serializable fieldValue) throws QException
+ {
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(tableName);
+ queryInput.setFilter(new QQueryFilter().withCriteria(new QFilterCriteria(fieldName, QCriteriaOperator.EQUALS, List.of(fieldValue))));
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ return (queryOutput.getRecords());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static Optional getRecordById(AbstractActionInput parentActionInput, String tableName, String fieldName, Serializable fieldValue) throws QException
+ {
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(tableName);
+ queryInput.setFilter(new QQueryFilter().withCriteria(new QFilterCriteria(fieldName, QCriteriaOperator.EQUALS, List.of(fieldValue))));
+ queryInput.setLimit(1);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ return (queryOutput.getRecords().stream().findFirst());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static List loadTable(AbstractActionInput parentActionInput, String tableName) throws QException
+ {
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(tableName);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ return (queryOutput.getRecords());
+ }
+
+
+
+ /*******************************************************************************
+ ** Note - null values from the key field are NOT put in the map.
+ *******************************************************************************/
+ public static Map loadTableToMap(AbstractActionInput parentActionInput, String tableName, String keyFieldName) throws QException
+ {
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(tableName);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ List records = queryOutput.getRecords();
+
+ Map map = new HashMap<>();
+ for(QRecord record : records)
+ {
+ Serializable value = record.getValue(keyFieldName);
+ if(value != null)
+ {
+ map.put(value, record);
+ }
+ }
+ return (map);
+ }
+
+
+
+ /*******************************************************************************
+ ** Note - null values from the key field are NOT put in the map.
+ *******************************************************************************/
+ public static ListingHash loadTableToListingHash(AbstractActionInput parentActionInput, String tableName, String keyFieldName) throws QException
+ {
+ QueryInput queryInput = new QueryInput(parentActionInput.getInstance());
+ queryInput.setSession(parentActionInput.getSession());
+ queryInput.setTableName(tableName);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ List records = queryOutput.getRecords();
+
+ ListingHash map = new ListingHash<>();
+ for(QRecord record : records)
+ {
+ Serializable value = record.getValue(keyFieldName);
+ if(value != null)
+ {
+ map.add(value, record);
+ }
+ }
+ return (map);
+ }
+
+}
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/ExecuteCodeActionTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/ExecuteCodeActionTest.java
new file mode 100644
index 00000000..963d29b4
--- /dev/null
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/ExecuteCodeActionTest.java
@@ -0,0 +1,177 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.HeaderAndDetailTableCodeExecutionLogger;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.Log4jCodeExecutionLogger;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.NoopCodeExecutionLogger;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.QCodeExecutionLoggerInterface;
+import com.kingsrook.qqq.backend.core.exceptions.QCodeException;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeUsage;
+import com.kingsrook.qqq.backend.core.model.scripts.ScriptsMetaDataProvider;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
+import com.kingsrook.qqq.backend.core.modules.backend.implementations.memory.MemoryRecordStore;
+import com.kingsrook.qqq.backend.core.utils.TestUtils;
+import com.kingsrook.qqq.backend.core.utils.ValueUtils;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+
+/*******************************************************************************
+ ** Unit test for ExecuteCodeAction
+ *******************************************************************************/
+class ExecuteCodeActionTest
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @BeforeEach
+ @AfterEach
+ void beforeAndAfterEach()
+ {
+ MemoryRecordStore.getInstance().reset();
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void test() throws QException
+ {
+ QInstance qInstance = TestUtils.defineInstance();
+ ExecuteCodeInput executeCodeInput = setupInput(qInstance, Map.of("x", 4), new NoopCodeExecutionLogger());
+ ExecuteCodeOutput executeCodeOutput = new ExecuteCodeOutput();
+ new ExecuteCodeAction().run(executeCodeInput, executeCodeOutput);
+ assertEquals(16, executeCodeOutput.getOutput());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private ExecuteCodeInput setupInput(QInstance qInstance, Map context, QCodeExecutionLoggerInterface executionLogger)
+ {
+ ExecuteCodeInput executeCodeInput = new ExecuteCodeInput(qInstance);
+ executeCodeInput.setSession(new QSession());
+ executeCodeInput.setCodeReference(new QCodeReference(ScriptInJava.class, QCodeUsage.CUSTOMIZER));
+ executeCodeInput.setContext(context);
+ executeCodeInput.setExecutionLogger(executionLogger);
+ return executeCodeInput;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testLog4jLogger() throws QException
+ {
+ QInstance qInstance = TestUtils.defineInstance();
+ ExecuteCodeInput executeCodeInput = setupInput(qInstance, Map.of("x", 4), new Log4jCodeExecutionLogger());
+ ExecuteCodeOutput executeCodeOutput = new ExecuteCodeOutput();
+ new ExecuteCodeAction().run(executeCodeInput, executeCodeOutput);
+ assertEquals(16, executeCodeOutput.getOutput());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testTableLogger() throws QException
+ {
+ QInstance qInstance = TestUtils.defineInstance();
+ new ScriptsMetaDataProvider().defineStandardScriptsTables(qInstance, TestUtils.MEMORY_BACKEND_NAME, null);
+
+ ExecuteCodeInput executeCodeInput = setupInput(qInstance, Map.of("x", 4), new HeaderAndDetailTableCodeExecutionLogger(1701, 1702));
+ ExecuteCodeOutput executeCodeOutput = new ExecuteCodeOutput();
+ new ExecuteCodeAction().run(executeCodeInput, executeCodeOutput);
+ assertEquals(16, executeCodeOutput.getOutput());
+
+ List scriptLogRecords = TestUtils.queryTable(qInstance, "scriptLog");
+ List scriptLogLineRecords = TestUtils.queryTable(qInstance, "scriptLogLine");
+ assertEquals(1, scriptLogRecords.size());
+ assertEquals(1701, scriptLogRecords.get(0).getValueInteger("scriptId"));
+ assertEquals(1702, scriptLogRecords.get(0).getValueInteger("scriptRevisionId"));
+ assertEquals(1, scriptLogLineRecords.size());
+ assertEquals(1, scriptLogLineRecords.get(0).getValueInteger("scriptLogId"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testException()
+ {
+ QInstance qInstance = TestUtils.defineInstance();
+ ExecuteCodeInput executeCodeInput = setupInput(qInstance, Map.of(), new NoopCodeExecutionLogger());
+ ExecuteCodeOutput executeCodeOutput = new ExecuteCodeOutput();
+ assertThrows(QCodeException.class, () ->
+ {
+ new ExecuteCodeAction().run(executeCodeInput, executeCodeOutput);
+ });
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static class ScriptInJava implements Function, Serializable>
+ {
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public Serializable apply(Map context)
+ {
+ ((QCodeExecutionLoggerInterface) context.get("logger")).log("Test a log");
+
+ int x = ValueUtils.getValueAsInteger(context.get("x"));
+ return (x * x);
+ }
+
+ }
+}
\ No newline at end of file
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/RunAssociatedScriptActionTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/RunAssociatedScriptActionTest.java
new file mode 100644
index 00000000..4ecd1ed2
--- /dev/null
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/RunAssociatedScriptActionTest.java
@@ -0,0 +1,116 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Map;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.RunAssociatedScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.RunAssociatedScriptOutput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.code.AssociatedScriptCodeReference;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldType;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.AssociatedScript;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.model.scripts.ScriptsMetaDataProvider;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
+import com.kingsrook.qqq.backend.core.utils.TestUtils;
+import org.junit.jupiter.api.Test;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+
+/*******************************************************************************
+ ** Unit test for RunAssociatedScriptAction
+ *******************************************************************************/
+class RunAssociatedScriptActionTest
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void test() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+ QTableMetaData table = instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY)
+ .withField(new QFieldMetaData("testScriptId", QFieldType.INTEGER))
+ .withAssociatedScript(new AssociatedScript()
+ .withScriptTypeId(1)
+ .withFieldName("testScriptId")
+ );
+
+ new ScriptsMetaDataProvider().defineStandardScriptsTables(instance, TestUtils.MEMORY_BACKEND_NAME, null);
+
+ TestUtils.insertRecords(instance, table, List.of(
+ new QRecord().withValue("id", 1),
+ new QRecord().withValue("id", 2)
+ ));
+
+ TestUtils.insertRecords(instance, instance.getTable("scriptType"), List.of(
+ new QRecord().withValue("id", 1).withValue("name", "Test Script Type")
+ ));
+
+ insertScript(instance, 1, """
+ return "Hello";
+ """);
+
+ RunAssociatedScriptInput runAssociatedScriptInput = new RunAssociatedScriptInput(instance);
+ runAssociatedScriptInput.setSession(new QSession());
+ runAssociatedScriptInput.setInputValues(Map.of());
+ runAssociatedScriptInput.setTableName(TestUtils.TABLE_NAME_PERSON_MEMORY);
+ runAssociatedScriptInput.setCodeReference(new AssociatedScriptCodeReference()
+ .withRecordTable(TestUtils.TABLE_NAME_PERSON_MEMORY)
+ .withRecordPrimaryKey(1)
+ .withFieldName("testScriptId")
+ );
+ RunAssociatedScriptOutput runAssociatedScriptOutput = new RunAssociatedScriptOutput();
+
+ assertThatThrownBy(() -> new RunAssociatedScriptAction().run(runAssociatedScriptInput, runAssociatedScriptOutput))
+ .isInstanceOf(QException.class)
+ .hasRootCauseInstanceOf(ClassNotFoundException.class)
+ .hasRootCauseMessage("com.kingsrook.qqq.languages.javascript.QJavaScriptExecutor");
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private void insertScript(QInstance instance, Serializable recordId, String code) throws QException
+ {
+ StoreAssociatedScriptInput storeAssociatedScriptInput = new StoreAssociatedScriptInput(instance);
+ storeAssociatedScriptInput.setSession(new QSession());
+ storeAssociatedScriptInput.setTableName(TestUtils.TABLE_NAME_PERSON_MEMORY);
+ storeAssociatedScriptInput.setRecordPrimaryKey(recordId);
+ storeAssociatedScriptInput.setCode(code);
+ storeAssociatedScriptInput.setFieldName("testScriptId");
+ StoreAssociatedScriptOutput storeAssociatedScriptOutput = new StoreAssociatedScriptOutput();
+ new StoreAssociatedScriptAction().run(storeAssociatedScriptInput, storeAssociatedScriptOutput);
+ }
+
+}
\ No newline at end of file
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/StoreAssociatedScriptActionTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/StoreAssociatedScriptActionTest.java
new file mode 100644
index 00000000..1ae95373
--- /dev/null
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/StoreAssociatedScriptActionTest.java
@@ -0,0 +1,172 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import java.io.Serializable;
+import java.util.List;
+import com.kingsrook.qqq.backend.core.actions.tables.QueryAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QCriteriaOperator;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldType;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.AssociatedScript;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.model.scripts.ScriptsMetaDataProvider;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
+import com.kingsrook.qqq.backend.core.modules.backend.implementations.memory.MemoryRecordStore;
+import com.kingsrook.qqq.backend.core.utils.TestUtils;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+
+/*******************************************************************************
+ ** Unit test for StoreAssociatedScriptAction
+ *******************************************************************************/
+class StoreAssociatedScriptActionTest
+{
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @BeforeEach
+ @AfterEach
+ void beforeAndAfterEach()
+ {
+ MemoryRecordStore.getInstance().reset();
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void test() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+ QTableMetaData table = instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY)
+ .withField(new QFieldMetaData("testScriptId", QFieldType.INTEGER))
+ .withAssociatedScript(new AssociatedScript()
+ .withScriptTypeId(1)
+ .withFieldName("testScriptId")
+ )
+ .withField(new QFieldMetaData("otherScriptId", QFieldType.INTEGER))
+ .withAssociatedScript(new AssociatedScript()
+ .withScriptTypeId(2)
+ .withFieldName("otherScriptId")
+ );
+
+ new ScriptsMetaDataProvider().defineStandardScriptsTables(instance, TestUtils.MEMORY_BACKEND_NAME, null);
+
+ TestUtils.insertRecords(instance, table, List.of(
+ new QRecord().withValue("id", 1),
+ new QRecord().withValue("id", 2),
+ new QRecord().withValue("id", 3)
+ ));
+
+ TestUtils.insertRecords(instance, instance.getTable("scriptType"), List.of(
+ new QRecord().withValue("id", 1).withValue("name", "Test Script"),
+ new QRecord().withValue("id", 2).withValue("name", "Other Script")
+ ));
+
+ StoreAssociatedScriptInput storeAssociatedScriptInput = new StoreAssociatedScriptInput(instance);
+ storeAssociatedScriptInput.setSession(new QSession());
+ storeAssociatedScriptInput.setTableName(TestUtils.TABLE_NAME_PERSON_MEMORY);
+ storeAssociatedScriptInput.setRecordPrimaryKey(1);
+ storeAssociatedScriptInput.setCode("var i = 0;");
+ storeAssociatedScriptInput.setCommitMessage("Test commit");
+ storeAssociatedScriptInput.setFieldName("testScriptId");
+ StoreAssociatedScriptOutput storeAssociatedScriptOutput = new StoreAssociatedScriptOutput();
+
+ ///////////////////////////////////////////////
+ // insert 1st version of script for record 1 //
+ ///////////////////////////////////////////////
+ new StoreAssociatedScriptAction().run(storeAssociatedScriptInput, storeAssociatedScriptOutput);
+ assertValueInField(instance, TestUtils.TABLE_NAME_PERSON_MEMORY, 1, "testScriptId", 1);
+ assertValueInField(instance, "script", 1, "currentScriptRevisionId", 1);
+
+ ////////////////////////////////////////////
+ // add 2nd version of script for record 1 //
+ ////////////////////////////////////////////
+ storeAssociatedScriptInput.setCode("var i = 1;");
+ storeAssociatedScriptInput.setCommitMessage("2nd commit");
+ new StoreAssociatedScriptAction().run(storeAssociatedScriptInput, storeAssociatedScriptOutput);
+ assertValueInField(instance, TestUtils.TABLE_NAME_PERSON_MEMORY, 1, "testScriptId", 1);
+ assertValueInField(instance, "script", 1, "currentScriptRevisionId", 2);
+
+ ///////////////////////////////////////////////
+ // insert 1st version of script for record 3 //
+ ///////////////////////////////////////////////
+ storeAssociatedScriptInput.setRecordPrimaryKey(3);
+ storeAssociatedScriptInput.setCode("var i = 2;");
+ storeAssociatedScriptInput.setCommitMessage("First Commit here");
+ new StoreAssociatedScriptAction().run(storeAssociatedScriptInput, storeAssociatedScriptOutput);
+ assertValueInField(instance, TestUtils.TABLE_NAME_PERSON_MEMORY, 3, "testScriptId", 2);
+ assertValueInField(instance, "script", 2, "currentScriptRevisionId", 3);
+
+ /////////////////////////////////////
+ // make sure no script on record 2 //
+ /////////////////////////////////////
+ assertValueInField(instance, TestUtils.TABLE_NAME_PERSON_MEMORY, 2, "testScriptId", null);
+
+ ////////////////////////////////////
+ // add another script to record 1 //
+ ////////////////////////////////////
+ storeAssociatedScriptInput.setRecordPrimaryKey(1);
+ storeAssociatedScriptInput.setCode("var i = 3;");
+ storeAssociatedScriptInput.setCommitMessage("Other field");
+ storeAssociatedScriptInput.setFieldName("otherScriptId");
+ new StoreAssociatedScriptAction().run(storeAssociatedScriptInput, storeAssociatedScriptOutput);
+ assertValueInField(instance, TestUtils.TABLE_NAME_PERSON_MEMORY, 1, "testScriptId", 1);
+ assertValueInField(instance, TestUtils.TABLE_NAME_PERSON_MEMORY, 1, "otherScriptId", 3);
+ assertValueInField(instance, "script", 3, "currentScriptRevisionId", 4);
+
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private Serializable assertValueInField(QInstance instance, String tableName, Serializable recordId, String fieldName, Serializable value) throws QException
+ {
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName(tableName);
+ queryInput.setFilter(new QQueryFilter().withCriteria(new QFilterCriteria("id", QCriteriaOperator.EQUALS, List.of(recordId))));
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ Serializable actual = queryOutput.getRecords().get(0).getValue(fieldName);
+ assertEquals(value, actual);
+ return (actual);
+ }
+
+}
\ No newline at end of file
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/TestScriptActionTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/TestScriptActionTest.java
new file mode 100644
index 00000000..7d492c9c
--- /dev/null
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/actions/scripts/TestScriptActionTest.java
@@ -0,0 +1,50 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.actions.scripts;
+
+
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.TestScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.TestScriptOutput;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.utils.TestUtils;
+import org.junit.jupiter.api.Test;
+
+
+/*******************************************************************************
+ ** Unit test for TestScriptAction
+ *******************************************************************************/
+class TestScriptActionTest
+{
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void test() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+ TestScriptInput input = new TestScriptInput(instance);
+ TestScriptOutput output = new TestScriptOutput();
+ new TestScriptAction().run(input, output);
+ }
+
+}
\ No newline at end of file
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationQueryActionTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationQueryActionTest.java
new file mode 100644
index 00000000..24d7d013
--- /dev/null
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/enumeration/EnumerationQueryActionTest.java
@@ -0,0 +1,271 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.modules.backend.implementations.enumeration;
+
+
+import java.util.List;
+import com.kingsrook.qqq.backend.core.actions.tables.QueryAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QCriteriaOperator;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterOrderBy;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecordEnum;
+import com.kingsrook.qqq.backend.core.model.metadata.QBackendMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldType;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
+import com.kingsrook.qqq.backend.core.utils.TestUtils;
+import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+
+/*******************************************************************************
+ ** Unit test for EnumerationQueryAction
+ *******************************************************************************/
+class EnumerationQueryActionTest
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testUnfilteredQuery() throws QException
+ {
+ QInstance instance = defineQInstance();
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName("statesEnum");
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(2, queryOutput.getRecords().size());
+
+ assertEquals(1, queryOutput.getRecords().get(0).getValueInteger("id"));
+ assertEquals("Missouri", queryOutput.getRecords().get(0).getValueString("name"));
+ assertEquals("MO", queryOutput.getRecords().get(0).getValueString("postalCode"));
+ assertEquals(15_000_000, queryOutput.getRecords().get(0).getValueInteger("population"));
+
+ assertEquals(2, queryOutput.getRecords().get(1).getValueInteger("id"));
+ assertEquals("Illinois", queryOutput.getRecords().get(1).getValueString("name"));
+ assertEquals("IL", queryOutput.getRecords().get(1).getValueString("postalCode"));
+ assertEquals(25_000_000, queryOutput.getRecords().get(1).getValueInteger("population"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testFilteredQuery() throws QException
+ {
+ QInstance instance = defineQInstance();
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName("statesEnum");
+ queryInput.setFilter(new QQueryFilter().withCriteria(new QFilterCriteria("population", QCriteriaOperator.GREATER_THAN, List.of(20_000_000))));
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(1, queryOutput.getRecords().size());
+
+ assertEquals(2, queryOutput.getRecords().get(0).getValueInteger("id"));
+ assertEquals("IL", queryOutput.getRecords().get(0).getValueString("postalCode"));
+ assertEquals(25_000_000, queryOutput.getRecords().get(0).getValueInteger("population"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testQueryOrderBy() throws QException
+ {
+ QInstance instance = defineQInstance();
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName("statesEnum");
+
+ queryInput.setFilter(new QQueryFilter().withOrderBy(new QFilterOrderBy("name")));
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Illinois", "Missouri"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setFilter(new QQueryFilter().withOrderBy(new QFilterOrderBy("name", false)));
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Missouri", "Illinois"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testQuerySkipLimit() throws QException
+ {
+ QInstance instance = defineQInstance();
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName("statesEnum");
+ queryInput.setSkip(0);
+ queryInput.setLimit(null);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Missouri", "Illinois"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setSkip(1);
+ queryInput.setLimit(null);
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Illinois"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setSkip(2);
+ queryInput.setLimit(null);
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of(), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setSkip(null);
+ queryInput.setLimit(1);
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Missouri"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setSkip(null);
+ queryInput.setLimit(2);
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Missouri", "Illinois"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setSkip(null);
+ queryInput.setLimit(3);
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of("Missouri", "Illinois"), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+
+ queryInput.setSkip(null);
+ queryInput.setLimit(0);
+ queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(List.of(), queryOutput.getRecords().stream().map(r -> r.getValueString("name")).toList());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QInstance defineQInstance()
+ {
+ QInstance instance = TestUtils.defineInstance();
+ instance.addBackend(new QBackendMetaData()
+ .withName("enum")
+ .withBackendType("enum")
+ );
+
+ instance.addTable(new QTableMetaData()
+ .withName("statesEnum")
+ .withBackendName("enum")
+ .withPrimaryKeyField("id")
+ .withField(new QFieldMetaData("id", QFieldType.INTEGER))
+ .withField(new QFieldMetaData("name", QFieldType.STRING))
+ .withField(new QFieldMetaData("postalCode", QFieldType.STRING))
+ .withField(new QFieldMetaData("population", QFieldType.INTEGER))
+ .withBackendDetails(new EnumerationTableBackendDetails().withEnumClass(States.class))
+ );
+ return instance;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static enum States implements QRecordEnum
+ {
+ MO(1, "Missouri", "MO", 15_000_000),
+ IL(2, "Illinois", "IL", 25_000_000);
+
+
+ private final Integer id;
+ private final String name;
+ private final String postalCode;
+ private final Integer population;
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ States(int id, String name, String postalCode, int population)
+ {
+ this.id = id;
+ this.name = name;
+ this.postalCode = postalCode;
+ this.population = population;
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for id
+ **
+ *******************************************************************************/
+ public Integer getId()
+ {
+ return id;
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for name
+ **
+ *******************************************************************************/
+ public String getName()
+ {
+ return name;
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for postalCode
+ **
+ *******************************************************************************/
+ public String getPostalCode()
+ {
+ return postalCode;
+ }
+
+
+
+ /*******************************************************************************
+ ** Getter for population
+ **
+ *******************************************************************************/
+ public Integer getPopulation()
+ {
+ return population;
+ }
+ }
+
+}
\ No newline at end of file
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModuleTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModuleTest.java
index 3f451a6b..21e00c65 100644
--- a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModuleTest.java
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/modules/backend/implementations/memory/MemoryBackendModuleTest.java
@@ -271,12 +271,12 @@ class MemoryBackendModuleTest
assertEquals(2, queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.LESS_THAN_OR_EQUALS, List.of(2))).size());
assertEquals(1, queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.LESS_THAN_OR_EQUALS, List.of(1))).size());
assertEquals(0, queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.LESS_THAN_OR_EQUALS, List.of(0))).size());
+ assertEquals(1, queryShapes(qInstance, table, session, new QFilterCriteria("name", QCriteriaOperator.LESS_THAN_OR_EQUALS, List.of("Darin"))).size());
assertThrows(QException.class, () -> queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.GREATER_THAN, List.of())));
assertThrows(QException.class, () -> queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.GREATER_THAN_OR_EQUALS, List.of())));
assertThrows(QException.class, () -> queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.LESS_THAN, List.of())));
assertThrows(QException.class, () -> queryShapes(qInstance, table, session, new QFilterCriteria("id", QCriteriaOperator.LESS_THAN_OR_EQUALS, List.of())));
- assertThrows(QException.class, () -> queryShapes(qInstance, table, session, new QFilterCriteria("name", QCriteriaOperator.LESS_THAN_OR_EQUALS, List.of("Bob"))));
{
////////////////////////////
diff --git a/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/processes/utils/GeneralProcessUtilsTest.java b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/processes/utils/GeneralProcessUtilsTest.java
new file mode 100644
index 00000000..ad98187a
--- /dev/null
+++ b/qqq-backend-core/src/test/java/com/kingsrook/qqq/backend/core/processes/utils/GeneralProcessUtilsTest.java
@@ -0,0 +1,326 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.backend.core.processes.utils;
+
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.stream.Collectors;
+import com.kingsrook.qqq.backend.core.actions.tables.QueryAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
+import com.kingsrook.qqq.backend.core.modules.backend.implementations.memory.MemoryRecordStore;
+import com.kingsrook.qqq.backend.core.utils.ListingHash;
+import com.kingsrook.qqq.backend.core.utils.TestUtils;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+
+/*******************************************************************************
+ ** Unit test for GeneralProcessUtils
+ *******************************************************************************/
+class GeneralProcessUtilsTest
+{
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @AfterEach
+ @BeforeEach
+ void beforeAndAfterEach()
+ {
+ MemoryRecordStore.getInstance().reset();
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testGetForeignRecordMap() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("favoriteShapeId", 3),
+ new QRecord().withValue("favoriteShapeId", 1)
+ ));
+ TestUtils.insertDefaultShapes(instance);
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName(TestUtils.TABLE_NAME_PERSON_MEMORY);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+
+ Map foreignRecordMap = GeneralProcessUtils.getForeignRecordMap(queryInput, queryOutput.getRecords(), "favoriteShapeId", TestUtils.TABLE_NAME_SHAPE, "id");
+
+ assertEquals(2, foreignRecordMap.size());
+ assertEquals(1, foreignRecordMap.get(1).getValueInteger("id"));
+ assertEquals(3, foreignRecordMap.get(3).getValueInteger("id"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testGetForeignRecordListingHashMap() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("favoriteShapeId", 3),
+ new QRecord().withValue("id", 2).withValue("favoriteShapeId", 3),
+ new QRecord().withValue("id", 3).withValue("favoriteShapeId", 1)
+ ));
+ TestUtils.insertDefaultShapes(instance);
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName(TestUtils.TABLE_NAME_SHAPE);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+
+ ListingHash foreignRecordListingHashMap = GeneralProcessUtils.getForeignRecordListingHashMap(queryInput, queryOutput.getRecords(), "id", TestUtils.TABLE_NAME_PERSON_MEMORY, "favoriteShapeId");
+
+ assertEquals(2, foreignRecordListingHashMap.size());
+
+ assertEquals(1, foreignRecordListingHashMap.get(1).size());
+ assertEquals(Set.of(3), foreignRecordListingHashMap.get(1).stream().map(r -> r.getValueInteger("id")).collect(Collectors.toSet()));
+
+ assertEquals(2, foreignRecordListingHashMap.get(3).size());
+ assertEquals(Set.of(1, 2), foreignRecordListingHashMap.get(3).stream().map(r -> r.getValueInteger("id")).collect(Collectors.toSet()));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testAddForeignRecordsToRecordList() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("favoriteShapeId", 3),
+ new QRecord().withValue("favoriteShapeId", 1)
+ ));
+ TestUtils.insertDefaultShapes(instance);
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName(TestUtils.TABLE_NAME_PERSON_MEMORY);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+
+ GeneralProcessUtils.addForeignRecordsToRecordList(queryInput, queryOutput.getRecords(), "favoriteShapeId", TestUtils.TABLE_NAME_SHAPE, "id");
+
+ for(QRecord record : queryOutput.getRecords())
+ {
+ assertEquals(record.getValue("favoriteShapeId"), ((QRecord) record.getValue(TestUtils.TABLE_NAME_SHAPE)).getValue("id"));
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testAddForeignRecordsListToRecordList() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("favoriteShapeId", 3),
+ new QRecord().withValue("id", 2).withValue("favoriteShapeId", 3),
+ new QRecord().withValue("id", 3).withValue("favoriteShapeId", 1)
+ ));
+ TestUtils.insertDefaultShapes(instance);
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ queryInput.setTableName(TestUtils.TABLE_NAME_SHAPE);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+
+ GeneralProcessUtils.addForeignRecordsListToRecordList(queryInput, queryOutput.getRecords(), "id", TestUtils.TABLE_NAME_PERSON_MEMORY, "favoriteShapeId");
+
+ for(QRecord record : queryOutput.getRecords())
+ {
+ @SuppressWarnings("unchecked")
+ List foreignRecordList = (List) record.getValue(TestUtils.TABLE_NAME_PERSON_MEMORY);
+
+ if(record.getValueInteger("id").equals(3))
+ {
+ assertEquals(2, foreignRecordList.size());
+ }
+ else if(record.getValueInteger("id").equals(2))
+ {
+ assertNull(foreignRecordList);
+ continue;
+ }
+
+ for(QRecord foreignRecord : foreignRecordList)
+ {
+ assertEquals(record.getValue("id"), foreignRecord.getValue("favoriteShapeId"));
+ }
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testGetRecordListByField() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("favoriteShapeId", 3),
+ new QRecord().withValue("id", 2).withValue("favoriteShapeId", 3),
+ new QRecord().withValue("id", 3).withValue("favoriteShapeId", 1)
+ ));
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ List records = GeneralProcessUtils.getRecordListByField(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY, "favoriteShapeId", 3);
+ assertEquals(2, records.size());
+ assertTrue(records.stream().anyMatch(r -> r.getValue("id").equals(1)));
+ assertTrue(records.stream().anyMatch(r -> r.getValue("id").equals(2)));
+ assertTrue(records.stream().noneMatch(r -> r.getValue("id").equals(3)));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testGetRecordById() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("firstName", "Darin"),
+ new QRecord().withValue("id", 2).withValue("firstName", "James"),
+ new QRecord().withValue("id", 3).withValue("firstName", "Tim")
+ ));
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ Optional record = GeneralProcessUtils.getRecordById(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY, "firstName", "James");
+ assertTrue(record.isPresent());
+ assertEquals(2, record.get().getValueInteger("id"));
+
+ record = GeneralProcessUtils.getRecordById(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY, "firstName", "Bobby");
+ assertFalse(record.isPresent());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testLoadTable() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("firstName", "Darin"),
+ new QRecord().withValue("id", 2).withValue("firstName", "James"),
+ new QRecord().withValue("id", 3).withValue("firstName", "Tim")
+ ));
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ List records = GeneralProcessUtils.loadTable(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY);
+ assertEquals(3, records.size());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testLoadTableToMap() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("firstName", "Darin"),
+ new QRecord().withValue("id", 2).withValue("firstName", "James"),
+ new QRecord().withValue("id", 3).withValue("firstName", "Tim")
+ ));
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ Map recordMapById = GeneralProcessUtils.loadTableToMap(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY, "id");
+ assertEquals(3, recordMapById.size());
+ assertEquals("Darin", recordMapById.get(1).getValueString("firstName"));
+ assertEquals("James", recordMapById.get(2).getValueString("firstName"));
+
+ Map recordMapByFirstName = GeneralProcessUtils.loadTableToMap(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY, "firstName");
+ assertEquals(3, recordMapByFirstName.size());
+ assertEquals(1, recordMapByFirstName.get("Darin").getValueInteger("id"));
+ assertEquals(3, recordMapByFirstName.get("Tim").getValueInteger("id"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testLoadTableToListingHash() throws QException
+ {
+ QInstance instance = TestUtils.defineInstance();
+
+ TestUtils.insertRecords(instance, instance.getTable(TestUtils.TABLE_NAME_PERSON_MEMORY), List.of(
+ new QRecord().withValue("id", 1).withValue("firstName", "Darin").withValue("lastName", "Kelkhoff"),
+ new QRecord().withValue("id", 2).withValue("firstName", "James").withValue("lastName", "Maes"),
+ new QRecord().withValue("id", 3).withValue("firstName", "James").withValue("lastName", "Brown")
+ ));
+
+ QueryInput queryInput = new QueryInput(instance);
+ queryInput.setSession(new QSession());
+ ListingHash map = GeneralProcessUtils.loadTableToListingHash(queryInput, TestUtils.TABLE_NAME_PERSON_MEMORY, "firstName");
+ assertEquals(2, map.size());
+ assertEquals(1, map.get("Darin").size());
+ assertEquals(2, map.get("James").size());
+ }
+}
\ No newline at end of file
diff --git a/qqq-language-support-javascript/pom.xml b/qqq-language-support-javascript/pom.xml
new file mode 100644
index 00000000..ba2af5a4
--- /dev/null
+++ b/qqq-language-support-javascript/pom.xml
@@ -0,0 +1,90 @@
+
+
+
+
+ 4.0.0
+
+ qqq-language-support-javascript
+
+
+ com.kingsrook.qqq
+ qqq-parent-project
+ ${revision}
+
+
+
+
+
+
+ 0.10
+ 0.10
+
+
+
+
+
+ com.kingsrook.qqq
+ qqq-backend-core
+ ${revision}
+
+
+
+
+ org.openjdk.nashorn
+ nashorn-core
+ 15.4
+
+
+
+
+ org.apache.maven.plugins
+ maven-checkstyle-plugin
+
+
+ org.apache.logging.log4j
+ log4j-api
+
+
+ org.apache.logging.log4j
+ log4j-core
+
+
+ org.junit.jupiter
+ junit-jupiter-engine
+ test
+
+
+ org.assertj
+ assertj-core
+ test
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/qqq-language-support-javascript/src/main/java/com/kingsrook/qqq/languages/javascript/QJavaScriptExecutor.java b/qqq-language-support-javascript/src/main/java/com/kingsrook/qqq/languages/javascript/QJavaScriptExecutor.java
new file mode 100644
index 00000000..90933f32
--- /dev/null
+++ b/qqq-language-support-javascript/src/main/java/com/kingsrook/qqq/languages/javascript/QJavaScriptExecutor.java
@@ -0,0 +1,168 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.languages.javascript;
+
+
+import javax.script.Bindings;
+import javax.script.ScriptEngine;
+import javax.script.ScriptEngineManager;
+import javax.script.ScriptException;
+import java.io.Serializable;
+import java.util.Map;
+import com.kingsrook.qqq.backend.core.actions.scripts.QCodeExecutor;
+import com.kingsrook.qqq.backend.core.actions.scripts.logging.QCodeExecutionLoggerInterface;
+import com.kingsrook.qqq.backend.core.exceptions.QCodeException;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+import com.kingsrook.qqq.backend.core.utils.ExceptionUtils;
+import com.kingsrook.qqq.backend.core.utils.StringUtils;
+import org.apache.commons.lang.NotImplementedException;
+import org.openjdk.nashorn.api.scripting.NashornScriptEngineFactory;
+import org.openjdk.nashorn.internal.runtime.ECMAException;
+import org.openjdk.nashorn.internal.runtime.ParserException;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class QJavaScriptExecutor implements QCodeExecutor
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public Serializable execute(QCodeReference codeReference, Map context, QCodeExecutionLoggerInterface executionLogger) throws QCodeException
+ {
+ String code = getCode(codeReference);
+ Serializable output = runInline(code, context, executionLogger);
+ return (output);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private Serializable runInline(String code, Map context, QCodeExecutionLoggerInterface executionLogger) throws QCodeException
+ {
+ new NashornScriptEngineFactory();
+ ScriptEngine engine = new ScriptEngineManager().getEngineByName("nashorn");
+
+ Bindings bindings = engine.createBindings();
+ bindings.putAll(context);
+ if(!bindings.containsKey("logger"))
+ {
+ bindings.put("logger", executionLogger);
+ }
+
+ ////////////////////////////////////////////////////////////////////////
+ // wrap the user's code in an immediately-invoked function expression //
+ ////////////////////////////////////////////////////////////////////////
+ String codeToRun = """
+ (function userDefinedFunction()
+ {
+ %s
+ })();
+ """.formatted(code);
+
+ Serializable output;
+ try
+ {
+ output = (Serializable) engine.eval(codeToRun, bindings);
+ }
+ catch(ScriptException se)
+ {
+ QCodeException qCodeException = getQCodeExceptionFromScriptException(se);
+ throw (qCodeException);
+ }
+
+ return (output);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private QCodeException getQCodeExceptionFromScriptException(ScriptException se)
+ {
+ boolean isParserException = ExceptionUtils.findClassInRootChain(se, ParserException.class) != null;
+ boolean isUserThrownException = ExceptionUtils.findClassInRootChain(se, ECMAException.class) != null;
+
+ String message = se.getMessage();
+ String errorContext = null;
+ if(message != null)
+ {
+ message = message.replaceFirst(" in .*", "");
+ message = message.replaceFirst(":\\d+:\\d+", "");
+
+ if(message.contains("\n"))
+ {
+ String[] parts = message.split("\n", 2);
+ message = parts[0];
+ errorContext = parts[1];
+ }
+ }
+
+ int actualScriptLineNumber = se.getLineNumber() - 2;
+
+ String prefix = "Script Exception";
+ boolean includeColumn = true;
+ boolean includeContext = false;
+ if(isParserException)
+ {
+ prefix = "Script parser exception";
+ includeContext = true;
+ }
+ else if(isUserThrownException)
+ {
+ prefix = "Script threw an exception";
+ includeColumn = false;
+ }
+
+ QCodeException qCodeException = new QCodeException(prefix + " at line " + actualScriptLineNumber + (includeColumn ? (" column " + se.getColumnNumber()) : "") + ": " + message);
+ if(includeContext)
+ {
+ qCodeException.setContext(errorContext);
+ }
+
+ return (qCodeException);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private String getCode(QCodeReference codeReference)
+ {
+ if(StringUtils.hasContent(codeReference.getInlineCode()))
+ {
+ return (codeReference.getInlineCode());
+ }
+ else
+ {
+ throw (new NotImplementedException("Only inline code is implemented at this time."));
+ }
+ }
+
+}
diff --git a/qqq-language-support-javascript/src/test/java/com/kingsrook/qqq/languages/javascript/ExecuteCodeActionTest.java b/qqq-language-support-javascript/src/test/java/com/kingsrook/qqq/languages/javascript/ExecuteCodeActionTest.java
new file mode 100644
index 00000000..192379c7
--- /dev/null
+++ b/qqq-language-support-javascript/src/test/java/com/kingsrook/qqq/languages/javascript/ExecuteCodeActionTest.java
@@ -0,0 +1,322 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.languages.javascript;
+
+
+import java.io.Serializable;
+import com.kingsrook.qqq.backend.core.actions.scripts.ExecuteCodeAction;
+import com.kingsrook.qqq.backend.core.exceptions.QCodeException;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.ExecuteCodeOutput;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeType;
+import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeUsage;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
+import org.assertj.core.api.Assertions;
+import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+
+/*******************************************************************************
+ ** Unit test for ExecuteCodeAction
+ *******************************************************************************/
+class ExecuteCodeActionTest
+{
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testHelloWorld() throws QException
+ {
+ ExecuteCodeInput input = new ExecuteCodeInput(TestUtils.defineInstance())
+ .withCodeReference(new QCodeReference("helloWorld.js", QCodeType.JAVA_SCRIPT, QCodeUsage.CUSTOMIZER)
+ .withInlineCode("""
+ return "Hello, " + input"""))
+ .withContext("input", "World");
+ ExecuteCodeOutput output = new ExecuteCodeOutput();
+ new ExecuteCodeAction().run(input, output);
+ assertEquals("Hello, World", output.getOutput());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testSetInContextObject() throws QException
+ {
+ OneTestOutput oneTestOutput = testOne(3, """
+ var a = 1;
+ var b = 2;
+ output.setD(a + b + input.getC());
+ """);
+ assertEquals(6, oneTestOutput.testOutput().getD());
+ assertNull(oneTestOutput.executeCodeOutput().getOutput());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testReturnsContextObject() throws QException
+ {
+ OneTestOutput oneTestOutput = testOne(4, """
+ var a = 1;
+ var b = 2;
+ output.setD(a + b + input.getC());
+ return (output);
+ """);
+ assertEquals(7, oneTestOutput.testOutput().getD());
+ assertTrue(oneTestOutput.executeCodeOutput().getOutput() instanceof TestOutput);
+ assertEquals(7, ((TestOutput) oneTestOutput.executeCodeOutput().getOutput()).getD());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testReturnsPrimitive() throws QException
+ {
+ OneTestOutput oneTestOutput = testOne(5, """
+ var a = 1;
+ var b = 2;
+ output.setD(a + b + input.getC());
+ return output.getD()
+ """);
+ assertEquals(8, oneTestOutput.testOutput().getD());
+ assertEquals(8, oneTestOutput.executeCodeOutput().getOutput());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testThrows() throws QException
+ {
+ String code = """
+ var a = 1;
+ var b = 2;
+ if (input.getC() === 6)
+ {
+ throw ("oh no, six!");
+ }
+ output.setD(a + b + input.getC());
+ return output.getD()
+ """;
+
+ Assertions.assertThatThrownBy(() -> testOne(6, code))
+ .isInstanceOf(QCodeException.class)
+ .hasMessageContaining("threw")
+ .hasMessageContaining("oh no, six!")
+ .hasMessageContaining("line 5:");
+
+ OneTestOutput oneTestOutput = testOne(7, code);
+ assertEquals(10, oneTestOutput.testOutput().getD());
+ assertEquals(10, oneTestOutput.executeCodeOutput().getOutput());
+
+ Assertions.assertThatThrownBy(() -> testOne(6, """
+ var a = null;
+ return a.toString();
+ """))
+ .isInstanceOf(QCodeException.class)
+ .hasMessageContaining("threw")
+ .hasMessageContaining("TypeError: null has no such function \"toString\"");
+
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testSyntaxError() throws QException
+ {
+ Assertions.assertThatThrownBy(() -> testOne(6, """
+ var a = 1;
+ if (input.getC() === 6
+ {
+ """))
+ .isInstanceOf(QCodeException.class)
+ .hasMessageContaining("parser")
+ .hasMessageContaining("line 3 column 0");
+
+ Assertions.assertThatThrownBy(() -> testOne(6, """
+ var a = 1;
+ vr b = 2;
+ """))
+ .isInstanceOf(QCodeException.class)
+ .hasMessageContaining("parser")
+ .hasMessageContaining("line 2 column 3");
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testLogs() throws QException
+ {
+ OneTestOutput oneTestOutput = testOne(5, """
+ logger.log("This is a log.");
+ """);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private OneTestOutput testOne(Integer inputValueC, String code) throws QException
+ {
+ System.out.println();
+ QInstance instance = TestUtils.defineInstance();
+
+ TestInput testInput = new TestInput();
+ testInput.setC(inputValueC);
+
+ TestOutput testOutput = new TestOutput();
+
+ ExecuteCodeInput input = new ExecuteCodeInput(instance);
+ input.setSession(new QSession());
+ input.setCodeReference(new QCodeReference("test.js", QCodeType.JAVA_SCRIPT, QCodeUsage.CUSTOMIZER).withInlineCode(code));
+ input.withContext("input", testInput);
+ input.withContext("output", testOutput);
+
+ ExecuteCodeOutput output = new ExecuteCodeOutput();
+
+ ExecuteCodeAction executeCodeAction = new ExecuteCodeAction();
+ executeCodeAction.run(input, output);
+
+ return (new OneTestOutput(output, testOutput));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private record OneTestOutput(ExecuteCodeOutput executeCodeOutput, TestOutput testOutput)
+ {
+
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static class TestInput implements Serializable
+ {
+ private Integer c;
+
+
+
+ /*******************************************************************************
+ ** Getter for c
+ **
+ *******************************************************************************/
+ public Integer getC()
+ {
+ return c;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for c
+ **
+ *******************************************************************************/
+ public void setC(Integer c)
+ {
+ this.c = c;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public String toString()
+ {
+ return "TestInput{c=" + c + '}';
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static class TestOutput implements Serializable
+ {
+ private Integer d;
+
+
+
+ /*******************************************************************************
+ ** Getter for d
+ **
+ *******************************************************************************/
+ public Integer getD()
+ {
+ return d;
+ }
+
+
+
+ /*******************************************************************************
+ ** Setter for d
+ **
+ *******************************************************************************/
+ public void setD(Integer d)
+ {
+ this.d = d;
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Override
+ public String toString()
+ {
+ return "TestOutput{d=" + d + '}';
+ }
+ }
+
+}
\ No newline at end of file
diff --git a/qqq-language-support-javascript/src/test/java/com/kingsrook/qqq/languages/javascript/TestUtils.java b/qqq-language-support-javascript/src/test/java/com/kingsrook/qqq/languages/javascript/TestUtils.java
new file mode 100644
index 00000000..8d414889
--- /dev/null
+++ b/qqq-language-support-javascript/src/test/java/com/kingsrook/qqq/languages/javascript/TestUtils.java
@@ -0,0 +1,100 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022. Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see .
+ */
+
+package com.kingsrook.qqq.languages.javascript;
+
+
+import com.kingsrook.qqq.backend.core.model.metadata.QAuthenticationType;
+import com.kingsrook.qqq.backend.core.model.metadata.QBackendMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldType;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.modules.authentication.metadata.QAuthenticationMetaData;
+
+
+/*******************************************************************************
+ **
+ *******************************************************************************/
+public class TestUtils
+{
+ public static final String DEFAULT_BACKEND_NAME = "memoryBackend";
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static QInstance defineInstance()
+ {
+ QInstance qInstance = new QInstance();
+ qInstance.addBackend(defineBackend());
+ qInstance.addTable(defineTablePerson());
+ qInstance.setAuthentication(defineAuthentication());
+ return (qInstance);
+ }
+
+
+
+ /*******************************************************************************
+ ** Define the authentication used in standard tests - using 'mock' type.
+ **
+ *******************************************************************************/
+ public static QAuthenticationMetaData defineAuthentication()
+ {
+ return new QAuthenticationMetaData()
+ .withName("mock")
+ .withType(QAuthenticationType.MOCK);
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static QBackendMetaData defineBackend()
+ {
+ return (new QBackendMetaData()
+ .withName(DEFAULT_BACKEND_NAME)
+ .withBackendType("memory"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static QTableMetaData defineTablePerson()
+ {
+ return new QTableMetaData()
+ .withName("person")
+ .withLabel("Person")
+ .withBackendName(DEFAULT_BACKEND_NAME)
+ .withPrimaryKeyField("id")
+ .withField(new QFieldMetaData("id", QFieldType.INTEGER).withIsEditable(false))
+ .withField(new QFieldMetaData("createDate", QFieldType.DATE_TIME).withIsEditable(false))
+ .withField(new QFieldMetaData("modifyDate", QFieldType.DATE_TIME).withIsEditable(false))
+ .withField(new QFieldMetaData("firstName", QFieldType.STRING))
+ .withField(new QFieldMetaData("lastName", QFieldType.STRING))
+ .withField(new QFieldMetaData("birthDate", QFieldType.DATE))
+ .withField(new QFieldMetaData("email", QFieldType.STRING));
+ }
+}
diff --git a/qqq-middleware-javalin/src/main/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementation.java b/qqq-middleware-javalin/src/main/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementation.java
index d7ca6f3a..9af73f36 100644
--- a/qqq-middleware-javalin/src/main/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementation.java
+++ b/qqq-middleware-javalin/src/main/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementation.java
@@ -42,6 +42,8 @@ import com.kingsrook.qqq.backend.core.actions.metadata.MetaDataAction;
import com.kingsrook.qqq.backend.core.actions.metadata.ProcessMetaDataAction;
import com.kingsrook.qqq.backend.core.actions.metadata.TableMetaDataAction;
import com.kingsrook.qqq.backend.core.actions.reporting.ExportAction;
+import com.kingsrook.qqq.backend.core.actions.scripts.StoreAssociatedScriptAction;
+import com.kingsrook.qqq.backend.core.actions.scripts.TestScriptAction;
import com.kingsrook.qqq.backend.core.actions.tables.CountAction;
import com.kingsrook.qqq.backend.core.actions.tables.DeleteAction;
import com.kingsrook.qqq.backend.core.actions.tables.GetAction;
@@ -66,6 +68,10 @@ import com.kingsrook.qqq.backend.core.model.actions.metadata.TableMetaDataInput;
import com.kingsrook.qqq.backend.core.model.actions.metadata.TableMetaDataOutput;
import com.kingsrook.qqq.backend.core.model.actions.reporting.ExportInput;
import com.kingsrook.qqq.backend.core.model.actions.reporting.ReportFormat;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.StoreAssociatedScriptOutput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.TestScriptInput;
+import com.kingsrook.qqq.backend.core.model.actions.scripts.TestScriptOutput;
import com.kingsrook.qqq.backend.core.model.actions.tables.count.CountInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.count.CountOutput;
import com.kingsrook.qqq.backend.core.model.actions.tables.delete.DeleteInput;
@@ -74,6 +80,9 @@ import com.kingsrook.qqq.backend.core.model.actions.tables.get.GetInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.get.GetOutput;
import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QCriteriaOperator;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterOrderBy;
import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
@@ -86,11 +95,13 @@ import com.kingsrook.qqq.backend.core.model.actions.widgets.RenderWidgetOutput;
import com.kingsrook.qqq.backend.core.model.data.QRecord;
import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
import com.kingsrook.qqq.backend.core.model.metadata.fields.QFieldMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.AssociatedScript;
import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
import com.kingsrook.qqq.backend.core.model.session.QSession;
import com.kingsrook.qqq.backend.core.modules.authentication.Auth0AuthenticationModule;
import com.kingsrook.qqq.backend.core.modules.authentication.QAuthenticationModuleDispatcher;
import com.kingsrook.qqq.backend.core.modules.authentication.QAuthenticationModuleInterface;
+import com.kingsrook.qqq.backend.core.processes.utils.GeneralProcessUtils;
import com.kingsrook.qqq.backend.core.utils.CollectionUtils;
import com.kingsrook.qqq.backend.core.utils.ExceptionUtils;
import com.kingsrook.qqq.backend.core.utils.JsonUtils;
@@ -271,6 +282,7 @@ public class QJavalinImplementation
{
get("", QJavalinImplementation::processMetaData);
});
+ get("/authentication", QJavalinImplementation::authenticationMetaData);
});
/////////////////////////
@@ -294,6 +306,11 @@ public class QJavalinImplementation
patch("", QJavalinImplementation::dataUpdate);
put("", QJavalinImplementation::dataUpdate); // todo - want different semantics??
delete("", QJavalinImplementation::dataDelete);
+
+ get("/developer", QJavalinImplementation::getRecordDeveloperMode);
+ post("/developer/associatedScript/{fieldName}", QJavalinImplementation::storeRecordAssociatedScript);
+ get("/developer/associatedScript/{fieldName}/{scriptRevisionId}/logs", QJavalinImplementation::getAssociatedScriptLogs);
+ post("/developer/associatedScript/{fieldName}/test", QJavalinImplementation::testAssociatedScript);
});
});
@@ -308,6 +325,16 @@ public class QJavalinImplementation
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static void authenticationMetaData(Context context)
+ {
+ context.result(JsonUtils.toJson(qInstance.getAuthentication()));
+ }
+
+
+
/*******************************************************************************
**
*******************************************************************************/
@@ -932,6 +959,211 @@ public class QJavalinImplementation
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static void getRecordDeveloperMode(Context context)
+ {
+ try
+ {
+ String tableName = context.pathParam("table");
+ QTableMetaData table = qInstance.getTable(tableName);
+ String primaryKey = context.pathParam("primaryKey");
+ GetInput getInput = new GetInput(qInstance);
+
+ setupSession(context, getInput);
+ getInput.setTableName(tableName);
+ getInput.setShouldGenerateDisplayValues(true);
+ getInput.setShouldTranslatePossibleValues(true);
+
+ // todo - validate that the primary key is of the proper type (e.g,. not a string for an id field)
+ // and throw a 400-series error (tell the user bad-request), rather than, we're doing a 500 (server error)
+
+ getInput.setPrimaryKey(primaryKey);
+
+ GetAction getAction = new GetAction();
+ GetOutput getOutput = getAction.execute(getInput);
+
+ ///////////////////////////////////////////////////////
+ // throw a not found error if the record isn't found //
+ ///////////////////////////////////////////////////////
+ QRecord record = getOutput.getRecord();
+ if(record == null)
+ {
+ throw (new QNotFoundException("Could not find " + table.getLabel() + " with "
+ + table.getFields().get(table.getPrimaryKeyField()).getLabel() + " of " + primaryKey));
+ }
+
+ Map rs = new HashMap<>();
+ rs.put("record", record);
+
+ ArrayList> associatedScripts = new ArrayList<>();
+ rs.put("associatedScripts", associatedScripts);
+
+ ///////////////////////////////////////////////////////
+ // process each associated script type for the table //
+ ///////////////////////////////////////////////////////
+ for(AssociatedScript associatedScript : CollectionUtils.nonNullList(table.getAssociatedScripts()))
+ {
+ HashMap thisScriptData = new HashMap<>();
+ associatedScripts.add(thisScriptData);
+ thisScriptData.put("associatedScript", associatedScript);
+
+ String fieldName = associatedScript.getFieldName();
+ Serializable scriptId = record.getValue(fieldName);
+ if(scriptId != null)
+ {
+ GetInput getScriptInput = new GetInput(qInstance);
+ setupSession(context, getScriptInput);
+ getScriptInput.setTableName("script");
+ getScriptInput.setPrimaryKey(scriptId);
+ GetOutput getScriptOutput = new GetAction().execute(getScriptInput);
+ if(getScriptOutput.getRecord() != null)
+ {
+ thisScriptData.put("script", getScriptOutput.getRecord());
+
+ QueryInput queryInput = new QueryInput(qInstance);
+ setupSession(context, queryInput);
+ queryInput.setTableName("scriptRevision");
+ queryInput.setFilter(new QQueryFilter()
+ .withCriteria(new QFilterCriteria("scriptId", QCriteriaOperator.EQUALS, List.of(getScriptOutput.getRecord().getValue("id"))))
+ .withOrderBy(new QFilterOrderBy("id", false))
+ );
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ thisScriptData.put("scriptRevisions", new ArrayList<>(queryOutput.getRecords()));
+ }
+ }
+ }
+
+ context.result(JsonUtils.toJson(rs));
+ }
+ catch(Exception e)
+ {
+ handleException(context, e);
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ public static void getAssociatedScriptLogs(Context context)
+ {
+ try
+ {
+ String scriptRevisionId = context.pathParam("scriptRevisionId");
+
+ QueryInput queryInput = new QueryInput(qInstance);
+ setupSession(context, queryInput);
+ queryInput.setTableName("scriptLog");
+ queryInput.setFilter(new QQueryFilter()
+ .withCriteria(new QFilterCriteria("scriptRevisionId", QCriteriaOperator.EQUALS, List.of(scriptRevisionId)))
+ .withOrderBy(new QFilterOrderBy("id", false))
+ );
+ queryInput.setLimit(100);
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+
+ if(CollectionUtils.nullSafeHasContents(queryOutput.getRecords()))
+ {
+ GeneralProcessUtils.addForeignRecordsListToRecordList(queryInput, queryOutput.getRecords(), "id", "scriptLogLine", "scriptLogId");
+ }
+
+ Map rs = new HashMap<>();
+ rs.put("scriptLogRecords", new ArrayList<>(queryOutput.getRecords()));
+
+ context.result(JsonUtils.toJson(rs));
+ }
+ catch(Exception e)
+ {
+ handleException(context, e);
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static void storeRecordAssociatedScript(Context context)
+ {
+ try
+ {
+ StoreAssociatedScriptInput input = new StoreAssociatedScriptInput(qInstance);
+ setupSession(context, input);
+ input.setCode(context.formParam("contents"));
+ input.setCommitMessage(context.formParam("commitMessage"));
+ input.setFieldName(context.pathParam("fieldName"));
+ input.setTableName(context.pathParam("table"));
+ input.setRecordPrimaryKey(context.pathParam("primaryKey"));
+
+ StoreAssociatedScriptOutput output = new StoreAssociatedScriptOutput();
+
+ StoreAssociatedScriptAction storeAssociatedScriptAction = new StoreAssociatedScriptAction();
+ storeAssociatedScriptAction.run(input, output);
+
+ context.result(JsonUtils.toJson("OK"));
+ }
+ catch(Exception e)
+ {
+ handleException(context, e);
+ }
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ private static void testAssociatedScript(Context context)
+ {
+ try
+ {
+ TestScriptInput input = new TestScriptInput(qInstance);
+ setupSession(context, input);
+ input.setTableName(context.pathParam("table"));
+ input.setRecordPrimaryKey(context.pathParam("primaryKey"));
+ // context.pathParam("fieldName");
+ Map inputValues = new HashMap<>();
+ input.setInputValues(inputValues);
+
+ for(Map.Entry> entry : context.formParamMap().entrySet())
+ {
+ String key = entry.getKey();
+ String value = entry.getValue().get(0);
+
+ if(key.equals("code"))
+ {
+ input.setCode(value);
+ }
+ else if(key.equals("scriptTypeId"))
+ {
+ input.setScriptTypeId(ValueUtils.getValueAsInteger(value));
+ }
+ else
+ {
+ inputValues.put(key, value);
+ }
+ }
+
+ TestScriptOutput output = new TestScriptOutput();
+
+ new TestScriptAction().run(input, output);
+
+ //////////////////////////////////////////////////////////////
+ // todo - output to frontend - then add assertions in test. //
+ //////////////////////////////////////////////////////////////
+
+ context.result(JsonUtils.toJson("OK"));
+ }
+ catch(Exception e)
+ {
+ handleException(context, e);
+ }
+ }
+
+
+
/*******************************************************************************
**
*******************************************************************************/
diff --git a/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementationTest.java b/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementationTest.java
index 07a37be7..df3bb744 100644
--- a/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementationTest.java
+++ b/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/QJavalinImplementationTest.java
@@ -26,9 +26,23 @@ import java.io.Serializable;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
+import java.util.List;
import java.util.Map;
+import com.kingsrook.qqq.backend.core.actions.tables.InsertAction;
+import com.kingsrook.qqq.backend.core.actions.tables.QueryAction;
+import com.kingsrook.qqq.backend.core.actions.tables.UpdateAction;
+import com.kingsrook.qqq.backend.core.exceptions.QException;
import com.kingsrook.qqq.backend.core.model.actions.reporting.ReportFormat;
+import com.kingsrook.qqq.backend.core.model.actions.tables.insert.InsertInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QCriteriaOperator;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QFilterCriteria;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QQueryFilter;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryInput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.query.QueryOutput;
+import com.kingsrook.qqq.backend.core.model.actions.tables.update.UpdateInput;
import com.kingsrook.qqq.backend.core.model.dashboard.widgets.WidgetType;
+import com.kingsrook.qqq.backend.core.model.data.QRecord;
+import com.kingsrook.qqq.backend.core.model.session.QSession;
import com.kingsrook.qqq.backend.core.utils.JsonUtils;
import kong.unirest.HttpResponse;
import kong.unirest.Unirest;
@@ -68,7 +82,7 @@ class QJavalinImplementationTest extends QJavalinTestBase
JSONObject jsonObject = JsonUtils.toJSONObject(response.getBody());
assertTrue(jsonObject.has("tables"));
JSONObject tables = jsonObject.getJSONObject("tables");
- assertEquals(1, tables.length());
+ assertEquals(6, tables.length()); // person + 5 script tables
JSONObject personTable = tables.getJSONObject("person");
assertTrue(personTable.has("name"));
assertEquals("person", personTable.getString("name"));
@@ -616,4 +630,135 @@ class QJavalinImplementationTest extends QJavalinTestBase
assertEquals(5, jsonObject.getJSONArray("options").getJSONObject(1).getInt("id"));
}
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testGetRecordDeveloperMode() throws QException
+ {
+ UpdateInput updateInput = new UpdateInput(TestUtils.defineInstance());
+ updateInput.setSession(new QSession());
+ updateInput.setTableName("person");
+ updateInput.setRecords(List.of(new QRecord().withValue("id", 1).withValue("testScriptId", 47)));
+ new UpdateAction().execute(updateInput);
+
+ InsertInput insertInput = new InsertInput(TestUtils.defineInstance());
+ insertInput.setSession(new QSession());
+ insertInput.setTableName("script");
+ insertInput.setRecords(List.of(new QRecord().withValue("id", 47).withValue("currentScriptRevisionId", 100)));
+ new InsertAction().execute(insertInput);
+
+ insertInput.setTableName("scriptRevision");
+ insertInput.setRecords(List.of(new QRecord().withValue("id", 1000).withValue("scriptId", 47).withValue("content", "var i;")));
+ new InsertAction().execute(insertInput);
+
+ HttpResponse response = Unirest.get(BASE_URL + "/data/person/1/developer").asString();
+ assertEquals(200, response.getStatus());
+ JSONObject jsonObject = JsonUtils.toJSONObject(response.getBody());
+ System.out.println(jsonObject.toString(3));
+ assertNotNull(jsonObject);
+ assertNotNull(jsonObject.getJSONObject("record"));
+ assertEquals("Darin", jsonObject.getJSONObject("record").getJSONObject("values").getString("firstName"));
+ assertEquals("Darin", jsonObject.getJSONObject("record").getJSONObject("displayValues").getString("firstName"));
+ assertNotNull(jsonObject.getJSONArray("associatedScripts"));
+ assertNotNull(jsonObject.getJSONArray("associatedScripts").getJSONObject(0));
+ assertNotNull(jsonObject.getJSONArray("associatedScripts").getJSONObject(0).getJSONArray("scriptRevisions"));
+ assertEquals("var i;", jsonObject.getJSONArray("associatedScripts").getJSONObject(0).getJSONArray("scriptRevisions").getJSONObject(0).getJSONObject("values").getString("content"));
+ assertNotNull(jsonObject.getJSONArray("associatedScripts").getJSONObject(0).getJSONObject("script"));
+ assertEquals(100, jsonObject.getJSONArray("associatedScripts").getJSONObject(0).getJSONObject("script").getJSONObject("values").getInt("currentScriptRevisionId"));
+ assertNotNull(jsonObject.getJSONArray("associatedScripts").getJSONObject(0).getJSONObject("associatedScript"));
+ assertEquals("testScriptId", jsonObject.getJSONArray("associatedScripts").getJSONObject(0).getJSONObject("associatedScript").getString("fieldName"));
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testStoreRecordAssociatedScript() throws QException
+ {
+ InsertInput insertInput = new InsertInput(TestUtils.defineInstance());
+ insertInput.setSession(new QSession());
+ insertInput.setTableName("scriptType");
+ insertInput.setRecords(List.of(new QRecord().withValue("id", 1).withValue("name", "Test")));
+ new InsertAction().execute(insertInput);
+
+ HttpResponse response = Unirest.post(BASE_URL + "/data/person/1/developer/associatedScript/testScriptId")
+ .field("contents", "var j = 0;")
+ .field("commitMessage", "Javalin Commit")
+ .asString();
+
+ QueryInput queryInput = new QueryInput(TestUtils.defineInstance());
+ queryInput.setSession(new QSession());
+ queryInput.setTableName("scriptRevision");
+ queryInput.setFilter(new QQueryFilter()
+ .withCriteria(new QFilterCriteria("contents", QCriteriaOperator.EQUALS, List.of("var j = 0;")))
+ .withCriteria(new QFilterCriteria("commitMessage", QCriteriaOperator.EQUALS, List.of("Javalin Commit")))
+ );
+ QueryOutput queryOutput = new QueryAction().execute(queryInput);
+ assertEquals(1, queryOutput.getRecords().size());
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testTestAssociatedScript() throws QException
+ {
+ InsertInput insertInput = new InsertInput(TestUtils.defineInstance());
+ insertInput.setSession(new QSession());
+ insertInput.setTableName("scriptType");
+ insertInput.setRecords(List.of(new QRecord().withValue("id", 1).withValue("name", "Test")));
+ new InsertAction().execute(insertInput);
+
+ HttpResponse response = Unirest.post(BASE_URL + "/data/person/1/developer/associatedScript/testScriptId/test")
+ .field("code", "var j = 0;")
+ .field("scriptTypeId", "1")
+ .field("x", "47")
+ .asString();
+
+ /////////////////////////////////////////
+ // todo - assertions after implemented //
+ /////////////////////////////////////////
+ }
+
+
+
+ /*******************************************************************************
+ **
+ *******************************************************************************/
+ @Test
+ void testGetAssociatedScriptLogs() throws QException
+ {
+ InsertInput insertInput = new InsertInput(TestUtils.defineInstance());
+ insertInput.setSession(new QSession());
+ insertInput.setTableName("scriptLog");
+ insertInput.setRecords(List.of(new QRecord().withValue("id", 1).withValue("output", "testOutput").withValue("scriptRevisionId", 100)));
+ new InsertAction().execute(insertInput);
+
+ insertInput.setTableName("scriptLogLine");
+ insertInput.setRecords(List.of(
+ new QRecord().withValue("scriptLogId", 1).withValue("text", "line one"),
+ new QRecord().withValue("scriptLogId", 1).withValue("text", "line two")
+ ));
+ new InsertAction().execute(insertInput);
+
+ HttpResponse response = Unirest.get(BASE_URL + "/data/person/1/developer/associatedScript/testScriptId/100/logs").asString();
+ assertEquals(200, response.getStatus());
+ JSONObject jsonObject = JsonUtils.toJSONObject(response.getBody());
+ assertNotNull(jsonObject.getJSONArray("scriptLogRecords"));
+ assertEquals(1, jsonObject.getJSONArray("scriptLogRecords").length());
+ assertNotNull(jsonObject.getJSONArray("scriptLogRecords").getJSONObject(0).getJSONObject("values"));
+ assertEquals("testOutput", jsonObject.getJSONArray("scriptLogRecords").getJSONObject(0).getJSONObject("values").getString("output"));
+ assertNotNull(jsonObject.getJSONArray("scriptLogRecords").getJSONObject(0).getJSONObject("values").getJSONArray("scriptLogLine"));
+ assertEquals(2, jsonObject.getJSONArray("scriptLogRecords").getJSONObject(0).getJSONObject("values").getJSONArray("scriptLogLine").length());
+ assertEquals("line one", jsonObject.getJSONArray("scriptLogRecords").getJSONObject(0).getJSONObject("values").getJSONArray("scriptLogLine").getJSONObject(0).getJSONObject("values").getString("text"));
+ assertEquals("line two", jsonObject.getJSONArray("scriptLogRecords").getJSONObject(0).getJSONObject("values").getJSONArray("scriptLogLine").getJSONObject(1).getJSONObject("values").getString("text"));
+ }
+
}
diff --git a/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/TestUtils.java b/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/TestUtils.java
index 98071fc7..1bf2a614 100644
--- a/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/TestUtils.java
+++ b/qqq-middleware-javalin/src/test/java/com/kingsrook/qqq/backend/javalin/TestUtils.java
@@ -31,6 +31,7 @@ import com.kingsrook.qqq.backend.core.exceptions.QValueException;
import com.kingsrook.qqq.backend.core.model.actions.processes.RunBackendStepInput;
import com.kingsrook.qqq.backend.core.model.actions.processes.RunBackendStepOutput;
import com.kingsrook.qqq.backend.core.model.metadata.QAuthenticationType;
+import com.kingsrook.qqq.backend.core.model.metadata.QBackendMetaData;
import com.kingsrook.qqq.backend.core.model.metadata.QInstance;
import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeReference;
import com.kingsrook.qqq.backend.core.model.metadata.code.QCodeType;
@@ -47,7 +48,9 @@ import com.kingsrook.qqq.backend.core.model.metadata.processes.QFunctionInputMet
import com.kingsrook.qqq.backend.core.model.metadata.processes.QFunctionOutputMetaData;
import com.kingsrook.qqq.backend.core.model.metadata.processes.QProcessMetaData;
import com.kingsrook.qqq.backend.core.model.metadata.processes.QRecordListMetaData;
+import com.kingsrook.qqq.backend.core.model.metadata.tables.AssociatedScript;
import com.kingsrook.qqq.backend.core.model.metadata.tables.QTableMetaData;
+import com.kingsrook.qqq.backend.core.model.scripts.ScriptsMetaDataProvider;
import com.kingsrook.qqq.backend.core.modules.authentication.metadata.QAuthenticationMetaData;
import com.kingsrook.qqq.backend.core.processes.implementations.mock.MockBackendStep;
import com.kingsrook.qqq.backend.module.rdbms.jdbc.ConnectionManager;
@@ -84,7 +87,7 @@ public class TestUtils
public static void primeTestDatabase() throws Exception
{
ConnectionManager connectionManager = new ConnectionManager();
- Connection connection = connectionManager.getConnection(TestUtils.defineBackend());
+ Connection connection = connectionManager.getConnection(TestUtils.defineDefaultH2Backend());
InputStream primeTestDatabaseSqlStream = TestUtils.class.getResourceAsStream("/prime-test-database.sql");
assertNotNull(primeTestDatabaseSqlStream);
List lines = (List) IOUtils.readLines(primeTestDatabaseSqlStream);
@@ -105,7 +108,7 @@ public class TestUtils
public static void runTestSql(String sql, QueryManager.ResultSetProcessor resultSetProcessor) throws Exception
{
ConnectionManager connectionManager = new ConnectionManager();
- Connection connection = connectionManager.getConnection(defineBackend());
+ Connection connection = connectionManager.getConnection(defineDefaultH2Backend());
QueryManager.executeStatement(connection, sql, resultSetProcessor);
}
@@ -119,7 +122,7 @@ public class TestUtils
{
QInstance qInstance = new QInstance();
qInstance.setAuthentication(defineAuthentication());
- qInstance.addBackend(defineBackend());
+ qInstance.addBackend(defineDefaultH2Backend());
qInstance.addTable(defineTablePerson());
qInstance.addProcess(defineProcessGreetPeople());
qInstance.addProcess(defineProcessGreetPeopleInteractive());
@@ -128,6 +131,17 @@ public class TestUtils
qInstance.addProcess(defineProcessSimpleThrow());
qInstance.addPossibleValueSource(definePossibleValueSourcePerson());
defineWidgets(qInstance);
+
+ qInstance.addBackend(defineMemoryBackend());
+ try
+ {
+ new ScriptsMetaDataProvider().defineStandardScriptsTables(qInstance, defineMemoryBackend().getName(), null);
+ }
+ catch(Exception e)
+ {
+ throw new IllegalStateException("Error adding script tables to instance");
+ }
+
return (qInstance);
}
@@ -162,7 +176,7 @@ public class TestUtils
** Define the h2 rdbms backend
**
*******************************************************************************/
- public static RDBMSBackendMetaData defineBackend()
+ public static RDBMSBackendMetaData defineDefaultH2Backend()
{
RDBMSBackendMetaData rdbmsBackendMetaData = new RDBMSBackendMetaData()
.withVendor("h2")
@@ -176,6 +190,19 @@ public class TestUtils
+ /*******************************************************************************
+ ** Define the memory-only backend
+ **
+ *******************************************************************************/
+ public static QBackendMetaData defineMemoryBackend()
+ {
+ return new QBackendMetaData()
+ .withBackendType("memory")
+ .withName("memory");
+ }
+
+
+
/*******************************************************************************
** Define the person table
**
@@ -187,7 +214,7 @@ public class TestUtils
.withLabel("Person")
.withRecordLabelFormat("%s %s")
.withRecordLabelFields("firstName", "lastName")
- .withBackendName(defineBackend().getName())
+ .withBackendName(defineDefaultH2Backend().getName())
.withPrimaryKeyField("id")
.withField(new QFieldMetaData("id", QFieldType.INTEGER))
.withField(new QFieldMetaData("createDate", QFieldType.DATE_TIME).withBackendName("create_date"))
@@ -196,7 +223,11 @@ public class TestUtils
.withField(new QFieldMetaData("lastName", QFieldType.STRING).withBackendName("last_name"))
.withField(new QFieldMetaData("birthDate", QFieldType.DATE).withBackendName("birth_date"))
.withField(new QFieldMetaData("partnerPersonId", QFieldType.INTEGER).withBackendName("partner_person_id").withPossibleValueSourceName("person"))
- .withField(new QFieldMetaData("email", QFieldType.STRING));
+ .withField(new QFieldMetaData("email", QFieldType.STRING))
+ .withField(new QFieldMetaData("testScriptId", QFieldType.INTEGER).withBackendName("test_script_id"))
+ .withAssociatedScript(new AssociatedScript()
+ .withFieldName("testScriptId")
+ .withScriptTypeId(1));
}
diff --git a/qqq-middleware-javalin/src/test/resources/prime-test-database.sql b/qqq-middleware-javalin/src/test/resources/prime-test-database.sql
index 22e88d10..c0a67766 100644
--- a/qqq-middleware-javalin/src/test/resources/prime-test-database.sql
+++ b/qqq-middleware-javalin/src/test/resources/prime-test-database.sql
@@ -30,7 +30,8 @@ CREATE TABLE person
last_name VARCHAR(80) NOT NULL,
birth_date DATE,
email VARCHAR(250) NOT NULL,
- partner_person_id INT
+ partner_person_id INT,
+ test_script_id INT
);
INSERT INTO person (id, first_name, last_name, birth_date, email) VALUES (1, 'Darin', 'Kelkhoff', '1980-05-31', 'darin.kelkhoff@gmail.com');