/*
* 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;
import fb4java.beans.BasicUserInfo;
import fb4java.beans.interfaces.Parameterable;
import fb4java.http.HttpResponseMessage;
import fb4java.service.DataRetrievalService;
import fb4java.util.Utility;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.StatusLine;
import org.apache.http.auth.AuthenticationException;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.json.JSONException;
import java.io.IOException;
import java.io.InputStream;
import java.net.URI;
import java.net.URISyntaxException;
import java.util.ArrayList;
import java.util.Date;
import java.util.Map;
/**
*
* fb4java<br />
* fb4java
*
* @author Choongsan Ro
* @version 1.0 2010. 3. 9.
*/
public class Facebook4j {
private String sessionKey;
private String apiKey;
private String apiSecret;
private String appId;
private Long userId;
private Date sessionExpires;
private HttpClient httpclient;
/**
* Protocol that facebook REST server uses.
*/
private static final String PROTOCOL = "HTTPS";
private static final String SERVER_ADDRESS = "api.facebook.com";
private static final String RESOURCE_URL = "/restserver.php";
private static final String CONTENT_TYPE = "application/x-www-form-urlencoded";
/**
* current Facebook API version
*/
public static final String VERSION = "1.0";
/**
*
* @param apiKey
* Facebook API Key
* @param apiSecret
* Facebook API Secret
*/
public Facebook4j(String apiKey, String apiSecret) {
this.apiKey = apiKey;
this.apiSecret = apiSecret;
httpclient = new DefaultHttpClient();
}
/**
* Personal Information that's provided by Facebook.
*
* @return BasicUserInfo object containing viewer's information
* @see BasicUserInfo
*/
public BasicUserInfo getMyInfo() {
BasicUserInfo userInfo = new BasicUserInfo();
DataRetrievalService dataRetSvc = new DataRetrievalService(this);
ArrayList<Parameterable> myInfo = new ArrayList<Parameterable>();
try {
dataRetSvc.getUserInfo(new Long[] { userId }, myInfo, userInfo.getClass());
} catch (Exception e) {
e.printStackTrace();
return null;
}
if (myInfo.size() <= 0) {
return null;
} else {
userInfo = (BasicUserInfo) myInfo.get(0);
}
return userInfo;
}
public String getSessionKey() {
return sessionKey;
}
public long getUserId() {
return userId;
}
/**
*
* @param listOfMethods
* @return
* @throws URISyntaxException
* @throws ClientProtocolException
* @throws IOException
* @throws AuthenticationException
*/
public HttpResponseMessage sendGetRequest(Map<String, String> listOfMethods) throws URISyntaxException,
ClientProtocolException, IOException {
HttpResponseMessage rslt = null;
String sig = Utility.convetToSignature(listOfMethods, apiSecret);
URI uri = Utility.createURI(listOfMethods, PROTOCOL, SERVER_ADDRESS, RESOURCE_URL, sig, null);
HttpGet get = new HttpGet(uri);
HttpResponse resp = httpclient.execute(get);
StatusLine status = resp.getStatusLine();
HttpEntity respEntity = resp.getEntity();
InputStream content = respEntity.getContent();
rslt = new HttpResponseMessage("GET", uri.toURL(), status.getStatusCode(), content);
return rslt;
}
/**
*
* @param listOfMethods
*/
public void setApiKeyParam(Map<String, String> listOfMethods) {
listOfMethods.put("api_key", apiKey);
listOfMethods.put("format", "json");
listOfMethods.put("v", VERSION);
}
/**
* Sets Application ID
*
* @param appId
* Application ID that's displayed on <a
* href='http://www.facebook.com/developers/apps.php'>My
* Applications Page</a>
*/
public void setAppId(String appId) {
this.appId = appId;
}
/**
* Sets a data structure for method. Requirement Params consists of
* session_key, api_key, format, and v.
*
* @param listOfMethods
* An Object that methods and it's value to be set.
*/
public void setRequirementParam(Map<String, String> listOfMethods) {
setApiKeyParam(listOfMethods);
listOfMethods.put("session_key", sessionKey);
}
/**
* Sets Session Expiration date for this connection.
*
* @param d
* Date object
*/
public void setSessionExpires(Date d) {
this.sessionExpires = d;
}
/**
* Sets Session Key for this connection. Session key will live until
* expiration date. If session expiration is set null, it is considered as
* this session has never expiring session.
*
* @param sessionKey
*/
public void setSessionKey(String sessionKey) {
this.sessionKey = sessionKey;
}
/**
*
* @param userid
*/
public void setUserId(long userid) {
this.userId = userid;
}
}