{"id":388,"date":"2020-05-25T09:38:30","date_gmt":"2020-05-25T09:38:30","guid":{"rendered":"http:\/\/spiderwiz.org\/project\/?page_id=388"},"modified":"2025-04-09T06:15:57","modified_gmt":"2025-04-09T06:15:57","slug":"lesson-1","status":"publish","type":"page","link":"https:\/\/spiderwiz.org\/project\/tutorial\/lesson-1\/","title":{"rendered":"Lesson 1: Hello World"},"content":{"rendered":"\n

Welcome to the first lesson of the Spiderwiz Tutorial<\/strong>. In this lesson you will learn how to build a basic functional Spiderwiz Application<\/strong>. We will start with a simple command-line Java project. It will not do much, but it will have all the building blocks needed for much more complex applications. In fact you will discover that writing much more complex Spiderwiz<\/em> applications is not that much harder than writing this simple one.<\/p>\n\n\n\n

The application contains one data object \u2013 HelloWorld<\/code>, which prints, guess what, \u201cHello World\u201d.<\/p>\n\n\n\n

So we start by creating a new empty Java application project. We use Maven<\/a> along this tutorial, but you can use any project management tool as you may find convenient. The Spiderwiz<\/em> dependency is described in the Download<\/a> page and we will copy it here for convenience:
<\/p>\n\n\n\n

<dependency>\n    <groupId>org.spiderwiz<\/groupId>\n    <artifactId>spiderwiz-core<\/artifactId>\n    <version>4.0<\/version>\n<\/dependency><\/pre><\/div>\n\n\n\n
 Our application comprises two source files \u2013 HelloWorldMain.java<\/code>, which is the entry (and exit) point of the application, and HelloWorld.java<\/code>, which codes the HelloWorld<\/code> object. Let\u2019s see the first and then explain it: <\/p>\n\n\n\n
package org.spiderwiz.tutorial.lesson1;\n\nimport java.util.List;\nimport org.spiderwiz.core.DataObject;\nimport org.spiderwiz.core.Main;\n\n\/**\n * Provides the entry point of the application. Initializes and executes the Spiderwiz framework.\n *\/\npublic class HelloWorldMain extends Main{\n    private static final String ROOT_DIRECTORY = "";\n    private static final String CONF_FILENAME = "hello-world.conf";\n    private static final String APP_NAME = "Hello World";\n    private static final String APP_VERSION = "Z1.01";  \/\/ Version Z1.01: Initial version\n\n    \/**\n     * Class constructor with constant parameters.\n     *\/\n    public HelloWorldMain() {\n        super(ROOT_DIRECTORY, CONF_FILENAME, APP_NAME, APP_VERSION);\n    }\n\n    \/**\n     * Application entry point. Instantiate the class, initialize the instance, then call a command-line hook that would shut down\n     * the application when "exit" is typed.\n     * \n     * @param args the command line arguments. Not used in this application.\n     *\/\n    public static void main(String[] args) {\n        HelloWorldMain main = new HelloWorldMain();\n        if (main.init())\n            main.commandLineHook();\n    }\n    \n    \/**\n     * @return the list of produced objects, in this case HelloWorld is the only one.\n     *\/\n    @Override\n    protected String[] getProducedObjects() {\n        return new String[]{HelloWorld.ObjectCode};\n    }\n\n    \/**\n     * @return the list of consumed objects, in this case HelloWorld is the only one.\n     *\/\n    @Override\n    protected String[] getConsumedObjects() {\n        return new String[]{HelloWorld.ObjectCode};\n    }\n\n    \/**\n     * Add HelloWorld class to the object factory list of this application.\n     * @param factoryList\n     *\/\n    @Override\n    protected void populateObjectFactory(List<Class<? extends DataObject>> factoryList) {\n        super.populateObjectFactory(factoryList);\n        factoryList.add(HelloWorld.class);\n    }\n\n    \/**\n     * Create a HelloWorld object, set its field and commit it.\n     *\/\n    @Override\n    protected void postStart() {\n        try {\n            HelloWorld helloWorld = createTopLevelObject(HelloWorld.class, null);\n            helloWorld.setSayHello("Hello World");\n            helloWorld.commit();\n            return;\n        } catch (NoSuchFieldException | IllegalAccessException ex) {\n            ex.printStackTrace();\n        }\n    }\n}<\/pre><\/div>\n\n\n\n
Every Spiderwiz application must extend org.spiderwiz.core.Main<\/a> class and call its init()<\/a> method in order to set the framework mechanism in motion. We do it with HelloWorldMain<\/code>. The Main<\/code> constructor requires four parameters \u2013 the root file folder of the application, the name of the configuration file (that must reside in the root folder), application name and version. In our case we hard code all these. We provide an empty string as the root folder as we want it to be the current working directory.<\/p>\n\n\n\n
Next we implement a static main()<\/code> method (line 29) that serves as the application\u2019s entry point. Inside the method we create an instance of HelloWorldMain<\/code> and call its init()<\/a> method. If successful, we set up a cleanup and exit point by calling Main.commandLineHook()<\/a>. This is a shortcut for adding a shutdown hook that calls Main.cleanup()<\/a> upon application termination and reading lines from the standard input stream until the command “exit” is encountered, then terminating the application.<\/p>\n\n\n\n
We implement the abstract methods Main.getProducedObjects()<\/a> (line 39) and Main.getConsumedObjects()<\/a> (line 47). The only data object that we both produce and consume is HelloWorldMain<\/code>, so in both methods we return a list containing a single element – HelloWorld.ObjectCode<\/code>. We will come back to it in a moment when we discuss HelloWorld.java<\/code>.<\/p>\n\n\n\n
We also override Main.populateObjectFactory()<\/a> (line 56). This is where we register the class that implements HelloWorld<\/code>. Note that before adding this class to the factory list, we must call super.populateObjectFactory(factoryList)<\/code> in order to preserve pre-registered classes.<\/p>\n\n\n\n
Last is to override Main.postStart()<\/a> (line 65) that is called after framework initialization. We create a HelloWorld<\/code> object (using createTopLevelObject()<\/a>), set its sayHello<\/code> property and commit<\/a> it.<\/p>\n\n\n\n
The second file, HelloWorld.java<\/code>, is where we define the HelloWorld<\/code> object and implement its task. Here it goes:  <\/p>\n\n\n\n
package org.spiderwiz.tutorial.lesson1;\n\nimport org.spiderwiz.annotation.WizField;\nimport org.spiderwiz.core.DataObject;\n\n\/**\n * Implements HelloWorld data object.\n *\/\npublic class HelloWorld extends DataObject{\n\n    \/**\n     * Mandatory public static field for all data objects.\n     *\/\n    public final static String ObjectCode = "HLWRLD";\n    \n    @WizField private String sayHello;\n\n    public String getSayHello() {\n        return sayHello;\n    }\n\n    public void setSayHello(String sayHello) {\n        this.sayHello = sayHello;\n    }\n\n    \/**\n     * @return null as this is a root object.\n     *\/\n    @Override\n    protected String getParentCode() {\n        return null;\n    }\n\n    \/**\n     * @return true as this object is disposable.\n     *\/\n    @Override\n    protected boolean isDisposable() {\n        return true;\n    }\n\n    \/**\n     * Do the consumer work.\n     * @return true to indicate that the event has been handled.\n     *\/\n    @Override\n    protected boolean onEvent() {\n        System.out.println(getSayHello());\n        return true;\n    }\n}<\/pre><\/div>\n\n\n\n
Classes that implement Spiderwiz Data Objects<\/em> extend org.spiderwiz.core.DataObject<\/a>. In order to participate in the game, classes that extend this class must define a public static String<\/code> field named ObjectCode<\/code> that uniquely identifies the data object type across the service mesh. Its value may contain any character except a comma. We define this field with the value “HLWRLD”. Our class also contains one String property \u2013 sayHello<\/code>.<\/p>\n\n\n\n
Next we need to implement two abstract methods – getParentCode()<\/a> and isDisposable()<\/a>. The first returns null<\/code> because the class defines a root object<\/em> (that has no parent). The second returns true<\/code> because the object is disposable<\/em> \u2013 it can be discarded after its event is handled.<\/p>\n\n\n\n
We achieve our task by overriding onEvent()<\/a>. This method is fired when the producer of the object commits<\/a> it. Our implementation gets the value of sayHello<\/code> property and outputs it to the console. We return true<\/code> to indicate that we have completely handled the event. (You will see later why this is important).<\/p>\n\n\n\n
So, are we ready to greet the world? Well, hold on. If you try to run what we have done so far, you will get the following message on your console:
<\/p>\n\n\n\n
Could not open setting file hello-world.conf<\/pre>\n\n\n\n
hello-world.conf<\/code> is the configuration file name as we defined in HelloWorldMain<\/code>. Every Spiderwiz application requires a configuration file<\/a>. In our case there is not much to put there and we can even leave it empty to use defaults, but a file must exist in what we defined as a root folder (the working directory where we launched the application in our case).<\/p>\n\n\n\n
Since we prefer to have a fixed place for our application\u2019s log folder<\/a>, we will include one line in hello-world.conf<\/code>:
<\/p>\n\n\n\n
[log folder]\/tests\/HelloWorld\/Logs<\/pre><\/div>\n\n\n\n
Now we are ready to run. Shoot it, and you will see the following on your console:
<\/p>\n\n\n\n
Hello World ver. Z1.01 (core version Z2.30) has been initiated successfully\nInclude spiderwiz-admin.jar in your project in order to use www.spiderwiz.org\/SpiderAdmin\nHello World\n<\/pre>\n\n\n\n
The first message is displayed by the framework when every Spiderwiz application is initialized. Application name and version are taken from the call to Main<\/code> class constructor as shown above. \u201cCore version\u201d is the version of the Spiderwiz framework used.<\/p>\n\n\n\n
Ignore the second message for now, we will come back to it later.<\/p>\n\n\n\n
The third message, \u201cHello World\u201d, is what our HelloWord object prints.<\/p>\n\n\n\n
At this point, the application is still active and waiting for user input. Type exit<\/code> (case insensitive), the application will terminate and you will see the following:
<\/p>\n\n\n\n
exit\nHello World undeployed\n<\/pre>\n\n\n\n
Before concluding this lesson, we should mention two more effects of running this (and every Spiderwiz) application. The first is the logs that are created by the framework under the log folder defined in the configuration file. After running the application you will see that a sub-folder was created with a name representing the running date (e.g. 20-06-02<\/code>), under which you will find a file with a name representing the hour of the day (e.g. am10.txt<\/code>). Inside that file you will see log messages that are, in this case, similar to what is displayed on the console:
<\/p>\n\n\n\n
10:54:31:125 Hello World ver. Z1.01 (core version Z2.30) has been initiated successfully\n10:54:31:200 Include spiderwiz-admin.jar in your project in order to use www.spiderwiz.org\/SpiderAdmin\n10:54:33:413 Hello World undeployed\n<\/pre>\n\n\n\n
You don\u2019t see the \u201cHello World\u201d message because this was not logged but just printed to stdout<\/code> by our sample application.
<\/p>\n\n\n\n
For detailed information about the logging system see Spiderwiz Logging System<\/a> in the project\u2019s Javadoc.<\/p>\n\n\n\n
Lastly, you may notice that the configuration file, hello-world.conf<\/code>, was automatically changed after the first run of the application. Now it shows something like:
<\/p>\n\n\n\n
[application uuid]4088df1e-7a23-4688-8d05-80a15b2622be\n[log folder]\/tests\/HelloWorld\/Logs<\/pre><\/div>\n\n\n\n
The property application uuid<\/code> was added by the framework, and it should normally stay there along the life of the application instance. This is an essential part of Spiderwiz routing mechanism and you shall not touch it unless you have a good reason. If you need to move the application to another location on the cloud, move it together with its configuration file with that line inside.<\/p>\n\n\n\n
So far so good. If you think that this is a long way around to say \u201cHello World\u201d you are right, of course. But, hey, when did you last see a shorter \u201cHello World\u201d application? But don\u2019t worry. Stay with us, and you will soon discover that developing even the most convoluted service mesh is not that much harder than writing this one.<\/p>\n\n\n\n
In the next lesson<\/a> we will start to learn about weaving a service mesh. We will see what are Producers<\/em> and Consumers<\/em>, and how easy it is to link them with Spiderwiz.
<\/p>\n","protected":false},"excerpt":{"rendered":"
Learn how to build a basic functional Spiderwiz Application. The application will contain one data object – HelloWorld, which will print, guess what, “Hello World”.<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":145,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"tutorial-child.php","meta":{"footnotes":""},"class_list":["post-388","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/pages\/388","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/comments?post=388"}],"version-history":[{"count":59,"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/pages\/388\/revisions"}],"predecessor-version":[{"id":1420,"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/pages\/388\/revisions\/1420"}],"up":[{"embeddable":true,"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/pages\/145"}],"wp:attachment":[{"href":"https:\/\/spiderwiz.org\/project\/wp-json\/wp\/v2\/media?parent=388"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}