Holds all versioned WildFly quickstarts
Clone or download
Latest commit e6e6c0f Dec 3, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.mvn fix release procedure Feb 21, 2018
app-client Next is 16.0.0.Beta1 Dec 3, 2018
batch-processing Next is 16.0.0.Beta1 Dec 3, 2018
bean-validation-custom-constraint Next is 16.0.0.Beta1 Dec 3, 2018
bean-validation Next is 16.0.0.Beta1 Dec 3, 2018
bmt Next is 16.0.0.Beta1 Dec 3, 2018
cmt Next is 16.0.0.Beta1 Dec 3, 2018
contacts-jquerymobile Next is 16.0.0.Beta1 Dec 3, 2018
deltaspike-authorization Next is 16.0.0.Beta1 Dec 3, 2018
deltaspike-beanbuilder Next is 16.0.0.Beta1 Dec 3, 2018
deltaspike-projectstage Next is 16.0.0.Beta1 Dec 3, 2018
dist Next is 16.0.0.Beta1 Dec 3, 2018
ejb-asynchronous Next is 16.0.0.Beta1 Dec 3, 2018
ejb-in-ear Next is 16.0.0.Beta1 Dec 3, 2018
ejb-in-war Next is 16.0.0.Beta1 Dec 3, 2018
ejb-multi-server Next is 16.0.0.Beta1 Dec 3, 2018
ejb-remote Next is 16.0.0.Beta1 Dec 3, 2018
ejb-security-context-propagation Next is 16.0.0.Beta1 Dec 3, 2018
ejb-security-jaas Next is 16.0.0.Beta1 Dec 3, 2018
ejb-security-programmatic-auth Next is 16.0.0.Beta1 Dec 3, 2018
ejb-security Next is 16.0.0.Beta1 Dec 3, 2018
ejb-throws-exception Next is 16.0.0.Beta1 Dec 3, 2018
ejb-timer Next is 16.0.0.Beta1 Dec 3, 2018
greeter Next is 16.0.0.Beta1 Dec 3, 2018
guide Rename profiles arq-wildfly-remote / arq-wildfly-managed --> arq-remo… Feb 27, 2017
ha-singleton-deployment Next is 16.0.0.Beta1 Dec 3, 2018
ha-singleton-service Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-classfiletransformer Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-html5 Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-jms Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-mbean Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-mdb-propertysubstitution Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-mdb Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-mutual-ssl-secured Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-mutual-ssl Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-rf Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-rs Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-singleton Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-ssl Next is 16.0.0.Beta1 Dec 3, 2018
helloworld-ws Next is 16.0.0.Beta1 Dec 3, 2018
helloworld Next is 16.0.0.Beta1 Dec 3, 2018
hibernate Next is 16.0.0.Beta1 Dec 3, 2018
hibernate4 Next is 16.0.0.Beta1 Dec 3, 2018
http-custom-mechanism Next is 16.0.0.Beta1 Dec 3, 2018
inter-app Next is 16.0.0.Beta1 Dec 3, 2018
jaxrs-client Next is 16.0.0.Beta1 Dec 3, 2018
jaxrs-jwt Next is 16.0.0.Beta1 Dec 3, 2018
jaxws-addressing Next is 16.0.0.Beta1 Dec 3, 2018
jaxws-ejb Next is 16.0.0.Beta1 Dec 3, 2018
jaxws-pojo Next is 16.0.0.Beta1 Dec 3, 2018
jaxws-retail Next is 16.0.0.Beta1 Dec 3, 2018
jsonp Next is 16.0.0.Beta1 Dec 3, 2018
jta-crash-rec Next is 16.0.0.Beta1 Dec 3, 2018
jts-distributed-crash-rec Next is 16.0.0.Beta1 Dec 3, 2018
jts Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink-angularjs Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink-ear Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink-jsp Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink-ml Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink-utjs-angularjs Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink-utjs-mustache Next is 16.0.0.Beta1 Dec 3, 2018
kitchensink Next is 16.0.0.Beta1 Dec 3, 2018
logging-tools Next is 16.0.0.Beta1 Dec 3, 2018
logging Next is 16.0.0.Beta1 Dec 3, 2018
mail Next is 16.0.0.Beta1 Dec 3, 2018
managed-executor-service Next is 16.0.0.Beta1 Dec 3, 2018
messaging-clustering-singleton Next is 16.0.0.Beta1 Dec 3, 2018
messaging-clustering Next is 16.0.0.Beta1 Dec 3, 2018
numberguess Next is 16.0.0.Beta1 Dec 3, 2018
payment-cdi-event Next is 16.0.0.Beta1 Dec 3, 2018
resteasy-jaxrs-client Next is 16.0.0.Beta1 Dec 3, 2018
security-domain-to-domain Next is 16.0.0.Beta1 Dec 3, 2018
servlet-async Next is 16.0.0.Beta1 Dec 3, 2018
servlet-filterlistener Next is 16.0.0.Beta1 Dec 3, 2018
servlet-security Next is 16.0.0.Beta1 Dec 3, 2018
shared-doc WFLY-11375,JBEAP-15873: Make instruction to install parent artifact c… Nov 19, 2018
shopping-cart Next is 16.0.0.Beta1 Dec 3, 2018
spring-greeter Next is 16.0.0.Beta1 Dec 3, 2018
spring-kitchensink-basic Next is 16.0.0.Beta1 Dec 3, 2018
spring-kitchensink-springmvctest Next is 16.0.0.Beta1 Dec 3, 2018
spring-resteasy Next is 16.0.0.Beta1 Dec 3, 2018
tasks-jsf Next is 16.0.0.Beta1 Dec 3, 2018
tasks-rs Next is 16.0.0.Beta1 Dec 3, 2018
temperature-converter Next is 16.0.0.Beta1 Dec 3, 2018
template Next is 16.0.0.Beta1 Dec 3, 2018
thread-racing Next is 16.0.0.Beta1 Dec 3, 2018
websocket-client Next is 16.0.0.Beta1 Dec 3, 2018
websocket-endpoint Next is 16.0.0.Beta1 Dec 3, 2018
websocket-hello Next is 16.0.0.Beta1 Dec 3, 2018
wicket-ear Next is 16.0.0.Beta1 Dec 3, 2018
wicket-war Next is 16.0.0.Beta1 Dec 3, 2018
wsat-simple Next is 16.0.0.Beta1 Dec 3, 2018
wsba-coordinator-completion-simple Next is 16.0.0.Beta1 Dec 3, 2018
wsba-participant-completion-simple Next is 16.0.0.Beta1 Dec 3, 2018
xml-jaxp Next is 16.0.0.Beta1 Dec 3, 2018
.gitattributes add .gitattributes Mar 16, 2017
.gitignore JBEAP-9156: Use githubRepoUrl and githubRepoBranch variables in OpenS… Mar 27, 2018
CONTRIBUTING.adoc WFLY-11362,JBEAP-15877: Add instructions to build quickstart README.h… Nov 19, 2018
LICENSE.txt JDF-841 - Synchronize Wildfly and EAP Quickstarts Sep 9, 2015
README.adoc WFLY-11362,JBEAP-15877: Add instructions to build quickstart README.h… Nov 19, 2018
RELEASE_PROCEDURE.adoc Move documentation to asciidoc Dec 11, 2017
buildReadmes.sh JBEAP-14084: Create shared content - Pulled out more common content i… Jan 29, 2018
configure-postgresql.cli Initial sync of EAP and WildFly quickstarts Feb 21, 2017
contributor-settings.xml JDF-841 - Synchronize Wildfly and EAP Quickstarts Sep 9, 2015
pom.xml Next is 16.0.0.Beta1 Dec 3, 2018
remove-postgresql.cli Initial sync of EAP and WildFly quickstarts Feb 21, 2017
settings.xml JDF-841 - Synchronize Wildfly and EAP Quickstarts Sep 9, 2015

README.adoc

{productNameFull} ({productName}) Quickstarts

The quickstarts demonstrate {javaVersion} and a few additional technologies from the {productNameFull} stack. They provide small, specific, working examples that can be used as a reference for your own project.
Important

The quickstart README files are written in AsciiDoc, not only because the language is much more powerful than Markdown, but also also because it is possible to extract common instructions into separate files to be reused across the quickstarts. While this makes them more flexible and easier to maintain, unfortunately, included files do not render in a readable format in GitHub or in most text editors.

The Maven plugin that is used to build and deploy the quickstarts can also generate fully rendered README.html instructions from the README.adoc files. For instructions on how to generate these files, see Build the README.html Files in the CONTRIBUTING guide.

Introduction

These quickstarts run on {productNameFull}. Each quickstart folder contains a README.adoc file that describes the quickstart features and provides instructions about how to build and run it.

The quickstarts are configured to use the correct Maven dependencies and ensure that you test and compile the quickstarts against the correct runtime environment.

Make sure you read this entire document before you attempt to work with the quickstarts. It contains the following information:

Use of {jbossHomeName} and JBOSS_HOME Variables

The quickstart README files use the replaceable value {jbossHomeName} to denote the path to the {productName} installation. When you encounter this value in a README file, make sure you replace it with the actual path to your {productName} installation. The installation path is described in detail here: Use of {jbossHomeName} and JBOSS_HOME Variables.

System Requirements

The applications these projects produce are designed to be run on {productNameFull} {productVersion} or later.

All you need to build these projects is {buildRequirements}. See Configure Maven to Build and Deploy the Quickstarts to make sure you are configured correctly for testing the quickstarts.

To run these quickstarts with the provided build scripts, you need the {productName} distribution ZIP. For information on how to install and run JBoss, see the {LinkGettingStartedGuide}[{GettingStartedBookName}] located on the Red Hat Customer Portal.

You can also run the quickstarts in {JBDSProductName} or Eclipse.

Run the Quickstarts

Build and Deploy a Quickstart

The root folder of each individual quickstart contains a README.adoc file with detailed instructions on how to build and run the example. In most cases you do the following:

  • Start the {productName} server.

  • Build the archive.

  • Deploy the quickstart.

  • Undeploy the quickstart when you are finished testing.

Verify All Quickstarts Build with One Command

You can also verify that all of the quickstarts build using one command. However, quickstarts that have complex dependencies must be skipped. For example, the resteasy-jaxrs-client quickstart is a RESTEasy client that depends on the deployment of the helloworld-rs quickstart. The root pom.xml file defines a complex-dependencies profile to exclude these quickstarts from the root build process.

To build all of the quickstarts:

  1. Open a terminal and navigate to the root directory of the quickstarts.

  2. Use the following command to build the quickstarts that do not have complex dependencies:

    $ mvn clean install '-Pdefault,!complex-dependencies'

Undeploy All Deployed Quickstarts with One Command

To undeploy all of the the quickstarts from the root of the quickstart folder, you must pass the argument -fae (fail at end) on the command line. This allows the command to continue past quickstarts that fail due to complex dependencies or only have Arquillian tests and do not deploy archives to the server.

You can undeploy quickstarts using the following procedure:

  1. Start the {productName} server.

  2. Open a terminal and navigate to the root directory of the quickstarts.

  3. Use the following command to undeploy any deployed quickstarts.

    $ mvn wildfly:undeploy -fae

To undeploy any quickstarts that fail due to complex dependencies, follow the undeploy procedure described in the quickstart’s README.adoc file.

Run the Quickstarts in {JBDSProductName} or Eclipse

You can also start the server and deploy the quickstarts or run the Arquillian tests from Eclipse using JBoss tools. For general information about how to import a quickstart, add a {productName} server, and build and deploy a quickstart, see Use {JBDSProductName} or Eclipse to Run the Quickstarts.

Optional Components

The following components are needed for only a small subset of the quickstarts. Do not install or configure them unless the quickstart requires it.