{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing the Archetype","type":"text"}]},{"type":"paragraph","content":[{"text":"We’ll start by cloning the archetype repository so we can install it. If the archetype will be published in Maven Central at some point, this step will be different but for now we will do it like this. Make sure Eclipse is open and ready. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clone ","type":"text"},{"text":"https://github.com/diging/spring-thymeleaf-archetype.git","type":"text","marks":[{"type":"code"}]},{"text":" using your favorite Git client.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to Eclipse.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click into the Project Explorer or if that doesn’t work choose “File > Import…”. Or if you see a list of options in the Project Explorer (if you have an empty workspace, you might see this) click “Import projects…”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the import wizard, choose “Projects from Git” from the list and click “Next.”","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":592,"id":"c2409c33-13a3-4a6a-80c3-701d738787a8","collection":"contentId-3114565688","type":"file","height":556}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose “Existing local repository” and click “Next.”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the Git repository you cloned in the first step, select ","type":"text"},{"text":"spring-thymeleaf-archetype","type":"text","marks":[{"type":"code"}]},{"text":" from the list that should appear after you added the repository, and click \"Next.\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure “Import existing Eclipse project” is selected, open the “Working Tree” folder and select ","type":"text"},{"text":"archetype","type":"text","marks":[{"type":"code"}]},{"text":". Click \"Next.\"","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":732,"id":"80454c71-7a14-4a35-a411-ffaf6c8d9f6a","collection":"contentId-3114565688","type":"file","height":558}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure ","type":"text"},{"text":"archetype","type":"text","marks":[{"type":"code"}]},{"text":" is selected. Click “Finish.”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"archetype","type":"text","marks":[{"type":"code"}]},{"text":" is not listed, go back to previous page and make sure “Import as general project“ is selected. Click “Next.“ Make sure ","type":"text"},{"text":"archetype","type":"text","marks":[{"type":"code"}]},{"text":" is selected. Click “Finish.” Then, right-click the project in the File Explorer and select “Configure > Convert to Maven Project.“","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The project should now show up in your Project Explorer with a little M decorator indicating that it’s a Maven project.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":260,"id":"5f7e81dd-7389-4656-a860-8be1c2c25e1b","collection":"contentId-3114565688","type":"file","height":138}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on the project and choose “Run as > Maven install.”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the console, you should see a bunch of output ending with something like this","type":"text"}]},{"type":"codeBlock","content":[{"text":"[INFO] ------------------------------------------------------------------------\n[INFO] BUILD SUCCESS\n[INFO] ------------------------------------------------------------------------\n[INFO] Total time: 24.405 s\n[INFO] Finished at: 2023-01-18T12:39:37-05:00\n[INFO] ------------------------------------------------------------------------","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The Maven archetype (Maven template) is now installed in your local Maven repository.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Creating a new project","type":"text"}]},{"type":"paragraph","content":[{"text":"Now we can create a project from the archetype.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click in the Project Explorer and select “New > Project…”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the New Project wizard, select open the ","type":"text"},{"text":"Maven","type":"text","marks":[{"type":"code"}]},{"text":" folder and select “Maven Project.” Click “Next.”","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":594,"id":"45cee34c-5587-4ecb-aa75-7dce681bf569","collection":"contentId-3114565688","type":"file","height":509}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the “New Maven project” page, make sure “Create a simple project (skip archetype selection)” is ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" selected. Click “Next.”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the “Select an archetype” page, choose “Default Local” from the “Catalog” dropdown. The archetype we just installed, should show up.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the archetype (","type":"text"},{"text":"spring-thymeleaf-webapp","type":"text","marks":[{"type":"code"}]},{"text":") and click \"Next.\"","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":689,"id":"d03bb0a1-33b9-40a7-a5b0-7f17d7b303c4","collection":"contentId-3114565688","type":"file","height":561}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter a group id and artifact id. The values do not matter too much, but the group and artifact ids will be used as base package name by default. Click “Finish.”","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":680,"id":"95530be6-1a69-4472-99ce-2428051b37e8","collection":"contentId-3114565688","type":"file","height":120}}]}]}]},{"type":"paragraph","content":[{"text":"Maven is now creating your project. This might take a while. In the console you can probably see Maven’s log output. If the console stops in between asking you to confirm the properties configuration, just hit enter.","type":"text"}]},{"type":"paragraph","content":[{"text":"Your project structure of the newly created project, should look something like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":255,"id":"973b5a01-c888-46e1-9704-f234587e3387","collection":"contentId-3114565688","type":"file","height":380}}]},{"type":"paragraph","content":[{"text":"If you are using Java 11, you will probably see the above errors on the project. To fix those:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"open ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"find the plugin with the artifact id ","type":"text"},{"text":"maven-war-plugin","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade the version to 3.3.1","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n org.apache.maven.plugins\n maven-war-plugin\n 3.3.1\n \n \n \n true\n src/main/webapp\n \n **/*\n \n \n **/*.woff\n **/*.ttf\n **/*.woff2\n \n \n \n \n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Next, we need to fix the compilation issues in ","type":"text"},{"text":"SimpleUsersConfig","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"SimpleUsersConfig.java","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove lines 4 and 5.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"import my.project.simpleusers.core.config.SimpleUsers;\nimport my.project.simpleusers.core.config.SimpleUsersConfiguration;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Organize imports by either right-clicking in the editor and selecting “Source > Organize Imports” or by using the keyboard shortcut (","type":"text"},{"text":"cmd-shift-o","type":"text","marks":[{"type":"code"}]},{"text":" on Mac).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the file. The compilation errors should be gone now.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Running the project","type":"text"}]},{"type":"paragraph","content":[{"text":"To run the project:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click it, and select “Run as > Run on Server.” ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the dialog, open the “Apache” folder and select “Tomcat v9.0 Server.” ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click “Next,” select the Tomcat installation directory (make sure you have downloaded Tomcat 9.0).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click “Finish.”","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The server should be starting but there should be exceptions in the log. You should find an exception in the log that says:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Caused by: java.lang.RuntimeException: Driver com.mysql.jdbc.Driver claims to not accept jdbcUrl, jdbc-url-to-db\n\tat com.zaxxer.hikari.util.DriverDataSource.(DriverDataSource.java:108)\n\tat com.zaxxer.hikari.pool.PoolBase.initializeDataSource(PoolBase.java:336)\n\tat com.zaxxer.hikari.pool.PoolBase.(PoolBase.java:109)\n\tat com.zaxxer.hikari.pool.HikariPool.(HikariPool.java:108)\n\tat com.zaxxer.hikari.HikariDataSource.(HikariDataSource.java:81)\n\tat my.project.thymeleaf.config.PersistenceConfig.dataSource(PersistenceConfig.java:41)\n\tat my.project.thymeleaf.config.PersistenceConfig$$EnhancerBySpringCGLIB$$f9717ade.CGLIB$dataSource$0()\n\tat my.project.thymeleaf.config.PersistenceConfig$$EnhancerBySpringCGLIB$$f9717ade$$FastClassBySpringCGLIB$$1490bd12.invoke()\n\tat org.springframework.cglib.proxy.MethodProxy.invokeSuper(MethodProxy.java:244)\n\tat org.springframework.context.annotation.ConfigurationClassEnhancer$BeanMethodInterceptor.intercept(ConfigurationClassEnhancer.java:363)\n\tat my.project.thymeleaf.config.PersistenceConfig$$EnhancerBySpringCGLIB$$f9717ade.dataSource()\n\tat java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)\n\tat java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)\n\tat java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\n\tat java.base/java.lang.reflect.Method.invoke(Method.java:568)\n\tat org.springframework.beans.factory.support.SimpleInstantiationStrategy.instantiate(SimpleInstantiationStrategy.java:154)\n\t... 70 more","type":"text"}]},{"type":"paragraph","content":[{"text":"You see this exception because we have not yet setup a database to which the application can connect. Currently, the application tries to connect to a database ","type":"text"},{"text":"jdbc-url-to-db","type":"text","marks":[{"type":"code"}]},{"text":", which does not exist. To fix this, create a new MySQL database in your favorite client and a user that has write access to that database (the user needs to be able to create tables, change them, etc).","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If you are using the MySLQ command line client you can do this in three lines:","type":"text"}]},{"type":"paragraph","content":[{"text":"create database thymeleaf;","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"create user 'app'@'localhost' identified by 'app';","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"grant all on thymeleaf.* to 'app'@'localhost';","type":"text","marks":[{"type":"code"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Fix for MySQL 8","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" If you are using MySQL 8, you will need to adjust the dialect Hibernate uses to create database tables. To do this, do the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"PersistenceConfig.java","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In line 73, change the Hibernate dialect to ","type":"text"},{"text":"org.hibernate.dialect.MySQL8Dialect","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"Properties additionalProperties() {\n Properties properties = new Properties();\n properties.setProperty(\"hibernate.hbm2ddl.auto\", \"update\");\n properties.setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQL8Dialect\");\n properties.setProperty(\"hibernate.show_sql\", \"true\");\n properties.setProperty(\"hibernate.id.new_generator_mappings\", \"true\");\n\n return properties;\n}","type":"text"}]},{"type":"paragraph"}]}]},{"type":"paragraph","content":[{"text":"If you do not adjust the dialect, you will see “key too long” exception when starting the server.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Provide database config","type":"text"}]},{"type":"paragraph","content":[{"text":"Then provide the details of the database in the POM file.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the part with the database properties.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"com.mysql.jdbc.Driver\njdbc-url-to-db\ndb-user\ndb-password","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"jdbc-url-to-db","type":"text","marks":[{"type":"code"}]},{"text":" with the url to the database (something like ","type":"text"},{"text":"jdbc:mysql://localhost:3306/databaseName","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"db-user","type":"text","marks":[{"type":"code"}]},{"text":" with the db user’s username.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"db-password","type":"text","marks":[{"type":"code"}]},{"text":" with the password of the db user.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now right-click the project and select “Maven > Update Project…”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure ","type":"text"},{"text":"thymeleaf","type":"text","marks":[{"type":"code"}]},{"text":" is selected and click “Ok.”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart the server.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The server should now start without errors and you should get the main app home page at ","type":"text"},{"text":"http://localhost:8080/thymeleaf/","type":"text","marks":[{"type":"code"}]},{"text":" (or ","type":"text"},{"text":"http://localhost:8080/spring-thymeleaf-artifact/","type":"text","marks":[{"type":"code"}]},{"text":" if you have committed the code to a Git repository).","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"A bug finding challenge","type":"text"}]},{"type":"paragraph","content":[{"text":"You should now be able to run the app and see something like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1188,"id":"62e0fa4e-778b-4c13-a137-f77c05c28fe2","collection":"contentId-3114565688","type":"file","height":832}}]},{"type":"paragraph","content":[{"text":"But try to login. Username is ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":" and password is ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":". You will see an error message. Try to fix it. If you need some help, the next page will give you some tips. But try it by yourself at first. Being able to resolve bugs is an important skill for any software developer.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"6642fb276a0b5d0c61c96294f8d30903"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"8833c2a5-5414-4d9e-ab22-bcf21b0ebe60"}}]}]},{"type":"paragraph"}],"version":1}

Browser not supported