Annotation based handler dispatch for REST/RPC protocols

[louiscryan]

Reviewers: shindig-dev,

Description:
Use annotations to describe the services exported by a protocol handler
class and their parameterization.
Additional services can be exported by creating Guice bindings.
RPC handlers can now support more operations than just the same list
that REST supports.
Added "system" endpoint to introspect the set of available endpoints,
this will be used for the os-lite implementation.
Fixed many, many API tests
The next phase of this work is to migrate all the basic protocol
handling into common so it can be used to makeRequest in terms of our
standard protocols.

Please review this at http://codereview.appspot.com/12646

Affected files:
   
java/social-api/src/main/java/org/apache/shindig/social/core/config/SocialApiGuiceModule.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/ActivityHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/ApiServlet.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/AppDataHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/BaseRequestItem.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/BasicHandlerRegistry.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/DataRequestHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/DataServiceServlet.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/HandlerDispatcher.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/HandlerPreconditions.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/HandlerRegistry.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/JsonRpcServlet.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/Operation.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/PersonHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/RequestItem.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/RestHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/RestfulRequestItem.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/RpcHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/RpcRequestItem.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/Service.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/StandardHandlerDispatcher.java
   
java/social-api/src/main/java/org/apache/shindig/social/opensocial/service/SystemHandler.java
   
java/social-api/src/main/java/org/apache/shindig/social/sample/service/SampleContainerHandler.java
   
java/social-api/src/test/java/org/apache/shindig/social/SocialApiTestsGuiceModule.java
   
java/social-api/src/test/java/org/apache/shindig/social/dataservice/integration/AbstractLargeRestfulTests.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/ActivityHandlerTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/AppDataHandlerTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/BaseRequestItemTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/BasicHandlerRegistryTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/DataServiceServletTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/JsonRpcServletTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/PersonHandlerTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/RestfulRequestItemTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/RpcRequestItemTest.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/service/TestHandler.java
   
java/social-api/src/test/java/org/apache/shindig/social/opensocial/spi/DataRequestHandlerTest.java