Skip to content

jasonray/jersey-starterkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview

This is a starter project using jax-rs / jersey. I've created this because I often find myself wanting to expirement with something that needs a webservice, and this gives me a starting spot. Clone or fork and use as needed.

Note: if you like this version, I highly recommend checking out the sample dropwizard implemenation (https://github.com/jasonray/jersey-starterkit/tree/dropwizard), much better for quick implemenations of java based web services. I love me some dropwizard. Until I discovered node/express.

How-to run

0.1) Pre-req

You will need the following installed: Java Gradle (optional) A java web container, such as Tomcat.

If you are on a mac, I recommend to do the following:

brew cask install java
brew install tomcat

If you will be using Tomcat, you will likely want to make sure you have CATALINA_HOME set.
On a mac, edit your profile

vi ~/.bash_profile

and then add the following (replacing with the directory where you Tomcat instance is deployed:

export CATALINA_HOME=/usr/local/Cellar/tomcat/x.x.x/libexec
  1. Compile The project compiles using gradle. If you already have gradle installed, compile using:
gradle build

If you do not have gradle installed, you can utilize the gradle wrapper included in the source

./gradlew war

The war file is compiled to: build/libs/jersey-starterkit.war

  1. Deploy the war file to web container. I've been using apache-tomcat [http://tomcat.apache.org], and typically copy the war to the tomcat webapps directory. On my machine:
cp build/libs/jersey-starterkit.war /usr/local/Cellar/tomcat/x.x.x/libexec/webapps/

Shortcut: if you are using tomcat, and $CATALINA_HOME is set, you can run: ./deploy.sh

  1. Confirm that it is running by fetching the URL at on webcontainer + /jersey-helloworld/rest/hello. On my machine:
curl localhost:8080/jersey-starterkit/rest/hello

The supported endpoints are:

http://localhost:8080/jersey-starterkit/rest/customer/id/1
http://localhost:8080/jersey-starterkit/rest/echo?m=hello
http://localhost:8080/jersey-starterkit/rest/hello

Opening in Eclipse

If you use Eclipse, the gradle scripts are nice enough to create your eclipse project and classpath files.

First time only

If you have gradle installed, run:

gradle eclipse

Now you can import the project into eclipse.

Updating classpath files

If you update dependencies, pull the new libs into your classpath:

gradle eclipseClasspath

Logging

There is a log4j configuration defined in src/main/resources/log4j.properties. By default this will log to the STDOUT and to a series of log files. Change the logging configuration as needed.

If you would like to use the default logging, create the logging folders:

> sudo mkdir /restapi
> chmod a+wr /restapi

About

Sample java project showing a hello world jersey project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •