com.chemaxon.calculations.common

Class ProgressObservers

java.lang.Object

com.chemaxon.calculations.common.ProgressObservers

@Beta
public final class ProgressObservers
extends Object

Utility functions for the creation of ProgressObservers.

Please note that this class is marked with @Beta annotation, so it can be subject of incompatible changes or removal in any of the later releases.

Author:

Gabor Imre

Method Summary

Methods

Modifier and Type	Method and Description
static SubProgressObserver	createForgivingNullObserver() Deprecated. Use nullProgressObserver() instead.
static CancelObserver	createNoCancelObserver() Deprecated. Use #noCancelObserver()
static SubProgressObserver	createNullObserver(String taskName) Deprecated. Use createStrictNullObserver().
static SubProgressObserver	createStrictNullObserver() Returns a SubProgressObserver which ignores observed data.
static CancelObserver	noCanceller() Returns a cancel observer which wont cancel execution.
static SubProgressObserver	nullProgressObserver() Returns a forgiving observer which wont enforce API contracts.
static SubProgressObserver	nullProgressObserver(CancelObserver canceller) Returns a forgiving cancellable observer which wont enforce API contracts.

Methods inherited from class java.lang.Object

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

Method Detail

createStrictNullObserver

public static SubProgressObserver createStrictNullObserver()

Returns a SubProgressObserver which ignores observed data.

API contract is still enforced, eg. IllegalStateException is thrown on API contract breaches from the observed code.

Returns:

A ProgressObserver with no query functionality.

createNullObserver

@Deprecated
public static SubProgressObserver createNullObserver(String taskName)

Deprecated. Use createStrictNullObserver().

Returns a SubProgressObserver which ignores observed data.

API contract is still enforced, eg. IllegalStateException is thrown on API contract breaches from the observed code.

Parameters:

taskName - Name of observed subtask

Returns:

A ProgressObserver with no query functionality.

noCanceller

public static CancelObserver noCanceller()

Returns a cancel observer which wont cancel execution.

Returns:

A canceller which wont cancel

createNoCancelObserver

@Deprecated
public static CancelObserver createNoCancelObserver()

Deprecated. Use #noCancelObserver()

Returns a cancel observer which wont cancel execution.

Returns:

A Canceller which wont cancel

nullProgressObserver

public static SubProgressObserver nullProgressObserver()

Returns a forgiving observer which wont enforce API contracts.

Returns:

A SubProgressObserver which wont enforce API contracts and wont cancel

createForgivingNullObserver

@Deprecated
public static SubProgressObserver createForgivingNullObserver()

Deprecated. Use nullProgressObserver() instead.

Returns a forgiving observer which wont enforce API contracts.

Returns:

A SubProgressObserver which wont enforce API contracts and wont cancel

nullProgressObserver

public static SubProgressObserver nullProgressObserver(CancelObserver canceller)

Returns a forgiving cancellable observer which wont enforce API contracts.

Note that current implementation polls cancelling upon method calls. If an observed code expects cancelling only through listener callbacks and wont call other methods (progress update) cancel event wont be generated.

Parameters:

canceller - Underlying canceller polled at every operation

Returns:

A SubProgressObserver which wont enforce API contracts and propagates cancellinkg