feat: align generated Application and tests with the enhanced developer guide

Author: m0ver

src/main/resources/archetype-resources/src/main/java/__packageInPathFormat__/Application.java

@@ -1,43 +1,47 @@
 package ${package};
 
 import org.tinystruct.AbstractApplication;
+import org.tinystruct.ApplicationException;
 import org.tinystruct.system.annotation.Action;
+import org.tinystruct.system.annotation.Action.Mode;
 
-@Action(value = "", description = "Sample tinystruct application", mode = Action.Mode.CLI)
 public class Application extends AbstractApplication {
+
     @Override
     public void init() {
-        this.setTemplateRequired(false);
+        // Initialization logic (e.g., setting up resources)
+        // Note: Do NOT register actions here — use the @Action annotation instead.
+        this.setTemplateRequired(false); // Skip .view template lookup if returning data directly
     }
 
-    @Action(value = "hello", description = "Say hello")
-    public String sayHello() {
-        return "Hello from generated tinystruct app!";
+    @Override
+    public String version() {
+        return "1.0.0";
     }
 
-    @Action(value = "hello", description = "Say hello")
-    public String sayHello(String words) {
-        return words;
+    // Handles: bin/dispatcher hello  AND  GET /?q=hello
+    @Action(value = "hello", description = "Say hello to tinystruct")
+    public String sayHello() {
+        return "Hello, tinystruct!";
     }
 
-    @Action(value = "hello", mode = Mode.HTTP_GET)
-    public String helloGet() {
-        return "GET";
+    // Path parameter: GET /?q=greet/James  OR  bin/dispatcher greet/James
+    @Action(value = "greet", description = "Greet a user by name")
+    public String greet(String name) {
+        return "Hello, " + name + "!";
     }
 
-    @Action(value = "hello", mode = Mode.HTTP_POST)
-    public String helloPost() {
-        return "POST";
+    // HTTP-only POST handler
+    @Action(value = "submit", mode = Mode.HTTP_POST, description = "Handle form submission")
+    public String submit() throws ApplicationException {
+        // Logic for handling submission
+        return "Submitted successfully";
     }
 
-    @Action(value = "--help", description = "Print help information")
+    // Built-in help command
+    @Action(value = "--help", description = "Print help information", mode = Mode.CLI)
     @Override
     public String help() {
         return super.help();
     }
-
-    @Override
-    public String version() {
-        return "";
-    }
 }

src/main/resources/archetype-resources/src/test/java/__packageInPathFormat__/ApplicationTest.java

@@ -1,13 +1,30 @@
-package ${packageName};
+package ${package};
 
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
-import static org.junit.jupiter.api.Assertions.*;
+import org.tinystruct.system.Settings;
 
 public class ApplicationTest {
 
+    private Application app;
+
+    @BeforeEach
+    public void setUp() {
+        app = new Application();
+        // Setting configuration triggers init() and annotation processing
+        app.setConfiguration(new Settings());
+    }
+
+    @Test
+    public void testSayHello() throws Exception {
+        Object result = app.invoke("hello");
+        Assertions.assertEquals("Hello, tinystruct!", result);
+    }
+
     @Test
-    public void testSayHello() {
-        Application app = new Application();
-        assertEquals("Hello from generated tinystruct app!", app.sayHello());
+    public void testGreet() throws Exception {
+        Object result = app.invoke("greet", new Object[]{"James"});
+        Assertions.assertEquals("Hello, James!", result);
     }
 }