com.github.geko444.im4java.utils

Class BatchConverter

java.lang.Object

java.util.concurrent.AbstractExecutorService

java.util.concurrent.ThreadPoolExecutor

com.github.geko444.im4java.process.ProcessExecutor

com.github.geko444.im4java.utils.BatchConverter

All Implemented Interfaces:

ProcessEventListener, Executor, ExecutorService

public class BatchConverter
extends ProcessExecutor

This class implements various batch-conversion methods.

• SEQUENTIAL: run commands sequentially for all images (this mode is mainly for debugging and benchmarking)
• PARALLEL: run commands in parallel using a ProcessExecutor
• BATCH: convert images at once with a single command.

Note that not every mode will work with every operation. The batch-mode will typically fail with all operations using ImageMagick's image-sequence operators (e.g. -clone).

Sequential and parallel-mode will convert all images and will save the indices of failed conversions. You can query these indices with the method getFailedConversions(). The batch mode behaves differently: it is a all-or-nothing conversion.

Since:

1.1.0

Version:

$Revision: 1.8 $

Author:

$Author: bablokb $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BatchConverter.ConvertException This nested exception wraps the original exception of failed conversions.
static class	BatchConverter.Mode Enumeration-type for the conversion mode: SEQUENTIAL: run commands sequentially for all images (this mode is mainly for debugging and benchmarking) PARALLEL: run commands in parallel using a ProcessExecutor BATCH: convert images at once with a single command.

Nested classes/interfaces inherited from class java.util.concurrent.ThreadPoolExecutor

ThreadPoolExecutor.AbortPolicy, ThreadPoolExecutor.CallerRunsPolicy, ThreadPoolExecutor.DiscardOldestPolicy, ThreadPoolExecutor.DiscardPolicy

Constructor Summary

Constructors

Constructor and Description
BatchConverter(BatchConverter.Mode pMode) The constructor.

Method Summary

Modifier and Type	Method and Description
List<BatchConverter.ConvertException>	getFailedConversions() Return the list of exceptions.
BatchConverter.Mode	getMode() Return the current run-mode
void	processTerminated(ProcessEvent pEvent) This method is called at normal or abnormal process termination.
void	run(Operation pOp, List<String> pImages, String pTargetPattern) Convert the given images with the given Operation.

Methods inherited from class com.github.geko444.im4java.process.ProcessExecutor

afterExecute, beforeExecute, destroy, processInitiated, processStarted, shutdownNow

Methods inherited from class java.util.concurrent.ThreadPoolExecutor

allowCoreThreadTimeOut, allowsCoreThreadTimeOut, awaitTermination, execute, finalize, getActiveCount, getCompletedTaskCount, getCorePoolSize, getKeepAliveTime, getLargestPoolSize, getMaximumPoolSize, getPoolSize, getQueue, getRejectedExecutionHandler, getTaskCount, getThreadFactory, isShutdown, isTerminated, isTerminating, prestartAllCoreThreads, prestartCoreThread, purge, remove, setCorePoolSize, setKeepAliveTime, setMaximumPoolSize, setRejectedExecutionHandler, setThreadFactory, shutdown, terminated, toString

Methods inherited from class java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, newTaskFor, newTaskFor, submit, submit, submit

Methods inherited from class java.lang.Object

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

Constructor Detail

BatchConverter

public BatchConverter(BatchConverter.Mode pMode)

The constructor.

Parameters:

pMode - The conversion mode of this BatchConverter

Method Detail

run

public void run(Operation pOp,
                List<String> pImages,
                String pTargetPattern)
         throws Exception,
                IOException,
                InterruptedException,
                IM4JavaException

Convert the given images with the given Operation.

Parameters:

pOp - the conversion-operation

pImages - List of images to convert

pTargetPattern - Pattern for the target-files. See FilenamePatternResolver for details

Throws:

Exception

IOException

InterruptedException

IM4JavaException

processTerminated

public void processTerminated(ProcessEvent pEvent)

This method is called at normal or abnormal process termination. This method is called at normal or abnormal process termination. In case of error, we will save the PID of the process (in our case, the PID is the index of the image causing the problem).

Specified by:

processTerminated in interface ProcessEventListener

Overrides:

processTerminated in class ProcessExecutor

getFailedConversions

public List<BatchConverter.ConvertException> getFailedConversions()

Return the list of exceptions.

Returns:

the list of exceptions (might be null)

getMode

public BatchConverter.Mode getMode()

Return the current run-mode

Returns:

the run-mode