com.riadalabs.jira.plugins.insight.channel.external.api.facade

Interface ObjectFacade

All Known Implementing Classes:

ObjectFacadeImpl

public interface ObjectFacade

Service interface to access and manage Insight objects

Since:

2.13.1

Author:

Mathias Edblom

Method Summary

Modifier and Type	Method and Description
com.riadalabs.jira.plugins.insight.services.model.AttachmentBean	addAttachmentBean(int objectId, File file, String fileName, String contentType, String comment) Add a AttachmentBean domain objects.
int	countObjectBeans(int objectTypeId) Finds total count of all ObjectBean domain objects.
com.riadalabs.jira.plugins.insight.services.model.WatcherBean	createWatcherBean(int objectId, String userKey) Created a WatcherBean
com.riadalabs.jira.plugins.insight.services.model.AttachmentBean	deleteAttachmentBean(int id) Delete AttachmentBean
void	deleteCommentBean(int commentBeanId) Delete a CommentBean
void	deleteObjectAttributeBean(int id) Deprecated. use the deleteObjectAttributeBean(long) instead
void	deleteObjectAttributeBean(int id, com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption) Deprecated. use the deleteObjectAttributeBean(long, EventDispatchOption) instead
void	deleteObjectAttributeBean(long id) Deletes an object attribute bean
void	deleteObjectAttributeBean(long id, com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption) Deletes an object attribute bean
void	deleteObjectBean(int id) Delete a ObjectBean
void	deleteObjectBean(int id, com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption) Delete a ObjectBean
void	deleteWatcherBean(com.riadalabs.jira.plugins.insight.services.model.WatcherBean watcherBean) Delete a WatcherBean
List<com.riadalabs.jira.plugins.insight.services.model.AttachmentBean>	findAttachmentBeans(int objectId) Finds attachmentBeans for specified ObjectBean id
List<com.riadalabs.jira.plugins.insight.services.model.CommentBean>	findCommentBeans(int objectId) Find all CommentBean for an ObjectBean
List<com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean>	findObjectAttributeBeans(int objectId) Finds all ObjectAttributeBean
List<com.riadalabs.jira.plugins.insight.services.model.ObjectHistoryBean>	findObjectHistoryBean(int objectId) Find the ObjectBean history
List<ObjectTicketConnectionEntry>	findObjectTicketConnections(int objectId) Find all JIRA issues connected to an ObjectBean
List<ObjectTicketConnectionEntry>	findObjectTicketConnections(int objectId, int offset, int limit) Deprecated. use findObjectTicketConnections(int) instead
List<ObjectTicketConnectionEntry>	findObjectTicketConnections(long ticketId) Find all ObjectBean connected to a JIRA issue
List<com.riadalabs.jira.plugins.insight.services.model.WatcherBean>	findWatcherBeans(int objectId) Finds all WatcherBean for an ObjectBean
com.riadalabs.jira.plugins.insight.services.model.AttachmentBean	loadAttachmentBeanById(int id) Load a AttachmentBean
com.riadalabs.jira.plugins.insight.services.model.CommentBean	loadCommentBean(int commentId) Load a CommentBean
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean	loadObjectAttributeBean(int id) Deprecated. Go through the object to load the object attribute bean instead of directly. This will be removed in future releases
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean	loadObjectAttributeBean(int objectId, int objectTypeAttributeId) Loads a ObjectAttributeBean given an object id and object type attribute id
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean	loadObjectAttributeBean(int objectId, String objectTypeAttributeName) Loads a ObjectAttributeBean given an object id and object type attribute name
com.riadalabs.jira.plugins.insight.services.model.ObjectBean	loadObjectBean(int id) Loads a ObjectBean given its id.
com.riadalabs.jira.plugins.insight.services.model.ObjectBean	loadObjectBean(String key) Loads a ObjectBean given its key.
com.riadalabs.jira.plugins.insight.services.model.WatcherBean	loadWatcherBean(int objectId, String userKey) Loads a WatcherBean
com.riadalabs.jira.plugins.insight.services.progress.model.Progress	moveObjects(MoveObjectBean moveObjectBean) Move objects to another object type
com.riadalabs.jira.plugins.insight.services.model.CommentBean	storeCommentBean(com.riadalabs.jira.plugins.insight.services.model.CommentBean commentBean) Store a CommentBean
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean	storeObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectAttributeBean objectAttributeBean) Stores a ObjectAttributeBean
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean	storeObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectAttributeBean objectAttributeBean, com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption) Stores a ObjectAttributeBean
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean	storeObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean objectAttributeBean) Deprecated.
com.riadalabs.jira.plugins.insight.services.model.ObjectBean	storeObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean) Stores a ObjectBean
com.riadalabs.jira.plugins.insight.services.model.ObjectBean	storeObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean, byte[] avatarData, com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption) Stores a ObjectBean with the corresponding avatar
com.riadalabs.jira.plugins.insight.services.model.ObjectBean	storeObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean, com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption) Stores a ObjectBean
com.riadalabs.jira.plugins.insight.services.model.ObjectBean	storeObjectBeanIgnoreAttributeValidation(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean) Stores a ObjectBean bypassing ALL attribute validation e.g.
void	validateObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectAttributeBean objectAttributeBean, com.riadalabs.jira.plugins.insight.services.model.ObjectBean objectBean) Validate an object attribute bean.
void	validateObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean) Validate an object bean.

Method Detail

storeObjectBean

com.riadalabs.jira.plugins.insight.services.model.ObjectBean storeObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean,
                                                                             @Nonnull
                                                                             com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption)
                                                                      throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Stores a ObjectBean

Parameters:

objectBean - the object bean to store

eventDispatchOption - event dispatch

Returns:

the stored ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException - if something goes wrong

storeObjectBean

com.riadalabs.jira.plugins.insight.services.model.ObjectBean storeObjectBean(@Nonnull
                                                                             com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean,
                                                                             @Nonnull
                                                                             byte[] avatarData,
                                                                             @Nonnull
                                                                             com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption)
                                                                      throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Stores a ObjectBean with the corresponding avatar

Parameters:

objectBean - an existing object bean, the object bean must exist and be stored in insight before added as a parameter to this method

avatarData - the actual avatar data to be used for the object

eventDispatchOption - event dispatch

Returns:

the stored ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException - if something goes

storeObjectBean

com.riadalabs.jira.plugins.insight.services.model.ObjectBean storeObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean)
                                                                      throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Stores a ObjectBean

Parameters:

objectBean - the object bean to store

Returns:

the stored ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException - if something goes wrong

storeObjectBeanIgnoreAttributeValidation

com.riadalabs.jira.plugins.insight.services.model.ObjectBean storeObjectBeanIgnoreAttributeValidation(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean)
                                                                                               throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Stores a ObjectBean bypassing ALL attribute validation e.g. uniqueness. This method should be used with care because it will create objects that potentially does not conform to the configuration of the object type.

Parameters:

objectBean - the object bean with corresponding attributes. Attributes present will NOT be validated

Returns:

the stored object bean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

storeObjectAttributeBean

com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean storeObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectAttributeBean objectAttributeBean)
                                                                                        throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Stores a ObjectAttributeBean

Returns:

the stored ObjectAttributeBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException - if something goes wrong

storeObjectAttributeBean

com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean storeObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectAttributeBean objectAttributeBean,
                                                                                               @Nonnull
                                                                                               com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption)
                                                                                        throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Stores a ObjectAttributeBean

Returns:

the stored ObjectAttributeBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException - if something goes wrong

storeObjectAttributeBean

@Deprecated
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean storeObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean objectAttributeBean)
                                                                                                    throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deprecated.

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

countObjectBeans

int countObjectBeans(int objectTypeId)
              throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Finds total count of all ObjectBean domain objects.

Returns:

the number of ObjectTypes

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadObjectBean

com.riadalabs.jira.plugins.insight.services.model.ObjectBean loadObjectBean(int id)
                                                                     throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Loads a ObjectBean given its id.

Returns:

a ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadObjectBean

com.riadalabs.jira.plugins.insight.services.model.ObjectBean loadObjectBean(String key)
                                                                     throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Loads a ObjectBean given its key.

Returns:

a ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteObjectBean

void deleteObjectBean(int id)
               throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Delete a ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteObjectBean

void deleteObjectBean(int id,
                      @Nonnull
                      com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption)
               throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Delete a ObjectBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findObjectAttributeBeans

List<com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean> findObjectAttributeBeans(int objectId)
                                                                                              throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Finds all ObjectAttributeBean

Parameters:

objectId - the ObjectBean id

Returns:

a list of ObjectAttributeBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadObjectAttributeBean

@Deprecated
com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean loadObjectAttributeBean(int id)
                                                                                                   throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deprecated. Go through the object to load the object attribute bean instead of directly. This will be removed in future releases

Loads a ObjectAttributeBean given its id.

Returns:

a ObjectAttributeBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteObjectAttributeBean

@Deprecated
void deleteObjectAttributeBean(int id)
                                    throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deprecated. use the deleteObjectAttributeBean(long) instead

Deletes an object attribute bean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteObjectAttributeBean

@Deprecated
void deleteObjectAttributeBean(int id,
                                           @Nonnull
                                           com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption)
                                    throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deprecated. use the deleteObjectAttributeBean(long, EventDispatchOption) instead

Deletes an object attribute bean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteObjectAttributeBean

void deleteObjectAttributeBean(long id)
                        throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deletes an object attribute bean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteObjectAttributeBean

void deleteObjectAttributeBean(long id,
                               @Nonnull
                               com.riadalabs.jira.plugins.insight.services.events.EventDispatchOption eventDispatchOption)
                        throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deletes an object attribute bean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadObjectAttributeBean

com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean loadObjectAttributeBean(int objectId,
                                                                                              int objectTypeAttributeId)
                                                                                       throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Loads a ObjectAttributeBean given an object id and object type attribute id

Returns:

a ObjectAttributeBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadObjectAttributeBean

com.riadalabs.jira.plugins.insight.services.model.ObjectAttributeBean loadObjectAttributeBean(int objectId,
                                                                                              String objectTypeAttributeName)
                                                                                       throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Loads a ObjectAttributeBean given an object id and object type attribute name

Returns:

a ObjectAttributeBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findObjectHistoryBean

List<com.riadalabs.jira.plugins.insight.services.model.ObjectHistoryBean> findObjectHistoryBean(int objectId)
                                                                                         throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Find the ObjectBean history

Returns:

a list of ObjectHistoryBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadAttachmentBeanById

com.riadalabs.jira.plugins.insight.services.model.AttachmentBean loadAttachmentBeanById(int id)
                                                                                 throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Load a AttachmentBean

Returns:

a AttachmentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

addAttachmentBean

com.riadalabs.jira.plugins.insight.services.model.AttachmentBean addAttachmentBean(int objectId,
                                                                                   File file,
                                                                                   String fileName,
                                                                                   String contentType,
                                                                                   String comment)
                                                                            throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Add a AttachmentBean domain objects.

Parameters:

objectId - the ObjectBean id

file - the file to add

fileName - the filename

contentType - the content type

comment - an optional comment

Returns:

the added AttachmentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findAttachmentBeans

List<com.riadalabs.jira.plugins.insight.services.model.AttachmentBean> findAttachmentBeans(int objectId)
                                                                                    throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Finds attachmentBeans for specified ObjectBean id

Parameters:

objectId - the ObjectBean id

Returns:

a list of AttachmentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteAttachmentBean

com.riadalabs.jira.plugins.insight.services.model.AttachmentBean deleteAttachmentBean(int id)
                                                                               throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Delete AttachmentBean

Returns:

the deleted AttachmentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findObjectTicketConnections

List<ObjectTicketConnectionEntry> findObjectTicketConnections(int objectId)
                                                       throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Find all JIRA issues connected to an ObjectBean

Returns:

list of ObjectTicketConnectionEntry

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findObjectTicketConnections

@Deprecated
List<ObjectTicketConnectionEntry> findObjectTicketConnections(int objectId,
                                                                          int offset,
                                                                          int limit)
                                                                   throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Deprecated. use findObjectTicketConnections(int) instead

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findObjectTicketConnections

List<ObjectTicketConnectionEntry> findObjectTicketConnections(long ticketId)
                                                       throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Find all ObjectBean connected to a JIRA issue

Returns:

list of ObjectTicketConnectionEntry

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteCommentBean

void deleteCommentBean(int commentBeanId)
                throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Delete a CommentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

storeCommentBean

com.riadalabs.jira.plugins.insight.services.model.CommentBean storeCommentBean(com.riadalabs.jira.plugins.insight.services.model.CommentBean commentBean)
                                                                        throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Store a CommentBean

Returns:

the stored CommentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findCommentBeans

List<com.riadalabs.jira.plugins.insight.services.model.CommentBean> findCommentBeans(int objectId)
                                                                              throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Find all CommentBean for an ObjectBean

Returns:

a list of CommentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadCommentBean

com.riadalabs.jira.plugins.insight.services.model.CommentBean loadCommentBean(int commentId)
                                                                       throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Load a CommentBean

Returns:

a CommentBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

loadWatcherBean

com.riadalabs.jira.plugins.insight.services.model.WatcherBean loadWatcherBean(int objectId,
                                                                              String userKey)
                                                                       throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Loads a WatcherBean

Parameters:

objectId - the ObjectBean id

userKey - the User key

Returns:

a WatcherBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

findWatcherBeans

List<com.riadalabs.jira.plugins.insight.services.model.WatcherBean> findWatcherBeans(int objectId)
                                                                              throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Finds all WatcherBean for an ObjectBean

Returns:

a list of WatcherBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

createWatcherBean

com.riadalabs.jira.plugins.insight.services.model.WatcherBean createWatcherBean(int objectId,
                                                                                String userKey)
                                                                         throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Created a WatcherBean

Parameters:

objectId - the ObjectBean id

userKey - the userkey

Returns:

a created WatcherBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

deleteWatcherBean

void deleteWatcherBean(com.riadalabs.jira.plugins.insight.services.model.WatcherBean watcherBean)
                throws com.riadalabs.jira.plugins.insight.common.exception.InsightException

Delete a WatcherBean

Throws:

com.riadalabs.jira.plugins.insight.common.exception.InsightException

moveObjects

com.riadalabs.jira.plugins.insight.services.progress.model.Progress moveObjects(MoveObjectBean moveObjectBean)
                                                                         throws Exception

Move objects to another object type

Returns:

a Progress

Throws:

Exception

validateObjectBean

void validateObjectBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectBean objectBean)
                 throws com.riadalabs.jira.plugins.insight.common.exception.ValidationInsightException,
                        com.riadalabs.jira.plugins.insight.common.exception.IQLValidationException

Validate an object bean. This will be implicitly be executed on store object

Throws:

com.riadalabs.jira.plugins.insight.common.exception.ValidationInsightException

com.riadalabs.jira.plugins.insight.common.exception.IQLValidationException

validateObjectAttributeBean

void validateObjectAttributeBean(com.riadalabs.jira.plugins.insight.services.model.MutableObjectAttributeBean objectAttributeBean,
                                 com.riadalabs.jira.plugins.insight.services.model.ObjectBean objectBean)
                          throws com.riadalabs.jira.plugins.insight.common.exception.ValidationInsightException,
                                 com.riadalabs.jira.plugins.insight.common.exception.IQLValidationException

Validate an object attribute bean. This will be implicitly be executed on store object

Throws:

com.riadalabs.jira.plugins.insight.common.exception.ValidationInsightException

com.riadalabs.jira.plugins.insight.common.exception.IQLValidationException