Package org.alfresco.service.cmr.blog

Interface BlogService

All Known Implementing Classes:
BlogServiceImpl
public interface BlogService
The Blog Service handles the management (CRUD) of Alfresco blog data, namely the blog posts which are exposed in the Share UI under the "Blog" heading.

Please note that this service is a work in progress and currently exists primarily to support the blogs REST API.

Since:
4.0
Author:
Neil Mc Erlean (based on existing webscript controllers in the REST API)

  • Method Details

    • createBlogPost

      BlogPostInfo createBlogPost(String siteShortName, String blogTitle, String blogContent, boolean isDraft)
      Creates a new blog post in the specified site
      Parameters:
      siteShortName - the name of the site to add the post to.
      blogTitle - the title of the blog post.
      blogContent - text/html content of the blog post.
      isDraft - true if the blog post is a draft post, else false.
      Returns:
      The BlogPostInfo of the newly created blog post.
      See Also:

    • createBlogPost

      BlogPostInfo createBlogPost(NodeRef blogContainerNode, String blogTitle, String blogContent, boolean isDraft)
      Creates a new blog post within the specified container node.
      Parameters:
      blogContainerNode - the container node for blog posts (under the site).
      blogTitle - the title of the blog post.
      blogContent - text/html content of the blog post.
      isDraft - true if the blog post is a draft post, else false.
      Returns:
      The BlogPostInfo of the newly created blog post.
      See Also:

    • updateBlogPost

      BlogPostInfo updateBlogPost(BlogPostInfo post)
      Updates an existing BlogPostInfo in the repository.
      Returns:
      The updated BlogPostInfo

    • deleteBlogPost

      void deleteBlogPost(BlogPostInfo post)
      Deletes an existing BlogPostInfo from the repository.

    • getForNodeRef

      @NotAuditable BlogPostInfo getForNodeRef(NodeRef nodeRef)
      For a given NodeRef corresponding to a BlogPostInfo, returns the object wrapping the Node. For anything else, the response is null.

    • getBlogPost

      BlogPostInfo getBlogPost(String siteShortName, String postName)
      Retrieves an existing BlogPostInfo from the repository, which is within a site

    • getBlogPost

      BlogPostInfo getBlogPost(NodeRef parentNodeRef, String postName)
      Retrieves an existing BlogPostInfo from the repository, which is attached to the specified Node. The parent Node should normally be a Site Container

    • getDrafts

      org.alfresco.query.PagingResults<BlogPostInfo> getDrafts(String siteShortName, String username, org.alfresco.query.PagingRequest pagingReq)
      Gets the draft blog posts created by the specified user.
      Parameters:
      siteShortName - the name of the site to add the post to.
      username - to limit results to blogs with this cm:creator. null means all users.
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • getDrafts

      org.alfresco.query.PagingResults<BlogPostInfo> getDrafts(NodeRef blogContainerNode, String username, org.alfresco.query.PagingRequest pagingReq)
      Gets the draft blog posts created by the specified user.
      Parameters:
      blogContainerNode - the container node for blog posts (under the site).
      username - to limit results to blogs with this cm:creator. null means all users.
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • getPublished

      org.alfresco.query.PagingResults<BlogPostInfo> getPublished(String siteShortName, Date fromDate, Date toDate, String byUser, org.alfresco.query.PagingRequest pagingReq)
      Gets the (internally, Alfresco-) published blog posts.
      Parameters:
      siteShortName - the name of the site to add the post to.
      fromDate - an inclusive date limit for the results (more recent than).
      toDate - an inclusive date limit for the results (before).
      byUser - if not null limits results to posts by the specified user. if null results will be by all users.
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • getPublished

      org.alfresco.query.PagingResults<BlogPostInfo> getPublished(NodeRef blogContainerNode, Date fromDate, Date toDate, String byUser, org.alfresco.query.PagingRequest pagingReq)
      Gets the (internally, Alfresco-) published blog posts.
      Parameters:
      blogContainerNode - the container node for blog posts (under the site).
      fromDate - an inclusive date limit for the results (more recent than).
      toDate - an inclusive date limit for the results (before).
      byUser - if not null limits results to posts by the specified user. if null results will be by all users.
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • getMyDraftsAndAllPublished

      org.alfresco.query.PagingResults<BlogPostInfo> getMyDraftsAndAllPublished(NodeRef blogContainerNode, Date fromDate, Date toDate, org.alfresco.query.PagingRequest pagingReq)
      Deprecated.
      This method is a domain-specific query used by the Blog REST API and is not considered suitable for general use.
      Gets draft blog posts by the currently authenticated user along with all published posts.
      Parameters:
      blogContainerNode - the container node for blog posts (under the site).
      fromDate - an inclusive date limit for the results (more recent than).
      toDate - an inclusive date limit for the results (before).
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • findBlogPosts

      org.alfresco.query.PagingResults<BlogPostInfo> findBlogPosts(String siteShortName, BlogService.RangedDateProperty dateRange, String tag, org.alfresco.query.PagingRequest pagingReq)
      Finds blog posts by the specified user tagged with the given tag string. This method allows date ranges to be applied to any valid DataTypeDefinition.DATE or DataTypeDefinition.DATETIME property. Examples include ContentModel.PROP_CREATED or ContentModel.PROP_PUBLISHED.
      Parameters:
      siteShortName - the name of the site to add the post to.
      dateRange - a BlogService.RangedDateProperty parameter object. Can be null.
      tag - tag string.
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • findBlogPosts

      org.alfresco.query.PagingResults<BlogPostInfo> findBlogPosts(NodeRef blogContainerNode, BlogService.RangedDateProperty dateRange, String tag, org.alfresco.query.PagingRequest pagingReq)
      Finds blog posts by the specified user tagged with the given tag string. This method allows date ranges to be applied to any valid DataTypeDefinition.DATE or DataTypeDefinition.DATETIME property. Examples include ContentModel.PROP_CREATED or ContentModel.PROP_PUBLISHED.
      Parameters:
      blogContainerNode - the container node for blog posts (under the site).
      dateRange - a BlogService.RangedDateProperty parameter object. Can be null.
      tag - tag string.
      pagingReq - an object defining the paging parameters for the result set.
      Returns:
      a PagingResults object containing some or all of the results (subject to paging).
      See Also:

    • isDraftBlogPost

      boolean isDraftBlogPost(NodeRef blogPostNode)
      Deprecated.
      Add this to the BlogPostInfo shortly
      Returns true if the specified blog-post node is a 'draft' blog post.
      Parameters:
      blogPostNode - a NodeRef representing a blog-post.
      Returns:
      true if it is a draft post, else false.