org.apache.stanbol.enhancer.jobmanager.event.impl

Class EnhancementJobHandler

java.lang.Object

org.apache.stanbol.enhancer.jobmanager.event.impl.EnhancementJobHandler

All Implemented Interfaces:

org.osgi.service.event.EventHandler

public class EnhancementJobHandler
extends Object
implements org.osgi.service.event.EventHandler

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	EnhancementJobHandler.EnhancementJobObserver

Constructor Summary

Constructors

Constructor and Description
EnhancementJobHandler(org.osgi.service.event.EventAdmin eventAdmin, org.apache.stanbol.enhancer.servicesapi.EnhancementEngineManager engineManager)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes this Handler and notifies all components that wait for still running jobs
protected boolean	executeNextNodes(EnhancementJob job) triggers the execution of the next nodes or if EnhancementJob.isFinished() notifies the one who registered the EnhancementJob with this component.
void	handleEvent(org.osgi.service.event.Event event)
protected static void	logExecutionTimes(org.slf4j.Logger logger, EnhancementJob job) Helper method that logs the execution time for the Chain and all the Enhancement Engines on DEBUG level
protected static void	logJobInfo(org.slf4j.Logger log, EnhancementJob job, String header, boolean logExecutions) Logs basic infos about the Job as INFO and detailed infos as DEBUG
EnhancementJobHandler.EnhancementJobObserver	register(EnhancementJob enhancementJob) Registers an EnhancementJob and will start the enhancement process.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnhancementJobHandler

public EnhancementJobHandler(org.osgi.service.event.EventAdmin eventAdmin,
                     org.apache.stanbol.enhancer.servicesapi.EnhancementEngineManager engineManager)

Method Detail

close

public void close()

Closes this Handler and notifies all components that wait for still running jobs

register

public EnhancementJobHandler.EnhancementJobObserver register(EnhancementJob enhancementJob)

Registers an EnhancementJob and will start the enhancement process. When the process is finished or this service is deactivated the returned oject will be notified. Therefore callers that need to wait for the completion of the parsed job will want to

   Object object = enhancementJobHandler.register();
   while(!job.isFinished() & enhancementJobHandler != null){
       synchronized (object) {
           try {
               object.wait();
           } catch (InterruptedException e) {}
       }
   }
 

Parameters:

enhancementJob - the enhancement job to register

Returns:

An object that will get Object.notifyAll() as soon as EnhancementJob.isFinished() or this instance is deactivated

handleEvent

public void handleEvent(org.osgi.service.event.Event event)

Specified by:

handleEvent in interface org.osgi.service.event.EventHandler

executeNextNodes

protected boolean executeNextNodes(EnhancementJob job)

triggers the execution of the next nodes or if EnhancementJob.isFinished() notifies the one who registered the EnhancementJob with this component.

Parameters:

job - the enhancement job to process

Returns:

if an Execution event was sent

logExecutionTimes

protected static void logExecutionTimes(org.slf4j.Logger logger,
                     EnhancementJob job)

Helper method that logs the execution time for the Chain and all the Enhancement Engines on DEBUG level

Parameters:

logger - The logger used for logging

job - the job to log. This expects that EnhancementJob.isFinished() == true

logJobInfo

protected static void logJobInfo(org.slf4j.Logger log,
              EnhancementJob job,
              String header,
              boolean logExecutions)

Logs basic infos about the Job as INFO and detailed infos as DEBUG

Parameters:

job -