1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
/* <copyright>
This file contains proprietary software owned by Motorola Mobility, Inc.<br/>
No rights, expressed or implied, whatsoever to this software are provided by Motorola Mobility, Inc. hereunder.<br/>
(c) Copyright 2011 Motorola Mobility, Inc. All Rights Reserved.
</copyright> */
/**
@module montage/data/transaction-id
@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("transaction-id");
/**
@private
*/
var _lastTimestamp = Date.now();
/**
@private
*/
var _lastNanos = 1;
/**
@private
*/
var _transactionManagerInstance = null;
/**
@class module:montage/data/transaction-id.TransactionId
@extends module:montage/core/core.Montage
*/
var TransactionId = exports.TransactionId = Montage.create(Montage, /** @lends module:montage/data/transaction-id.TransactionId# */ {
_mappingFolderName:{
serializable:true,
enumerable:false,
value:""
},
mappingFolderName:{
get:function () {
return this._mappingFolderName;
}
},
/**
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
@param {name} Mapping folder name used for this transaction
@function
@returns itself
*/
initWithMappingFolderName:{
serializable:false,
enumerable:false,
value:function (name) {
this._mappingFolderName = name;
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.<br>
This factory supports a delegate so that application requiring subclassing can do so easily.<br>
The factory delegate should implement <code>createTransactionId</code> 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.<br>
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 = TransactionManager.create().init();
}
return _transactionManagerInstance;
}
}
});
/**
@class module:montage/data/transaction-id.TransactionManager
*/
var TransactionManager = exports.TransactionManager = Montage.create(Montage, /** @lends module:montage/data/transaction-id.TransactionManager# */ {
/*
* @private
*/
_currentTransaction:{
serializable:false,
enumerable:false,
value:null
},
/**
Enables the trace of creation starts.<br>
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
@param {name} Mapping folder name used for this transaction
@returns null or new transaction ID
@throws IllegalStateException if a transaction is already open for this thread.
*/
startTransaction:{ value:function (name) {
if (this._currentTransaction) {
throw new Error("Transaction Open: " + JSON.stringify(this._currentTransaction));
}
this._currentTransaction = TransactionId.create().initWithMappingFolderName(name);
return this._currentTransaction;
}},
/**
Returns the current transaction ID for this thread.
@function
@returns null or current transaction ID
*/
currentTransaction:{ value:function () {
return this._currentTransaction;
}},
/**
Checks if the current thread has an open transaction.
@function
@returns {Boolean} <code>true</code> if the current thread has an open transaction, <code>flase</code> otherwise.
*/
hasCurrentTransaction:{ value:function () {
return this._currentTransaction != null;
}},
/**
Sets the transaction ID as the current transaction.<br>
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) {
if (this._currentTransaction) {
throw new Error("Transaction Open: " + JSON.stringify(this._currentTransaction));
}
this._currentTransaction = transactionId;
return this._currentTransaction;
}},
/**
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) {
if (this._currentTransaction !== transactionId) {
throw new Error("Transaction Not Open: " + JSON.stringify(this._currentTransaction));
}
this._currentTransaction = null;
return this._currentTransaction;
}}
});
|