FacebookTemplate (Spring Social Facebook 1.1.1.RELEASE API)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.social.facebook.api.impl
Class FacebookTemplate

java.lang.Object
  org.springframework.social.oauth2.AbstractOAuth2ApiBinding
      org.springframework.social.facebook.api.impl.FacebookTemplate

All Implemented Interfaces:: org.springframework.social.ApiBinding, Facebook, GraphApi

public class FacebookTemplate
extends org.springframework.social.oauth2.AbstractOAuth2ApiBinding
implements Facebook
extends org.springframework.social.oauth2.AbstractOAuth2ApiBinding
implements Facebook

This is the central class for interacting with Facebook.

There are some operations, such as searching, that do not require OAuth authentication. In those cases, you may use a FacebookTemplate that is created through the default constructor and without any OAuth details. Attempts to perform secured operations through such an instance, however, will result in NotAuthorizedException being thrown.

Field Summary

Fields inherited from interface org.springframework.social.facebook.api.GraphApi
`GRAPH_API_URL`

Constructor Summary
`FacebookTemplate()` Create a new instance of FacebookTemplate.
`FacebookTemplate(String accessToken)` Create a new instance of FacebookTemplate.
`FacebookTemplate(String accessToken, String applicationNamespace)`

Method Summary

CommentOperations commentOperations()
API for reading and posting comments.

protected void configureRestTemplate(RestTemplate restTemplate)

void delete(String objectId)
Deletes an object.

void delete(String objectId, String connectionType)
Deletes an object connection.

EventOperations eventOperations()
API for performing operations on events.

FeedOperations feedOperations()
API for performing operations on feeds.





<T> PagedList<T>

fetchConnections(String objectId,
                 String connectionType,
                 Class<T> type,
                 MultiValueMap<String,String> queryParameters)

Fetches connections, extracting them into a collection of the given Java type Requires appropriate permission to fetch the object connection.





<T> PagedList<T>

fetchConnections(String objectId,
                 String connectionType,
                 Class<T> type,
                 MultiValueMap<String,String> queryParameters,
                 String... fields)

Fetches connections, extracting them into a collection of the given Java type Requires appropriate permission to fetch the object connection.





<T> PagedList<T>

fetchConnections(String objectId,
                 String connectionType,
                 Class<T> type,
                 String... fields)

Fetches connections, extracting them into a collection of the given Java type Requires appropriate permission to fetch the object connection.

byte[] fetchImage(String objectId, String connectionType, ImageType type)
Fetches an image as an array of bytes.





<T> T

fetchObject(String objectId,
            Class<T> type)

Fetches an object, extracting it into the given Java type Requires appropriate permission to fetch the object.





<T> T

fetchObject(String objectId,
            Class<T> type,
            MultiValueMap<String,String> queryParameters)

Fetches an object, extracting it into the given Java type Requires appropriate permission to fetch the object.





<T> PagedList<T>

fetchPagedConnections(String objectId,
                      String connectionType,
                      Class<T> type,
                      MultiValueMap<String,String> queryParameters)

FqlOperations fqlOperations()
API for performing Facebook Query Language (FQL) queries.

FriendOperations friendOperations()
API for performing operations with a user's set of friends.

String getApplicationNamespace()

protected MappingJackson2HttpMessageConverter getJsonMessageConverter()

protected org.springframework.social.oauth2.OAuth2Version getOAuth2Version()

GroupOperations groupOperations()
API for performing operations on groups.

LikeOperations likeOperations()
API for performing operations against user likes and interests.

MediaOperations mediaOperations()
API for performing operations on albums, photos, and videos.

OpenGraphOperations openGraphOperations()
API for working with OpenGraph actions.

PageOperations pageOperations()
API for working with Facebook pages.

PlacesOperations placesOperations()
API for performing Facebook Places checkin operations.

void post(String objectId, String connectionType, MultiValueMap<String,String> data)
Publishes data to an object's connection.

String publish(String objectId, String connectionType, MultiValueMap<String,Object> data)
Publishes data to an object's connection.

QuestionOperations questionOperations()
API for performing question operations.

RestOperations restOperations()
Returns the underlying RestOperations object allowing for consumption of Facebook endpoints that may not be otherwise covered by the API binding.

void setRequestFactory(ClientHttpRequestFactory requestFactory)

UserOperations userOperations()
API for performing operations on Facebook user profiles.

Methods inherited from class org.springframework.social.oauth2.AbstractOAuth2ApiBinding
`getByteArrayMessageConverter, getFormMessageConverter, getMessageConverters, getRestTemplate, isAuthorized`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Methods inherited from interface org.springframework.social.ApiBinding
`isAuthorized`

Constructor Detail

FacebookTemplate

public FacebookTemplate()

Create a new instance of FacebookTemplate. This constructor creates a new FacebookTemplate able to perform unauthenticated operations against Facebook's Graph API. Some operations do not require OAuth authentication. For example, retrieving a specified user's profile or feed does not require authentication (although the data returned will be limited to what is publicly available). A FacebookTemplate created with this constructor will support those operations. Those operations requiring authentication will throw NotAuthorizedException.

FacebookTemplate

public FacebookTemplate(String accessToken)

Create a new instance of FacebookTemplate. This constructor creates the FacebookTemplate using a given access token.

Parameters:: accessToken - An access token given by Facebook after a successful OAuth 2 authentication (or through Facebook's JS library).

FacebookTemplate

public FacebookTemplate(String accessToken,
                        String applicationNamespace)

Method Detail

setRequestFactory

public void setRequestFactory(ClientHttpRequestFactory requestFactory)

Overrides:: setRequestFactory in class org.springframework.social.oauth2.AbstractOAuth2ApiBinding