Improving documentation of the SearchGitHub class and working on fetc…

…hing more interesting data from the Google Code forge. Successfully could grab one more property: watchers count. Related to #20 and #14.

src/java/main/br/ufpe/cin/groundhog/search/SearchGitHub.java

@@ -18,9 +18,8 @@
 import com.google.inject.Inject;
 
 /**
- * Responsible for searching projects on GitHub via its official API
+ * Performs the project search on GitHub, via its official JSON API
  * @author fjsj, gustavopinto, rodrigoalvesvieira
- *
  */
 public class SearchGitHub implements ForgeSearch {
 	private static String root = "https://api.github.com";
@@ -31,6 +30,13 @@ public SearchGitHub(Requests requests) {
 		this.requests = requests;
 	}
 
+	/**
+	 * 
+	 * @param urlStr the URL of the JSON document
+	 * @return a JSON object created filled with the content of the given JSON document
+	 * @throws IOException
+	 * @throws JSONException
+	 */
 	private JSONObject getJsonFromAPI(String urlStr) throws IOException, JSONException {
 		return new JSONObject(requests.get(urlStr));
 	}

src/java/main/br/ufpe/cin/groundhog/search/SearchGoogleCode.java

@@ -87,12 +87,18 @@ public List<Project> getProjects(String term, int page) throws SearchException {
 			for (Element tr : doc.select("#serp table tbody tr")) {
 				Element el = tr.child(0).child(0);
 
+				// The span element within the main search result that contains the number
+				// of people watching the project on Google Code
+				Element span = tr.child(1).child(2).child(0);
+
 				String projectName, description, imgSrc, iconURL, sourceCodeUrl;
+				int stars;
 
 				projectName = el.attr("href").split("/")[2];
 				description = tr.child(1).ownText();
 				imgSrc = el.child(0).attr("src");
 				iconURL = imgSrc;
+				stars = Integer.parseInt(span.text());
 
 				if (imgSrc.startsWith("/")) {
 					iconURL = root + iconURL;
@@ -101,6 +107,8 @@ public List<Project> getProjects(String term, int page) throws SearchException {
 				sourceCodeUrl = "https://code.google.com/p/" + projectName + "/source/browse/";
 
 				Project forgeProject = new Project(projectName, description, iconURL, sourceCodeUrl);
+				forgeProject.setWatchersCount(stars);
+				forgeProject.setFollowersCount(stars);
 				projects.add(forgeProject);
 			}