Codestarts as default codegen

- Codestarts which only works alone are called "Singleton"
- Added checks to avoid conflict between Singelton codestarts
- Make codestart the default codegen and add a `legacyCodegen` flag
- Update the guides for compat by adding `resteasy` when relevent

Fixes #quarkusio#12113

devtools/cli/src/main/java/io/quarkus/cli/Create.java

@@ -115,7 +115,6 @@ else if (targetBuildTool.gradleKotlinDsl)
                             .version(version)
                             .sourceType(sourceType)
                             .extensions(extensions)
-                            .codestartsEnabled(true)
                             .noExamples(noExamples)
                             .execute().isSuccess();
 

devtools/maven/src/main/java/io/quarkus/maven/CreateProjectMojo.java

@@ -74,8 +74,8 @@ public class CreateProjectMojo extends AbstractMojo {
     @Parameter(property = "projectVersion")
     private String projectVersion;
 
-    @Parameter(property = "codestartsEnabled", defaultValue = "false")
-    private boolean codestartsEnabled;
+    @Parameter(property = "legacyCodegen", defaultValue = "false")
+    private boolean legacyCodegen;
 
     @Parameter(property = "noExamples", defaultValue = "false")
     private boolean noExamples;
@@ -195,15 +195,15 @@ public void execute() throws MojoExecutionException {
                     .sourceType(sourceType)
                     .className(className)
                     .extensions(extensions)
-                    .codestartsEnabled(codestartsEnabled)
+                    .legacyCodegen(legacyCodegen)
                     .noExamples(noExamples);
             if (path != null) {
                 createProject.setValue("path", path);
             }
 
             success = createProject.execute().isSuccess();
 
-            if (!codestartsEnabled) {
+            if (legacyCodegen) {
                 File createdDependenciesBuildFile = new File(projectRoot, buildToolEnum.getDependenciesFile());
                 if (BuildTool.MAVEN.equals(buildToolEnum)) {
                     createMavenWrapper(createdDependenciesBuildFile, ToolsUtils.readQuarkusProperties(platform));

devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/advanced-examples/amazon-lambda-example/codestart.yml → devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/singleton-examples/amazon-lambda-example/codestart.yml

@@ -3,7 +3,7 @@ ref: amazon-lambda
 type: code
 tags:
   - example
-  - compatibility-issues
+  - singleton-example
 language:
   base:
     shared-data:

devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/advanced-examples/azure-functions-http-example/codestart.yml → devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/singleton-examples/azure-functions-http-example/codestart.yml

@@ -3,7 +3,7 @@ ref: azure-functions-http
 type: code
 tags:
   - example
-  - compatibility-issues
+  - singleton-example
   - maven-only
 language:
   base:

devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/advanced-examples/funqy-amazon-lambda-example/codestart.yml → devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/singleton-examples/funqy-amazon-lambda-example/codestart.yml

@@ -3,7 +3,7 @@ ref: funqy-amazon-lambda
 type: code
 tags:
   - example
-  - compatibility-issues
+  - singleton-example
 language:
   base:
     shared-data:

devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/advanced-examples/funqy-knative-events-example/codestart.yml → devtools/platform-descriptor-json/src/main/resources/codestarts/quarkus/singleton-examples/funqy-knative-events-example/codestart.yml

@@ -3,7 +3,7 @@ ref: funqy-knative-events
 type: code
 tags:
   - example
-  - compatibility-issues
+  - singleton-example
 language:
   base:
     data:

docs/src/main/asciidoc/amazon-dynamodb.adoc

@@ -105,7 +105,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=amazon-dynamodb-quickstart \
     -DclassName="org.acme.dynamodb.FruitResource" \
     -Dpath="/fruits" \
-    -Dextensions="resteasy-jsonb,amazon-dynamodb,resteasy-mutiny"
+    -Dextensions="resteasy,resteasy-jsonb,amazon-dynamodb,resteasy-mutiny"
 cd amazon-dynamodb-quickstart
 ----
 

docs/src/main/asciidoc/amazon-kms.adoc

@@ -97,7 +97,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=amazon-kms-quickstart \
     -DclassName="org.acme.kms.QuarkusKmsSyncResource" \
     -Dpath="/sync" \
-    -Dextensions="resteasy-jsonb,amazon-kms,resteasy-mutiny"
+    -Dextensions="resteasy,resteasy-jsonb,amazon-kms,resteasy-mutiny"
 cd amazon-kms-quickstart
 ----
 

docs/src/main/asciidoc/amazon-s3.adoc

@@ -86,7 +86,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=amazon-s3-quickstart \
     -DclassName="org.acme.s3.S3SyncClientResource" \
     -Dpath="/s3" \
-    -Dextensions="resteasy-jsonb,amazon-s3"
+    -Dextensions="resteasy,resteasy-jsonb,amazon-s3"
 cd amazon-s3-quickstart
 ----
 

docs/src/main/asciidoc/amazon-ses.adoc

@@ -106,7 +106,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=amazon-ses-quickstart \
     -DclassName="org.acme.ses.QuarkusSesSyncResource" \
     -Dpath="/sync" \
-    -Dextensions="resteasy-jsonb,amazon-ses,resteasy-mutiny"
+    -Dextensions="resteasy,resteasy-jsonb,amazon-ses,resteasy-mutiny"
 cd amazon-ses-quickstart
 ----
 

docs/src/main/asciidoc/amazon-sns.adoc

@@ -94,7 +94,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=amazon-sns-quickstart \
     -DclassName="org.acme.sns.QuarksCannonSyncResource" \
     -Dpath="/sync-cannon" \
-    -Dextensions="resteasy-jsonb,amazon-sns,resteasy-mutiny"
+    -Dextensions="resteasy,resteasy-jsonb,amazon-sns,resteasy-mutiny"
 cd amazon-sns-quickstart
 ----
 

docs/src/main/asciidoc/amazon-sqs.adoc

@@ -95,7 +95,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=amazon-sqs-quickstart \
     -DclassName="org.acme.sqs.QuarksCannonSyncResource" \
     -Dpath="/sync-cannon" \
-    -Dextensions="resteasy-jsonb,amazon-sqs,resteasy-mutiny"
+    -Dextensions="resteasy,resteasy-jsonb,amazon-sqs,resteasy-mutiny"
 cd amazon-sqs-quickstart
 ----
 

docs/src/main/asciidoc/building-my-first-extension.adoc

@@ -740,7 +740,7 @@ $mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
      -DprojectGroupId=org.acme \
      -DprojectArtifactId=greeting-app \
      -DprojectVersion=1.0-SNAPSHOT \
-     -DclassName=HelloResource
+     -DnoExamples
 ----
 
 `cd` into `greeting-app` and add the dependency on `quarkus-greeting` extension we created above.

docs/src/main/asciidoc/cache.adoc

@@ -49,7 +49,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=cache-quickstart \
     -DclassName="org.acme.cache.WeatherForecastResource" \
     -Dpath="/weather" \
-    -Dextensions="cache,resteasy-jsonb"
+    -Dextensions="cache,resteasy,resteasy-jsonb"
 ----
 
 This command generates the Maven project with a REST endpoint and imports the `cache` and `resteasy-jsonb` extensions.

docs/src/main/asciidoc/centralized-log-management.adoc

@@ -30,7 +30,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=gelf-logging \
     -DclassName="org.acme.quickstart.GelfLoggingResource" \
     -Dpath="/gelf-logging" \
-    -Dextensions="logging-gelf"
+    -Dextensions="resteasty,logging-gelf"
 ----
 
 If you already have your Quarkus project configured, you can add the `logging-gelf` extension

docs/src/main/asciidoc/config.adoc

@@ -39,6 +39,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=config-quickstart \
     -DclassName="org.acme.config.GreetingResource" \
     -Dpath="/greeting"
+    -Dextensions="resteasty"
 cd config-quickstart
 ----
 

docs/src/main/asciidoc/consul-config.adoc

@@ -53,7 +53,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=consul-config-quickstart \
     -DclassName="org.acme.consul.config.GreetingResource" \
     -Dpath="/greeting" \
-    -Dextensions="consul-config"
+    -Dextensions="resteasy,consul-config"
 cd consul-config-quickstart
 ----
 

docs/src/main/asciidoc/deploying-to-kubernetes.adoc

@@ -34,7 +34,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=kubernetes-quickstart \
     -DclassName="org.acme.rest.GreetingResource" \
     -Dpath="/greeting" \
-    -Dextensions="kubernetes, jib"
+    -Dextensions="resteasy,kubernetes,jib"
 cd kubernetes-quickstart
 ----
 

docs/src/main/asciidoc/deploying-to-openshift.adoc

@@ -32,7 +32,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=openshift-quickstart \
     -DclassName="org.acme.rest.GreetingResource" \
     -Dpath="/greeting" \
-    -Dextensions="openshift"
+    -Dextensions="resteasy,openshift"
 
 cd openshift-quickstart
 ----

docs/src/main/asciidoc/elasticsearch.adoc

@@ -56,7 +56,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=elasticsearch-quickstart \
     -DclassName="org.acme.elasticsearch.FruitResource" \
     -Dpath="/fruits" \
-    -Dextensions="resteasy-jackson,elasticsearch-rest-client"
+    -Dextensions="resteasy,resteasy-jackson,elasticsearch-rest-client"
 cd elasticsearch-quickstart
 ----
 

docs/src/main/asciidoc/funqy-gcp-functions.adoc

@@ -58,7 +58,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=funqy-google-cloud-functions \
     -DclassName="org.acme.quickstart.GreetingResource" \
     -Dpath="/hello" \
-    -Dextensions="funqy-google-cloud-functions"
+    -Dextensions="resteasy,funqy-google-cloud-functions"
 ----
 
 Now, let's remove what's not needed inside the generated application:

docs/src/main/asciidoc/gcp-functions-http.adoc

@@ -51,7 +51,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=google-cloud-functions-http \
     -DclassName="org.acme.quickstart.GreetingResource" \
     -Dpath="/hello" \
-    -Dextensions="google-cloud-functions-http,resteasy-json,undertow,vertx-web,funqy-http"
+    -Dextensions="resteasy,google-cloud-functions-http,resteasy-json,undertow,vertx-web,funqy-http"
 ----
 
 == Login to Google Cloud

docs/src/main/asciidoc/gcp-functions.adoc

@@ -49,7 +49,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=google-cloud-functions \
     -DclassName="org.acme.quickstart.GreetingResource" \
     -Dpath="/hello" \
-    -Dextensions="google-cloud-functions"
+    -Dextensions="resteasy,google-cloud-functions"
 ----
 
 Now, let's remove what's not needed inside the generated application:

docs/src/main/asciidoc/getting-started-reactive.adoc

@@ -171,7 +171,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=getting-started-reactive \
     -DclassName="org.acme.quickstart.ReactiveGreetingResource" \
     -Dpath="/hello" \
-    -Dextensions="resteasy-mutiny, resteasy-jsonb"
+    -Dextensions="resteasy,resteasy-mutiny,resteasy-jsonb"
 cd getting-started-reactive
 ----
 
@@ -181,14 +181,14 @@ For Windows users
 
 [source,shell,subs=attributes+]
 ----
-mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create -DprojectGroupId=org.acme -DprojectArtifactId=getting-started-reactive -DclassName="org.acme.quickstart.ReactiveGreetingResource" -Dpath="/hello" -Dextensions="resteasy-mutiny,resteasy-jsonb"
+mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create -DprojectGroupId=org.acme -DprojectArtifactId=getting-started-reactive -DclassName="org.acme.quickstart.ReactiveGreetingResource" -Dpath="/hello" -Dextensions="resteasy,resteasy-mutiny,resteasy-jsonb"
 ----
 
 - If using Powershell, wrap `-D` parameters in double quotes
 
 [source,shell,subs=attributes+]
 ----
-mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create "-DprojectGroupId=org.acme" "-DprojectArtifactId=getting-started-reactive" "-DclassName=org.acme.quickstart.ReactiveGreetingResource" "-Dpath=/hello" "-Dextensions=resteasy-mutiny,resteasy-jsonb"
+mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create "-DprojectGroupId=org.acme" "-DprojectArtifactId=getting-started-reactive" "-DclassName=org.acme.quickstart.ReactiveGreetingResource" "-Dpath=/hello" "-Dextensions=resteasy,resteasy-mutiny,resteasy-jsonb"
 ----
 
 It generates the following in  `./getting-started-reactive`:
@@ -407,7 +407,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=getting-started-reactive-crud \
     -DclassName="org.acme.reactive.crud.FruitResource" \
     -Dpath="/fruits" \
-    -Dextensions="resteasy-mutiny, resteasy-jsonb, reactive-pg-client"
+    -Dextensions="resteasy,resteasy-mutiny,resteasy-jsonb,reactive-pg-client"
 cd getting-started-reactive-crud
 ----
 

docs/src/main/asciidoc/getting-started.adoc

@@ -81,7 +81,8 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectGroupId=org.acme \
     -DprojectArtifactId=getting-started \
     -DclassName="org.acme.getting.started.GreetingResource" \
-    -Dpath="/hello"
+    -Dpath="/hello" \
+    -Dextensions="resteasy"
 cd getting-started
 ----
 
@@ -91,14 +92,14 @@ For Windows users
 
 [source,shell,subs=attributes+]
 ----
-mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create -DprojectGroupId=org.acme -DprojectArtifactId=getting-started -DclassName="org.acme.getting.started.GreetingResource" -Dpath="/hello"
+mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create -DprojectGroupId=org.acme -DprojectArtifactId=getting-started -DclassName="org.acme.getting.started.GreetingResource" -Dpath="/hello" -Dextensions="resteasy"
 ----
 
 - If using Powershell , wrap `-D` parameters in double quotes
 
 [source,shell,subs=attributes+]
 ----
-mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create "-DprojectGroupId=org.acme" "-DprojectArtifactId=getting-started" "-DclassName=org.acme.getting.started.GreetingResource" "-Dpath=/hello"
+mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create "-DprojectGroupId=org.acme" "-DprojectArtifactId=getting-started" "-DclassName=org.acme.getting.started.GreetingResource" "-Dpath=/hello" "-Dextensions=resteasy"
 ----
 
 It generates the following in  `./getting-started`:
@@ -107,7 +108,7 @@ It generates the following in  `./getting-started`:
 * an `org.acme.getting.started.GreetingResource` resource exposed on `/hello`
 * an associated unit test
 * a landing page that is accessible on `http://localhost:8080` after starting the application
-* example `Dockerfile` files for both `native` and `jvm` modes in `src/main/docker`
+* example `Dockerfile` files for `native`, `jvm` and `fast-jar` modes in `src/main/docker`
 * the application configuration file
 
 Once generated, look at the `pom.xml`.

docs/src/main/asciidoc/gradle-tooling.adoc

@@ -24,7 +24,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=my-artifactId \
     -DprojectVersion=my-version \
     -DclassName="org.my.group.MyResource" \
-    -Dextensions="resteasy-jsonb" \
+    -Dextensions="resteasy,resteasy-jsonb" \
     -DbuildTool=gradle
 ----
 

docs/src/main/asciidoc/hibernate-search-elasticsearch.adoc

@@ -62,7 +62,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=hibernate-search-elasticsearch-quickstart \
     -DclassName="org.acme.hibernate.search.elasticsearch.LibraryResource" \
     -Dpath="/library" \
-    -Dextensions="hibernate-orm-panache, hibernate-search-elasticsearch, resteasy-jsonb, jdbc-postgresql"
+    -Dextensions="resteasy,hibernate-orm-panachehibernate-search-elasticsearch,resteasy-jsonb,jdbc-postgresql"
 cd hibernate-search-elasticsearch-quickstart
 ----
 

docs/src/main/asciidoc/kafka-streams.adoc

@@ -246,7 +246,7 @@ Create another project like so:
 mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectGroupId=org.acme \
     -DprojectArtifactId=kafka-streams-quickstart-aggregator \
-    -Dextensions="kafka-streams,resteasy-jsonb" \
+    -Dextensions="resteasy,kafka-streams,resteasy-jsonb" \
     && mv kafka-streams-quickstart-aggregator aggregator
 ----
 

docs/src/main/asciidoc/kotlin.adoc

@@ -36,7 +36,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=rest-kotlin-quickstart \
     -DclassName="org.acme.rest.GreetingResource" \
     -Dpath="/greeting" \
-    -Dextensions="kotlin,resteasy-jsonb"
+    -Dextensions="resteasy,kotlin,resteasy-jsonb"
 cd rest-kotlin-quickstart
 ----
 

docs/src/main/asciidoc/lifecycle.adoc

@@ -43,7 +43,8 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectGroupId=org.acme \
     -DprojectArtifactId=lifecycle-quickstart \
     -DclassName="org.acme.lifecycle.GreetingResource" \
-    -Dpath="/hello"
+    -Dpath="/hello" \
+    -Dextensions="resteasy"
 cd lifecycle-quickstart
 ----
 

docs/src/main/asciidoc/maven-tooling.adoc

@@ -18,7 +18,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectGroupId=my-groupId \
     -DprojectArtifactId=my-artifactId \
     -DprojectVersion=my-version \
-    -DclassName="org.my.group.MyResource"
+    -DnoExamples
 ----
 
 NOTE: If you just launch `mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create` the Maven plugin asks

docs/src/main/asciidoc/microprofile-fault-tolerance.adoc

@@ -51,7 +51,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=microprofile-fault-tolerance-quickstart \
     -DclassName="org.acme.microprofile.faulttolerance.CoffeeResource" \
     -Dpath="/coffee" \
-    -Dextensions="smallrye-fault-tolerance, resteasy-jsonb"
+    -Dextensions="resteasy,smallrye-fault-tolerance,resteasy-jsonb"
 cd microprofile-fault-tolerance-quickstart
 ----
 

docs/src/main/asciidoc/microprofile-graphql.adoc

@@ -71,7 +71,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectGroupId=org.acme \
     -DprojectArtifactId=microprofile-graphql-quickstart \
     -DclassName="org.acme.microprofile.graphql.FilmResource" \
-    -Dextensions="graphql"
+    -Dextensions="resteasy,graphql"
 cd microprofile-graphql-quickstart
 ----
 

docs/src/main/asciidoc/mongodb-panache.adoc

@@ -70,7 +70,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=mongodb-panache-quickstart \
     -DclassName="org.acme.mongodb.panache.PersonResource" \
     -Dpath="/persons" \
-    -Dextensions="resteasy-jsonb,mongodb-panache"
+    -Dextensions="resteasy,resteasy-jsonb,mongodb-panache"
 cd mongodb-panache-quickstart
 ----
 

docs/src/main/asciidoc/mongodb.adoc

@@ -48,7 +48,7 @@ mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectArtifactId=mongodb-quickstart \
     -DclassName="org.acme.mongodb.FruitResource" \
     -Dpath="/fruits" \
-    -Dextensions="resteasy-jsonb,mongodb-client,resteasy-mutiny,context-propagation"
+    -Dextensions="resteasy,resteasy-jsonb,mongodb-client,resteasy-mutiny,context-propagation"
 cd mongodb-quickstart
 ----
 

docs/src/main/asciidoc/neo4j.adoc

@@ -127,7 +127,7 @@ First, we need a new project. Create a new project with the following command:
 mvn io.quarkus:quarkus-maven-plugin:{quarkus-version}:create \
     -DprojectGroupId=org.acme \
     -DprojectArtifactId=neo4j-quickstart \
-    -Dextensions="neo4j,resteasy-jsonb"
+    -Dextensions="resteasy,neo4j,resteasy-jsonb"
 cd neo4j-quickstart
 ----