root / HServer / 00.Server / 00.Program / node_modules / async / auto.js
이력 | 보기 | 이력해설 | 다운로드 (9.35 KB)
1 | 39 | HKM | 'use strict';
|
---|---|---|---|
2 | |||
3 | Object.defineProperty(exports, "__esModule", {
|
||
4 | value: true |
||
5 | }); |
||
6 | |||
7 | exports.default = function (tasks, concurrency, callback) { |
||
8 | if (typeof concurrency === 'function') { |
||
9 | // concurrency is optional, shift the args.
|
||
10 | callback = concurrency; |
||
11 | concurrency = null;
|
||
12 | } |
||
13 | callback = (0, _once2.default)(callback || _noop2.default); |
||
14 | var keys = (0, _keys2.default)(tasks); |
||
15 | var numTasks = keys.length;
|
||
16 | if (!numTasks) {
|
||
17 | return callback(null); |
||
18 | } |
||
19 | if (!concurrency) {
|
||
20 | concurrency = numTasks; |
||
21 | } |
||
22 | |||
23 | var results = {};
|
||
24 | var runningTasks = 0; |
||
25 | var hasError = false; |
||
26 | |||
27 | var listeners = {};
|
||
28 | |||
29 | var readyTasks = [];
|
||
30 | |||
31 | // for cycle detection:
|
||
32 | var readyToCheck = []; // tasks that have been identified as reachable |
||
33 | // without the possibility of returning to an ancestor task
|
||
34 | var uncheckedDependencies = {};
|
||
35 | |||
36 | (0, _baseForOwn2.default)(tasks, function (task, key) { |
||
37 | if (!(0, _isArray2.default)(task)) { |
||
38 | // no dependencies
|
||
39 | enqueueTask(key, [task]); |
||
40 | readyToCheck.push(key); |
||
41 | return;
|
||
42 | } |
||
43 | |||
44 | var dependencies = task.slice(0, task.length - 1); |
||
45 | var remainingDependencies = dependencies.length;
|
||
46 | if (remainingDependencies === 0) { |
||
47 | enqueueTask(key, task); |
||
48 | readyToCheck.push(key); |
||
49 | return;
|
||
50 | } |
||
51 | uncheckedDependencies[key] = remainingDependencies; |
||
52 | |||
53 | (0, _arrayEach2.default)(dependencies, function (dependencyName) { |
||
54 | if (!tasks[dependencyName]) {
|
||
55 | throw new Error('async.auto task `' + key + '` has a non-existent dependency in ' + dependencies.join(', ')); |
||
56 | } |
||
57 | addListener(dependencyName, function () {
|
||
58 | remainingDependencies--; |
||
59 | if (remainingDependencies === 0) { |
||
60 | enqueueTask(key, task); |
||
61 | } |
||
62 | }); |
||
63 | }); |
||
64 | }); |
||
65 | |||
66 | checkForDeadlocks(); |
||
67 | processQueue(); |
||
68 | |||
69 | function enqueueTask(key, task) { |
||
70 | readyTasks.push(function () {
|
||
71 | runTask(key, task); |
||
72 | }); |
||
73 | } |
||
74 | |||
75 | function processQueue() { |
||
76 | if (readyTasks.length === 0 && runningTasks === 0) { |
||
77 | return callback(null, results); |
||
78 | } |
||
79 | while (readyTasks.length && runningTasks < concurrency) {
|
||
80 | var run = readyTasks.shift();
|
||
81 | run(); |
||
82 | } |
||
83 | } |
||
84 | |||
85 | function addListener(taskName, fn) { |
||
86 | var taskListeners = listeners[taskName];
|
||
87 | if (!taskListeners) {
|
||
88 | taskListeners = listeners[taskName] = []; |
||
89 | } |
||
90 | |||
91 | taskListeners.push(fn); |
||
92 | } |
||
93 | |||
94 | function taskComplete(taskName) { |
||
95 | var taskListeners = listeners[taskName] || [];
|
||
96 | (0, _arrayEach2.default)(taskListeners, function (fn) { |
||
97 | fn(); |
||
98 | }); |
||
99 | processQueue(); |
||
100 | } |
||
101 | |||
102 | function runTask(key, task) { |
||
103 | if (hasError) return; |
||
104 | |||
105 | var taskCallback = (0, _onlyOnce2.default)((0, _rest2.default)(function (err, args) { |
||
106 | runningTasks--; |
||
107 | if (args.length <= 1) { |
||
108 | args = args[0];
|
||
109 | } |
||
110 | if (err) {
|
||
111 | var safeResults = {};
|
||
112 | (0, _baseForOwn2.default)(results, function (val, rkey) { |
||
113 | safeResults[rkey] = val; |
||
114 | }); |
||
115 | safeResults[key] = args; |
||
116 | hasError = true;
|
||
117 | listeners = []; |
||
118 | |||
119 | callback(err, safeResults); |
||
120 | } else {
|
||
121 | results[key] = args; |
||
122 | taskComplete(key); |
||
123 | } |
||
124 | })); |
||
125 | |||
126 | runningTasks++; |
||
127 | var taskFn = task[task.length - 1]; |
||
128 | if (task.length > 1) { |
||
129 | taskFn(results, taskCallback); |
||
130 | } else {
|
||
131 | taskFn(taskCallback); |
||
132 | } |
||
133 | } |
||
134 | |||
135 | function checkForDeadlocks() { |
||
136 | // Kahn's algorithm
|
||
137 | // https://en.wikipedia.org/wiki/Topological_sorting#Kahn.27s_algorithm
|
||
138 | // http://connalle.blogspot.com/2013/10/topological-sortingkahn-algorithm.html
|
||
139 | var currentTask;
|
||
140 | var counter = 0; |
||
141 | while (readyToCheck.length) {
|
||
142 | currentTask = readyToCheck.pop(); |
||
143 | counter++; |
||
144 | (0, _arrayEach2.default)(getDependents(currentTask), function (dependent) { |
||
145 | if (--uncheckedDependencies[dependent] === 0) { |
||
146 | readyToCheck.push(dependent); |
||
147 | } |
||
148 | }); |
||
149 | } |
||
150 | |||
151 | if (counter !== numTasks) {
|
||
152 | throw new Error('async.auto cannot execute tasks due to a recursive dependency'); |
||
153 | } |
||
154 | } |
||
155 | |||
156 | function getDependents(taskName) { |
||
157 | var result = [];
|
||
158 | (0, _baseForOwn2.default)(tasks, function (task, key) { |
||
159 | if ((0, _isArray2.default)(task) && (0, _baseIndexOf2.default)(task, taskName, 0) >= 0) { |
||
160 | result.push(key); |
||
161 | } |
||
162 | }); |
||
163 | return result;
|
||
164 | } |
||
165 | }; |
||
166 | |||
167 | var _arrayEach = require('lodash/_arrayEach'); |
||
168 | |||
169 | var _arrayEach2 = _interopRequireDefault(_arrayEach);
|
||
170 | |||
171 | var _baseForOwn = require('lodash/_baseForOwn'); |
||
172 | |||
173 | var _baseForOwn2 = _interopRequireDefault(_baseForOwn);
|
||
174 | |||
175 | var _baseIndexOf = require('lodash/_baseIndexOf'); |
||
176 | |||
177 | var _baseIndexOf2 = _interopRequireDefault(_baseIndexOf);
|
||
178 | |||
179 | var _isArray = require('lodash/isArray'); |
||
180 | |||
181 | var _isArray2 = _interopRequireDefault(_isArray);
|
||
182 | |||
183 | var _keys = require('lodash/keys'); |
||
184 | |||
185 | var _keys2 = _interopRequireDefault(_keys);
|
||
186 | |||
187 | var _noop = require('lodash/noop'); |
||
188 | |||
189 | var _noop2 = _interopRequireDefault(_noop);
|
||
190 | |||
191 | var _rest = require('./internal/rest'); |
||
192 | |||
193 | var _rest2 = _interopRequireDefault(_rest);
|
||
194 | |||
195 | var _once = require('./internal/once'); |
||
196 | |||
197 | var _once2 = _interopRequireDefault(_once);
|
||
198 | |||
199 | var _onlyOnce = require('./internal/onlyOnce'); |
||
200 | |||
201 | var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||
202 | |||
203 | function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } |
||
204 | |||
205 | module.exports = exports['default'];
|
||
206 | |||
207 | /**
|
||
208 | * Determines the best order for running the functions in `tasks`, based on
|
||
209 | * their requirements. Each function can optionally depend on other functions
|
||
210 | * being completed first, and each function is run as soon as its requirements
|
||
211 | * are satisfied.
|
||
212 | *
|
||
213 | * If any of the functions pass an error to their callback, the `auto` sequence
|
||
214 | * will stop. Further tasks will not execute (so any other functions depending
|
||
215 | * on it will not run), and the main `callback` is immediately called with the
|
||
216 | * error.
|
||
217 | *
|
||
218 | * Functions also receive an object containing the results of functions which
|
||
219 | * have completed so far as the first argument, if they have dependencies. If a
|
||
220 | * task function has no dependencies, it will only be passed a callback.
|
||
221 | *
|
||
222 | * @name auto
|
||
223 | * @static
|
||
224 | * @memberOf module:ControlFlow
|
||
225 | * @method
|
||
226 | * @category Control Flow
|
||
227 | * @param {Object} tasks - An object. Each of its properties is either a
|
||
228 | * function or an array of requirements, with the function itself the last item
|
||
229 | * in the array. The object's key of a property serves as the name of the task
|
||
230 | * defined by that property, i.e. can be used when specifying requirements for
|
||
231 | * other tasks. The function receives one or two arguments:
|
||
232 | * * a `results` object, containing the results of the previously executed
|
||
233 | * functions, only passed if the task has any dependencies,
|
||
234 | * * a `callback(err, result)` function, which must be called when finished,
|
||
235 | * passing an `error` (which can be `null`) and the result of the function's
|
||
236 | * execution.
|
||
237 | * @param {number} [concurrency=Infinity] - An optional `integer` for
|
||
238 | * determining the maximum number of tasks that can be run in parallel. By
|
||
239 | * default, as many as possible.
|
||
240 | * @param {Function} [callback] - An optional callback which is called when all
|
||
241 | * the tasks have been completed. It receives the `err` argument if any `tasks`
|
||
242 | * pass an error to their callback. Results are always returned; however, if an
|
||
243 | * error occurs, no further `tasks` will be performed, and the results object
|
||
244 | * will only contain partial results. Invoked with (err, results).
|
||
245 | * @returns undefined
|
||
246 | * @example
|
||
247 | *
|
||
248 | * async.auto({
|
||
249 | * // this function will just be passed a callback
|
||
250 | * readData: async.apply(fs.readFile, 'data.txt', 'utf-8'),
|
||
251 | * showData: ['readData', function(results, cb) {
|
||
252 | * // results.readData is the file's contents
|
||
253 | * // ...
|
||
254 | * }]
|
||
255 | * }, callback);
|
||
256 | *
|
||
257 | * async.auto({
|
||
258 | * get_data: function(callback) {
|
||
259 | * console.log('in get_data');
|
||
260 | * // async code to get some data
|
||
261 | * callback(null, 'data', 'converted to array');
|
||
262 | * },
|
||
263 | * make_folder: function(callback) {
|
||
264 | * console.log('in make_folder');
|
||
265 | * // async code to create a directory to store a file in
|
||
266 | * // this is run at the same time as getting the data
|
||
267 | * callback(null, 'folder');
|
||
268 | * },
|
||
269 | * write_file: ['get_data', 'make_folder', function(results, callback) {
|
||
270 | * console.log('in write_file', JSON.stringify(results));
|
||
271 | * // once there is some data and the directory exists,
|
||
272 | * // write the data to a file in the directory
|
||
273 | * callback(null, 'filename');
|
||
274 | * }],
|
||
275 | * email_link: ['write_file', function(results, callback) {
|
||
276 | * console.log('in email_link', JSON.stringify(results));
|
||
277 | * // once the file is written let's email a link to it...
|
||
278 | * // results.write_file contains the filename returned by write_file.
|
||
279 | * callback(null, {'file':results.write_file, 'email':'user@example.com'});
|
||
280 | * }]
|
||
281 | * }, function(err, results) {
|
||
282 | * console.log('err = ', err);
|
||
283 | * console.log('results = ', results);
|
||
284 | * });
|
||
285 | */ |