Merge pull request #47 from MarcelDiessner/CobigenJavaBackend

Cobigen java backend

Author: GuentherJulian

cobigen-cli/files/CustomerEntity.java cobigen/files/CustomerEntity.javacobigen-cli/files/CustomerEntity.java renamed to cobigen/files/CustomerEntity.java

@@ -0,0 +1,9 @@
+private int age;
+private String company;
+
+public String getCompany() {
+    return company;
+}
+public void setCompany(String company) {
+    this.company = company;
+}

cobigen/files/Placeholder.java

@@ -1,27 +1,23 @@
-= CobiGen Cli
+= Tutorial for Java Backend Generation with CobiGen
 ====
-CobiGen is a generic incremental code generator. It allows you build Java CRUD application based on the devonfw architecture including all software layers. You can generate all necessary classes and services (DAOs, Transfer Objects, simple CRUD use cases with REST services) of the application from one single entity class.
+CobiGen is a generic incremental code generator. It allows you to build Java CRUD application based on the devonfw architecture including all software layers. You can generate all necessary classes and services (DAOs, Transfer Objects, simple CRUD use cases with REST services) of the application from one single entity class.
 
-CobiGen provides Maven and Eclipse integrations. But there is also a command line interface (CLI) which enables the generation of code using only few commands. In this scenario, you will learn how to install and use the cobigen cli inside a java project.
+CobiGen provides Maven and Eclipse integrations. But there is also a command line interface (CLI) which enables the generation of code using only few commands.
 
 More information about CobiGen on https://devonfw.com/website/pages/docs/master-cobigen.asciidoc.html
 ====
 
-To use the cobigen cli you first have to install the devonfw ide. You will find more information about devonfw on https://devonfw.com/website/pages/welcome/welcome.html.
 [step]
 --
-installDevonfwIde(["java","mvn"])
+restoreDevonfwIde(["java","mvn"])
 --
 
-Now, you have to download cobigen
+For this tutorial an installation of the devonfw IDE is required, which was already set up for you.
+To begin you need to install CobiGen and create a Java Project.
 [step]
+== Install CobiGen and create Java Project
 --
 installCobiGen()
---
-
-Now you are ready to create your first project
-[step]
---
 createDevon4jProject("cobigenexample")
 --
 
@@ -31,7 +27,7 @@ Create the entity class which will be passed to the cobigen cli generator later
 createFile("cobigenexample/core/src/main/java/com/example/application/cobigenexample/customermanagement/dataaccess/api/CustomerEntity.java", "files/CustomerEntity.java")
 --
 
-Build the java project
+Now Build the java project
 [step]
 --
 buildJava("cobigenexample", false)
@@ -41,6 +37,7 @@ buildJava("cobigenexample", false)
 CobiGen is integrated via plugin in the VS Code IDE. We will use it to generate code from one single java class based on existing templates.
 [step]
 --
+adaptTemplatesCobiGen()
 cobiGenJava("cobigenexample/core/src/main/java/com/example/application/cobigenexample/customermanagement/dataaccess/api/CustomerEntity.java",[1,3,5,6,8])
 --
 The CobiGen code generator will generate some java classes for you. These contain code for basic CRUD operations, REST service handling and data access.
@@ -68,3 +65,11 @@ For example, the following files are generated by CobiGen when using the specifi
 (8) CRUD SpringData Repository: Generates the entity repository (that contains the CRUD operations) in the data access layer.
 - `devonfw/workspaces/main/cobigenexample/core/src/main/java/com/example/application/cobigenexample/customermanagement/dataaccess/api/repo/CustomerRepository.java`{{open}}
 ====
+
+Furthermore, we can change the CustomerEntity afterwards and update our source files simply by running cobigen again.
+[step]
+== Change Entity and run cobigen again
+--
+changeFile("cobigenexample/core/src/main/java/com/example/application/cobigenexample/customermanagement/dataaccess/api/CustomerEntity.java", { "file": "files/Placeholder.java", "placeholder": "private int age;" })
+cobiGenJava("cobigenexample/core/src/main/java/com/example/application/cobigenexample/customermanagement/dataaccess/api/CustomerEntity.java",[1,3,5,6,8])
+--