High-performance batching Java API for Facebook
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



BatchFB is a Java library that provides a power-user's interface to Facebook's Graph API.

  • Automatically groups requests into the minimum number of remote calls to Facebook:
    • FQL queries are combined into a single multiquery.
    • FQL and Graph requests are combined into a single Graph Batch API request.
  • Provides a unified, coherent, and programmer-friendly set of exceptions from Graph and FQL calls.
  • Deeply integrates with Jackson to map Facebook results to your typesafe objects.

Additional bonus for Google App Engine users: Oversized batches are automatically split and executed in parallel, rather than serially. GAE is not required to use BatchFB.

Before you read the UserGuide, here is a quick example:

/** You write your own Jackson user mapping for the pieces you care about */
public class User {
    long uid;
    @JsonProperty("first_name") String firstName;
    String pic_square;
    String timezone;

Batcher batcher = new FacebookBatcher(accessToken);

Later<User> me = batcher.graph("me", User.class);
Later<User> mark = batcher.graph("markzuckerberg", User.class);
Later<List<User>> myFriends = batcher.query(
    "SELECT uid, first_name, pic_square FROM user WHERE uid IN" +
    "(SELECT uid2 FROM friend WHERE uid1 = " + myId + ")", User.class);
Later<User> bob = batcher.queryFirst("SELECT timezone FROM user WHERE uid = " + bobsId, User.class);
PagedLater<Post> feed = batcher.paged("me/feed", Post.class);

// No calls to Facebook have been made yet.  The following get() will execute the
// whole batch as a single Facebook call.
String timezone = bob.get().timezone;

// You can just get simple values forcing immediate execution of the batch at any time.
User ivan = batcher.graph("ivan", User.class).get();

Note: BatchFB requires that you understand both the Facebook API and Jackson's annotation-based configuration. For a more novice-friendly Java interface to Facebook, try RestFB.

Now, read the UserGuide.

You may also be interested in the ReleaseNotes.