org.nuxeo.ecm.platform.comment.impl

Class AnnotationServiceImpl

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.platform.comment.impl.AnnotationServiceImpl

All Implemented Interfaces:

AnnotationService, Adaptable, Component, Extensible, TimestampedService

public class AnnotationServiceImpl
extends DefaultComponent
implements AnnotationService

Since:

10.1

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	GET_ANNOTATION_PAGEPROVIDER_NAME
protected static String	GET_ANNOTATIONS_FOR_DOC_PAGEPROVIDER_NAME

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified, name

Constructor Summary

Constructors

Constructor and Description
AnnotationServiceImpl()

Method Summary

Modifier and Type	Method and Description
Annotation	createAnnotation(CoreSession session, Annotation annotation) Creates an annotation on a document.
void	deleteAnnotation(CoreSession session, String annotationId) Deletes an annotation for a document.
void	deleteExternalAnnotation(CoreSession session, String entityId) Deletes an external annotation.
Annotation	getAnnotation(CoreSession session, String annotationId) Gets an annotation.
protected DocumentModel	getAnnotationModel(CoreSession session, String entityId)
List<Annotation>	getAnnotations(CoreSession session, String documentId, String xpath) Gets all annotations for a document.
Annotation	getExternalAnnotation(CoreSession session, String entityId) Gets an annotation generated by an external service.
void	updateAnnotation(CoreSession session, String annotationId, Annotation annotation) Updates an annotation for a document.
void	updateExternalAnnotation(CoreSession session, String entityId, Annotation annotation) Updates an external annotation.

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

activate, deactivate, getAdapter, getDescriptor, getDescriptors, getLastModified, getRegistry, register, registerContribution, registerExtension, setLastModified, setModifiedNow, setName, start, stop, unregister, unregisterContribution, unregisterExtension

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.runtime.model.Component

applicationStarted, getApplicationStartedOrder

Field Detail

GET_ANNOTATION_PAGEPROVIDER_NAME

protected static final String GET_ANNOTATION_PAGEPROVIDER_NAME

See Also:

Constant Field Values

GET_ANNOTATIONS_FOR_DOC_PAGEPROVIDER_NAME

protected static final String GET_ANNOTATIONS_FOR_DOC_PAGEPROVIDER_NAME

See Also:

Constant Field Values

Constructor Detail

AnnotationServiceImpl

public AnnotationServiceImpl()

Method Detail

createAnnotation

public Annotation createAnnotation(CoreSession session,
                                   Annotation annotation)
                            throws CommentSecurityException

Description copied from interface: AnnotationService

Creates an annotation on a document.

Specified by:

createAnnotation in interface AnnotationService

Parameters:

session - the core session

annotation - the annotation to create

Returns:

the created annotation

Throws:

CommentSecurityException - if the current user does have the right permissions on the document to annotate.

getAnnotation

public Annotation getAnnotation(CoreSession session,
                                String annotationId)
                         throws CommentNotFoundException,
                                CommentSecurityException

Description copied from interface: AnnotationService

Gets an annotation.

Specified by:

getAnnotation in interface AnnotationService

Parameters:

session - the core session

annotationId - the annotation document model id

Returns:

the annotation, or null if the annotation with the given id was not found

Throws:

CommentNotFoundException - if no annotation was found with the given id

CommentSecurityException - if the current user does have the right permissions on the annotated document.

getAnnotations

public List<Annotation> getAnnotations(CoreSession session,
                                       String documentId,
                                       String xpath)
                                throws CommentNotFoundException,
                                       CommentSecurityException

Description copied from interface: AnnotationService

Gets all annotations for a document.

Specified by:

getAnnotations in interface AnnotationService

Parameters:

session - the core session

documentId - the annotated document id

xpath - the annotated blob xpath in the document

Returns:

the list of annotations, or an empty list if no annotation is found

Throws:

CommentNotFoundException - if no annotation was found with the given id

CommentSecurityException - if the current user does have the right permissions on the annotated document.

updateAnnotation

public void updateAnnotation(CoreSession session,
                             String annotationId,
                             Annotation annotation)
                      throws CommentNotFoundException,
                             CommentSecurityException

Description copied from interface: AnnotationService

Updates an annotation for a document.

Specified by:

updateAnnotation in interface AnnotationService

Parameters:

session - the core session

annotationId - the annotation document model id

annotation - the annotation containing the modifications

Throws:

CommentNotFoundException - if no annotation was found with the given id

CommentSecurityException - if the current user does have the right permissions on the annotated document.

deleteAnnotation

public void deleteAnnotation(CoreSession session,
                             String annotationId)
                      throws CommentNotFoundException

Description copied from interface: AnnotationService

Deletes an annotation for a document.

Specified by:

deleteAnnotation in interface AnnotationService

Parameters:

session - the core session

annotationId - the annotation document model id

Throws:

CommentNotFoundException - if no annotation was found with the given id

getExternalAnnotation

public Annotation getExternalAnnotation(CoreSession session,
                                        String entityId)
                                 throws CommentNotFoundException,
                                        CommentSecurityException

Description copied from interface: AnnotationService

Gets an annotation generated by an external service.

Specified by:

getExternalAnnotation in interface AnnotationService

Parameters:

session - the core session

entityId - the annotation entity id

Returns:

the annotation

Throws:

CommentNotFoundException - if no annotation was found with the given external entity id

CommentSecurityException - if the current user does have the right permissions on the annotated document.

updateExternalAnnotation

public void updateExternalAnnotation(CoreSession session,
                                     String entityId,
                                     Annotation annotation)
                              throws CommentNotFoundException,
                                     CommentSecurityException

Description copied from interface: AnnotationService

Updates an external annotation.

Specified by:

updateExternalAnnotation in interface AnnotationService

Parameters:

session - the core session

entityId - the annotation document model id

annotation - the annotation containing the modifications

Throws:

CommentNotFoundException - if no annotation was found with the given external entity id

CommentSecurityException - if the current user does have the right permissions on the annotated document.

deleteExternalAnnotation

public void deleteExternalAnnotation(CoreSession session,
                                     String entityId)
                              throws CommentNotFoundException,
                                     CommentSecurityException

Description copied from interface: AnnotationService

Deletes an external annotation.

Specified by:

deleteExternalAnnotation in interface AnnotationService

Parameters:

session - the core session

entityId - the annotation entity id

Throws:

CommentNotFoundException - if no annotation was found with the given external entity id

CommentSecurityException - if the current user does have the right permissions on the annotated document.

getAnnotationModel

protected DocumentModel getAnnotationModel(CoreSession session,
                                           String entityId)