Safe Prediction Template

This template is used for querying the predictions
by the trained model.

Change-Id: If4389f52f281ed7a8bc0d08b448f8756196604d2
diff --git a/apps/aiplugin/api/src/main/java/org/onosproject/aiplugin/PredictionTemplate.java b/apps/aiplugin/api/src/main/java/org/onosproject/aiplugin/PredictionTemplate.java
new file mode 100644
index 0000000..493fe4a
--- /dev/null
+++ b/apps/aiplugin/api/src/main/java/org/onosproject/aiplugin/PredictionTemplate.java
@@ -0,0 +1,274 @@
+/*
+ * Copyright 2024-present Open Networking Foundation
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package aiplugin.api;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.fasterxml.jackson.databind.annotation.JsonPOJOBuilder;
+import com.google.common.base.MoreObjects;
+import com.google.common.base.Preconditions;
+
+/**
+ * Class representing a prediction template.
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonDeserialize(builder = PredictionTemplate.Builder.class)
+public final class PredictionTemplate {
+    private String templateVersion;
+    private String type;
+    private String id;
+    private String datasource;
+    private Selector selector;
+    private Group group;
+    private Sort sort;
+    private Condition condition;
+
+    /**
+     * Private constructor for the PredictionTemplate class.
+     *
+     * @param builder The Builder object providing field values.
+     */
+    private PredictionTemplate(Builder builder) {
+        this.templateVersion = builder.templateVersion;
+        this.type = builder.type;
+        this.id = builder.id;
+        this.datasource = builder.datasource;
+        this.selector = builder.selector;
+        this.group = builder.group;
+        this.sort = builder.sort;
+        this.condition = builder.condition;
+    }
+
+    /**
+     * Returns the template version.
+     *
+     * @return The template version as a string.
+     */
+    public String getTemplateVersion() {
+        return templateVersion;
+    }
+
+    /**
+     * Returns the type of template.
+     *
+     * @return The template type as a string.
+     */
+    public String getType() {
+        return type;
+    }
+
+    /**
+     * Returns the ID of the template.
+     *
+     * @return The template ID as a string.
+     */
+    public String getId() {
+        return id;
+    }
+
+    /**
+     * Returns the datasource for the template.
+     *
+     * @return The datasource as a string.
+     */
+    public String getDatasource() {
+        return datasource;
+    }
+
+    /**
+     * Returns the selector for the template.
+     *
+     * @return The selector object.
+     */
+    public Selector getSelector() {
+        return selector;
+    }
+
+    /**
+     * Returns the group for the template.
+     *
+     * @return The group object.
+     */
+    public Group getGroup() {
+        return group;
+    }
+
+    /**
+     * Returns the sort for the template.
+     *
+     * @return The sort object.
+     */
+    public Sort getSort() {
+        return sort;
+    }
+
+    /**
+     * Returns the condition for the template.
+     *
+     * @return The condition object.
+     */
+    public Condition getCondition() {
+        return condition;
+    }
+
+    /**
+     * Static method to create a new Builder instance.
+     *
+     * @return A new Builder for creating a PredictionTemplate instance.
+     */
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    /**
+     * Builder class for PredictionTemplate.
+     */
+    @JsonPOJOBuilder(withPrefix = "", buildMethodName = "build")
+    public static class Builder {
+        private String templateVersion;
+        private String type;
+        private String id;
+        private String datasource;
+        private Selector selector;
+        private Group group;
+        private Sort sort;
+        private Condition condition;
+
+        /**
+         * Sets the template version.
+         *
+         * @param templateVersion The template version as a string.
+         * @return The Builder instance.
+         */
+        public Builder templateVersion(String templateVersion) {
+            this.templateVersion = templateVersion;
+            return this;
+        }
+
+        /**
+         * Sets the template type.
+         *
+         * @param type The template type as a string.
+         * @return The Builder instance.
+         */
+        public Builder type(String type) {
+            this.type = type;
+            return this;
+        }
+
+        /**
+         * Sets the template ID.
+         *
+         * @param id The template ID as a string.
+         * @return The Builder instance.
+         */
+        public Builder id(String id) {
+            this.id = id;
+            return this;
+        }
+
+        /**
+         * Sets the datasource for the template.
+         *
+         * @param datasource The datasource as a string.
+         * @return The Builder instance.
+         */
+        public Builder datasource(String datasource) {
+            this.datasource = datasource;
+            return this;
+        }
+
+        /**
+         * Sets the selector for the template.
+         *
+         * @param selector The selector object.
+         * @return The Builder instance.
+         */
+        public Builder selector(Selector selector) {
+            this.selector = selector;
+            return this;
+        }
+
+        /**
+         * Sets the group for the template.
+         *
+         * @param group The group object.
+         * @return The Builder instance.
+         */
+        public Builder group(Group group) {
+            this.group = group;
+            return this;
+        }
+
+        /**
+         * Sets the sort for the template.
+         *
+         * @param sort The sort object.
+         * @return The Builder instance.
+         */
+        public Builder sort(Sort sort) {
+            this.sort = sort;
+            return this;
+        }
+
+        /**
+         * Sets the condition for the template.
+         *
+         * @param condition The condition object.
+         * @return The Builder instance.
+         */
+        public Builder condition(Condition condition) {
+            this.condition = condition;
+            return this;
+        }
+
+        /**
+         * Builds the PredictionTemplate instance.
+         * Before creating the PredictionTemplate, it checks that all required fields are not null.
+         *
+         * @return A new PredictionTemplate instance.
+         * @throws NullPointerException if any required field is null.
+         */
+        public PredictionTemplate build() {
+            Preconditions.checkNotNull(templateVersion, "Template version cannot be null");
+            Preconditions.checkNotNull(type, "Type cannot be null");
+            Preconditions.checkNotNull(datasource, "Datasource cannot be null");
+            Preconditions.checkNotNull(id, "Template ID cannot be null");
+            Preconditions.checkNotNull(selector, "Selector cannot be null");
+            return new PredictionTemplate(this);
+        }
+
+        /**
+         * Generates a string representation of the PredictionTemplate.
+         *
+         * @return A string representation of the PredictionTemplate.
+         */
+        @Override
+        public String toString() {
+            return MoreObjects.toStringHelper(this)
+                    .add("templateVersion", templateVersion)
+                    .add("type", type)
+                    .add("id", id)
+                    .add("datasource", datasource)
+                    .add("selector", selector)
+                    .add("group", group)
+                    .add("sort", sort)
+                    .add("condition", condition)
+                    .toString();
+        }
+    }
+}