Added apiee

Signed-off-by:Phillip Kruger <phillip.kruger@gmail.com>

jello-cards/pom.xml

@@ -67,7 +67,14 @@
             <version>3.12.2</version>
             <scope>runtime</scope>
         </dependency>    
-
+
+        <!-- Apiee -->
+        <dependency>
+            <groupId>com.github.phillip-kruger</groupId>
+            <artifactId>apiee-core</artifactId>
+            <version>1.0.8</version>
+        </dependency>  
+
         <!-- Testing -->
         <dependency>
             <groupId>org.jboss.arquillian.testng</groupId>

jello-cards/src/main/java/com/github/phillipkruger/jello/api/ApplicationConfig.java

@@ -1,5 +1,8 @@
 package com.github.phillipkruger.jello.api;
 
+import io.swagger.annotations.Contact;
+import io.swagger.annotations.Info;
+import io.swagger.annotations.SwaggerDefinition;
 import javax.annotation.security.DeclareRoles;
 import javax.ws.rs.ApplicationPath;
 import javax.ws.rs.core.Application;
@@ -10,6 +13,17 @@
  * @author Phillip Kruger (phillip.kruger@redhat.com)
  */
 @ApplicationPath("/api")
+@SwaggerDefinition (info = @Info (
+                    title = "Jello Service",
+                    description = "A simple REST API for Jello",
+                    version = "1.0.0",
+                    contact = @Contact (
+                        name = "Phillip Kruger", 
+                        email = "apiee@phillip-kruger.com", 
+                        url = "http://phillip-kruger.com"
+                    )
+                )
+            )
 @DeclareRoles({ "user", "admin" })
 public class ApplicationConfig extends Application {
 

jello-cards/src/main/java/com/github/phillipkruger/jello/api/CardRestApi.java

@@ -2,6 +2,8 @@
 
 import com.github.phillipkruger.jello.Card;
 import com.github.phillipkruger.jello.service.CardService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import java.net.URI;
 import java.util.List;
 import javax.inject.Inject;
@@ -27,6 +29,7 @@
 @Path("/card")
 @Produces(MediaType.APPLICATION_JSON)
 @Consumes(MediaType.APPLICATION_JSON)
+@Api(value = "Card service")
 @Log
 public class CardRestApi {
 
@@ -37,12 +40,14 @@ public class CardRestApi {
     private UriInfo uriInfo;
 
     @POST
+    @ApiOperation(value = "Create a new Card", notes = "Create a card using json")
     public Response createCard(Card card){
         card = cardService.createCard(card);
         return Response.created(getGetUri(card)).build();
     }
 
     @PUT
+    @ApiOperation(value = "Update a new Card", notes = "Update a card using json")
     public Response updateCard(Card card){
         if(card.getId()==null)return createCard(card);
         card = cardService.updateCard(card);
@@ -51,6 +56,7 @@ public Response updateCard(Card card){
 
     @GET
     @Path("/{id}")
+    @ApiOperation(value = "Get a Card", notes = "Get a card using an Id", response = Card.class)
     public Response getCard(@PathParam("id") Long id){
         Card card = cardService.getCard(id);
         if(card==null)return Response.noContent().build();
@@ -59,13 +65,15 @@ public Response getCard(@PathParam("id") Long id){
 
     @DELETE
     @Path("/{id}")
+    @ApiOperation(value = "Delete a Card", notes = "Delete a card with an Id")
     public Response removeCard(@PathParam("id") Long id){
         Card card = cardService.getCard(id);
         if(card!=null)cardService.removeCard(card);
         return Response.noContent().build();
     }
 
     @GET
+    @ApiOperation(value = "Get all cards", notes = "Get all cards in json")
     public Response getCards(){
         List<Card> cards = cardService.getAllCards();
         if(cards==null || cards.isEmpty())return Response.noContent().build();