umiPropertiesHelper

Описание

Класс для работы с полями (umiObjectProperty) объекта (umiObject), без обращения к последнему.

Собранные данные класс хранит в своих свойствах, кэш можно сбросить с помощью метода clearCache().

Класс является синглтоном, для получения экземпляра класса необходимо использовать статический метод getInstance().

Перед смертью экземпляра класса инициируется сохранения всех собранных полей объектов, если они были изменены.

Примеры использования

Получить значения поля (на примере класса umiHierarchyElement)


        public function getValue($propName, $params = NULL) {
			$umiPropertiesHelper = umiPropertiesHelper::getInstance();
			return $umiPropertiesHelper->getPropertyValue(
				$this->getObjectId(),
				$propName,
				$this->getObjectTypeId()
			);
		}

Записать значения поля (на примере класса umiHierarchyElement)


        public function setValue($propName, $propValue) {
			$umiPropertiesHelper = umiPropertiesHelper::getInstance();

			$property = $umiPropertiesHelper->getProperty(
				$this->getObjectId(),
				$propName,
				$this->getObjectTypeId()
			);

			if (!$property instanceof umiObjectProperty) {
				return false;
			}

			$property->setValue($propValue);

			if ($property->getIsUpdated()) {
				$property->commit();
			}

			return true;
		}
  • getInstance() — Возвращает экземпляр класса umiPropertiesHelper
  • getProperty() — Получает и возвращает объект поля (umiObjectProperty)
  • getPropertyValue() — Получает и возвращает значение поля
  • saveProperties() — Сохраняет все загруженные поля, если необходимо
  • clearCache() — Удаляет собранные данные