ArcGIS Runtime SDK for iOS: AGSOperationBase Class Reference
ArcGIS Runtime SDK for iOS  100.12
AGSOperationBase Class Reference

Description

A base operation class that implements the AGSOperation protocol.

Since
100
Inheritance diagram for AGSOperationBase:
<AGSOperation> AGSObservableOperation AGSRequestOperation AGSJSONRequestOperation

Instance Methods

(void) - cancel
 
(void) - didComplete:
 
(void) - doCancel
 
(void) - doExecute
 
(void) - doneExecuting
 
(void) - execute
 

Properties

BOOL canceled
 
void(^ internalCompletion )(void)
 
BOOL startAsynchronously
 
AGSOperationState state
 

Method Documentation

◆ cancel

- (void) cancel

Cancels the operation.

Since
100

◆ didComplete:

- (void) didComplete: (BOOL)  everStarted

Subclasses should override if they want to run some code once the operation is completed. This function is guaranteed to only be called once. everStarted will be NO if the operation was canceled before it could be started.

Since
100

Provided by category AGSOperationBase(ForSubclassEyesOnly).

◆ doCancel

- (void) doCancel

Subclasses can override to do the actual work to cancel the operation. Once cancel is complete, call doneExecuting. For operations that do not do all of their work in doExecute, it makes sense to override this and cancel any network connections, etc. Then when the cancel is complete, you call doneExecuting. For operations where the work is all done in doExecute they shouldn't need to override this, you should just check the isCanceled property throughout the execution of the operation and if it is canceled then call doneExecuting and return.

Since
100

Provided by category AGSOperationBase(ForSubclassEyesOnly).

◆ doExecute

- (void) doExecute

Subclasses should override to do the actual execution of the operation. Once done, call doneExecuting.

Since
100

Provided by category AGSOperationBase(ForSubclassEyesOnly).

◆ doneExecuting

- (void) doneExecuting

Subclasses should call this when they are done executing or done cancelling.

Since
100

Provided by category AGSOperationBase(ForSubclassEyesOnly).

◆ execute

- (void) execute

Starts the operation

Since
100

Property Documentation

◆ canceled

- (BOOL) canceled
readnonatomicassigninherited

Whether or not cancel has been called on the operation. "Canceled" is a modifier on the current state since:

  1. The operation can be still "executing" until the cancel takes effect.
  2. An operation can be canceled and in a completed state at the same time.
    Since
    100

◆ internalCompletion

- (void(^ internalCompletion) (void))
readwritenonatomiccopyinherited

The block the operation will call to signify to the operation queue that the operation is complete. This block is reserved for use by the AGSOperationQueue. Do not assign your own block to this.

Since
100

◆ startAsynchronously

- (BOOL) startAsynchronously
readwritenonatomicassign

Subclasses can set this if they want to be started asynchronously or not. If an operation does most or all of it's work in doExecute it should set this to YES. If an operation returns quickly from doExecute and does all of it's work on a different queue then this value should be NO. The default value is YES.

Provided by category AGSOperationBase(ForSubclassEyesOnly).

◆ state

- (AGSOperationState) state
readnonatomicassigninherited

The current state of the operation.

Since
100