Add a getDocument() function that calls the api docs.getSettings func…

…tion to create a Document from a document id.

examples/SimpleTest.java

@@ -59,5 +59,8 @@ public static void main(String[] args) {
         for (ScribdDocument doc : featuredList) {
             System.out.println(doc);
         }
+
+        System.out.println("===== Get Document =====");
+        System.out.println(scribd.getDocument(73038675));
     }
 }

src/com/scribd/jscribd/Scribd.java

@@ -109,4 +109,25 @@ public List<ScribdDocument> getFeaturedDocuments(String scope, int limit, int of
 
         return list;
     }
+
+    /**
+     * For more information, see the Scribd API documentation:
+     * http://www.scribd.com/developers/api?method_name=docs.getSettings
+     *
+     * @param doc_id The ID for the document.
+     * @return The ScribdDocument corresponding to the ID.
+     */
+    public ScribdDocument getDocument(int doc_id) {
+        Map<String, Object> fields = new HashMap<String, Object>();
+        fields.put("doc_id", doc_id);
+
+        Document xml = api.sendRequest("docs.getSettings", fields);
+        NodeList results = xml.getElementsByTagName("rsp");
+
+        if (results.getLength() < 1) {
+            return null;
+        }
+
+        return new ScribdDocument(api, results.item(0));
+    }
 }