Liberty App Accelerator

This project was generated by the Liberty app accelerator

Table of Contents

• Summary
• Requirements
• Configuration
• Project contents
• Run
• Notices

Summary

The Liberty App Accelerator provides a starting point for creating applications running on WebSphere Liberty.

Requirements

• Maven
• Java 8: Any compliant JVM should work.
  • Java 8 JDK from Oracle
  • Java 8 JDK from IBM (AIX, Linux, z/OS, IBM i), or Download a Liberty server package that contains the IBM JDK (Windows, Linux)

Configuration

The application is configured to provide various technologies and features. These capabilities are provided through dependencies in the pom.xml file and Liberty features enabled in the server config file found in src/main/liberty/config/server.xml.

Project contents

The context root is set in the src/main/webapp/WEB-INF/ibm-web-ext.xml file. The ports are set in the pom.xml file.

• Persistence : For the complete feature documentation, see the jpa-2.1 feature description in IBM Knowledge Center.

• REST : Inside the project there is a application.rest package containing the LibertyRestEndpoint class. This adds a REST endpoint which you can access at http://localhost:9080/<context>/rest. There is also a test class named it.rest.LibertyRestEndpointTest that will test the REST endpoint to ensure it is working. For the complete feature documentation, see the jaxrs-2.0 feature description in IBM Knowledge Center.

• Springboot : Inside the project there is a application.springboot.web package containing two classes:

  • SpringBootLibertyApplication: The entry point for the SpringBoot application.
  • LibertyHelloController: A Spring REST endpoint which you can access at http://localhost:9080/<context>/springbootweb

There is also a test class named it.springboot.web.HelloControllerTest that will test the Spring REST endpoint to ensure it is working.

• Websockets : For the complete feature documentation, see the websocket-1.1 feature description in IBM Knowledge Center.

Run

To build and run the application:

1. mvn install
2. mvn liberty:run-server

Endpoints

The context root is set in the src/main/webapp/WEB-INF/ibm-web-ext.xml file. The ports are set in the pom.xml file.

Notices

This project was generated using:

• generator-java v2.5.8
• java-common v2.3.0
• generator-ibm-service-enablement v0.0.88
• generator-ibm-cloud-enablement v0.0.98
• generator-liberty v5.3.3