Ferret

This sample project contains a simple Servlet application called Ferret. Ferret listens for HTTP requests sent to <host>:<port>/ferret[/*], and responds with information about the request and the server.

Running in Eclipse

Maven

1. Download and install Eclipse with the WebSphere Developer Tools.
2. Create a new Liberty Profile Server. See step 3 for details.
3. Clone this repository.
4. Import the sample into Eclipse using File -> Import -> Maven -> Existing Maven Projects option.
5. Deploy the sample into Liberty server. Right click on the ferret sample and select Run As -> Run on Server option. Find and select the Liberty profile server and press Finish.
6. Go to: http://localhost:9080/ferret

Gradle

1. Go to Help > Eclipse Marketplace > Install Buildship Gradle Integration 2.0
2. Clone this project and import into Eclipse as an 'Existing Gradle Project'.
3. Go to Window > Show View > Other > Gradle Executions & Gradle Tasks
4. Go to Gradle Tasks view and run clean in build folder, then build in build folder, then libertyStart in liberty folder.
5. You should see the following in the console: Application ferret started in XX.XX seconds.

Running in the Command Line

Maven cmd-line

This project can be built with Apache Maven. The project uses the Liberty Maven Plug-in to automatically download and install the Liberty Java EE Web Profile 7 runtime from Maven Central. The Liberty Maven Plug-in is also used to create, configure, and run the application on the Liberty server.

Use the following steps to run the application with Maven:

1. Execute the full Maven build. The Liberty Maven Plug-in will download and install the Liberty server.

   $ mvn clean install

2. To run the server Ferret sample execute:

   $ mvn liberty:run-server

Once the server is running, the application will be available under http://localhost:9080/ferret.

Please refer to the Liberty Maven Plug-in repository for documentation about using the Liberty Maven Plug-in.

Gradle cmd-line

This project can also be built and run with Gradle. The provided build.gradle file applies the Liberty Gradle Plug-in and is configured to automatically download and install the Liberty Java EE Web Profile 7 runtime from Maven Central. The Liberty Gradle Plug-in has built-in tasks that can be used to create, configure, and run the application on the Liberty server.

Use the following steps to run the application with the Gradle wrapper (Windows machines use gradlew.bat):

1. Execute the full Gradle build. The Liberty Gradle Plug-in will download and install the Liberty server.

   $ ./gradlew clean build

2. To start the server with the Servlet sample execute:

   $ ./gradlew libertyStart

   Alternatively, execute the run command:

   $ ./gradlew libertyRun --no-daemon

Once the server has started, the application will be available under http://localhost:9080/ferret.

3. To stop the server, execute:

   $ ./gradlew libertyStop

Note, if Gradle is properly installed, Gradle commands can be executed directly using gradle and wouldn't require gradlew.

Please refer to the Liberty Gradle Plug-in repository for documentation about using the Liberty Gradle Plug-in.

Deploying to Bluemix

Click the button below to deploy your own copy of this application to Bluemix.

Notice

© Copyright IBM Corporation 2014, 2017.

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.