@terascope/job-components / operations/core/slicer-core / default

Class: abstract default<T>

A base class for supporting "Slicers" that run on a "Execution Controller", that supports the execution lifecycle events. This class will likely not be used externally since Teraslice only supports a few type varients.

See [[Core]] for more information

Extends

• default<Context>

Extended by

• default
• default

Type parameters

Type parameter	Value
T	OpConfig

Implements

• SlicerOperationLifeCycle

Constructors

new default()

new default<T>(context, opConfig, executionConfig): default<T>

Parameters

Parameter	Type
context	Context
opConfig	OpConfig & T
executionConfig	ExecutionConfig

Returns

default<T>

Overrides

default.constructor

Source

packages/job-components/src/operations/core/slicer-core.ts:30

Properties

context

readonly context: Readonly<Context>

Inherited from

default.context

Source

packages/job-components/src/operations/core/core.ts:10

---

events

readonly events: EventEmitter<DefaultEventMap>

Inherited from

default.events

Source

packages/job-components/src/operations/core/core.ts:13

---

executionConfig

readonly executionConfig: Readonly<ExecutionConfig>

Inherited from

default.executionConfig

Source

packages/job-components/src/operations/core/core.ts:11

---

logger

readonly logger: Logger

Inherited from

default.logger

Source

packages/job-components/src/operations/core/core.ts:12

---

opConfig

protected readonly opConfig: Readonly<OpConfig & T>

Source

packages/job-components/src/operations/core/slicer-core.ts:27

---

recoveryData

protected recoveryData: SlicerRecoveryData[]

Source

packages/job-components/src/operations/core/slicer-core.ts:26

---

stats

protected stats: ExecutionStats

Source

packages/job-components/src/operations/core/slicer-core.ts:25

Accessors

workersConnected

get protected workersConnected(): number

Returns

number

Source

packages/job-components/src/operations/core/slicer-core.ts:176

Methods

canComplete()

protected canComplete(): boolean

Returns

boolean

Source

packages/job-components/src/operations/core/slicer-core.ts:172

---

createAPI()

createAPI<A>(name, ...params): Promise<A>

Create an API and add it to the operation lifecycle

Type parameters

Type parameter	Value
A extends OpAPI	OpAPI

Parameters

Parameter	Type
name	string
...params	any[]

Returns

Promise<A>

Source

packages/job-components/src/operations/core/slicer-core.ts:67

---

createSlice()

createSlice(input, order, id): void

Create a Slice object from a slice request. In the case of recovery the "Slice" already has the required This will be enqueued and dequeued by the "Execution Controller"

Parameters

Parameter	Type	Default value
input	SliceRequest | Slice	undefined
order	number	undefined
id	number	0

Returns

void

Source

packages/job-components/src/operations/core/slicer-core.ts:95

---

getAPI()

getAPI<A>(name): A

Get a reference to an existing API

Type parameters

Type parameter	Value
A extends OpAPI	OpAPI

Parameters

Parameter	Type
name	string

Returns

A

Source

packages/job-components/src/operations/core/slicer-core.ts:74

---

getSlice()

getSlice(): null | Slice

A method called by the "Execution Controller" to dequeue a created "Slice"

Returns

null | Slice

Source

packages/job-components/src/operations/core/slicer-core.ts:112

---

getSlices()

getSlices(max): Slice[]

A method called by the "Execution Controller" to dequeue many created slices

Parameters

Parameter	Type
max	number

Returns

Slice[]

Source

packages/job-components/src/operations/core/slicer-core.ts:121

---

handle()

abstract handle(): Promise<boolean>

A generic method called by the Teraslice framework to a give a "Slicer" the ability to handle creating slices.

Returns

Promise<boolean>

a boolean depending on whether the slicer is done

Source

packages/job-components/src/operations/core/slicer-core.ts:83

---

initialize()

initialize(recoveryData): Promise<void>

Called during execution initialization

Parameters

Parameter	Type	Description
recoveryData	SlicerRecoveryData[]	is the data to recover from

Returns

Promise<void>

Implementation of

SlicerOperationLifeCycle.initialize

Overrides

default.initialize

Source

packages/job-components/src/operations/core/slicer-core.ts:55

---

isRecoverable()

isRecoverable(): boolean

Used to indicate whether this slicer is recoverable.

Returns

boolean

Source

packages/job-components/src/operations/core/slicer-core.ts:146

---

isRelocatable()

isRelocatable(): boolean

Used to indicate whether this slicer is relocatable. Only relevant for kubernetesV2 backend

Returns

boolean

Source

packages/job-components/src/operations/core/slicer-core.ts:154

---

maxQueueLength()

maxQueueLength(): number

Used to determine the maximum number of slices queued. Defaults to 10000 NOTE: if you want to base of the number of workers use #workersConnected

Returns

number

Source

packages/job-components/src/operations/core/slicer-core.ts:164

---

onExecutionStats()

onExecutionStats(stats): void

A method called by the "Execution Controller" to give a "Slicer" the opportunity to track various slicer satistics

Parameters

Parameter	Type
stats	ExecutionStats

Returns

void

Implementation of

SlicerOperationLifeCycle.onExecutionStats

Source

packages/job-components/src/operations/core/slicer-core.ts:168

---

shutdown()

shutdown(): Promise<void>

Called during execution shutdown, when this is cleanup any open connections or destroy any in-memory state.

Returns

Promise<void>

Implementation of

SlicerOperationLifeCycle.shutdown

Overrides

default.shutdown

Source

packages/job-components/src/operations/core/slicer-core.ts:60

---

sliceCount()

sliceCount(): number

The number of enqueued slices

Returns

number

Source

packages/job-components/src/operations/core/slicer-core.ts:139

---

slicers()

abstract slicers(): number

Return the number of registered slicers

Returns

number

Source

packages/job-components/src/operations/core/slicer-core.ts:88