service.tut.pori.contentanalysis.video

Class VideoContentCore

java.lang.Object

service.tut.pori.contentanalysis.video.VideoContentCore

public final class VideoContentCore
extends java.lang.Object

Video content analysis core methods.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.EnumSet<AnalysisBackend.Capability>	DEFAULT_CAPABILITIES default capabilities for video tasks

Method Summary

Modifier and Type	Method and Description
static java.lang.String	generateRedirectUrl(java.lang.String guid, CAContentCore.ServiceType type)
static RedirectResponse	generateTargetUrl(UserIdentity authenticatedUser, CAContentCore.ServiceType serviceType, java.lang.String guid) resolves dynamic /rest/r? redirection URL to static access URL
static VideoList	getVideos(UserIdentity authenticatedUser, java.util.List<java.lang.String> guids, DataGroups dataGroups, Limits limits, java.util.EnumSet<CAContentCore.ServiceType> serviceTypes, long[] userIdFilters)
static VideoTaskDetails	queryTaskDetails(java.lang.Integer backendId, java.lang.Long taskId, DataGroups dataGroups, Limits limits) This method is called by back-ends to retrieve a list of videos to be analyzed.
static void	scheduleBackendFeedback(java.lang.Integer backendId, VideoList videos, java.lang.Long taskId) Create and schedule the task for all capable back-ends included in the task designated by the task Id.
static java.lang.Long	scheduleTask(VideoTaskDetails details) Note: if the details already contain a taskId, the task will NOT be re-added to the database, but simply re-scheduled.
static void	taskFinished(VideoTaskResponse response)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CAPABILITIES

public static final java.util.EnumSet<AnalysisBackend.Capability> DEFAULT_CAPABILITIES

default capabilities for video tasks

Method Detail

generateRedirectUrl

public static java.lang.String generateRedirectUrl(java.lang.String guid,
                                                   CAContentCore.ServiceType type)

Parameters:

guid -

type -

Returns:

redirection URL for the given GUID and type or null if either one the given values was null

generateTargetUrl

public static RedirectResponse generateTargetUrl(UserIdentity authenticatedUser,
                                                 CAContentCore.ServiceType serviceType,
                                                 java.lang.String guid)

resolves dynamic /rest/r? redirection URL to static access URL

Parameters:

authenticatedUser -

serviceType -

guid -

Returns:

redirection to static URL referenced by the given parameters

queryTaskDetails

public static VideoTaskDetails queryTaskDetails(java.lang.Integer backendId,
                                                java.lang.Long taskId,
                                                DataGroups dataGroups,
                                                Limits limits)

This method is called by back-ends to retrieve a list of videos to be analyzed. To query tasks status from back-end use queryTaskStatus.

Parameters:

backendId -

taskId -

dataGroups -

limits -

Returns:

the task or null if not found

taskFinished

public static void taskFinished(VideoTaskResponse response)
                         throws java.lang.IllegalArgumentException

Parameters:

response -

Throws:

java.lang.IllegalArgumentException

getVideos

public static VideoList getVideos(UserIdentity authenticatedUser,
                                  java.util.List<java.lang.String> guids,
                                  DataGroups dataGroups,
                                  Limits limits,
                                  java.util.EnumSet<CAContentCore.ServiceType> serviceTypes,
                                  long[] userIdFilters)

Parameters:

authenticatedUser -

guids -

dataGroups -

limits -

serviceTypes -

userIdFilters -

Returns:

list of videos or null if none was found with the given parameters

scheduleTask

public static java.lang.Long scheduleTask(VideoTaskDetails details)

Note: if the details already contain a taskId, the task will NOT be re-added to the database, but simply re-scheduled. If the details contains no back-ends, default back-ends will be added. See DEFAULT_CAPABILITIES

Parameters:

details -

Returns:

task id of the generated task, null if task could not be created

scheduleBackendFeedback

public static void scheduleBackendFeedback(java.lang.Integer backendId,
                                           VideoList videos,
                                           java.lang.Long taskId)

Create and schedule the task for all capable back-ends included in the task designated by the task Id. The given back-end Id will not participate in the feedback task.

Parameters:

backendId - the back-end that send the task finished call, this back-end is automatically omitted from the list of target back-ends

videos - videos returned in task finished call

taskId - the id of the finished analysis task