package cc.bran.tumblr.persistence;

import cc.bran.tumblr.types.Post;

/**
 * Represents a database with the ability to persist and retrieve {@link Post}s.
 * 
 * @author Brandon Pitman (brandon.pitman@gmail.com)
 */
public interface PostDb {

  Post get(long id) throws Exception;

  void put(Post post) throws Exception;
  
  void delete(long id) throws Exception;
}

@@ -244,65 +244,534 @@
 %0A%0A  
-Post get(long id) throws Exception;%0A%0A  void put(Post post
+/**%0A   * Delete a post from the database. Deleting a nonexistent post is a no-op.%0A   * %0A   * @param id%0A   *          the ID of the post to delete%0A   * @throws Exception%0A   *           if a database error occurs%0A   */%0A  void delete(long id) throws Exception;%0A%0A  /**%0A   * Gets a post from the database. Returns null if there is no such post.%0A   * %0A   * @param id%0A   *          the ID of the post to retrieve%0A   * @return the post, or null%0A   * @throws Exception%0A   *           if a database error occurs%0A   */%0A  Post get(long id
 ) th
@@ -790,32 +790,277 @@
 on;%0A
+%0A
   
-%0A  void delete(long id
+/**%0A   * Puts a post into the database. If there is already a post with the same ID, it is overwritten.%0A   * %0A   * @param post%0A   *          the post to put into the database%0A   * @throws Exception%0A   *           if a database error occurs%0A   */%0A  void put(Post post
 ) th

Add documentation to PostDb.