Geck

Geck - is a demo JavaEE Application.

Includes:

JPA example (2 entities with simple mapping, persistence via JTA, simple DAO layer, lazy fetching)
JAX-RS example

Requirements

Java SDK 8
Maven
WildFly Application Server
python 2.6+ and pygmentize (for pretty json output)

Install and run application

0. Install WildFly App Server

$ wget http://download.jboss.org/wildfly/8.2.0.Final/wildfly-8.2.0.Final.zip
$ unzip wildfly-8.2.0.Final.zip
$ sudo ln -s `pwd`/wildfly-8.2.0.Final /opt/wildfly
$ cd /opt/wildfly/bin
$ ./add-user.sh

1. Run WildFly

$ cd /opt/wildfly/bin
$ ./standalone.sh

Admin console available on http://localhost:9990/

2. Run application

In a new terminal session:

$ git clone https://github.com/bromzh/geck.git
$ cd geck
$ mvn clean install
$ mvn wildfly:deploy

Go to http://localhost:8080/geck/

Testing REST API

User CRUD

Create new user

$ curl -s -H "Content-Type: application/json" \
    -X POST \
    -d '{"name": "user1", "age": 42, "email": "user1@example.com"}' \
    http://localhost:8080/geck/rest/users/ \
    | python -m json.tool | pygmentize -l json

{
    "age": 42,
    "email": "user1@example.com",
    "id": 1,
    "name": "user1"
}

Add another user:

$ curl -s -H "Content-Type: application/json" \
    -X POST \
    -d '{"name": "user2", "age": 27, "email": "user2@example.com"}' \
    http://localhost:8080/geck/rest/users/ \
    | python -m json.tool | pygmentize -l json

{
    "age": 27,
    "email": "user2@example.com",
    "id": 2,
    "name": "user2"
}

Get users list

$ curl -s http://localhost:8080/geck/rest/users/ \
    | python -m json.tool | pygmentize -l json

[
    {
        "age": 42,
        "email": "user1@example.com",
        "id": 1,
        "name": "user1"
    },
    {
        "age": 27,
        "email": "user2@example.com",
        "id": 2,
        "name": "user2"
    }
]

Get user by id

$ curl -s http://localhost:8080/geck/rest/users/1 \
    | python -m json.tool | pygmentize -l json

{
    "age": 42,
    "email": "user1@example.com",
    "id": 1,
    "name": "user1"
}

Change user data

$ curl -s -H "Content-Type: application/json" \
    -X PUT \
    -d '{"name": "user1", "age": 43, "email": "user1@example.com"}' \
    http://localhost:8080/geck/rest/users/1 \
    | python -m json.tool | pygmentize -l json

{
    "age": 43,
    "email": "user1@example.com",
    "id": 1,
    "name": "user1"
}

Delete user

$ curl -s -X DELETE http://localhost:8080/geck/rest/users/2

$ curl -s http://localhost:8080/geck/rest/users/ \
    | python -m json.tool | pygmentize -l json

[
    {
        "age": 43,
        "email": "user1@example.com",
        "id": 1,
        "name": "user1"
    }
]

Post CRUD

Create new post

$ curl -s -H "Content-Type: application/json" \
    -X POST \
    -d '{"title": "Post 1", "text": "This is a first post", "owner": {"id": 1}}' \
    http://localhost:8080/geck/rest/posts/ \
    | python -m json.tool | pygmentize -l json

{
    "id": 3,
    "owner": {
        "age": 43,
        "email": "user1@example.com",
        "id": 1,
        "name": "user1"
    },
    "text": "This is a first post",
    "title": "Post 1"
}

Get posts list

$ curl -s http://localhost:8080/geck/rest/posts/ \
    | python -m json.tool | pygmentize -l json

[
    {
        "id": 3,
        "owner": {
            "age": 43,
            "email": "user1@example.com",
            "id": 1,
            "name": "user1"
        },
        "text": "This is a first post",
        "title": "Post 1"
    }
]

Delete user and his posts

$ curl -s -X DELETE http://localhost:8080/geck/rest/users/1

$ curl -s http://localhost:8080/geck/rest/users/ \
    | python -m json.tool | pygmentize -l json

[]

$ curl -s http://localhost:8080/geck/rest/posts/ \
    | python -m json.tool | pygmentize -l json

[]