gwt-maven-springboot-archetype

This project contains a Maven archetype for modular GWT projects using Spring Boot. The repo is based on the implementation of Thomas Broyer's gwt-maven-archetypes.

If you are looking for the original archetype creator or would prefer another backend/implementation, please visit: gwt-maven-archetypes.

How to use

Generate a project

mvn archetype:generate -DarchetypeGroupId=com.github.nalukit.archetype -DarchetypeVersion=LATEST -DarchetypeArtifactId=<artifactId>

where the available <artifactId> is:

• clean-modular-springboot-webapp

  • Generates a clean Spring Boot multi Maven module project without any example code.
  • This is the best way to start if you understand how things work and want to start your own project.

• modular-springboot-webapp

  • Generates a Spring Boot multi Maven module project with example code.
  • The example is similar to the one from the GWT project.
  • This is the best way to start if you want to see how things work.

The generated project will use the following versions:

• Java 17
• GWT 2.12.2
• Spring Boot 3.4.4

📝 Maven 2.2 or later is required.

Start the development mode

Change directory to your generated project and issue the following commands:

1. In one terminal window: mvn gwt:codeserver -pl *-client -am
2. In another terminal window: mvn spring-boot:run -pl *-server -am

📝 The -pl and -am are not strictly necessary, they just tell Maven not to build the client module when you're dealing with the server one, and vice versa.

Once both are server are running, enter http://localhost:8080 in a browser window.

📝 Both servers are running when the code server outputs The code server is ready at http://127.0.0.1:9876/ and the Spring Boot server outputs Started Application in xxx seconds.

Build a release

After you have generated your project from the above steps, you can create a release build and test it works.

Change directory to your generated project and issue the following commands:

1. mvn clean package
2. cd *-server/target
3. java -jar myapp.war

📝 Replace myapp.war with the name of your war file.

Open http://localhost:8080 in a browser window to test your release build.

Contributing

If you want to hack on / contribute to the archetypes, you can:

git clone https://github.com/NaluKit/gwt-maven-springboot-archetype
cd gwt-maven-springboot-archetype

Make your changes, and run:

mvn clean verify

This will generate sample apps that can be found in both the clean-modular-springboot-webapp and modular-springboot-webapp directories, in the target/test-classes/projects/basic-webapp/project/basic-webapp directory.

You can also install your modified version of the project locally:

mvn clean install

Then use the mvn archetype:generate command from above, except for the -DarchetypeVersion argument which you'll replace with HEAD-SNAPSHOT.

To get in touch with the developer

Please visit use us at Nalu Gitter room.