Added License to new files and comment to new API classes

api/src/main/java/org/jboss/seam/social/linkedin/LinkedIn.java

@@ -1,5 +1,18 @@
-/**
- * 
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
  */
 package org.jboss.seam.social.linkedin;
 
@@ -20,7 +33,8 @@
 @Retention(RUNTIME)
 @Documented
 /**
- * @author antoine
+ * A CDI qualifier annotation to qualify bean being released to LinkedIn configuration 
+ * @author Antoine Sabot-Durand
  *
  */
 public @interface LinkedIn

api/src/main/java/org/jboss/seam/social/linkedin/LinkedInHandler.java

@@ -1,12 +1,27 @@
-/**
- * 
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
  */
 package org.jboss.seam.social.linkedin;
 
 import org.jboss.seam.social.oauth.OAuthServiceHandler;
 
 /**
- * @author antoine
+ * A specialization of {@link OAuthServiceHandler} to add LinkedIn specific methods
+ * 
+ * @author Antoine Sabot-Durand
  *
  */
 public interface LinkedInHandler extends OAuthServiceHandler

api/src/main/java/org/jboss/seam/social/linkedin/package-info.java

@@ -0,0 +1,21 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
+ */
+package org.jboss.seam.social.linkedin;
+
+/**
+* This package contains API elements to manage interactions with LinkedIn thru CDI Beans 
+*/

api/src/main/java/org/jboss/seam/social/oauth/HttpResponse.java

@@ -1,13 +1,28 @@
-/**
- * 
- */
-package org.jboss.seam.social.oauth;
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
+ */package org.jboss.seam.social.oauth;
 
 import java.io.InputStream;
 import java.util.Map;
 
 /**
- * @author antoine
+ * 
+ * Implementation of this interface represent an Http Response
+ * 
+ * @author Antoine Sabot-Durand
  *
  */
 public interface HttpResponse

api/src/main/java/org/jboss/seam/social/oauth/Setted.java

@@ -16,22 +16,19 @@
  */
 package org.jboss.seam.social.oauth;
 
+import static java.lang.annotation.ElementType.FIELD;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.PARAMETER;
+import static java.lang.annotation.ElementType.TYPE;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
 import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 import javax.enterprise.util.Nonbinding;
-import javax.inject.Inject;
 import javax.inject.Qualifier;
 
-import org.jboss.seam.social.twitter.TwitterHandler;
-
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.ElementType.METHOD;
-import static java.lang.annotation.ElementType.PARAMETER;
-import static java.lang.annotation.ElementType.TYPE;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
 /**
  * A CDI Qualifier annotation to qualify and set OAuthServiceHandler directly in the code
  * It can be used like this :
@@ -41,7 +38,7 @@
  *    TwitterHandler service;
  *</pre>    
  * 
- * It's one of the alternates solution intitialize an OAuth service configuration
+ * It's one of the alternates solution initialize an OAuth service configuration
  * 
  * @author Antoine Sabot-Durand
  *

api/src/main/java/org/jboss/seam/social/twitter/TwitterHandler.java

@@ -18,7 +18,6 @@
 
 import org.jboss.seam.social.oauth.OAuthServiceHandler;
 import org.jboss.seam.social.twitter.domain.Credential;
-import org.jboss.seam.social.twitter.domain.SearchResult;
 import org.jboss.seam.social.twitter.domain.Tweet;
 
 

api/src/main/java/org/jboss/seam/social/twitter/domain/Credential.java

@@ -1,10 +1,28 @@
-/**
- * 
- */
-package org.jboss.seam.social.twitter.domain;
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
+ */package org.jboss.seam.social.twitter.domain;
+
+import org.jboss.seam.social.twitter.TwitterHandler;
 
 /**
- * @author antoine
+ *
+ * Implementation of this interface contains information about Twitter Credential of the current user
+ * It is returned by {@link TwitterHandler#verifyCrendentials()}
+ * 
+ * @author Antoine Sabot-Durand
  *
  */
 public interface Credential

api/src/main/java/org/jboss/seam/social/twitter/domain/SearchResult.java

@@ -1,14 +1,32 @@
-/**
- * 
- */
-package org.jboss.seam.social.twitter.domain;
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
+ */package org.jboss.seam.social.twitter.domain;
 
 import java.util.List;
 
+import org.jboss.seam.social.twitter.TwitterHandler;
+
 /**
- * @author antoine
- *
- */
+*
+* Implementation of this interface contains a Twitter search result
+* It is returned by {@link TwitterHandler#search()}
+* 
+* @author Antoine Sabot-Durand
+*
+*/
 public interface SearchResult
 {
 

api/src/main/java/org/jboss/seam/social/twitter/domain/Tweet.java

@@ -1,10 +1,26 @@
-/**
- * 
- */
-package org.jboss.seam.social.twitter.domain;
-
-/**
- * @author antoine
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
+ */package org.jboss.seam.social.twitter.domain;
+
+
+ /**
+ *
+ * Implementation of this interface contains a Tweet
+ *
+ * @author Antoine Sabot-Durand
  *
  */
 public interface Tweet

examples/web-client/src/main/java/org/jboss/seam/social/example/twitterweb/SocialClient.java

@@ -23,7 +23,6 @@
 import javax.inject.Named;
 
 import org.jboss.seam.social.oauth.Setted;
-import org.jboss.seam.social.twitter.Twitter;
 import org.jboss.seam.social.twitter.TwitterHandler;
 import org.jboss.seam.social.twitter.domain.Credential;
 

impl/src/main/java/org/jboss/seam/social/linkedin/LinkedInHanlderBean.java

@@ -1,5 +1,18 @@
-/**
- * 
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
  */
 package org.jboss.seam.social.linkedin;
 
@@ -8,16 +21,14 @@
 
 import org.jboss.seam.social.oauth.OAuthServiceHandlerScribe;
 import org.jboss.seam.social.oauth.OAuthServiceSettings;
-import org.jboss.seam.social.twitter.Twitter;
 import org.scribe.builder.api.Api;
 import org.scribe.builder.api.LinkedInApi;
-import org.scribe.builder.api.TwitterApi;
 
 /**
  * @author antoine
  *
  */
-//@Typed(LinkedInHanlderBean.class)
+@Typed(LinkedInHandler.class)
 public class LinkedInHanlderBean extends OAuthServiceHandlerScribe implements LinkedInHandler
 {
 

impl/src/main/java/org/jboss/seam/social/linkedin/LinkedInProducer.java

@@ -1,5 +1,18 @@
-/**
- * 
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
  */
 package org.jboss.seam.social.linkedin;
 

impl/src/main/java/org/jboss/seam/social/linkedin/package-info.java

@@ -0,0 +1,17 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
+ */
+package org.jboss.seam.social.linkedin;

impl/src/main/java/org/jboss/seam/social/oauth/HttpResponseScribe.java

@@ -1,5 +1,18 @@
-/**
- * 
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2011, Red Hat Middleware LLC, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * 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.
  */
 package org.jboss.seam.social.oauth;