{"id":15290808,"url":"https://github.com/rieckpil/custom-maven-archetypes","last_synced_at":"2025-05-07T03:11:07.795Z","repository":{"id":47540052,"uuid":"151612633","full_name":"rieckpil/custom-maven-archetypes","owner":"rieckpil","description":":open_file_folder: Maven Archetypes to conveniently bootstrap new Java projects","archived":false,"fork":false,"pushed_at":"2022-09-15T08:10:45.000Z","size":236,"stargazers_count":42,"open_issues_count":1,"forks_count":21,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-04T22:46:27.490Z","etag":null,"topics":["jakarta-ee","java","java-ee","jsf","jsf-development","maven","maven-archetype","openliberty","payara","project-template","tomee","wildfly"],"latest_commit_sha":null,"homepage":"https://rieckpil.de","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rieckpil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-04T17:46:52.000Z","updated_at":"2025-03-27T00:48:40.000Z","dependencies_parsed_at":"2022-09-10T21:02:07.772Z","dependency_job_id":null,"html_url":"https://github.com/rieckpil/custom-maven-archetypes","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rieckpil%2Fcustom-maven-archetypes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rieckpil%2Fcustom-maven-archetypes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rieckpil%2Fcustom-maven-archetypes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rieckpil%2Fcustom-maven-archetypes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rieckpil","download_url":"https://codeload.github.com/rieckpil/custom-maven-archetypes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252804219,"owners_count":21806771,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jakarta-ee","java","java-ee","jsf","jsf-development","maven","maven-archetype","openliberty","payara","project-template","tomee","wildfly"],"created_at":"2024-09-30T16:09:34.965Z","updated_at":"2025-05-07T03:11:07.776Z","avatar_url":"https://github.com/rieckpil.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bootstrap New Maven Projects With Ease\n\n[![Jakarta EE Archetype Maven Central](https://img.shields.io/maven-central/v/de.rieckpil.archetypes/jakartaee8.svg?label=Jakarta%20EE%20Archetype%20Maven%20Central)](https://search.maven.org/search?q=g:%22de.rieckpil.archetypes%22%20AND%20a:%22jakartaee8%22)\n[![JSF Archetype Maven Central](https://img.shields.io/maven-central/v/de.rieckpil.archetypes/javaee8-jsf.svg?label=JSF%20Archetype%20Maven%20Central)](https://search.maven.org/search?q=g:%22de.rieckpil.archetypes%22%20AND%20a:%22javaee8-jsf%22)\n[![Java EE Archetype Maven Central](https://img.shields.io/maven-central/v/de.rieckpil.archetypes/javaee8.svg?label=Java%20EE%20Archetype%20Maven%20Central)](https://search.maven.org/search?q=g:%22de.rieckpil.archetypes%22%20AND%20a:%22javaee8%22)\n[![Testing Toolkit Archetype Maven Central](https://img.shields.io/maven-central/v/de.rieckpil.archetypes/testing-toolkit.svg?label=Testing%20Toolkit%20Archetype%20Maven%20Central)](https://search.maven.org/search?q=g:%22de.rieckpil.archetypes%22%20AND%20a:%22testing-toolkit%22)\n\n[![Build Maven Archetypes](https://github.com/rieckpil/custom-maven-archetypes/workflows/Build%20Maven%20Archetypes/badge.svg)](https://github.com/rieckpil/custom-maven-archetypes/actions)\n\n[Maven Archetypes](https://maven.apache.org/guides/introduction/introduction-to-archetypes.html) are a project templating toolkit to scaffold new Maven projects in seconds.\n\nThis repository contains a set of custom Maven Archetypes to conveniently bootstrap your next Java project:\n\n* [Java Project with Basic Testing Capabilities](#java-project-with-basic-testing-capabilities)\n* [Jakarta EE 8 with Microprofile 3.3 and Java 11](#jakarta-ee-8-with-microprofile-33-and-java-11)\n* [Java EE 8 with Microprofile 3.3 and Java 11 for JSF development](#java-ee-8-with-microprofile-33-and-java-11-for-jsf-development)\n* [Java EE 8 with Microprofile 3.3 and Java 11](#java-ee-8-with-microprofile-33-and-java-11)\n\n## Archetype Usage\n\nPrerequisites:\n\n* Java 8 or 17 (for `testing-toolkit` archetype)\n* Maven (either as a CLI tool or using the Maven Wrapper) \u003e 3.6.1\n\nBootstrap a new Maven project using an archetype on Mac and Linux:\n\n```shell\nmvn archetype:generate \\\n    -DarchetypeGroupId=de.rieckpil.archetypes \\\n    -DarchetypeArtifactId=\u003carchetype name\u003e \\\n    -DarchetypeVersion=\u003clatest archetype version\u003e \\\n    -DgroupId=\u003cyour group id\u003e \\\n    -DartifactId=\u003cyour artifact id\u003e \\\n    -DinteractiveMode=false\n```\n\nBootstrap a new Maven project using an archetype on Windows (CMD or PowerShell):\n\n```shell\nmvn archetype:generate \"-DarchetypeGroupId=de.rieckpil.archetypes\" \"-DarchetypeArtifactId=\u003carchetype name\u003e\" \"-DarchetypeVersion=\u003clatest archetype version\u003e\" \"-DgroupId=\u003cyour group id\u003e\" \"-DartifactId=\u003cyour artifact id\u003e\" \"-DinteractiveMode=false\"\n```\n\nMake sure to replace all `\u003cxyz\u003e` placeholders before running the commands on your machine.\n\nThe available archetype names are:\n\n- `testing-toolkit`\n- `jakartaee8`\n- `javaee8`\n- `javaee8-jsf`\n\nYou can find the latest version of each archetype as part of the badges on top of this README. The badges display the version with a preceding `v`, e.g. `v1.0.2` which you must remove.\n\nComplete example for Mac or Linux:\n\n```shell\nmvn archetype:generate \\\n    -DarchetypeGroupId=de.rieckpil.archetypes \\\n    -DarchetypeArtifactId=testing-toolkit \\\n    -DarchetypeVersion=1.0.2 \\\n    -DgroupId=com.mycompany \\\n    -DartifactId=order-service \\\n    -DinteractiveMode=false\n```\n\n```shell\ncd order-service\n./mvnw package\n```\n\nComplete example for Windows:\n\n```shell\nmvn archetype:generate \"-DarchetypeGroupId=de.rieckpil.archetypes\"  \"-DarchetypeArtifactId=testing-toolkit\" \"-DarchetypeVersion=1.0.2\" \"-DgroupId=com.mycompany\" \"-DartifactId=order-service\" \"-DinteractiveMode=false\"\n```\n```shell\ncd order-service\nmvnw package\n```\n\n## Java Project with Basic Testing Capabilities\n\n**Archetype name**: `testing-toolkit`\n\nWith this Maven archetype you can bootstrap a simple Java 17 application with basic testing capabilities in seconds. This archetype contains the following files/dependencies:\n\n* Java 17\n* Mockito and JUnit 5 dependencies for efficient testing\n* Testcontainers for integration test\n* AssertJ for writing fluent assertions\n* A basic JUnit Jupiter test\n* Maven Wrapper\n* A basic `.gitignore`\n\nRefer to the [Maven Setup For Testing Java Applications](https://rieckpil.de/maven-setup-for-testing-java-applications/) blog post on how to get started with this project.\n\n## Jakarta EE 8 with Microprofile 3.3 and Java 11\n\n**Archetype name**: `jakartaee8`\n\nWith this Maven archetype you can bootstrap a simple Jakarta EE 8 application in seconds. This archetype contains the following files/dependencies:\n\n* Jakarta EE 8 API dependency\n* Microprofile 3.3 dependency\n* Mockito and JUnit 5 dependencies for efficient testing\n* `beans.xml` with `bean-discovery-mode=\"all\"`\n* `persistence.xml` configured for JTA persistence unit\n* `microprofile-config.properties` for configuration\n* Dockerfile for latest Open Liberty deployment\n* Build and deploy script as `.sh` and `.bat`\n\nBootstrapping and deploying a new application under **Linux/Mac** (Docker daemon needs to run):\n\n```\nmvn archetype:generate -DarchetypeGroupId=de.rieckpil.archetypes -DarchetypeArtifactId=jakartaee8 -DarchetypeVersion=1.1.0 -DgroupId=de.rieckpil.blog -DartifactId=jakartaee-8-microservice -DinteractiveMode=false\ncd jakartaee-8-microservice\n./buildAndRun.sh\n```\n\nAfter Open Liberty successfully started visit `http://localhost:9080/resources/sample`\n\n## Java EE 8 with Microprofile 3.3 and Java 11\n\n**Archetype name**: `javaee8`\n\nWith this Maven archetype you can bootstrap a simple Java EE 8 application in seconds. This archetype contains the following files/dependencies:\n\n* Java EE 8 API dependency\n* Microprofile 3.3 dependency\n* Mockito and JUnit 5 dependencies for efficient testing\n* `beans.xml` with `bean-discovery-mode=\"all\"`\n* `persistence.xml` configured for JTA persistence unit\n* `microprofile-config.properties` for configuration\n* Dockerfile for latest Open Liberty deployment\n* Build and deploy script as `.sh` and `.bat`\n\nBootstrapping and deploying a new application under **Linux/Mac** (Docker daemon needs to run):\n\n```\nmvn archetype:generate -DarchetypeGroupId=de.rieckpil.archetypes -DarchetypeArtifactId=javaee8 -DarchetypeVersion=2.1.0 -DgroupId=de.rieckpil.blog -DartifactId=javaee-8-microservice -DinteractiveMode=false\ncd javaee-8-microservice\n./buildAndRun.sh\n```\n\nAfter Open Liberty successfully started visit `http://localhost:9080/resources/sample`\n\n## Java EE 8 with Microprofile 3.3 and Java 11 for JSF development\n\n**Archetype name**: `javaee8-jsf`\n\nWith this Maven archetype you can bootstrap a simple Java EE 8 JSF application in seconds. This archetype contains the following files/dependencies:\n\n* Java EE 8 API dependency\n* Microprofile 3.3 dependency\n* Primefaces 8.0 and all-themes dependency\n* Omnifaces 3.6.1 dependency\n* Mockito and JUnit 5 dependencies for efficient testing\n* `web.xml` for JSF development with `bootstrap` as selected PrimeFaces theme\n* `beans.xml` with `bean-discovery-mode=\"all\"`\n* `persistence.xml` configured for JTA persistence unit\n* `microprofile-config.properties` for configuration\n* Simple `index.xhtml` with backing bean `SampleBean`\n* Dockerfile for latest Open Liberty deployment\n* Build and deploy script as `.sh` and `.bat`\n\nBootstrapping and deploying a new application under **Linux/Mac** (Docker daemon needs to run):\n\n```\nmvn archetype:generate -DarchetypeGroupId=de.rieckpil.archetypes -DarchetypeArtifactId=javaee8-jsf -DarchetypeVersion=2.1.0 -DgroupId=de.rieckpil.blog -DartifactId=jsf-app -DinteractiveMode=false\ncd jsf-app\nchmod +x buildAndRun.sh\n./buildAndRun.sh\n```\n\nAfter Open Liberty successfully started visit `http://localhost:9080/`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frieckpil%2Fcustom-maven-archetypes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frieckpil%2Fcustom-maven-archetypes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frieckpil%2Fcustom-maven-archetypes/lists"}