ALF-9153 Update the new discussions service interfaces following review with Gav, and webscript testing experience

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@29670 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/service/cmr/discussion/PostInfo.java

@@ -0,0 +1,98 @@
+/*
+ * Copyright (C) 2005-2010 Alfresco Software Limited.
+ *
+ * This file is part of Alfresco
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.alfresco.service.cmr.discussion;
+
+import java.io.Serializable;
+import java.util.Date;
+
+import org.alfresco.repo.security.permissions.PermissionCheckValue;
+import org.alfresco.service.cmr.repository.NodeRef;
+
+/**
+ * This class represents a Post in a Forum Topic.
+ * 
+ * To retrieve replies to this, see 
+ *  {@link DiscussionService#listPostReplies(PostInfo, int, org.alfresco.query.PagingRequest)}
+ * 
+ * @author Nick Burch
+ * @since 4.0
+ */
+public interface PostInfo extends Serializable, PermissionCheckValue {
+   /**
+    * @return the NodeRef of the underlying post
+    */
+   NodeRef getNodeRef();
+   
+   /**
+    * @return the {@link TopicInfo} representing the topic this belongs to
+    */
+   TopicInfo getTopic();
+   
+   /**
+    * @return the System generated name for the post
+    */
+   String getSystemName();
+   
+   /**
+    * @return the Title of the post (if set)
+    */
+   String getTitle();
+   
+   /**
+    * Sets the Title of the post. Normally only the Primary Post
+    *  in a Topic has a Title set.
+    */
+   void setTitle(String title);
+   
+   /**
+    * @return the HTML Content of the post
+    */
+   String getContents();
+   
+   /**
+    * Sets the (HTML) Content of the post
+    */
+   void setContents(String contentHTML);
+   
+   /**
+    * @return the creator of the post
+    */
+   String getCreator();
+   
+   /**
+    * @return the modifier of the post
+    */
+   String getModifier();
+   
+   /**
+    * @return the creation date and time
+    */
+   Date getCreatedAt();
+   
+   /**
+    * @return the modification date and time
+    */
+   Date getModifiedAt();
+   
+//   /**
+//    * @return the Tags associated with the post
+//    * TODO Are posts ever tagged, or only ever topics?
+//    */
+//   List<String> getTags();
+}