Expose endpoint for accessing Profile URL instead of bytes and Flexibility on Comments, Posts and Likes

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/CommentOperations.java

@@ -18,6 +18,7 @@
 import org.springframework.social.ApiException;
 import org.springframework.social.InsufficientPermissionException;
 import org.springframework.social.MissingAuthorizationException;
+import org.springframework.util.MultiValueMap;
 
 
 /**
@@ -43,6 +44,15 @@ public interface CommentOperations {
 	 */
 	PagedList<Comment> getComments(String objectId, PagingParameters pagedListParameters);
 
+	/**
+	 * Retrieves comments for a given object.
+	 * @param objectId the ID of the object
+	 * @param params the parameters defining the bounds of the list to return.
+	 * @return a list of {@link Comment}s for the specified object
+	 * @throws ApiException if there is an error while communicating with Facebook.
+	 */
+	PagedList<Comment> getComments(String objectId, MultiValueMap<String, String> params);
+
 	/**
 	 * Retrieves a single comment
 	 * @param commentId the comment ID

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/FeedOperations.java

@@ -20,6 +20,7 @@
 import org.springframework.social.InsufficientPermissionException;
 import org.springframework.social.MissingAuthorizationException;
 import org.springframework.social.RateLimitExceededException;
+import org.springframework.util.MultiValueMap;
 
 /**
  * Interface defining operations that can be performed on a Facebook feed.
@@ -99,6 +100,23 @@ public interface FeedOperations {
 	 * @throws ApiException if there is an error while communicating with Facebook.
 	 */
 	Post getPost(String entryId);
+
+	/**
+	 *  Retrieve a single post with meta data
+	 * @param entryId the entry ID
+	 * @return the requested {@link Post}
+	 * @throws ApiException if there is an error while communicating with Facebook.
+     */
+	Post getPostWithMeta(String entryId);
+
+	/**
+	 *  Retrieve a single post with meta data
+	 * @param entryId the entry ID
+	 * @param params the extended URI paramas
+	 * @return the requested {@link Post}
+	 * @throws ApiException if there is an error while communicating with Facebook.
+	 */
+	Post getPostWithMeta(String entryId, MultiValueMap<String, String> params);
 
 	/**
 	 * Retrieves the status entries from the authenticated user's feed.

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/GraphApi.java

@@ -111,6 +111,15 @@ public interface GraphApi {
 	 */
 	byte[] fetchImage(String objectId, String connectionName, Integer width, Integer height);
 
+	/**
+	 * Fetch the image url instead of the actual bytes
+	 * @param objectId the object ID
+	 * @param width desired width of the image (optional)
+	 * @param height desired height of the image (optional)
+	 * @return a URL of the image
+	 */
+	String fetchImageUrl(String objectId, Integer width, Integer height);
+
 	/**
 	 * Publishes data to an object's connection.
 	 * Requires appropriate permission to publish to the object connection.

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/LikeOperations.java

@@ -18,6 +18,7 @@
 import org.springframework.social.ApiException;
 import org.springframework.social.InsufficientPermissionException;
 import org.springframework.social.MissingAuthorizationException;
+import org.springframework.util.MultiValueMap;
 
 
 /**
@@ -47,6 +48,16 @@ public interface LikeOperations {
 	 */
 	PagedList<Reference> getLikes(String objectId, PagingParameters pagingParameters);
 
+	/**
+	 * Retrieves a page of references to users who have liked the specified object.
+	 * @param objectId the object ID (an Album, Checkin, Comment, Note, Photo, Post, or Video).
+	 * @param params the paging parameters for fetching a specific page of references.
+	 * @return a list of {@link Reference} objects for the users who have liked the object.
+	 * @throws ApiException if there is an error while communicating with Facebook.
+	 * @throws MissingAuthorizationException if FacebookTemplate was not created with an access token.
+     */
+	PagedList<Reference> getLikes(String objectId, MultiValueMap<String, String> params);
+
 	/**
 	 * Retrieves a list of pages that the authenticated user has liked.
 	 * Requires "user_likes" permission. Returns an empty list if permission isn't granted.

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/UserOperations.java

@@ -74,6 +74,15 @@ public interface UserOperations {
 	 */
 	byte[] getUserProfileImage(String userId, ImageType imageType);
 
+	/**
+	 * Get the user profile image url
+	 * @param userId the facebook user ID
+	 * @param width desired width of image (optional)
+	 * @param height desired height of image (optional)
+	 * @return Url of profile image
+	 */
+	String getUserProfileImageUrl(String userId, Integer width, Integer height);
+
 	/**
 	 * Retrieves the user's profile image. When height and width are both used,
 	 * the image will be scaled as close to the dimensions as possible and then

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/impl/CommentTemplate.java

@@ -41,6 +41,10 @@ public PagedList<Comment> getComments(String objectId, PagingParameters pagedLis
 		return graphApi.fetchConnections(objectId, "comments", Comment.class, getPagingParameters(pagedListParameters));
 	}
 
+	public PagedList<Comment> getComments(String objectId, MultiValueMap<String, String> params) {
+		return graphApi.fetchConnections(objectId, "comments", Comment.class, params);
+	}
+
 	public Comment getComment(String commentId) {
 		return graphApi.fetchObject(commentId, Comment.class, ALL_FIELDS);
 	}

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/impl/FacebookTemplate.java

@@ -326,6 +326,22 @@ public byte[] fetchImage(String objectId, String connectionType, Integer width,
 		return fetchImage(objectId, connectionType, null, width, height);
 	}
 
+	public String fetchImageUrl(String objectId, Integer width, Integer height) {
+		URIBuilder uriBuilder = URIBuilder.fromUri(getBaseGraphApiUrl() + objectId + "/picture");
+		if (width != null) {
+			uriBuilder.queryParam("width", width.toString());
+		}
+		if (height != null) {
+			uriBuilder.queryParam("height", height.toString());
+		}
+		try {
+			JsonNode response = getRestTemplate().getForObject(uriBuilder.build(), JsonNode.class);
+			return response.get("data").get("url").asText();
+		} catch (Exception e) {
+			throw new RuntimeException(e);
+		}
+	}
+
 	private byte[] fetchImage(String objectId, String connectionType, ImageType type, Integer width, Integer height) {
 		URIBuilder uriBuilder = URIBuilder.fromUri(getBaseGraphApiUrl() + objectId + "/" + connectionType);
 		if (type != null) {

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/impl/FeedTemplate.java

@@ -157,6 +157,17 @@ public Post getPost(String entryId) {
 		return deserializePost(null, Post.class, responseNode);
 	}
 
+	public Post getPostWithMeta(String entryId) {
+		ObjectNode responseNode = (ObjectNode) restTemplate.getForObject(graphApi.getBaseGraphApiUrl() + entryId + "?metadata=true", JsonNode.class);
+		return deserializePost(null, Post.class, responseNode);
+	}
+
+	public Post getPostWithMeta(String entryId, MultiValueMap<String, String> queryParameters) {
+		URIBuilder uriBuilder = URIBuilder.fromUri(graphApi.getBaseGraphApiUrl() + entryId).queryParams(queryParameters);
+		ObjectNode responseNode = (ObjectNode) restTemplate.getForObject(uriBuilder.build(), JsonNode.class);
+		return deserializePost(null, Post.class, responseNode);
+	}
+
 	public String updateStatus(String message) {
 		return post("me", message);
 	}

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/impl/LikeTemplate.java

@@ -22,6 +22,9 @@
 import org.springframework.social.facebook.api.PagingParameters;
 import org.springframework.social.facebook.api.Reference;
 import org.springframework.util.LinkedMultiValueMap;
+import org.springframework.util.MultiValueMap;
+
+import java.util.Map;
 
 class LikeTemplate implements LikeOperations {
 
@@ -47,6 +50,10 @@ public PagedList<Reference> getLikes(String objectId, PagingParameters pagingPar
 		return graphApi.fetchConnections(objectId, "likes", Reference.class, pagingParameters.toMap());
 	}
 
+	public PagedList<Reference> getLikes(String objectId, MultiValueMap<String, String> params) {
+		return graphApi.fetchConnections(objectId, "likes", Reference.class, params);
+	}
+
 	public PagedList<Page> getPagesLiked() {
 		return getPagesLiked("me");
 	}

spring-social-facebook/src/main/java/org/springframework/social/facebook/api/impl/UserTemplate.java

@@ -61,6 +61,8 @@ public byte[] getUserProfileImage(String userId) {
 		return getUserProfileImage(userId, ImageType.NORMAL);
 	}
 
+	public String getUserProfileImageUrl(String userId) { return getUserProfileImageUrl(userId, null, null);}
+
 	public byte[] getUserProfileImage(ImageType imageType) {
 		return getUserProfileImage("me", imageType);
 	}
@@ -69,6 +71,10 @@ public byte[] getUserProfileImage(String userId, ImageType imageType) {
 		return graphApi.fetchImage(userId, "picture", imageType);
 	}
 
+	public String getUserProfileImageUrl(String userId, Integer width, Integer height) {
+		return graphApi.fetchImageUrl(userId, width, height);
+	}
+
 	public byte[] getUserProfileImage(Integer width, Integer height) {
 		return getUserProfileImage("me", width, height);
 	}