srd1rooster / memo

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.

• 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.

• Servlet : Inside the project there is a application.servlet package containing the LibertyServlet class. This adds a servlet with an endpoint which you can access at http://localhost:9080/<context>/servlet. There is also a test named it.servlet.LibertyServletTest that will test the servlet's endpoint to ensure it is working. For the complete feature documentation, see the servlet-3.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-ibm-java v5.4.6
• ibm-java-codegen-common v3.0.1
• generator-ibm-service-enablement v0.7.0
• generator-ibm-cloud-enablement v^0.8.9
• generator-ibm-java-liberty v8.1.2