View Full Version : What happened to all the documentation??
Jun 27th, 2011, 08:00 PM
What happened to all the documentation (JavaDocs) on the TwitterApi and FacebookApi after the release of Spring Social 1.0.0.RC1???
Jun 27th, 2011, 08:19 PM
Relax, take a deep breath, no need for extreme punctuation. The Twitter and Facebook bindings were split out from the core project. The links are on the main project page, but perhaps not as clear as they should be. We'll make things clearer; in the mean time, here is a link to the JavaDoc API and Reference for each project. All of this stuff is also included in the download distribution for each project.
Spring Social | http://static.springsource.org/spring-social/docs/1.0.x/api/
Spring Social Twitter | http://static.springsource.org/spring-social-twitter/docs/1.0.x/api/
Spring Social Facebook | http://static.springsource.org/spring-social-facebook/docs/1.0.x/api/
Spring Social | http://static.springsource.org/spring-social/docs/1.0.x/reference/html/
Spring Social Twitter | http://static.springsource.org/spring-social-twitter/docs/1.0.x/reference/html/
Spring Social Facebook | http://static.springsource.org/spring-social-facebook/docs/1.0.x/reference/html/
Jun 27th, 2011, 08:29 PM
nice! thanks you. I use extreme punctuation in general :). I'll try to keep in down.
just a quick clarification: the Twitter and Facebook APIs are implemented by their dev teams. Spring Social just includes them in the org.springframework.social package ?
Jun 27th, 2011, 08:32 PM
Re: clarification: No, the Spring Social team has implemented the Twitter and Facebook bindings. The community maintains them with our help. We hope to have the support of Twitter and Facebook themselves in the future, once 1.0 is out. Having these bindings as a separate projects allows them to evolve independently with their own release schedule.
p.s. the APIs are actually linked on the project page, just not terribly obvious. Where were you looking by chance?
Jun 27th, 2011, 09:00 PM
what about the GraphApi? Is it implemented by Spring as well?
It is pretty obvious the location of the material you linked here. It is just that I need to spend a little more time scanning pages rather then asking on forums. I had the TwitterApi on a bookmark and when i when back to it, it just pointed to the social api with no more twitter and facebook and i though you guys forgot to link the docs back.
Jun 27th, 2011, 09:03 PM
Technically speaking, the provider (Facebook) implements their API. The Spring Social community implements a API *binding* in Java. Yes, the binding to the Facebook GraphApi was implemented by us.
Jun 27th, 2011, 09:10 PM
api binding. hmmm.. would it be too much trouble if you briefly explain what an Api Binding is? From google i got that it is language independent but that is it.
My specific question is: when i use the methods of GraphApi, for example: post(), are they implemented by Spring or by Facebook devs? meaning are they SpringSocial user dependent or i can use the GraphApi directly from Facebook where the methods would be the same as those of springsocial.api.facebook?
Jun 27th, 2011, 09:13 PM
Our Facebook.class calls the remote Facebook Graph API, which is hosted on Facebook's servers and implemented by the Facebook dev team. It allows you to easily invoke the Facebook API, implemented by the Facebook dev team, from Java. It's a "Java binding, or client interface, to the Facebook API"
Jun 27th, 2011, 09:14 PM
so the actual methods are written by facebook, thus they are the same if i start using facebookApi directly and not via springsocial?
Jun 28th, 2011, 07:12 AM
Alright, hopefully this is all clear now. If not, just look at the code of spring-social-facebook and it should become clear (you'll see how the binding is implemented, what it does, and the @author tags that indicate we developed it).
Jun 28th, 2011, 08:27 PM
thanks a lot. Sorry if I was a bit of a pain. I can understand the API and use it well, I just dont get when does the connection to facebook actaully happen. But its clear now.
Powered by vBulletin® Version 4.2.1 Copyright © 2013 vBulletin Solutions, Inc. All rights reserved.