Use it for ApiStashEdit so that large PaserOutput can be stored. Add flag to allow for value segmentation on set() in BagOStuff. Also add a flag for immediate deletion of segments on delete(). BagOStuff now has base serialize()/unserialize() methods. Bug: T204742 Change-Id: I0667a02612526d8ddfd91d5de48b6faa78bd1ab5
66 lines
1.5 KiB
PHP
66 lines
1.5 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Helper class for segmenting large cache values without relying on serializing classes
|
|
*
|
|
* @since 1.34
|
|
*/
|
|
class SerializedValueContainer {
|
|
const SCHEMA = '__svc_schema__';
|
|
const SCHEMA_UNIFIED = 'DAAIDgoKAQw'; // 64 bit UID
|
|
const SCHEMA_SEGMENTED = 'CAYCDAgCDw4'; // 64 bit UID
|
|
|
|
const UNIFIED_DATA = '__data__';
|
|
const SEGMENTED_HASHES = '__hashes__';
|
|
|
|
/**
|
|
* @param string $serialized
|
|
* @return stdClass
|
|
*/
|
|
public static function newUnified( $serialized ) {
|
|
return (object)[
|
|
self::SCHEMA => self::SCHEMA_UNIFIED,
|
|
self::UNIFIED_DATA => $serialized
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @param string[] $segmentHashList Ordered list of hashes for each segment
|
|
* @return stdClass
|
|
*/
|
|
public static function newSegmented( array $segmentHashList ) {
|
|
return (object)[
|
|
self::SCHEMA => self::SCHEMA_SEGMENTED,
|
|
self::SEGMENTED_HASHES => $segmentHashList
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @param mixed $value
|
|
* @return bool
|
|
*/
|
|
public static function isUnified( $value ) {
|
|
return self::instanceOf( $value, self::SCHEMA_UNIFIED );
|
|
}
|
|
|
|
/**
|
|
* @param mixed $value
|
|
* @return bool
|
|
*/
|
|
public static function isSegmented( $value ) {
|
|
return self::instanceOf( $value, self::SCHEMA_SEGMENTED );
|
|
}
|
|
|
|
/**
|
|
* @param mixed $value
|
|
* @param string $schema SCHEMA_* class constant
|
|
* @return bool
|
|
*/
|
|
private static function instanceOf( $value, $schema ) {
|
|
return (
|
|
$value instanceof stdClass &&
|
|
property_exists( $value, self::SCHEMA ) &&
|
|
$value->{self::SCHEMA} === $schema
|
|
);
|
|
}
|
|
}
|