added likes interface

src/main/java/org/gcube/portal/social/networking/ws/methods/v2/Comments.java

@@ -45,6 +45,8 @@ public class Comments {
 	/*
 	 * Retrieve the list of comments belonging to the post id (key) of the token in the related context
 	 * @param key the key as in the POST JSON representation 
+	 * @pathExample /get-comments-by-post-id?key=9ea137e9-6606-45ff-a1a2-94d4e8760583
+	 * @return the list of comments belonging to the post identified by the key in the context identified by the token 
 	 */
 	@GET
 	@Produces(MediaType.APPLICATION_JSON)
@@ -81,7 +83,8 @@ public class Comments {
 		return Response.status(status).entity(responseBean).build();
 	}
 	/*
-	 * Retrieve the list of comments belonging to the owner of the token in the related context.
+	 * Retrieve the list of comments belonging to the owner of the token in the related context
+	 * @return the list of comments belonging to the owner of the token in the related context.
 	 */
 	@GET
 	@Produces(MediaType.APPLICATION_JSON)

src/main/java/org/gcube/portal/social/networking/ws/methods/v2/Likes.java

@@ -0,0 +1,84 @@
+package org.gcube.portal.social.networking.ws.methods.v2;
+
+
+import java.util.List;
+
+import javax.validation.ValidationException;
+import javax.validation.constraints.Min;
+import javax.validation.constraints.NotNull;
+import javax.ws.rs.GET;
+import javax.ws.rs.Path;
+import javax.ws.rs.Produces;
+import javax.ws.rs.QueryParam;
+import javax.ws.rs.core.MediaType;
+import javax.ws.rs.core.Response;
+import javax.ws.rs.core.Response.Status;
+
+import org.gcube.common.authorization.library.provider.AuthorizationProvider;
+import org.gcube.common.authorization.library.utils.Caller;
+import org.gcube.common.scope.api.ScopeProvider;
+import org.gcube.portal.databook.shared.Like;
+import org.gcube.portal.social.networking.ws.outputs.ResponseBean;
+import org.gcube.portal.social.networking.ws.utils.CassandraConnection;
+import org.gcube.portal.social.networking.ws.utils.ErrorMessages;
+import org.gcube.portal.social.networking.ws.utils.Filters;
+import org.slf4j.LoggerFactory;
+
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+import com.webcohesion.enunciate.metadata.rs.ResponseCode;
+import com.webcohesion.enunciate.metadata.rs.StatusCodes;
+
+/**
+ * REST interface for the social networking library (likes).
+ */
+@Path("2/likes")
+@RequestHeaders ({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	  @RequestHeader( name = "Content-Type", description = "application/json")	  
+	})
+public class Likes {
+
+	// Logger
+	private static final org.slf4j.Logger logger = LoggerFactory.getLogger(Likes.class);
+	
+	/*
+	 * Retrieve the list of likes belonging to the post id (key) of the token in the related context
+	 * @param key the key as in the POST JSON representation 
+	 * @pathExample /get-likes-by-post-id?key=9ea137e9-6606-45ff-a1a2-94d4e8760583
+	 * @return the list of likes belonging to the post identified by the key in the context identified by the token 
+	 */
+	@GET
+	@Produces(MediaType.APPLICATION_JSON)
+	@Path("get-likes-by-post-id")
+	@StatusCodes ({
+		@ResponseCode ( code = 200, condition = "The list of likes is put into the 'result' field"),
+		@ResponseCode ( code = 500, condition = ErrorMessages.ERROR_IN_API_RESULT)
+	})
+	public Response getAllLikesByPostId(
+			@NotNull
+			@QueryParam("key") 
+			String key) {
+
+		ResponseBean responseBean = new ResponseBean();
+		Status status = Status.OK;
+		Caller caller = AuthorizationProvider.instance.get();
+		String context = ScopeProvider.instance.get();
+		String username = caller.getClient().getId();
+		List<Like> likes = null;
+
+		try{
+			logger.info("Retrieving comments for user id " + username);
+			likes = CassandraConnection.getInstance().getDatabookStore().getAllLikesByPost(key);
+			responseBean.setResult(likes);
+			responseBean.setSuccess(true);
+		}catch(Exception e){
+			logger.error("Unable to retrieve such likes.", e);
+			responseBean.setMessage(e.getMessage());
+			responseBean.setSuccess(false);
+			status = Status.INTERNAL_SERVER_ERROR;
+		}
+
+		return Response.status(status).entity(responseBean).build();
+	}
+}

src/main/java/org/gcube/portal/social/networking/ws/methods/v2/Posts.java

@@ -141,6 +141,7 @@ public class Posts {
 	/**
 	 * Retrieve a given quantity of latest user's posts
 	 * @param quantity the number of latest post to get
+	 * @pathExample /get-posts-user-quantity?quantity=10
 	 * @return all posts of the auth token's owner in the context identified by the token, in reverse chronological order up to quantity (at most)
 	 * @throws ValidationException
 	 */
@@ -430,6 +431,7 @@ public class Posts {
 	 * 
 	 * @param from the range start (most recent feeds for this vre) has to be greater than 0
 	 * @param quantity the number of most recent feeds for this vre starting from "from" param
+	 * @pathExample /get-recent-posts-vre-by-range?from=1&quantity=10
 	 * @return a <class>RangePosts</class> containing of most recent feeds for this vre
 	 * @throws FeedTypeNotFoundException 
 	 * @throws PrivacyLevelTypeNotFoundException 
@@ -470,6 +472,13 @@ public class Posts {
 		return Response.status(status).entity(responseBean).build();
 	}
 
+	/**
+	 * Retrieve posts containing the hashtag in the context bound to the auth token
+	 * @param hashtag he hashtag to be contained within the posts
+	 * @pathExample /get-posts-by-hashtag?hashtag=#thehashtag
+	 * @return the posts in the context bound to the auth token matching the hashtag
+	 * @throws ValidationException
+	 */
 	@GET
 	@Path("get-posts-by-hashtag/")
 	@Produces({MediaType.APPLICATION_JSON})
@@ -477,12 +486,6 @@ public class Posts {
 		@ResponseCode ( code = 201, condition = "Sccessfull retrieved posts, they are reported in the 'result' field of the returned object"),
 		@ResponseCode ( code = 500, condition = ErrorMessages.ERROR_IN_API_RESULT)
 	})
-	/**
-	 * Retrieve posts containing the hashtag in the context bound to the auth token
-	 * @param hashtag he hashtag to be contained within the posts
-	 * @return the posts in the context bound to the auth token matching the hashtag
-	 * @throws ValidationException
-	 */
 	public Response getPostsByHashTags(
 			@QueryParam("hashtag") 
 			@NotNull(message="hashtag cannot be missing")