Builds a new forum post or forum reply within a specific forum. When forumPost is left unset, createPost creates a new top-level forum question; when it is set, createPost creates a comment or reply against that question, optionally as a reply to an existing forumReply. Obtained from ForumManager.newForumPostBuilder, which binds it to the forum being posted into. Set the comment text and any attachments with the inherited methods, then pass the builder to ForumManager.createPost to save it.

Group: Builders

Extends: PostBuilder

---

Inherited from PostBuilder

Properties

Methods

getAttachments() · addAttachment() · attachments(Map<String,FileItem> files) · attach(FileItem fileItem) · attach(String name, InputStream in) · attach(String name, String contentSpec, String contentType, Long size) · websiteBranch(Branch b) · comment(String s) · postedByUser(Profile s) · postedDate(Date s)

getAttachments()

Returns: List<PostAttachmentBuilder>

Files attached to this post so far, built up by repeated calls to addAttachment or attach.

addAttachment()

Returns: PostAttachmentBuilder

Creates a new file attachment, adds it to this post's list of attachments, and returns it so its properties can be set. Note that attachments must already be initialised (for example via attach or attachments) before calling this directly, as it does not lazily create the list.

attachments(Map<String,FileItem> files)

Returns: T

Attaches every file in the given map, saving each one's content to content storage, and returns this builder for chaining.

attach(FileItem fileItem)

Returns: T

Attaches an uploaded file, saving its content to content storage and detecting its content type from the file item, and returns this builder for chaining.

attach(String name, InputStream in)

Returns: T

Attaches a file from a name and content stream, saving its content to content storage and detecting its content type from the file name, and returns this builder for chaining.

attach(String name, String contentSpec, String contentType, Long size)

Returns: T

Attaches a file whose content has already been saved to content storage, and returns this builder for chaining.

websiteBranch(Branch b)

Returns: T

Sets the website branch (and derives the website from it) that the post is created against, and returns this builder for chaining.

comment(String s)

Returns: T

Sets the comment text and returns this builder for chaining.

postedByUser(Profile s)

Returns: T

Sets the profile the post is attributed to and returns this builder for chaining. Defaults to the current user.

postedDate(Date s)

Returns: T

Sets the date the post is recorded as being made and returns this builder for chaining. Defaults to the time the builder was created.

---

Methods

forumPost(ForumPost s)

Returns: ForumPostBuilder

Sets the forum post this builder creates a reply against, and returns this builder for chaining. Leave unset to create a new top-level forum question instead.

forumReply(ForumReply s)

Returns: ForumPostBuilder

Sets the forum reply this builder creates a nested reply against, and returns this builder for chaining. Only used when forumPost has also been set.