MediaWiki  REL1_24
Public Member Functions | Public Attributes
DiffHistoryBlob Class Reference

Diff-based history compression Requires xdiff 1.5+ and zlib. More...

Inheritance diagram for DiffHistoryBlob:
Inheritance graph
[legend]
Collaboration diagram for DiffHistoryBlob:
Collaboration graph
[legend]

List of all members.

Public Member Functions

 __construct ()
 __sleep ()
 __wakeup ()
 addItem ($text)
 compress ()
 diff ($t1, $t2)
 getItem ($key)
 getText ()
 isHappy ()
 Helper function for compression jobs Returns true until the object is "full" and ready to be committed.
 patch ($base, $diff)
 setText ($text)
 uncompress ()
 xdiffAdler32 ($s)
 Compute a binary "Adler-32" checksum as defined by LibXDiff, i.e.

Public Attributes

string $mCompressed
 Compressed storage *.
int $mDefaultKey
 The key for getText()
array $mDiffMap
 The diff map, see above *.
array $mDiffs
 Array of diffs.
bool $mFrozen = false
 True if the object is locked against further writes *.
array $mItems = array()
 Uncompressed item cache *.
int $mMaxCount = 100
 The maximum number of text items before the object becomes sad *.
int $mMaxSize = 10000000
 The maximum uncompressed size before the object becomes sad Should be less than max_allowed_packet.
int $mSize = 0
 Total uncompressed size *.
const XDL_BDOP_CPY = 2
const XDL_BDOP_INS = 1
 Constants from xdiff.h.
const XDL_BDOP_INSB = 3

Detailed Description

Diff-based history compression Requires xdiff 1.5+ and zlib.

Definition at line 348 of file HistoryBlob.php.

Constructor & Destructor Documentation

DiffHistoryBlob::__construct ( )

Definition at line 383 of file HistoryBlob.php.

Member Function Documentation

DiffHistoryBlob::__sleep ( )
Returns:
array

Definition at line 618 of file HistoryBlob.php.

DiffHistoryBlob::__wakeup ( )

Definition at line 646 of file HistoryBlob.php.

DiffHistoryBlob::addItem ( $  text)
Exceptions:
MWException
Parameters:
string$text
Returns:
int

Implements HistoryBlob.

Definition at line 394 of file HistoryBlob.php.

DiffHistoryBlob::compress ( )
Exceptions:
MWException

Definition at line 430 of file HistoryBlob.php.

DiffHistoryBlob::diff ( $  t1,
$  t2 
)
Parameters:
string$t1
string$t2
Returns:
string

Definition at line 509 of file HistoryBlob.php.

DiffHistoryBlob::getItem ( $  key)
Parameters:
string$key
Returns:
string

Implements HistoryBlob.

Definition at line 409 of file HistoryBlob.php.

DiffHistoryBlob::getText ( )
Returns:
string

Implements HistoryBlob.

Definition at line 423 of file HistoryBlob.php.

DiffHistoryBlob::isHappy ( )

Helper function for compression jobs Returns true until the object is "full" and ready to be committed.

Returns:
bool

Definition at line 686 of file HistoryBlob.php.

DiffHistoryBlob::patch ( $  base,
$  diff 
)
Parameters:
string$base
string$diff
Returns:
bool|string

Definition at line 523 of file HistoryBlob.php.

DiffHistoryBlob::setText ( $  text)
Parameters:
string$text

Implements HistoryBlob.

Definition at line 416 of file HistoryBlob.php.

DiffHistoryBlob::uncompress ( )

Definition at line 601 of file HistoryBlob.php.

DiffHistoryBlob::xdiffAdler32 ( $  s)

Compute a binary "Adler-32" checksum as defined by LibXDiff, i.e.

with the bytes backwards and initialised with 0 instead of 1. See bug 34428.

Parameters:
string$s
Returns:
string|bool False if the hash extension is not available

Definition at line 585 of file HistoryBlob.php.

Referenced by DiffHistoryBlobTest\testXdiffAdler32().

Member Data Documentation

string DiffHistoryBlob::$mCompressed

Compressed storage *.

Definition at line 367 of file HistoryBlob.php.

int DiffHistoryBlob::$mDefaultKey

The key for getText()

Definition at line 365 of file HistoryBlob.php.

array DiffHistoryBlob::$mDiffMap

The diff map, see above *.

Definition at line 362 of file HistoryBlob.php.

array DiffHistoryBlob::$mDiffs

Array of diffs.

If a diff D from A to B is notated D = B - A, and Z is an empty string:

{ item[map[i]] - item[map[i-1]] where i > 0 diff[i] = { { item[map[i]] - Z where i = 0

Definition at line 360 of file HistoryBlob.php.

bool DiffHistoryBlob::$mFrozen = false

True if the object is locked against further writes *.

Definition at line 369 of file HistoryBlob.php.

array DiffHistoryBlob::$mItems = array()

Uncompressed item cache *.

Definition at line 349 of file HistoryBlob.php.

int DiffHistoryBlob::$mMaxCount = 100

The maximum number of text items before the object becomes sad *.

Definition at line 376 of file HistoryBlob.php.

int DiffHistoryBlob::$mMaxSize = 10000000

The maximum uncompressed size before the object becomes sad Should be less than max_allowed_packet.

Definition at line 374 of file HistoryBlob.php.

int DiffHistoryBlob::$mSize = 0

Total uncompressed size *.

Definition at line 351 of file HistoryBlob.php.

const DiffHistoryBlob::XDL_BDOP_CPY = 2

Definition at line 380 of file HistoryBlob.php.

const DiffHistoryBlob::XDL_BDOP_INS = 1

Constants from xdiff.h.

Definition at line 379 of file HistoryBlob.php.

const DiffHistoryBlob::XDL_BDOP_INSB = 3

Definition at line 381 of file HistoryBlob.php.

The documentation for this class was generated from the following file: