From eafa82eb85aed2b9aec8f8b659efe8f9f251cef4 Mon Sep 17 00:00:00 2001 From: Darin Kelkhoff Date: Tue, 7 Mar 2023 15:14:15 -0600 Subject: [PATCH] initial checkin --- .../core/model/automation/TableTrigger.java | 392 ++++++++++++++++++ .../scripts/RunRecordScriptExtractStep.java | 59 +++ .../scripts/RunRecordScriptLoadStep.java | 51 +++ 3 files changed, 502 insertions(+) create mode 100644 qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/automation/TableTrigger.java create mode 100644 qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptExtractStep.java create mode 100644 qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptLoadStep.java diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/automation/TableTrigger.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/automation/TableTrigger.java new file mode 100644 index 00000000..a21aedf0 --- /dev/null +++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/model/automation/TableTrigger.java @@ -0,0 +1,392 @@ +/* + * QQQ - Low-code Application Framework for Engineers. + * Copyright (C) 2021-2023. 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.automation; + + +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; +import com.kingsrook.qqq.backend.core.model.metadata.tables.TablesPossibleValueSourceMetaDataProvider; +import com.kingsrook.qqq.backend.core.model.scripts.Script; + + +/******************************************************************************* + ** Definition of in-app/user/data-defined triggers (aka, automations). + *******************************************************************************/ +public class TableTrigger extends QRecordEntity +{ + public static final String TABLE_NAME = "tableTrigger"; + + @QField(isEditable = false) + private Integer id; + + @QField(isEditable = false) + private Instant createDate; + + @QField(isEditable = false) + private Instant modifyDate; + + @QField(possibleValueSourceName = TablesPossibleValueSourceMetaDataProvider.NAME) + private String tableName; + + @QField(/* todo possibleValueSourceName = */) + private Integer filterId; + + @QField(possibleValueSourceName = Script.TABLE_NAME) + private Integer scriptId; + + @QField() + private Integer priority; + + @QField() + private Boolean postInsert; + + @QField() + private Boolean postUpdate; + + + + /******************************************************************************* + ** Constructor + ** + *******************************************************************************/ + public TableTrigger() + { + } + + + + /******************************************************************************* + ** Constructor + ** + *******************************************************************************/ + public TableTrigger(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 TableTrigger 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 TableTrigger 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 TableTrigger withModifyDate(Instant modifyDate) + { + this.modifyDate = modifyDate; + return (this); + } + + + + /******************************************************************************* + ** Getter for tableName + ** + *******************************************************************************/ + public String getTableName() + { + return tableName; + } + + + + /******************************************************************************* + ** Setter for tableName + ** + *******************************************************************************/ + public void setTableName(String tableName) + { + this.tableName = tableName; + } + + + + /******************************************************************************* + ** Fluent setter for tableName + ** + *******************************************************************************/ + public TableTrigger withTableName(String tableName) + { + this.tableName = tableName; + return (this); + } + + + + /******************************************************************************* + ** Getter for filterId + ** + *******************************************************************************/ + public Integer getFilterId() + { + return filterId; + } + + + + /******************************************************************************* + ** Setter for filterId + ** + *******************************************************************************/ + public void setFilterId(Integer filterId) + { + this.filterId = filterId; + } + + + + /******************************************************************************* + ** Fluent setter for filterId + ** + *******************************************************************************/ + public TableTrigger withFilterId(Integer filterId) + { + this.filterId = filterId; + 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 TableTrigger withScriptId(Integer scriptId) + { + this.scriptId = scriptId; + return (this); + } + + + + /******************************************************************************* + ** Getter for postInsert + ** + *******************************************************************************/ + public Boolean getPostInsert() + { + return postInsert; + } + + + + /******************************************************************************* + ** Setter for postInsert + ** + *******************************************************************************/ + public void setPostInsert(Boolean postInsert) + { + this.postInsert = postInsert; + } + + + + /******************************************************************************* + ** Fluent setter for postInsert + ** + *******************************************************************************/ + public TableTrigger withPostInsert(Boolean postInsert) + { + this.postInsert = postInsert; + return (this); + } + + + + /******************************************************************************* + ** Getter for postUpdate + ** + *******************************************************************************/ + public Boolean getPostUpdate() + { + return postUpdate; + } + + + + /******************************************************************************* + ** Setter for postUpdate + ** + *******************************************************************************/ + public void setPostUpdate(Boolean postUpdate) + { + this.postUpdate = postUpdate; + } + + + + /******************************************************************************* + ** Fluent setter for postUpdate + ** + *******************************************************************************/ + public TableTrigger withPostUpdate(Boolean postUpdate) + { + this.postUpdate = postUpdate; + return (this); + } + + + + /******************************************************************************* + ** Getter for priority + *******************************************************************************/ + public Integer getPriority() + { + return (this.priority); + } + + + + /******************************************************************************* + ** Setter for priority + *******************************************************************************/ + public void setPriority(Integer priority) + { + this.priority = priority; + } + + + + /******************************************************************************* + ** Fluent setter for priority + *******************************************************************************/ + public TableTrigger withPriority(Integer priority) + { + this.priority = priority; + return (this); + } + +} diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptExtractStep.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptExtractStep.java new file mode 100644 index 00000000..227611f9 --- /dev/null +++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptExtractStep.java @@ -0,0 +1,59 @@ +/* + * QQQ - Low-code Application Framework for Engineers. + * Copyright (C) 2021-2023. 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.implementations.scripts; + + +import com.kingsrook.qqq.backend.core.exceptions.QException; +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.processes.implementations.etl.streamedwithfrontend.ExtractViaQueryStep; +import com.kingsrook.qqq.backend.core.utils.StringUtils; + + +/******************************************************************************* + ** Extract step for the run-record process. Exists only to deal with this being + ** a generic process (e.g., no table name defined in the meta data). + *******************************************************************************/ +public class RunRecordScriptExtractStep extends ExtractViaQueryStep +{ + + /******************************************************************************* + ** + *******************************************************************************/ + @Override + public void preRun(RunBackendStepInput runBackendStepInput, RunBackendStepOutput runBackendStepOutput) throws QException + { + //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// + // this is a generic (e.g., not table-specific) process - so we must be sure to set the tableName field in the expected slot. // + //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// + String tableName = runBackendStepInput.getValueString("tableName"); + if(!StringUtils.hasContent(tableName)) + { + throw (new QException("Table name was not specified as input value")); + } + + runBackendStepInput.addValue(FIELD_SOURCE_TABLE, tableName); + + super.preRun(runBackendStepInput, runBackendStepOutput); + } + +} diff --git a/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptLoadStep.java b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptLoadStep.java new file mode 100644 index 00000000..598f20fb --- /dev/null +++ b/qqq-backend-core/src/main/java/com/kingsrook/qqq/backend/core/processes/implementations/scripts/RunRecordScriptLoadStep.java @@ -0,0 +1,51 @@ +/* + * QQQ - Low-code Application Framework for Engineers. + * Copyright (C) 2021-2023. 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.implementations.scripts; + + +import com.kingsrook.qqq.backend.core.actions.scripts.RunAdHocRecordScriptAction; +import com.kingsrook.qqq.backend.core.exceptions.QException; +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.actions.scripts.RunAdHocRecordScriptInput; +import com.kingsrook.qqq.backend.core.model.actions.scripts.RunAdHocRecordScriptOutput; +import com.kingsrook.qqq.backend.core.model.metadata.code.AdHocScriptCodeReference; +import com.kingsrook.qqq.backend.core.processes.implementations.etl.streamedwithfrontend.AbstractLoadStep; + + +/******************************************************************************* + ** Load step for the runRecordScript process - runs the script on a page of records + *******************************************************************************/ +public class RunRecordScriptLoadStep extends AbstractLoadStep +{ + @Override + public void run(RunBackendStepInput runBackendStepInput, RunBackendStepOutput runBackendStepOutput) throws QException + { + runBackendStepInput.getAsyncJobCallback().updateStatus("Running script"); + + RunAdHocRecordScriptInput input = new RunAdHocRecordScriptInput(); + input.setRecordList(runBackendStepInput.getRecords()); + input.setCodeReference(new AdHocScriptCodeReference().withScriptId(runBackendStepInput.getValueInteger("scriptId"))); + RunAdHocRecordScriptOutput output = new RunAdHocRecordScriptOutput(); + new RunAdHocRecordScriptAction().run(input, output); + } +}