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
|
/* <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/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.<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 = 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.<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
@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} <code>true</code> if the current thread has an open transaction, <code>flase</code> otherwise.
*/
hasCurrentTransaction: { value: function() {
return false;
}},
/**
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) {
//
}},
/**
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) {
//
}}
});
|