codetest

================================================================================

CONTENTS:

1 Worksample - Description
2 Assignment - Blog REST-service
3 Installing Blog project
4 Integration Test

================================================================================

================================================================================ 1 Worksample - Description

If you do not already have one or more projects you're proud of and has opportunity to submit, please perform the following worksample:

The goal of the test is to show how you would normally take on a java-based programming task.

The assessment will be based on following criterias:

Clean design
Reuse (of code and 3rd party products)
Maintainability
Ability to test
Java Knowledge Base
Coding style

You decide how "deep" you go when implementing the task to satisfy the criterias.

================================================================================ 2 Assignment - Blog REST-service

Write a RESTful service that implement a simple version of serving blog-posts. A "Post" have the attributes [id:String, title:String, content:String]

We would like to see:

A client (command line or webapp) that calls a the servive with the correct arguments (and handles all possible/plausible errors) using REST API
- The client should be able to add, list, view and delete posts.
A blog server that can serve a REST-service according to the Swagger-specification below.
- That is:
  - List all posts
  - Create a post
  - Get one post by id
  - Delete one post by id

The REST service should support the following resources (swagger, can be viewd in editor.swagger.io)

swagger: "2.0"
info:
  description: "This is the definition of the API for code test as Pierce AB"
  version: "1.0.0"
  title: "Simple blog post API"
host: "localhost:8080"
basePath: "/blog-web"
schemes:
- "http"
paths:
  /posts:
    get:
      tags:
      - "post"
      summary: "Get all posts"
      description: "Returns all posts"
      operationId: "getAllPosts"
      produces:
      - "application/xml"
      - "application/json"
      responses:
        200:
          description: "successful operation"
          schema:
            $ref: "#/definitions/Post"
    post:
      tags:
      - "post"
      summary: "Add a new post"
      description: ""
      operationId: "addPost"
      consumes:
      - "application/json"
      - "application/xml"
      produces:
      - "application/xml"
      - "application/json"
      parameters:
      - in: "body"
        name: "body"
        description: "Post object that needs to be added"
        required: true
        schema:
          $ref: "#/definitions/Post"
      responses:
        201: 
          description: "OK of post"
          schema:
            $ref: "#/definitions/Post"
        405:
          description: "Invalid input"
    put:
      tags:
      - "post"
      summary: "Updates a post"
      description: ""
      operationId: "updatePost"
      consumes:
      - "application/json"
      - "application/xml"
      produces:
      - "application/xml"
      - "application/json"
      parameters:
      - in: "body"
        name: "body"
        description: "Post object that needs to be updated"
        required: true
        schema:
          $ref: "#/definitions/Post"
      responses:
        201: 
          description: "OK of post"
          schema:
            $ref: "#/definitions/Post"
        404: 
          description: "Post not found"
        405:
          description: "Invalid input"
  /posts/{postId}:
    get:
      tags:
      - "post"
      summary: "Find post by ID"
      description: "Returns a single post"
      operationId: "getPostById"
      produces:
      - "application/xml"
      - "application/json"
      parameters:
      - name: "postId"
        in: "path"
        description: "ID of post to return"
        required: true
        type: "string"
      responses:
        200:
          description: "successful operation"
          schema:
            $ref: "#/definitions/Post"
        204:
          description: "No content"
    delete:
      tags:
      - "post"
      summary: "Deletes a post"
      description: ""
      operationId: "deletePost"
      parameters:
      - name: "postId"
        in: "path"
        description: "Post id to delete"
        required: true
        type: "string"
      responses:
        200:
          description: "successful operation"
        404:
          description: "Post not found"
definitions:
  Post:
    type: "object"
    required:
    - "title"
    - "content"
    properties:
      id:
        type: "string"
        example: "1"
      title:
        type: "string"
        example: "what I did today"
      content:
        type: "string"
        example: "wrote a boring post"

References: https://jersey.java.net/documentation/latest/client.html http://swagger.io/

================================================================================ 3 Installing the Blog Ping project

Please follow the steps below:

Download and install Maven 3. You can download it from http://maven.apache.org/download.html.
Download Payara, to run embedded: http://www.payara.co.uk/downloads Payara Micro is enough to run
Run the command: "mvn install" in the root folder of the distributionfolder.
Run the blog-web

java -jar payara-micro-4.1.152.1.jar --deploy blog-web\target\blog-web.war
Go to address: http://localhost:8080/blog-web/hello-pierce. The server should respond with a text that reads: {"message":"Hello Pierce"}.
Now basic environment and Blog Ping project is installed correctly.

================================================================================ 4 Integration Test

The integration tests is (and should be) located under the maven artifact "integration test". These tests should test the expected behavior of a correct implementation of Blog posts.

There is a simple test to start with. You run the test with "mvn test-Dtest =*TestIntegr" .