This is an automated email from the ASF dual-hosted git repository.

gitgabrio pushed a commit to branch main
in repository 
https://gitbox.apache.org/repos/asf/incubator-kie-kogito-runtimes.git


The following commit(s) were added to refs/heads/main by this push:
     new 38f8c145cb [incubator-kie-issues#1500] Add javadoc to kogito 
properties (#3685)
38f8c145cb is described below

commit 38f8c145cbd5e129e6e0f45d8f79afd5048de602
Author: Gabriele Cardosi <[email protected]>
AuthorDate: Wed Oct 2 17:15:03 2024 +0200

    [incubator-kie-issues#1500] Add javadoc to kogito properties (#3685)
    
    * [incubator-kie-issues#1500] Add javadoc to kogito properties
    
    * [incubator-kie-issues#1450] Include CI hack inside 
kie-addons-quarkus-process-dynamic-integration-tests pom to avoid 
io.quarkus.bootstrap.BootstrapException: Failed to create the application model 
for 
org.kie:kie-addons-quarkus-process-dynamic-integration-tests::jar:999-SNAPSHOT 
error
    
    ---------
    
    Co-authored-by: Gabriele-Cardosi <[email protected]>
---
 .../java/org/kie/kogito/codegen/api/Generator.java |  3 +++
 .../kie/kogito/codegen/core/GeneratorConfig.java   |  3 +++
 .../kogito/codegen/decision/DecisionCodegen.java   | 29 ++++++++++++++++++++++
 .../process/persistence/PersistenceGenerator.java  |  9 +++++++
 .../codegen/rules/config/NamedRuleUnitConfig.java  |  9 +++++++
 .../WorkflowOperationIdFactoryProvider.java        |  8 ++++++
 quarkus/addons/dynamic/integration-tests/pom.xml   | 14 +++++++++++
 .../quarkus/workflow/KogitoBeanProducer.java       |  5 ++++
 8 files changed, 80 insertions(+)

diff --git 
a/kogito-codegen-modules/kogito-codegen-api/src/main/java/org/kie/kogito/codegen/api/Generator.java
 
b/kogito-codegen-modules/kogito-codegen-api/src/main/java/org/kie/kogito/codegen/api/Generator.java
index fdb95496a7..ac62d78117 100644
--- 
a/kogito-codegen-modules/kogito-codegen-api/src/main/java/org/kie/kogito/codegen/api/Generator.java
+++ 
b/kogito-codegen-modules/kogito-codegen-api/src/main/java/org/kie/kogito/codegen/api/Generator.java
@@ -33,6 +33,9 @@ public interface Generator {
     GeneratedFileType REST_TYPE = GeneratedFileType.of("REST", 
GeneratedFileType.Category.SOURCE, true, true);
     GeneratedFileType MODEL_TYPE = GeneratedFileType.of("MODEL", 
GeneratedFileType.Category.SOURCE, true, true);
 
+    /**
+     * kogito.codegen.(engine_name) -> (boolean) enable/disable engine code 
generation (default true)
+     */
     String CONFIG_PREFIX = "kogito.codegen.";
 
     /**
diff --git 
a/kogito-codegen-modules/kogito-codegen-core/src/main/java/org/kie/kogito/codegen/core/GeneratorConfig.java
 
b/kogito-codegen-modules/kogito-codegen-core/src/main/java/org/kie/kogito/codegen/core/GeneratorConfig.java
index 6886ccc49f..31f813356f 100644
--- 
a/kogito-codegen-modules/kogito-codegen-core/src/main/java/org/kie/kogito/codegen/core/GeneratorConfig.java
+++ 
b/kogito-codegen-modules/kogito-codegen-core/src/main/java/org/kie/kogito/codegen/core/GeneratorConfig.java
@@ -23,6 +23,9 @@ package org.kie.kogito.codegen.core;
  */
 public class GeneratorConfig {
 
+    /**
+     * the type of generated rest (currently used only by processes); possible 
values: reactive; (default is empty)
+     */
     public static final String KOGITO_REST_RESOURCE_TYPE_PROP = 
"kogito.rest.resource.type";
 
     private GeneratorConfig() {
diff --git 
a/kogito-codegen-modules/kogito-codegen-decisions/src/main/java/org/kie/kogito/codegen/decision/DecisionCodegen.java
 
b/kogito-codegen-modules/kogito-codegen-decisions/src/main/java/org/kie/kogito/codegen/decision/DecisionCodegen.java
index b0944b5409..757bd5caf0 100644
--- 
a/kogito-codegen-modules/kogito-codegen-decisions/src/main/java/org/kie/kogito/codegen/decision/DecisionCodegen.java
+++ 
b/kogito-codegen-modules/kogito-codegen-decisions/src/main/java/org/kie/kogito/codegen/decision/DecisionCodegen.java
@@ -72,9 +72,38 @@ public class DecisionCodegen extends AbstractGenerator {
     public static final Logger LOGGER = 
LoggerFactory.getLogger(DecisionCodegen.class);
     public static final String GENERATOR_NAME = "decisions";
 
+    /**
+     *  (boolean) generate java classes to support strongly typed input 
(default false)
+     */
     public static String STRONGLY_TYPED_CONFIGURATION_KEY = 
"kogito.decisions.stronglytyped";
+    /**
+     * model validation strategy; possible values: ENABLED, DISABLED, IGNORE; 
(default ENABLED)
+     */
     public static String VALIDATION_CONFIGURATION_KEY = 
"kogito.decisions.validation";
 
+    /**
+     * (string) kafka bootstrap server address
+     */
+    public static final String 
KOGITO_ADDON_TRACING_DECISION_KAFKA_BOOTSTRAPADDRESS = 
"kogito.addon.tracing.decision.kafka.bootstrapAddress";
+    /**
+     * (string) name of the decision topic; default to kogito-tracing-decision
+     */
+    public static final String KOGITO_ADDON_TRACING_DECISION_KAFKA_TOPIC_NAME 
= "kogito.addon.tracing.decision.kafka.topic.name";
+    /**
+     * (integer) number of decision topic partitions; default to 1
+     */
+    public static final String 
KOGITO_ADDON_TRACING_DECISION_KAFKA_TOPIC_PARTITIONS = 
"kogito.addon.tracing.decision.kafka.topic.partitions";
+
+    /**
+     * (integer) number of decision topic replication factor; default to 1
+     */
+    public static final String 
KOGITO_ADDON_TRACING_DECISION_KAFKA_TOPIC_REPLICATION_FACTOR = 
"kogito.addon.tracing.decision.kafka.topic.replicationFactor";
+
+    /**
+     * (boolean) enable/disable asynchronous collection of decision events; 
default to true
+     */
+    public static final String KOGITO_ADDON_TRACING_DECISION_ASYNC_ENABLED = 
"kogito.addon.tracing.decision.asyncEnabled";
+
     public static DecisionCodegen ofCollectedResources(KogitoBuildContext 
context, Collection<CollectedResource> resources) {
         OASFactoryResolver.instance(); // manually invoke SPI, o/w Kogito 
CodeGen Kogito Quarkus extension failure at NewFileHotReloadTest due to 
java.util.ServiceConfigurationError: 
org.eclipse.microprofile.openapi.spi.OASFactoryResolver: 
io.smallrye.openapi.spi.OASFactoryResolverImpl not a subtype
         List<CollectedResource> dmnResources = resources.stream()
diff --git 
a/kogito-codegen-modules/kogito-codegen-processes/src/main/java/org/kie/kogito/codegen/process/persistence/PersistenceGenerator.java
 
b/kogito-codegen-modules/kogito-codegen-processes/src/main/java/org/kie/kogito/codegen/process/persistence/PersistenceGenerator.java
index 55f40fcf6b..7a46969720 100644
--- 
a/kogito-codegen-modules/kogito-codegen-processes/src/main/java/org/kie/kogito/codegen/process/persistence/PersistenceGenerator.java
+++ 
b/kogito-codegen-modules/kogito-codegen-processes/src/main/java/org/kie/kogito/codegen/process/persistence/PersistenceGenerator.java
@@ -77,10 +77,19 @@ public class PersistenceGenerator extends AbstractGenerator 
{
      * Kogito persistence properties
      */
     // Generic
+    /**
+     * (boolean) enable/disable proto generation for DATA-INDEX; default to 
true
+     */
     public static final String KOGITO_PERSISTENCE_DATA_INDEX_PROTO_GENERATION 
= "kogito.persistence.data-index.proto.generation";
     public static final String 
KOGITO_PERSISTENCE_DATA_INDEX_PROTO_GENERATION_DEFAULT = "true";
+    /**
+     * (boolean) enable/disable proto marshaller generation; default to true
+     */
     public static final String KOGITO_PERSISTENCE_PROTO_MARSHALLER = 
"kogito.persistence.proto.marshaller";
     public static final String KOGITO_PERSISTENCE_PROTO_MARSHALLER_DEFAULT = 
"true";
+    /**
+     * (string) kind of persistence used; possible values: filesystem, 
infinispan, mongodb, postgresql, kafka, jdbc; default to infinispan
+     */
     public static final String KOGITO_PERSISTENCE_TYPE = 
"kogito.persistence.type";
 
     /**
diff --git 
a/kogito-codegen-modules/kogito-codegen-rules/src/main/java/org/kie/kogito/codegen/rules/config/NamedRuleUnitConfig.java
 
b/kogito-codegen-modules/kogito-codegen-rules/src/main/java/org/kie/kogito/codegen/rules/config/NamedRuleUnitConfig.java
index d655bf1838..f0d0851917 100644
--- 
a/kogito-codegen-modules/kogito-codegen-rules/src/main/java/org/kie/kogito/codegen/rules/config/NamedRuleUnitConfig.java
+++ 
b/kogito-codegen-modules/kogito-codegen-rules/src/main/java/org/kie/kogito/codegen/rules/config/NamedRuleUnitConfig.java
@@ -31,8 +31,17 @@ import org.kie.kogito.rules.RuleUnitConfig;
 public final class NamedRuleUnitConfig {
 
     private static String CONFIG_PREFIX = "kogito.rules.";
+    /**
+     * (string) kind of event processing type for a given rule-unit; possible 
values: CLOUD, STREAM; default is null
+     */
     private static String CONFIG_EVENT_PROCESSING_TYPE = CONFIG_PREFIX + 
"\"%s\".event-processing-type";
+    /**
+     * (string) kind of event clock type for a given rule-unit; possible 
values: PSEUDO, REALTIME; default is null
+     */
     private static String CONFIG_CLOCK_TYPE = CONFIG_PREFIX + 
"\"%s\".clock-type";
+    /**
+     * (integer) size of session poolfor a given rule-unit; possible values; 
default is null
+     */
     private static String CONFIG_SESSIONS_POOL = CONFIG_PREFIX + 
"\"%s\".sessions-pool";
 
     public static List<NamedRuleUnitConfig> fromContext(KogitoBuildContext 
context) {
diff --git 
a/kogito-serverless-workflow/kogito-serverless-workflow-builder/src/main/java/org/kie/kogito/serverless/workflow/operationid/WorkflowOperationIdFactoryProvider.java
 
b/kogito-serverless-workflow/kogito-serverless-workflow-builder/src/main/java/org/kie/kogito/serverless/workflow/operationid/WorkflowOperationIdFactoryProvider.java
index af53cc1a0a..ec17685447 100644
--- 
a/kogito-serverless-workflow/kogito-serverless-workflow-builder/src/main/java/org/kie/kogito/serverless/workflow/operationid/WorkflowOperationIdFactoryProvider.java
+++ 
b/kogito-serverless-workflow/kogito-serverless-workflow-builder/src/main/java/org/kie/kogito/serverless/workflow/operationid/WorkflowOperationIdFactoryProvider.java
@@ -25,6 +25,14 @@ import java.util.ServiceLoader;
 
 public class WorkflowOperationIdFactoryProvider {
 
+    /**
+     * (string) strategy for generating the configuration key of open API 
specifications; possible values are:
+     * file_name: uses the last element of the spec uri
+     * full_uri: uses the full path of the uri
+     * spec_title: uses the spec title
+     * function_name: uses the function name
+     *
+     */
     public static final String PROPERTY_NAME = "kogito.sw.operationIdStrategy";
 
     private static final Map<String, WorkflowOperationIdFactory> operationIds 
= new HashMap<>();
diff --git a/quarkus/addons/dynamic/integration-tests/pom.xml 
b/quarkus/addons/dynamic/integration-tests/pom.xml
index 4fe89ac815..7109502889 100644
--- a/quarkus/addons/dynamic/integration-tests/pom.xml
+++ b/quarkus/addons/dynamic/integration-tests/pom.xml
@@ -41,6 +41,20 @@
       <artifactId>rest-assured</artifactId>
       <scope>test</scope>
     </dependency>
+    <!-- hack for CI to work -->
+    <dependency>
+      <groupId>org.apache.kie.sonataflow</groupId>
+      <artifactId>sonataflow-quarkus-deployment</artifactId>
+      <version>${project.version}</version>
+      <type>pom</type>
+      <scope>test</scope>
+      <exclusions>
+        <exclusion>
+          <groupId>*</groupId>
+          <artifactId>*</artifactId>
+        </exclusion>
+      </exclusions>
+    </dependency>
   </dependencies>
 
   <build>
diff --git 
a/quarkus/extensions/kogito-quarkus-workflow-extension-common/kogito-quarkus-workflow-common/src/main/java/org/kie/kogito/quarkus/workflow/KogitoBeanProducer.java
 
b/quarkus/extensions/kogito-quarkus-workflow-extension-common/kogito-quarkus-workflow-common/src/main/java/org/kie/kogito/quarkus/workflow/KogitoBeanProducer.java
index ea7fe04f78..7b282dc8f9 100644
--- 
a/quarkus/extensions/kogito-quarkus-workflow-extension-common/kogito-quarkus-workflow-common/src/main/java/org/kie/kogito/quarkus/workflow/KogitoBeanProducer.java
+++ 
b/quarkus/extensions/kogito-quarkus-workflow-extension-common/kogito-quarkus-workflow-common/src/main/java/org/kie/kogito/quarkus/workflow/KogitoBeanProducer.java
@@ -42,6 +42,11 @@ import jakarta.enterprise.inject.Produces;
 @ApplicationScoped
 public class KogitoBeanProducer {
 
+    /**
+     * (string) strategy to resolve a Process version to use; possible values: 
project, workflow; if "project", requires project GAV; default is workflow
+     */
+    public static final String KOGITO_WORKFLOW_VERSION_STRATEGY = 
"kogito.workflow.version-strategy";
+
     @DefaultBean
     @Produces
     CorrelationService correlationService() {


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to