/*
* GNU LESSER GENERAL PUBLIC LICENSE
* Version 3, 29 June 2007
*
* Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
* Everyone is permitted to copy and distribute verbatim copies
* of this license document, but changing it is not allowed.
*
*
* This version of the GNU Lesser General Public License incorporates
* the terms and conditions of version 3 of the GNU General Public
* License, supplemented by the additional permissions listed below.
*
* 0. Additional Definitions.
*
* As used herein, "this License" refers to version 3 of the GNU Lesser
* General Public License, and the "GNU GPL" refers to version 3 of the GNU
* General Public License.
*
* "The Library" refers to a covered work governed by this License,
* other than an Application or a Combined Work as defined below.
*
* An "Application" is any work that makes use of an interface provided
* by the Library, but which is not otherwise based on the Library.
* Defining a subclass of a class defined by the Library is deemed a mode
* of using an interface provided by the Library.
*
* A "Combined Work" is a work produced by combining or linking an
* Application with the Library. The particular version of the Library
* with which the Combined Work was made is also called the "Linked
* Version".
*
* The "Minimal Corresponding Source" for a Combined Work means the
* Corresponding Source for the Combined Work, excluding any source code
* for portions of the Combined Work that, considered in isolation, are
* based on the Application, and not on the Linked Version.
*
* The "Corresponding Application Code" for a Combined Work means the
* object code and/or source code for the Application, including any data
* and utility programs needed for reproducing the Combined Work from the
* Application, but excluding the System Libraries of the Combined Work.
*
* 1. Exception to Section 3 of the GNU GPL.
*
* You may convey a covered work under sections 3 and 4 of this License
* without being bound by section 3 of the GNU GPL.
*
* 2. Conveying Modified Versions.
*
* If you modify a copy of the Library, and, in your modifications, a
* facility refers to a function or data to be supplied by an Application
* that uses the facility (other than as an argument passed when the
* facility is invoked), then you may convey a copy of the modified
* version:
*
* a) under this License, provided that you make a good faith effort to
* ensure that, in the event an Application does not supply the
* function or data, the facility still operates, and performs
* whatever part of its purpose remains meaningful, or
*
* b) under the GNU GPL, with none of the additional permissions of
* this License applicable to that copy.
*
* 3. Object Code Incorporating Material from Library Header Files.
*
* The object code form of an Application may incorporate material from
* a header file that is part of the Library. You may convey such object
* code under terms of your choice, provided that, if the incorporated
* material is not limited to numerical parameters, data structure
* layouts and accessors, or small macros, inline functions and templates
* (ten or fewer lines in length), you do both of the following:
*
* a) Give prominent notice with each copy of the object code that the
* Library is used in it and that the Library and its use are
* covered by this License.
*
* b) Accompany the object code with a copy of the GNU GPL and this license
* document.
*
* 4. Combined Works.
*
* You may convey a Combined Work under terms of your choice that,
* taken together, effectively do not restrict modification of the
* portions of the Library contained in the Combined Work and reverse
* engineering for debugging such modifications, if you also do each of
* the following:
*
* a) Give prominent notice with each copy of the Combined Work that
* the Library is used in it and that the Library and its use are
* covered by this License.
*
* b) Accompany the Combined Work with a copy of the GNU GPL and this license
* document.
*
* c) For a Combined Work that displays copyright notices during
* execution, include the copyright notice for the Library among
* these notices, as well as a reference directing the user to the
* copies of the GNU GPL and this license document.
*
* d) Do one of the following:
*
* 0) Convey the Minimal Corresponding Source under the terms of this
* License, and the Corresponding Application Code in a form
* suitable for, and under terms that permit, the user to
* recombine or relink the Application with a modified version of
* the Linked Version to produce a modified Combined Work, in the
* manner specified by section 6 of the GNU GPL for conveying
* Corresponding Source.
*
* 1) Use a suitable shared library mechanism for linking with the
* Library. A suitable mechanism is one that (a) uses at run time
* a copy of the Library already present on the user's computer
* system, and (b) will operate properly with a modified version
* of the Library that is interface-compatible with the Linked
* Version.
*
* e) Provide Installation Information, but only if you would otherwise
* be required to provide such information under section 6 of the
* GNU GPL, and only to the extent that such information is
* necessary to install and execute a modified version of the
* Combined Work produced by recombining or relinking the
* Application with a modified version of the Linked Version. (If
* you use option 4d0, the Installation Information must accompany
* the Minimal Corresponding Source and Corresponding Application
* Code. If you use option 4d1, you must provide the Installation
* Information in the manner specified by section 6 of the GNU GPL
* for conveying Corresponding Source.)
*
* 5. Combined Libraries.
*
* You may place library facilities that are a work based on the
* Library side by side in a single library together with other library
* facilities that are not Applications and are not covered by this
* License, and convey such a combined library under terms of your
* choice, if you do both of the following:
*
* a) Accompany the combined library with a copy of the same work based
* on the Library, uncombined with any other library facilities,
* conveyed under the terms of this License.
*
* b) Give prominent notice with the combined library that part of it
* is a work based on the Library, and explaining where to find the
* accompanying uncombined form of the same work.
*
* 6. Revised Versions of the GNU Lesser General Public License.
*
* The Free Software Foundation may publish revised and/or new versions
* of the GNU Lesser General Public License from time to time. Such new
* versions will be similar in spirit to the present version, but may
* differ in detail to address new problems or concerns.
*
* Each version is given a distinguishing version number. If the
* Library as you received it specifies that a certain numbered version
* of the GNU Lesser General Public License "or any later version"
* applies to it, you have the option of following the terms and
* conditions either of that published version or of any later version
* published by the Free Software Foundation. If the Library as you
* received it does not specify a version number of the GNU Lesser
* General Public License, you may choose any version of the GNU Lesser
* General Public License ever published by the Free Software Foundation.
*
* If the Library as you received it specifies that a proxy can decide
* whether future versions of the GNU Lesser General Public License shall
* apply, that proxy's public statement of acceptance of any version is
* permanent authorization for you to choose that version for the
* Library.
*/
package fb4java.service;
import fb4java.Facebook4j;
import fb4java.http.HttpResponseMessage;
import org.apache.http.client.ClientProtocolException;
import org.json.JSONException;
import java.io.IOException;
import java.net.URISyntaxException;
import java.util.Map;
public class PublishService extends Service {
private static final String COMMENTS_ADD = "comments.add";
private static final String COMMENTS_REMOVE = "comments.remove";
private static final String NOTES_CREATE = "notes.create";
private static final String NOTES_DELETE = "notes.delete";
private static final String NOTES_EDIT = "notes.edit";
private static final String STATUS_SET = "status.set";
private static final String STREAM_ADDCOMMENT = "stream.addComment";
private static final String STREAM_PUBLISH = "stream.publish";
private static final String STREAM_REMOVE = "stream.remove";
private static final String USERS_SETSTATUS = "users.setStatus";
public PublishService(Facebook4j f4j) {
super(f4j);
}
/**
*
* @param objectId
* @param comment
* @return
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
*/
public boolean addComment(String objectId, String comment) throws ClientProtocolException, URISyntaxException,
IOException {
return addComment(objectId, comment, "", "", true);
}
/**
*
* @param objectId
* @param comment
* @param title
* @param url
* @param doPublishToStream
* @return
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
*/
public boolean addComment(String objectId, String comment, String title, String url, boolean doPublishToStream)
throws ClientProtocolException,
URISyntaxException,
IOException {
if (objectId == null || objectId.trim().equals("") || comment == null || comment.trim().equals("")) {
throw new IllegalArgumentException("Invalid objectId/comment. Please check those two parameters.");
}
Map<String, String> listOfMethods = getBasicParams();
listOfMethods.put(METHOD, COMMENTS_ADD);
listOfMethods.put("object_id", objectId);
listOfMethods.put("text", comment);
if (title != null) {
listOfMethods.put("title", title);
}
if (url != null) {
listOfMethods.put("url", url);
}
listOfMethods.put("publish_to_stream", "" + doPublishToStream);
HttpResponseMessage response = f4j.sendGetRequest(listOfMethods);
return response.getStatusCode() < 300;
}
/**
* Add comment to a stream.
*
* @param postid
* post Id
* @param comment
* comment to be posted
* @return returns true if the operation is successful, otherwise false.
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
*/
public boolean addStreamComment(String postid, String comment) throws ClientProtocolException, URISyntaxException,
IOException {
if (comment == null || comment.trim().equals("") || postid == null || postid.trim().equals("")) {
throw new IllegalArgumentException("Please check parameters.");
}
Map<String, String> listOfMethods = getBasicParams();
listOfMethods.put(METHOD, STREAM_ADDCOMMENT);
listOfMethods.put("comment", comment);
listOfMethods.put("post_id", "" + postid);
HttpResponseMessage response = f4j.sendGetRequest(listOfMethods);
return response.getStatusCode() < 300;
}
/**
* This method requires extended permission: create_note. This method lets
* user write a Facebook note.
*
* @param userId
* User Id
* @param title
* Note Title
* @param content
* Note Content
* @return true if note created successfully, otherwise false
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
*/
public boolean createNote(long userId, String title, String content) throws ClientProtocolException,
URISyntaxException, IOException {
if (title == null || title.trim().equals("") || content == null || content.trim().equals("") || userId <= 0) {
throw new IllegalArgumentException("Invalid objectId/comment. Please check those two parameters.");
}
Map<String, String> listOfMethods = getBasicParams();
listOfMethods.put(METHOD, NOTES_CREATE);
listOfMethods.put("uid", "" + userId);
listOfMethods.put("title", title);
listOfMethods.put("content", content);
HttpResponseMessage response = f4j.sendGetRequest(listOfMethods);
return response.getStatusCode() < 300;
}
/**
* This method requires extended permission: create_note. This method lets
* user delete a Facebook note.
*
* @param userId
* User ID
* @param noteId
* Note Id
* @param title
* Note Title
* @param content
* Note Content
* @return true if note deleted successfully, otherwise false
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
*/
public boolean deleteNote(long userId, long noteId, String title, String content) throws ClientProtocolException,
URISyntaxException, IOException {
if ((title == null || title.trim().equals("")) && (content == null || content.trim().equals("")) && noteId <= 0) {
throw new IllegalArgumentException("Invalid objectId/comment. Please check those two parameters.");
}
Map<String, String> listOfMethods = getBasicParams();
listOfMethods.put(METHOD, NOTES_DELETE);
if (userId > 0) {
listOfMethods.put("uid", "" + userId);
}
if (title != null && title.trim().equals("")) {
listOfMethods.put("title", title);
}
if (content != null && content.trim().equals("")) {
listOfMethods.put("content", content);
}
if (noteId > 0) {
listOfMethods.put("note_id", "" + noteId);
}
HttpResponseMessage response = f4j.sendGetRequest(listOfMethods);
return response.getStatusCode() < 300;
}
/**
* This method requires extended permission: create_note. This method lets
* user delete a Facebook note.
*
* @param noteId
* Note ID
* @param title
* modified note title
* @param content
* modified note content
* @return true if note edited successfully, otherwise false
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
*/
public boolean editNote(long noteId, String title, String content) throws ClientProtocolException,
URISyntaxException, IOException {
if ((title == null || title.trim().equals("")) && (content == null || content.trim().equals("")) && noteId <= 0) {
throw new IllegalArgumentException("Invalid objectId/comment. Please check those two parameters.");
}
Map<String, String> listOfMethods = getBasicParams();
listOfMethods.put(METHOD, NOTES_EDIT);
if (title != null && title.trim().equals("")) {
listOfMethods.put("title", title);
}
if (content != null && content.trim().equals("")) {
listOfMethods.put("content", content);
}
if (noteId > 0) {
listOfMethods.put("note_id", "" + noteId);
}
HttpResponseMessage response = f4j.sendGetRequest(listOfMethods);
return response.getStatusCode() < 300;
}
/**
* Set logged in user's Status.
*
* @param message
* message to be posted on uid's wall
* @return returns true if the operation is successful, otherwise it returns
* false.
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
* @throws JSONException
*/
public boolean setStatus(String message) throws ClientProtocolException, URISyntaxException, IOException,
JSONException {
return setStatus(message, f4j.getUserId());
}
/**
* set user's Status. Please note that with private Key and it's permission,
* one can set anyone's status without limitation.
*
* @param message
* message to be posted on uid's wall
* @param uid
* user id
* @return returns true if the operation is successful, otherwise it returns
* false.
* @throws ClientProtocolException
* @throws URISyntaxException
* @throws IOException
* @throws JSONException
*/
public boolean setStatus(String message, long uid) throws ClientProtocolException, URISyntaxException, IOException,
JSONException {
if (message == null || message.trim().equals("")) {
throw new IllegalArgumentException("Please check parameters.");
}
Map<String, String> listOfMethods = getBasicParams();
listOfMethods.put(METHOD, STATUS_SET);
listOfMethods.put("status", message);
if (uid > 0) {
listOfMethods.put("uid", "" + uid);
}
HttpResponseMessage response = f4j.sendGetRequest(listOfMethods);
return response.getResponse().equals("true");
}
}