ReactiveFB
ReactiveFB provides an API that bridges the reactive world of RxJava 2.0 with the callback-style of Facebook-SDK. The aim of the library is to :
- make the use of the facebook api easy and less boilerplate.
- expose the facebook api methods to the possibilities of the reactive world like transformations, filtering, composition.
Download :
Add this dependency to your app build.gradle
file :
compile 'com.beltaief.reactivefb:reactivefb:0.1.0-beta-1'
and these lines to your project build.gradle
file :
allprojects {
repositories {
maven {
url 'https://dl.bintray.com/wassimbenltaief/maven/'
}
}
}
This lib depends on :
- facebook-android-sdk:4.15.0
- rxjava:2.0.0
- rxandroid:2.0.0
How to use it ?
First initialize the lib :
ReactiveFB.sdkInitialize(this);
then you can use one of the methods provided by ReactiveFB :
Login :
// Login with LoginManager
Maybe<LoginResult> loginResult = ReactiveLogin.login(activityInstance);
// Login with LoginButton from an activity
Observable<LoginResult> loginResult = ReactiveLogin.loginWithButton(loginButtonInstance);
// Login with LoginButton from a fragment
Observable<LoginResult> loginResult = ReactiveLogin.loginWithButton(loginButtonInstance, fragmentInstance);
Note that you still have to add onActivityResult to intercept the facebook callbacks :
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
ReactiveLogin.onActivityResult(requestCode, resultCode, data);
}
Login with additional permisisons
Check if permission is granted :
boolean permissionIsGranted = ReactiveFB.checkPermission(PermissionHelper.USER_PHOTOS);
if a specific permission was not granted, ask for it with an additional permission call :
MaybeObserver<LoginResult> loginResult = ReactiveLogin.requestAdditionalPermission(permissions, activityInstance);
Note you still have to pass a list of Permission
to ask for additional permissions. Permission
is an enum of facebook permissions.
Example :
List<PermissionHelper> permissions = new ArrayList<>();
permissions.add(PermissionHelper.USER_PHOTOS);
permissions.add(PermissionHelper.USER_FRIENDS);
permissions.add(PermissionHelper.PUBLISH_ACTION);
permissions.add(PermissionHelper.RSVP_EVENT);
ReactiveLogin.requestAdditionalPermission(permissions, activityInstance).subscribe(...)
Alternatively, you can configure the permissions when initializing the lib. Provide a configuration and a list of permissions and set it just after initialization :
// define list of permissions
Permission[] permissions = new Permission[]{
PermissionHelper.USER_ABOUT_ME,
PermissionHelper.EMAIL,
PermissionHelper.USER_PHOTOS,
PermissionHelper.USER_EVENTS,
PermissionHelper.USER_ACTIONS_MUSIC,
PermissionHelper.USER_FRIENDS,
PermissionHelper.USER_GAMES_ACTIVITY,
PermissionHelper.USER_BIRTHDAY,
PermissionHelper.USER_TAGGED_PLACES,
PermissionHelper.USER_MANAGED_GROUPS,
PermissionHelper.PUBLISH_ACTION};
// add permission to a configuration
SimpleFacebookConfiguration configuration = new SimpleFacebookConfiguration.Builder()
.setAppId(String.valueOf(R.string.facebook_app_id))
.setPermissions(permissions)
.setDefaultAudience(DefaultAudience.FRIENDS)
.setAskForAllPermissionsAtOnce(false)
.build();
// init lib
ReactiveFB.sdkInitialize(this);
ReactiveFB.setConfiguration(configuration);
Graph Api Requests
The GraphAPI requests returns a java Single<GraphResponse>
and let you provide a json mapping strategy by your own.
// Get the profile of the logged in user
Single<GraphResponse> me = ReactiveRequest.getMe();
Single<GraphResponse> me = ReactiveRequest.getMe(fields);
// Get the list of the friends of the logged in user
Single<GraphResponse> friends = ReactiveRequest.getFriends();
Single<GraphResponse> friends = ReactiveRequest.getFriends(fields);
Single<GraphResponse> friends = ReactiveRequest.getFriends(fields, limit);
// Get a user profile by providing his facebookId
Single<GraphResponse> profile = ReactiveRequest.getProfile(profileId);
Single<GraphResponse> profile = ReactiveRequest.getProfile(profileId, fields);
Single<GraphResponse> profile = ReactiveRequest.getProfile(profileId, fields, limits);
// Get a list of albums of the logged in user
Single<GraphResponse> albums = ReactiveRequest.getMyAlbums();
Single<GraphResponse> albums = ReactiveRequest.getMyAlbums(fields);
Single<GraphResponse> albums = ReactiveRequest.getMyAlbums(fields, limit);
// Get a list of albums of a user
Single<GraphResponse> albums = ReactiveRequest.getAlbums(userId);
Single<GraphResponse> albums = ReactiveRequest.getAlbums(userId, fields);
Single<GraphResponse> albums = ReactiveRequest.getAlbums(userId, fields, limit);
// Get a photo of a user, album, page, event ..
Single<GraphResponse> photo = ReactiveRequest.getPhoto(photoId);
Single<GraphResponse> photo = ReactiveRequest.getPhoto(photoId, fields);
// Get list of photos of the logged in user
Single<GraphResponse> photos = ReactiveRequest.getMyPhotos();
Single<GraphResponse> photos = ReactiveRequest.getMyPhotos(fields);
Single<GraphResponse> photos = ReactiveRequest.getMyPhotos(fields, limit);
// Get list of photos of a user
Single<GraphResponse> photos = ReactiveRequest.getPhotos();
Single<GraphResponse> photos = ReactiveRequest.getPhotos(fields);
Single<GraphResponse> photos = ReactiveRequest.getPhotos(fields, limit);
You can compose with rx operators to get to your goal faster and efficiently. For example if you wants to get the logged in user albums and every photo of an album, in one block :
ReactiveRequest
.getMyAlbums(albumFields) // get albums
.map(this::parseAlbums) // parse json to list of Album
.flatMapObservable(Observable::fromIterable) // iterate throw collection
.flatMap(album -> ReactiveRequest.getPhoto(album.getCover().getId(), photoFields).toObservable()) // get one alb. photo
.doOnError(throwable -> Observable.empty()) // return Observable.empty if error occured
.map(this::parsePhoto)// transform json to Photo
.subscribe(
photo -> {
Log.d(TAG, "onNext");
addPhoto(photo);
},
throwable -> Log.d(TAG, "onError " + throwable.getMessage()),
() -> Log.d(TAG, "onComplete")
);
private void addPhoto(Photo photo) {
// add item
mAdapter.addItem(photo);
// notify inserted
...
}
More examples :
Check the sample project for more examples.
Todo
- Implement more GraphAPI requests.
- Pagination
- ..
Credits
This library is based on a fork of simple-facebook by sromku. All credits of the graph api GetAction class and Facebook entities returns to the nice work of sromku.
License
Copyright 2016 Wassim Beltaief
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.