Page Menu
Home
WickedGov Phorge
Search
Configure Global Search
Log In
Files
F7404619
ve.dm.RebaseServer.js
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Flag For Later
Award Token
Size
4 KB
Referenced Files
None
Subscribers
None
ve.dm.RebaseServer.js
View Options
/*!
* VisualEditor DataModel rebase server class.
*
* @copyright See AUTHORS.txt
*/
'use strict'
;
/**
* DataModel rebase server
*
* @class
*
* @constructor
* @param {Function} [logCallback]
*/
ve
.
dm
.
RebaseServer
=
function
VeDmRebaseServer
(
logCallback
)
{
this
.
stateForDoc
=
new
Map
();
this
.
logEvent
=
logCallback
||
function
()
{};
};
OO
.
initClass
(
ve
.
dm
.
RebaseServer
);
/* Methods */
/**
* Get the state of a document by name.
*
* @param {string} doc Name of a document
* @return {ve.dm.RebaseDocState} Document state
*/
ve
.
dm
.
RebaseServer
.
prototype
.
getDocState
=
function
(
doc
)
{
if
(
!
this
.
stateForDoc
.
has
(
doc
)
)
{
this
.
stateForDoc
.
set
(
doc
,
new
ve
.
dm
.
RebaseDocState
()
);
}
return
this
.
stateForDoc
.
get
(
doc
);
};
/**
* Update document history
*
* @param {string} doc Name of a document
* @param {number|null} authorId Author ID
* @param {ve.dm.Change} [newHistory] New history to append
* @param {Object} [authorDataChanges] New values for author data (modified keys only)
*/
ve
.
dm
.
RebaseServer
.
prototype
.
updateDocState
=
function
updateDocState
(
doc
,
authorId
,
newHistory
,
authorDataChanges
)
{
const
state
=
this
.
getDocState
(
doc
);
if
(
newHistory
)
{
state
.
history
.
push
(
newHistory
);
}
if
(
!
authorId
)
{
return
;
}
let
authorData
=
state
.
authors
.
get
(
authorId
);
if
(
!
authorData
)
{
authorData
=
state
.
constructor
.
static
.
newAuthorData
();
state
.
authors
.
set
(
authorId
,
authorData
);
}
if
(
authorDataChanges
)
{
for
(
const
key
in
authorData
)
{
if
(
authorDataChanges
[
key
]
!==
undefined
)
{
authorData
[
key
]
=
authorDataChanges
[
key
];
}
}
}
};
/**
* Forget all history for a document
*
* @param {string} doc Name of a document
*/
ve
.
dm
.
RebaseServer
.
prototype
.
clearDocState
=
function
clearDocState
(
doc
)
{
const
state
=
this
.
stateForDoc
.
get
(
doc
);
if
(
!
state
)
{
return
;
}
state
.
clearHistory
();
};
/**
* Attempt to rebase and apply a change to a document.
*
* The change can be a new change, or a continued change. A continuated change means one that
* follows on immediately from the author's last submitted change, other than possibly being
* rebased onto some more recent committed history.
*
* @param {string} doc Document name
* @param {number} authorId Author ID
* @param {number} backtrack How many transactions are backtracked from the previous submission
* @param {ve.dm.Change} change Change to apply
* @return {ve.dm.Change} Accepted change (or initial segment thereof), as rebased
*/
ve
.
dm
.
RebaseServer
.
prototype
.
applyChange
=
function
applyChange
(
doc
,
authorId
,
backtrack
,
change
)
{
const
state
=
this
.
getDocState
(
doc
),
authorData
=
state
.
authors
.
get
(
authorId
);
let
appliedChange
;
let
base
=
(
authorData
&&
authorData
.
continueBase
)
||
change
.
truncate
(
0
);
let
rejections
=
(
authorData
&&
authorData
.
rejections
)
||
0
;
if
(
rejections
>
backtrack
)
{
// Follow-on does not fully acknowledge outstanding conflicts: reject entirely
rejections
=
rejections
-
backtrack
+
change
.
transactions
.
length
;
this
.
updateDocState
(
doc
,
authorId
,
null
,
{
rejections
:
rejections
}
);
// FIXME argh this publishes an empty change, which is not what we want
appliedChange
=
state
.
history
.
truncate
(
0
);
}
else
if
(
rejections
<
backtrack
)
{
throw
new
Error
(
'Backtrack='
+
backtrack
+
' > '
+
rejections
+
'=rejections'
);
}
else
{
if
(
change
.
start
>
base
.
start
)
{
// Remote has rebased some committed changes into its history since base was built.
// They are guaranteed to be equivalent to the start of base. See mathematical
// docs for proof (Cuius rei demonstrationem mirabilem sane deteximus hanc marginis
// exiguitas non caperet).
base
=
base
.
mostRecent
(
change
.
start
);
}
base
=
base
.
concat
(
state
.
history
.
mostRecent
(
base
.
start
+
base
.
getLength
()
)
);
const
result
=
ve
.
dm
.
Change
.
static
.
rebaseUncommittedChange
(
base
,
change
);
rejections
=
result
.
rejected
?
result
.
rejected
.
getLength
()
:
0
;
this
.
updateDocState
(
doc
,
authorId
,
result
.
rebased
,
{
rejections
:
rejections
,
continueBase
:
result
.
transposedHistory
}
);
appliedChange
=
result
.
rebased
;
}
this
.
logEvent
(
{
type
:
'applyChange'
,
doc
:
doc
,
authorId
:
authorId
,
incoming
:
change
,
applied
:
appliedChange
,
backtrack
:
backtrack
,
rejections
:
rejections
}
);
return
appliedChange
;
};
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Sat, Nov 21, 19:16 (1 d, 2 h)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
06/9a/3691a7e90cc932347b36e55f28a4
Default Alt Text
ve.dm.RebaseServer.js (4 KB)
Attached To
Mode
rMWPROD MediaWiki Production
Attached
Detach File
Event Timeline
Log In to Comment