Документация

Валидация свойств в определениях классов

MATLAB^® валидация свойств позволяет вам устанавливать определенные ограничения на значения свойств. Можно использовать валидацию, чтобы ограничить класс и размер значений свойств. Кроме того, можно использовать функции для установления критериев, которым должно соответствовать значение свойства. MATLAB задает набор функций валидации, и вы можете написать свои собственные функции валидации.

Использование валидации свойств необязательно в определениях классов.

Пример класса с использованием валидации свойств

The ValidateProps класс задает три свойства с валидацией.

classdef ValidateProps
   properties
      Location(1,3) double {mustBeReal, mustBeFinite}
      Label(1,:) char {mustBeMember(Label,{'High','Medium','Low'})} = 'Low'
      State(1,1) matlab.lang.OnOffSwitchState
   end
end

a = ValidateProps

a = 

  ValidateProps with properties:

    Location: [0 0 0]
       Label: 'Low'
       State: off

Порядок валидации

Когда свойству присваивается значение, включая значения по умолчанию, заданные в определении класса, MATLAB выполняет валидацию в следующем порядке:

classdef ValueProp
   properties
      Value(1,1) double {mustBeNonnegative} = 0
   end
end

a.Value = {10,20};

Error setting property 'Value' of class 'ValueProp':
Invalid data type. Value must be double or be convertible to double.

a.Value = [10 20];

Error setting property 'Value' of class 'ValueProp':
Size of value must be scalar.

a.Value = -10;

Error setting property 'Value' of class 'ValueProp':
Value must be nonnegative.

Абстрактные Валидации свойств

Можно задать валидацию свойств для абстрактных свойств. Это валидация применяется ко всем подклассам, которые реализуют свойство. Однако подклассы не могут использовать какую-либо валидацию при реализации свойства. При наследовании валидации для свойства из нескольких классов только одно свойство Abstract в одном суперклассе может задать валидацию. Ни один из суперклассов не может задать свойство как nonAbstract.

Объекты, не обновляемые при изменении валидации

Если вы изменяете валидацию свойств, пока существуют объекты класса, MATLAB не пытается применить новую валидацию к существующим значениям свойств. Однако MATLAB применяет новую валидацию при назначении свойств существующих объектов.

Валидация во время операции загрузки

При сохранении объекта в MAT Файл сохраняет все значения свойств nondefault вместе с объектом. При загрузке объекта MATLAB восстанавливает эти значения свойств во вновь созданном объекте.

Если определение класса изменяет валидацию свойства таким образом, чтобы значение загруженного свойства больше не было допустимым, MATLAB заменяет текущее значение по умолчанию для этого свойства. Однако, load функция подавляет ошибки валидации, возникающие перед назначением значения по умолчанию из текущего определения класса. Поэтому ошибки валидации молчаливо игнорируются во время операций загрузки.

Чтобы проиллюстрировать это поведение, этот пример создает, сохраняет и загружает объект MonthTemp класс. Этот класс ограничивает AveTemp свойство массиву ячеек.

classdef MonthTemp
   properties
      AveTemp cell 
   end
end

Создайте MonthTemp и присвойте значение AveTemp свойство.

a = MonthTemp;
a.AveTemp = {'May',70};

Сохраните объект используя save.

save TemperatureFile a

Измените определение свойства, чтобы изменить класс валидации для AveTemp свойство из массива ячеек в containers.Map.

classdef MonthTemp
   properties
      AveTemp containers.Map
   end
end

Загрузите сохраненный объект с новым определением класса в путь MATLAB. MATLAB не может назначить сохраненное значение AveTemp свойство, поскольку массив ячеек, {'May',70}, несовместимо с текущим требованием, чтобы значение свойства было containers.Map объект. MATLAB не может преобразовать массив ячеек в containers.Map.

Чтобы решить проблему несовместимости, MATLAB устанавливает AveTemp свойство загруженного объекта к текущему значению по умолчанию, которое является пустым containers.Map объект.

load TemperatureFile a
 a.AveTemp

ans = 

  Map with properties:

        Count: 0
      KeyType: char
    ValueType: any

Загруженному объекту назначено другое значение AveTemp свойство, поскольку сохраненное значение теперь недопустимо. Однако процесс загрузки подавляет ошибку валидации.

Чтобы предотвратить потерю данных при изменении определений классов и перезагрузке объектов, реализуйте loadobj метод или метод преобразования классов, который позволяет сохраненным значениям удовлетворять текущей валидации свойства.

Дополнительные сведения о сохранении и загрузке объектов см. в разделе Сохранение и загрузка процесса для объектов.