Site Service: refactor container API (Java & JS) to have separate create method, fix-up UI fallout, expose node details on site details (Java/JS/REST), fixup web scripts with correct permission levels

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

source/java/org/alfresco/repo/site/SiteInfo.java

@@ -24,18 +24,59 @@
  */
 package org.alfresco.repo.site;
 
+import org.alfresco.service.cmr.repository.NodeRef;
+
 /**
+ * Site Information Class
+ * 
  * @author Roy Wetherall
  */
 public class SiteInfo
 {
+    /** Site node reference */    
+    private NodeRef nodeRef;
+    
+    /** Site preset */
     private String sitePreset;
+    
+    /** Site short name */
     private String shortName;
+    
+    /** Site title */
     private String title;
+    
+    /** Site description */
     private String description;
+    
+    /** Indicates whether the site is public or not */
     private boolean isPublic;
    
-    public SiteInfo(String sitePreset, String shortName, String title, String description, boolean isPublic)
+    /**
+     * Constructor
+     * 
+     * @param sitePreset    site preset
+     * @param shortName     short name
+     * @param title         title
+     * @param description   description
+     * @param isPublic      is site public
+     * @param nodeRef       site node reference
+     */
+    /*package*/ SiteInfo(String sitePreset, String shortName, String title, String description, boolean isPublic, NodeRef nodeRef)
+    {
+        this(sitePreset, shortName, title, description, isPublic);
+        this.nodeRef = nodeRef;
+    }
+    
+    /**
+     * Constructor
+     * 
+     * @param sitePreset    site preset
+     * @param shortName     short name
+     * @param title         title
+     * @param description   description
+     * @param isPublic      is site public
+     */
+    /*package*/ SiteInfo(String sitePreset, String shortName, String title, String description, boolean isPublic)
     {
         this.sitePreset = sitePreset;
         this.shortName = shortName;
@@ -44,41 +85,91 @@ public class SiteInfo
         this.isPublic = isPublic;
     }
     
+    /**
+     * Get the site node reference
+     * 
+     * @return  NodeRef     site node reference, null if not set
+     */
+    public NodeRef getNodeRef()
+    {
+        return nodeRef;
+    }
+    
+    /**
+     * Get the site preset
+     * 
+     * @return  String  site preset
+     */
     public String getSitePreset()
     {
         return sitePreset;
     }
     
+    /**
+     * Get the short name
+     * 
+     * @return  String  short name
+     */
     public String getShortName()
     {
         return shortName;
     }
     
+    /**
+     * Get the title
+     * 
+     * @return  String  site title
+     */
     public String getTitle()
     {
         return title;
     }
     
+    /**
+     * Set the title
+     * 
+     * @param title site title
+     */
     public void setTitle(String title)
     {
         this.title = title;
     }
     
+    /**
+     * Get the description
+     * 
+     * @return  String  site description
+     */
     public String getDescription()
     {
         return description;
     }
     
+    /**
+     * Set the description
+     * 
+     * @param description   site description
+     */
     public void setDescription(String description)
     {
         this.description = description;
     }
     
+    /**
+     * Sets whether the site is public or not
+     * 
+     * @param isPublic  true if the site is public, false otherwise
+     */
     public void setIsPublic(boolean isPublic)
     {
         this.isPublic = isPublic;
     }
     
+    /**
+     * Indicates wehther the site is public
+     * 
+     * @return  boolean true if public false otherwise
+     */
     public boolean getIsPublic()
     {
         return this.isPublic;