From 8592cfb89db05f0e52d8c1b8c7046e6f49e3522d Mon Sep 17 00:00:00 2001 From: Valerio Virgillito Date: Wed, 1 Feb 2012 00:09:27 -0800 Subject: Adding a montage framework copy for the user document Adding a new montage copy containing the latest version of montage to use the new native widgets Signed-off-by: Valerio Virgillito --- node_modules/montage-user/data/transactionid.js | 230 ++++++++++++++++++++++++ 1 file changed, 230 insertions(+) create mode 100755 node_modules/montage-user/data/transactionid.js (limited to 'node_modules/montage-user/data/transactionid.js') diff --git a/node_modules/montage-user/data/transactionid.js b/node_modules/montage-user/data/transactionid.js new file mode 100755 index 00000000..330dc6c4 --- /dev/null +++ b/node_modules/montage-user/data/transactionid.js @@ -0,0 +1,230 @@ +/* +This file contains proprietary software owned by Motorola Mobility, Inc.
+No rights, expressed or implied, whatsoever to this software are provided by Motorola Mobility, Inc. hereunder.
+(c) Copyright 2011 Motorola Mobility, Inc. All Rights Reserved. + */ +/** + @module montage/data/transactionid + @requires montage/core/core + @requires montage/core/uuid + @requires montage/core/logger +*/ +var Montage = require("montage").Montage; +var Uuid = require("core/uuid").Uuid; +var logger = require("core/logger").logger("transactionid"); +/** + Description TODO + @private +*/ +var _lastTimestamp = Date.now(); +/** + Description TODO + @private +*/ +var _lastNanos = 1; +/** + Description TODO + @private +*/ +var _transactionManagerInstance = null; +/** + @class module:montage/data/transactionid.TransactionId + @extends module:montage/core/core.Montage +*/ +var TransactionId = exports.TransactionId = Montage.create(Montage,/** @lends module:montage/data/transactionid.TransactionId# */ { +/** + This is used to guarantee unicity. + @private +*/ + _uuid: { + serializable: true, + enumerable: false, + value: null + }, +/** + This is used to order transactions. + @private +*/ + _timestamp: { + serializable: true, + enumerable: false, + value: null + }, +/** + This is used to order transactions. + @private +*/ + _nanos: { + serializable: true, + enumerable: false, + value: null + }, +/** + Description TODO + @function + @returns itself + */ + init: { + serializable: false, + enumerable: false, + value: function() { + this._uuid = Uuid.generate(); + var timestamp = Date.now(); + if (_lastTimestamp === timestamp) { + _lastNanos = _lastNanos + 1; + } else { + _lastTimestamp = timestamp; + _lastNanos = 1 + } + this._timestamp = _lastTimestamp; + this._nanos = _lastNanos; + if (logger.isDebug) { + logger.debug(this, "New Transaction ID: " + this._timestamp); + } + return this; + } + }, + +/** + Factory method used to create new Transaction IDs.
+ This factory supports a delegate so that application requiring subclassing can do so easily.
+ The factory delegate should implement createTransactionId method. + @function + @returns TransactionId.create().init() A newly initialized transaction ID. + */ + factory: { + value: function() { + if (this.factory.delegate && typeof this.factory.delegate.createTransactionId === "function") { + return this.factory.delegate.createTransactionId(); + } else { + return TransactionId.create().init(); + } + }}, + +/** + Description TODO + @function + @param {Property} transactionId For comparison purposes. + @returns {Boolean} true If transactionId is after the target transaction ID. + */ + before: { + value: function(transactionId) { + if (this._timestamp === transactionId._timestamp) { + return this._nanos < transactionId._nanos; + } + return this._timestamp < transactionId._timestamp; + + }}, + +/** + Description TODO + @function + @param {Property} transactionId For comparison purposes. + @returns {Boolean} true If transactionId is before the target transaction ID. + */ + after: { + value: function(transactionId) { + if (this._timestamp === transactionId._timestamp) { + return this._nanos > transactionId._nanos; + } + return this._timestamp > transactionId._timestamp; + }}, + +/** + Returns the transaction manager.
+ The transaction manager is a unique object in charge of openning and closing transactions. + @function + @returns transaction manager + */ + manager: { + get: function() { + if (_transactionManagerInstance === null) { + _transactionManagerInstance = Object.freeze(TransactionManager.create().init()); + } + return _transactionManagerInstance; + } + } + + +}); +/** + @class module:montage/data/transactionid.TransactionManager +*/ +var TransactionManager = exports.TransactionManager = Montage.create(Montage,/** @lends module:montage/data/transactionid.TransactionManager# */ { + + /** + Enables the trace of creation starts.
+ When enabled, the transaction ID will memorize the state of the thread stack when created. + @type {Property} Function + @default {Boolean} false + */ + traceTransactionStart: { + serializable: false, + enumerable: false, + value: false + }, + +/** + Description TODO + @function + @returns itself + */ + init: { + serializable: false, + enumerable: false, + value: function() { + return this; + } + }, + + /** + Opens a new transaction ID for this thread. + @function + @returns null or new transaction ID + @throws IllegalStateException if a transaction is already open for this thread. + */ + startTransaction: { value: function() { + return null; + }}, + + /** + Returns the current transaction ID for this thread. + @function + @returns null or current transaction ID + */ + currentTransaction: { value: function() { + return null; + }}, + +/** + Checks if the current thread has an open transaction. + @function + @returns {Boolean} true if the current thread has an open transaction, flase otherwise. + */ + hasCurrentTransaction: { value: function() { + return false; + }}, + +/** + Sets the transaction ID as the current transaction.
+ The transaction ID can be made current only if there is no other transaction in process for the thread, and this transaction is not used by another thread. + @function + @param {Property} transactionId to use + @throws IllegalStateException if there is an open transaction for this thread or if there is another thread using this ID. + */ + openTransaction: { value: function(transactionId) { + // + }}, + +/** + Retires a transaction ID of the current thread. + @function + @param {Property} transactionId The current transaction ID. + @throws IllegalStateException if there is no open transaction ID for this thread. + */ + closeTransaction: { value: function(transactionId) { + // + }} + +}); + -- cgit v1.2.3