forked from facebookarchive/flux
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
0ccdc95
commit b79d0ed
Showing
2 changed files
with
321 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,5 @@ | ||
node_modules | ||
lib/ | ||
Flux.js | ||
*.log | ||
website/src/flux/docs/ | ||
website/core/metadata.js |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,321 @@ | ||
!function(e){if("object"==typeof exports&&"undefined"!=typeof module)module.exports=e();else if("function"==typeof define&&define.amd)define([],e);else{var f;"undefined"!=typeof window?f=window:"undefined"!=typeof global?f=global:"undefined"!=typeof self&&(f=self),f.Flux=e()}}(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){ | ||
/** | ||
* Copyright (c) 2014, Facebook, Inc. | ||
* All rights reserved. | ||
* | ||
* This source code is licensed under the BSD-style license found in the | ||
* LICENSE file in the root directory of this source tree. An additional grant | ||
* of patent rights can be found in the PATENTS file in the same directory. | ||
*/ | ||
|
||
module.exports.Dispatcher = require('./lib/Dispatcher') | ||
|
||
},{"./lib/Dispatcher":2}],2:[function(require,module,exports){ | ||
/* | ||
* Copyright (c) 2014, Facebook, Inc. | ||
* All rights reserved. | ||
* | ||
* This source code is licensed under the BSD-style license found in the | ||
* LICENSE file in the root directory of this source tree. An additional grant | ||
* of patent rights can be found in the PATENTS file in the same directory. | ||
* | ||
* @providesModule Dispatcher | ||
* @typechecks | ||
*/ | ||
|
||
"use strict"; | ||
|
||
var invariant = require('./invariant'); | ||
|
||
var _lastID = 1; | ||
var _prefix = 'ID_'; | ||
|
||
/** | ||
* Dispatcher is used to broadcast payloads to registered callbacks. This is | ||
* different from generic pub-sub systems in two ways: | ||
* | ||
* 1) Callbacks are not subscribed to particular events. Every payload is | ||
* dispatched to every registered callback. | ||
* 2) Callbacks can be deferred in whole or part until other callbacks have | ||
* been executed. | ||
* | ||
* For example, consider this hypothetical flight destination form, which | ||
* selects a default city when a country is selected: | ||
* | ||
* var flightDispatcher = new Dispatcher(); | ||
* | ||
* // Keeps track of which country is selected | ||
* var CountryStore = {country: null}; | ||
* | ||
* // Keeps track of which city is selected | ||
* var CityStore = {city: null}; | ||
* | ||
* // Keeps track of the base flight price of the selected city | ||
* var FlightPriceStore = {price: null} | ||
* | ||
* When a user changes the selected city, we dispatch the payload: | ||
* | ||
* flightDispatcher.dispatch({ | ||
* actionType: 'city-update', | ||
* selectedCity: 'paris' | ||
* }); | ||
* | ||
* This payload is digested by `CityStore`: | ||
* | ||
* flightDispatcher.register(function(payload) { | ||
* if (payload.actionType === 'city-update') { | ||
* CityStore.city = payload.selectedCity; | ||
* } | ||
* }); | ||
* | ||
* When the user selects a country, we dispatch the payload: | ||
* | ||
* flightDispatcher.dispatch({ | ||
* actionType: 'country-update', | ||
* selectedCountry: 'australia' | ||
* }); | ||
* | ||
* This payload is digested by both stores: | ||
* | ||
* CountryStore.dispatchToken = flightDispatcher.register(function(payload) { | ||
* if (payload.actionType === 'country-update') { | ||
* CountryStore.country = payload.selectedCountry; | ||
* } | ||
* }); | ||
* | ||
* When the callback to update `CountryStore` is registered, we save a reference | ||
* to the returned token. Using this token with `waitFor()`, we can guarantee | ||
* that `CountryStore` is updated before the callback that updates `CityStore` | ||
* needs to query its data. | ||
* | ||
* CityStore.dispatchToken = flightDispatcher.register(function(payload) { | ||
* if (payload.actionType === 'country-update') { | ||
* // `CountryStore.country` may not be updated. | ||
* flightDispatcher.waitFor([CountryStore.dispatchToken]); | ||
* // `CountryStore.country` is now guaranteed to be updated. | ||
* | ||
* // Select the default city for the new country | ||
* CityStore.city = getDefaultCityForCountry(CountryStore.country); | ||
* } | ||
* }); | ||
* | ||
* The usage of `waitFor()` can be chained, for example: | ||
* | ||
* FlightPriceStore.dispatchToken = | ||
* flightDispatcher.register(function(payload) { | ||
* switch (payload.actionType) { | ||
* case 'country-update': | ||
* flightDispatcher.waitFor([CityStore.dispatchToken]); | ||
* FlightPriceStore.price = | ||
* getFlightPriceStore(CountryStore.country, CityStore.city); | ||
* break; | ||
* | ||
* case 'city-update': | ||
* FlightPriceStore.price = | ||
* FlightPriceStore(CountryStore.country, CityStore.city); | ||
* break; | ||
* } | ||
* }); | ||
* | ||
* The `country-update` payload will be guaranteed to invoke the stores' | ||
* registered callbacks in order: `CountryStore`, `CityStore`, then | ||
* `FlightPriceStore`. | ||
*/ | ||
|
||
function Dispatcher() { | ||
this.$Dispatcher_callbacks = {}; | ||
this.$Dispatcher_isPending = {}; | ||
this.$Dispatcher_isHandled = {}; | ||
this.$Dispatcher_isDispatching = false; | ||
this.$Dispatcher_pendingPayload = null; | ||
} | ||
|
||
/** | ||
* Registers a callback to be invoked with every dispatched payload. Returns | ||
* a token that can be used with `waitFor()`. | ||
* | ||
* @param {function} callback | ||
* @return {string} | ||
*/ | ||
Dispatcher.prototype.register=function(callback) { | ||
var id = _prefix + _lastID++; | ||
this.$Dispatcher_callbacks[id] = callback; | ||
return id; | ||
}; | ||
|
||
/** | ||
* Removes a callback based on its token. | ||
* | ||
* @param {string} id | ||
*/ | ||
Dispatcher.prototype.unregister=function(id) { | ||
invariant( | ||
this.$Dispatcher_callbacks[id], | ||
'Dispatcher.unregister(...): `%s` does not map to a registered callback.', | ||
id | ||
); | ||
delete this.$Dispatcher_callbacks[id]; | ||
}; | ||
|
||
/** | ||
* Waits for the callbacks specified to be invoked before continuing execution | ||
* of the current callback. This method should only be used by a callback in | ||
* response to a dispatched payload. | ||
* | ||
* @param {array<string>} ids | ||
*/ | ||
Dispatcher.prototype.waitFor=function(ids) { | ||
invariant( | ||
this.$Dispatcher_isDispatching, | ||
'Dispatcher.waitFor(...): Must be invoked while dispatching.' | ||
); | ||
for (var ii = 0; ii < ids.length; ii++) { | ||
var id = ids[ii]; | ||
if (this.$Dispatcher_isPending[id]) { | ||
invariant( | ||
this.$Dispatcher_isHandled[id], | ||
'Dispatcher.waitFor(...): Circular dependency detected while ' + | ||
'waiting for `%s`.', | ||
id | ||
); | ||
continue; | ||
} | ||
invariant( | ||
this.$Dispatcher_callbacks[id], | ||
'Dispatcher.waitFor(...): `%s` does not map to a registered callback.', | ||
id | ||
); | ||
this.$Dispatcher_invokeCallback(id); | ||
} | ||
}; | ||
|
||
/** | ||
* Dispatches a payload to all registered callbacks. | ||
* | ||
* @param {object} payload | ||
*/ | ||
Dispatcher.prototype.dispatch=function(payload) { | ||
invariant( | ||
!this.$Dispatcher_isDispatching, | ||
'Dispatch.dispatch(...): Cannot dispatch in the middle of a dispatch.' | ||
); | ||
this.$Dispatcher_startDispatching(payload); | ||
try { | ||
for (var id in this.$Dispatcher_callbacks) { | ||
if (this.$Dispatcher_isPending[id]) { | ||
continue; | ||
} | ||
this.$Dispatcher_invokeCallback(id); | ||
} | ||
} finally { | ||
this.$Dispatcher_stopDispatching(); | ||
} | ||
}; | ||
|
||
/** | ||
* Is this Dispatcher currently dispatching. | ||
* | ||
* @return {boolean} | ||
*/ | ||
Dispatcher.prototype.isDispatching=function() { | ||
return this.$Dispatcher_isDispatching; | ||
}; | ||
|
||
/** | ||
* Call the callback stored with the given id. Also do some internal | ||
* bookkeeping. | ||
* | ||
* @param {string} id | ||
* @internal | ||
*/ | ||
Dispatcher.prototype.$Dispatcher_invokeCallback=function(id) { | ||
this.$Dispatcher_isPending[id] = true; | ||
this.$Dispatcher_callbacks[id](this.$Dispatcher_pendingPayload); | ||
this.$Dispatcher_isHandled[id] = true; | ||
}; | ||
|
||
/** | ||
* Set up bookkeeping needed when dispatching. | ||
* | ||
* @param {object} payload | ||
* @internal | ||
*/ | ||
Dispatcher.prototype.$Dispatcher_startDispatching=function(payload) { | ||
for (var id in this.$Dispatcher_callbacks) { | ||
this.$Dispatcher_isPending[id] = false; | ||
this.$Dispatcher_isHandled[id] = false; | ||
} | ||
this.$Dispatcher_pendingPayload = payload; | ||
this.$Dispatcher_isDispatching = true; | ||
}; | ||
|
||
/** | ||
* Clear bookkeeping used for dispatching. | ||
* | ||
* @internal | ||
*/ | ||
Dispatcher.prototype.$Dispatcher_stopDispatching=function() { | ||
this.$Dispatcher_pendingPayload = null; | ||
this.$Dispatcher_isDispatching = false; | ||
}; | ||
|
||
|
||
module.exports = Dispatcher; | ||
|
||
},{"./invariant":3}],3:[function(require,module,exports){ | ||
/** | ||
* Copyright (c) 2014, Facebook, Inc. | ||
* All rights reserved. | ||
* | ||
* This source code is licensed under the BSD-style license found in the | ||
* LICENSE file in the root directory of this source tree. An additional grant | ||
* of patent rights can be found in the PATENTS file in the same directory. | ||
* | ||
* @providesModule invariant | ||
*/ | ||
|
||
"use strict"; | ||
|
||
/** | ||
* Use invariant() to assert state which your program assumes to be true. | ||
* | ||
* Provide sprintf-style format (only %s is supported) and arguments | ||
* to provide information about what broke and what you were | ||
* expecting. | ||
* | ||
* The invariant message will be stripped in production, but the invariant | ||
* will remain to ensure logic does not differ in production. | ||
*/ | ||
|
||
var invariant = function(condition, format, a, b, c, d, e, f) { | ||
if (false) { | ||
if (format === undefined) { | ||
throw new Error('invariant requires an error message argument'); | ||
} | ||
} | ||
|
||
if (!condition) { | ||
var error; | ||
if (format === undefined) { | ||
error = new Error( | ||
'Minified exception occurred; use the non-minified dev environment ' + | ||
'for the full error message and additional helpful warnings.' | ||
); | ||
} else { | ||
var args = [a, b, c, d, e, f]; | ||
var argIndex = 0; | ||
error = new Error( | ||
'Invariant Violation: ' + | ||
format.replace(/%s/g, function() { return args[argIndex++]; }) | ||
); | ||
} | ||
|
||
error.framesToPop = 1; // we don't care about invariant's own frame | ||
throw error; | ||
} | ||
}; | ||
|
||
module.exports = invariant; | ||
|
||
},{}]},{},[1])(1) | ||
}); |