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

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

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

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

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

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 MATLAB сохраняет все значения свойств, не заданные по умолчанию, вместе с объектом. При загрузке объекта 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 метод или метод конвертера классов, который позволяет сохранить значения, удовлетворяющие текущей проверке свойств.

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