You don't need to have any additional libraries included in your project. You will not run into trouble with dependency clashes. In addition, RestFB is highly portable and usable in both Android projects and normal Java applications.
Although we provide a default implementation for our core components, every component may be replaced with a custom implementation. Therefore RestFB integrates flawlessly in every kind of project. Even Android projects are supported.
The RestFB API is really minimal and you simply need to use a method to fetch information from and one to publish new items to Facebook. We provide default implementations for all core components, so you can drop the jar in your project and are ready to go.
Our Facebook types are simple POJOs with special annotations. This configuration is designed with ease of use in mind and can be used to really simple define custom types.
Newest Version of the
library is available via RestFB's home on Github.
View the
changelog here.
RestFB is a single JAR - just drop it into your app and you're ready to go. Download it from
Maven Central:
It's easy to work directly with the RestFB source code. This is necessary if you need to use an unreleased version or
want to contribute to the code. It's very important to know that RestFB is using
the Lombok
code generator. All types use special annotations to generate the boilerplate code for the
setter
s and getter
s. It's important to know that we made the design
decision to handle List
s and Map
s differently - the
Lombok annotations are not used for them
and we provide add()
, remove()
and getList()
methods.
The returned List
is immutable to prevent inner List
s and Map
s
from being altered by other objects. This idea can be found at Martin Fowler's blog.
You have to install Lombok in your IDE to compile RestFB. If you don't do this, you will see a lot of compilation errors and missing methods. Further information regarding the installation of Lombok for different IDEs can be found here.
Contributing code is a essential part of open source and we try to make this as easy as possible. You only need to
fork RestFB at Github and send us a pull request. We have some prerequisites to merge the pull request in our Dev
branch.
These conditions are defined to make everyone's lives easier and cause fewer conflicts when merging a pull request into the dev branch. If you put some work in a pull request and it meets our requirements, it's very likely we'll merge it the same day.
If you don't want to dive into the RestFB code you may open an issue. We are very thankful for every issue you open, no matter what kind it is. We solve bugs, explain Facebook, and answer your RestFB and Facebook questions.
restfb source code is placed on Github and the library itself evolves with the help of many great people. A lot of Github users contribute to restfb. We get many hints and questions, and of course many pull and feature requests. And we'd like to say thank you to everyone who has helped along the way!
The development of restfb is sponsored by these great companies and individuals. If you also like to sponsor us, please check the sponsor button on our RestFB Github page or send us a short note here.
Copyright (c) 2010-2022 Mark Allen, Norbert Bartels. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.