com.communote.server.core.blog

Class NoteManagementImpl

java.lang.Object

com.communote.server.core.blog.NoteManagementBase

com.communote.server.core.blog.NoteManagementImpl

All Implemented Interfaces:

NoteManagement

@Service(value="noteManagement")
public class NoteManagementImpl
extends NoteManagementBase

Author:

Communote GmbH - http://www.communote.com/

See Also:

NoteManagement

Field Summary

Fields inherited from interface com.communote.server.core.blog.NoteManagement

CONSTANT_MENTION_DISCUSSION_PARTICIPANTS, CONSTANT_MENTION_TOPIC_AUTHORS, CONSTANT_MENTION_TOPIC_MANAGERS, CONSTANT_MENTION_TOPIC_READERS, USER_NOTE_PROPERTY_KEY_LIKE

Constructor Summary

Constructors

Constructor and Description
NoteManagementImpl()

Method Summary

Modifier and Type	Method and Description
void	correctTopicOfComment(Long noteId) Corrects the topic of a comment note if it does not equal the topic of the discussion root note.
AutosaveNoteData	getAutosave(Long noteId, Long parentNoteId, Collection<StringPropertyTO> properties, Locale locale) Return an autosave of the current user.
<T> T	getNote(Long noteId, Converter<Note,T> converter) Method to get a specific note.
NoteData	getNote(long noteId, NoteRenderContext renderContext)
long	getNoteCount() Returns the number of notes created within the current client.
protected NoteModificationResult	handleCreateNote(NoteStoringTO noteStoringTO, Set<String> additionalBlogIds) Performs the core logic for NoteManagementBase.createNote(NoteStoringTO, Set)
protected void	handleDeleteAutosave(Long postId) Performs the core logic for NoteManagementBase.deleteAutosave(Long)
protected void	handleDeleteNote(Long postId, boolean deleteSystemPosts, boolean clientManagerCanDelete) Performs the core logic for NoteManagementBase.deleteNote(Long, boolean, boolean)
protected Set<Long>	handleDeleteNotesOfUser(Long userId) Performs the core logic for NoteManagementBase.deleteNotesOfUser(Long)
protected List<SimpleNoteListItem>	handleGetCommentsOfDiscussion(Long noteId) Performs the core logic for NoteManagementBase.getCommentsOfDiscussion(Long)
protected Long	handleGetDiscussionId(Long noteId) Implementation of NoteManagementBase.getDiscussionId(Long)
protected DiscussionNoteData	handleGetNoteWithComments(Long noteId, QueryResultConverter<SimpleNoteListItem,DiscussionNoteData> converter) Performs the core logic for NoteManagementBase.getNoteWithComments(Long, QueryResultConverter)
protected int	handleGetNumberOfNotesInDiscussion(Long noteId) Performs the core logic for NoteManagementBase.getNumberOfNotesInDiscussion(Long)
protected int	handleGetNumberOfReplies(Long noteId) Performs the core logic for NoteManagementBase.getNumberOfReplies(Long)
protected NoteModificationResult	handleUpdateNote(NoteStoringTO noteStoringTO, Long noteId, Set<String> additionalBlogIds)
void	moveToTopic(Long discussionId, Long topicId) Method to move a given discussion to another topic.
boolean	noteExists(Long noteId) Checks whether a note exists.
void	updateFollowableItems(Long noteId, boolean updateChildren) Update the followable items of a given note and optionally although of its children.
void	updateLastDiscussionCreationDate(Long noteId, Timestamp creationDate) Method to update the last discussion creation date.

Methods inherited from class com.communote.server.core.blog.NoteManagementBase

createNote, deleteAutosave, deleteNote, deleteNotesOfUser, getCommentsOfDiscussion, getDiscussionId, getNoteWithComments, getNumberOfNotesInDiscussion, getNumberOfReplies, getPrincipal, updateNote

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NoteManagementImpl

public NoteManagementImpl()

Method Detail

correctTopicOfComment

public void correctTopicOfComment(Long noteId)

Description copied from interface: NoteManagement

Corrects the topic of a comment note if it does not equal the topic of the discussion root note. This method helps to resolve inconsistent discussions if move and edit or comment operations ran concurrently.

Parameters:

noteId - ID of the comment note that was created or updated

getAutosave

@Transactional(readOnly=true)
public AutosaveNoteData getAutosave(Long noteId,
                                                                  Long parentNoteId,
                                                                  Collection<StringPropertyTO> properties,
                                                                  Locale locale)

Description copied from interface: NoteManagement

Return an autosave of the current user. The parameters noteId and parentNoteId can be used to retrieve an autosave for an edit operation or a comment.

Parameters:

noteId - the ID of a note to get the autosave of the edit operation of this note. Can be null.

parentNoteId - the ID of a parent note to get the autosave of a comment to this note. Can be null.

properties - properties which should be used to get filters for finding an autosave. The filters are resolved with the help of the registered AutosavePropertyFilterProvider the re Can be null.

locale - the locale to use when filling localizable content of the note like tags

Returns:

the autosave or null if there is none

getNote

@Transactional(readOnly=true)
public NoteData getNote(long noteId,
                                                      NoteRenderContext renderContext)
                                               throws NoteNotFoundException,
                                                      AuthorizationException

Parameters:

noteId - The note id.

renderContext - The rendering context. If the render mode of the context is null, no NoteRenderingPreProcessors will be called.

Returns:

The note as NoteData.

Throws:

NoteNotFoundException - Thrown, when there is no note for this id.

AuthorizationException - Thrown, when the user is not allowed to access the note.

getNote

@Transactional(readOnly=true)
public <T> T getNote(Long noteId,
                                                   Converter<Note,T> converter)

Method to get a specific note.

Type Parameters:

T - Type of the return value.

Parameters:

noteId - The notes id.

converter - The converter to convert the note.

Returns:

The note in the desired converter output or null, if none.

getNoteCount

@Transactional(readOnly=true)
public long getNoteCount()

Returns the number of notes created within the current client.

Returns:

The actual count of notes.

handleCreateNote

protected NoteModificationResult handleCreateNote(NoteStoringTO noteStoringTO,
                                                  Set<String> additionalBlogIds)
                                           throws BlogNotFoundException,
                                                  NoteManagementAuthorizationException,
                                                  NoteStoringPreProcessorException

Description copied from class: NoteManagementBase

Performs the core logic for NoteManagementBase.createNote(NoteStoringTO, Set)

Specified by:

handleCreateNote in class NoteManagementBase

Throws:

BlogNotFoundException

NoteManagementAuthorizationException

NoteStoringPreProcessorException

handleDeleteAutosave

protected void handleDeleteAutosave(Long postId)
                             throws NoteManagementAuthorizationException

Performs the core logic for NoteManagementBase.deleteAutosave(Long)

Specified by:

handleDeleteAutosave in class NoteManagementBase

Throws:

NoteManagementAuthorizationException

handleDeleteNote

protected void handleDeleteNote(Long postId,
                                boolean deleteSystemPosts,
                                boolean clientManagerCanDelete)
                         throws NoteManagementAuthorizationException

Performs the core logic for NoteManagementBase.deleteNote(Long, boolean, boolean)

Specified by:

handleDeleteNote in class NoteManagementBase

Throws:

NoteManagementAuthorizationException

handleDeleteNotesOfUser

protected Set<Long> handleDeleteNotesOfUser(Long userId)
                                     throws AuthorizationException

Performs the core logic for NoteManagementBase.deleteNotesOfUser(Long)

Specified by:

handleDeleteNotesOfUser in class NoteManagementBase

Throws:

AuthorizationException

handleGetCommentsOfDiscussion

protected List<SimpleNoteListItem> handleGetCommentsOfDiscussion(Long noteId)
                                                          throws NoteNotFoundException

Performs the core logic for NoteManagementBase.getCommentsOfDiscussion(Long)

Specified by:

handleGetCommentsOfDiscussion in class NoteManagementBase

Parameters:

noteId - the ID of the note

Returns:

the notes

Throws:

NoteNotFoundException - in case the note does not exists

handleGetDiscussionId

protected Long handleGetDiscussionId(Long noteId)
                              throws NoteNotFoundException

Implementation of NoteManagementBase.getDiscussionId(Long)

Specified by:

handleGetDiscussionId in class NoteManagementBase

Parameters:

noteId - the ID of the note for which the discussion ID should be returned

Returns:

the ID of the discussion

Throws:

NoteNotFoundException - in case the note does not exist

handleGetNoteWithComments

protected DiscussionNoteData handleGetNoteWithComments(Long noteId,
                                                       QueryResultConverter<SimpleNoteListItem,DiscussionNoteData> converter)
                                                throws NoteNotFoundException,
                                                       AuthorizationException

Performs the core logic for NoteManagementBase.getNoteWithComments(Long, QueryResultConverter)

Specified by:

handleGetNoteWithComments in class NoteManagementBase

Parameters:

noteId - the id of the note to retrieve

converter - the converter to use for filling the comments

Returns:

the object holding the data of the note

Throws:

NoteNotFoundException - if the requested note does not exist

AuthorizationException - if the current user has no read access to the note

handleGetNumberOfNotesInDiscussion

protected int handleGetNumberOfNotesInDiscussion(Long noteId)
                                          throws NoteNotFoundException

Performs the core logic for NoteManagementBase.getNumberOfNotesInDiscussion(Long)

Specified by:

handleGetNumberOfNotesInDiscussion in class NoteManagementBase

Parameters:

noteId - the ID of the note

Returns:

the number notes

Throws:

NoteNotFoundException - in case the note does not exists

handleGetNumberOfReplies

protected int handleGetNumberOfReplies(Long noteId)
                                throws NoteNotFoundException

Performs the core logic for NoteManagementBase.getNumberOfReplies(Long)

Specified by:

handleGetNumberOfReplies in class NoteManagementBase

Throws:

NoteNotFoundException

handleUpdateNote

protected NoteModificationResult handleUpdateNote(NoteStoringTO noteStoringTO,
                                                  Long noteId,
                                                  Set<String> additionalBlogIds)
                                           throws BlogNotFoundException,
                                                  NoteNotFoundException,
                                                  NoteManagementAuthorizationException,
                                                  NoteStoringPreProcessorException

Specified by:

handleUpdateNote in class NoteManagementBase

Throws:

BlogNotFoundException

NoteNotFoundException

NoteManagementAuthorizationException

NoteStoringPreProcessorException

moveToTopic

public void moveToTopic(Long discussionId,
                        Long topicId)
                 throws NoteManagementAuthorizationException

Method to move a given discussion to another topic.

Parameters:

discussionId - Id of the discussion to move.

topicId - If of the new topic.

Throws:

NoteManagementAuthorizationException - Thrown, when the use isn't allowed to write within the given topic.

noteExists

@Transactional(readOnly=true)
public boolean noteExists(Long noteId)

Description copied from interface: NoteManagement

Checks whether a note exists. It is not checked whether the current user has read access to the note.

Parameters:

noteId - the ID of the note to retrieve

Returns:

true if the note exists, false otherwise

updateFollowableItems

public void updateFollowableItems(Long noteId,
                                  boolean updateChildren)

Update the followable items of a given note and optionally although of its children.

Parameters:

noteId - Id of the note to update.

updateChildren - If true, all children will be updated too.

updateLastDiscussionCreationDate

public void updateLastDiscussionCreationDate(Long noteId,
                                             Timestamp creationDate)

Method to update the last discussion creation date.

Parameters:

noteId - Id of the note, which is part of the discussion.

creationDate - The new date to set.