data = $initialData;
$this->doneLoading = true;
}
}
/**
* @inheritDoc
*/
public function setValue($value) {
$this->data = $value;
$this->doneLoading = true;
$this->isMarkedForDeletion = false;
return true;
}
public function deleteValue() {
$this->data = null;
$this->doneLoading = true;
$this->isMarkedForDeletion = true;
}
/**
* @inheritDoc
*/
public function setPath($path, $value) {
$this->lazyLoad();
$this->isMarkedForDeletion = false;
$path = $this->parsePath($path);
//Data could be NULL if it was previously deleted.
if ( $this->data === null ) {
$this->data = [];
}
return ameMultiDictionary::set($this->data, $path, $value);
}
public function deletePath($path) {
$this->lazyLoad();
$path = $this->parsePath($path);
//An empty path is invalid. This method can't delete the entire storage.
if ( empty($path) ) {
throw new \InvalidArgumentException('Path cannot be empty');
}
ameMultiDictionary::delete($this->data, $path);
}
/**
* @inheritDoc
*/
public function buildSlot($path) {
return new Slot($this, $path);
}
/**
* @inheritDoc
*/
protected function rawGetPath($path, $defaultValue = null) {
$this->lazyLoad();
return ameMultiDictionary::get($this->data, $path, $defaultValue);
}
protected function rawGetValue($defaultValue = null) {
$this->lazyLoad();
return ($this->data !== null) ? $this->data : $defaultValue;
}
protected function lazyLoad() {
if ( $this->doneLoading ) {
return;
}
$this->doneLoading = true;
$this->isMarkedForDeletion = false;
$this->data = $this->loadData();
}
public function save() {
if ( $this->isMarkedForDeletion && ($this->data === null) ) {
$this->deleteStoredData();
} else {
$this->lazyLoad();
$this->storeData($this->data);
}
}
/**
* Save data to the database or other persistent storage.
*
* @param array $newData
* @return void
*/
protected function storeData($newData) {
//Override in subclasses.
}
/**
* Load data from persistent storage.
*
* @return array|null
*/
protected function loadData() {
//Override in subclasses.
return [];
}
/**
* Delete data in persistent storage.
*
* @return void
*/
protected function deleteStoredData() {
//Override in subclasses.
}
}