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

Элементарные знания

Class destructor – метод под названием delete, который MATLAB^® вызывает неявно прежде, чем уничтожить объект класса Handle. Кроме того, пользовательский код может вызвать delete явным образом, чтобы уничтожить объект.

Nondestructor – метод под названием delete, который не удовлетворяет требования синтаксиса допустимого деструктора. Поэтому MATLAB не вызывает этот метод неявно при уничтожении объектов указателя. Метод под названием delete в классе значения не является деструктором. Метод под названием delete в классе значения, который устанавливает атрибут HandleCompatible на true, не является деструктором.

Объектный жизненный цикл

Атрибуты метода

Синтаксис метода деструктора класса Handle

MATLAB вызывает деструктор класса Handle при уничтожении объектов класса. MATLAB распознает метод под названием delete как деструктор класса, только если вы задаете delete как обычный метод с соответствующим синтаксисом.

Быть допустимым деструктором класса, методом delete:

Кроме того, метод delete не должен:

MATLAB не вызывает несовместимый метод delete при уничтожении объектов класса. Метод delete, который не является допустимым деструктором тени базовый класс указателя метод delete. Несовместимый метод delete может предотвратить разрушение объекта затенением, класс handle удаляет метод.

Объявите delete как обычный метод:

methods
   function delete(obj)
      % obj is always scalar
   ...
   end
end

Объект указателя во время осуществления метода delete

Вызов метода delete на объекте всегда приводит к разрушению объекта. Объект уничтожается, когда вызов delete выполняется явным образом в коде MATLAB или, когда названо MATLAB, потому что объект более не достижим из любой рабочей области. После того, как названный, метод delete не может прервать или предотвратить объектное разрушение.

Метод delete может получить доступ к свойствам удаляемого объекта. MATLAB не уничтожает эти свойства до окончания методов delete для класса объекта, и все суперклассы закончили выполняться.

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

Метод isvalid возвращает false для объекта указателя в рамках метода delete, потому что объектное разрушение начинается, когда метод называется.

MATLAB вызывает методы delete в инверсии порядка конструкции. Таким образом, MATLAB вызывает, разделяют на подклассы методы delete перед суперклассом методы delete.

Если суперкласс ожидает свойство быть управляемым подклассами, то суперкласс не должен получать доступ к тому свойству в своем методе delete. Например, если подкласс использует наследованное абстрактное свойство сохранить указатель на объект, то подкласс должен уничтожить этот объект в своем методе delete, но суперкласс не должен получать доступ к тому свойству в своем методе delete.

Поддержка разрушения частично созданных объектов

Ошибки, которые происходят при построении объекта, могут привести к вызову delete, прежде чем объект будет полностью создан. Поэтому класс методы delete должен смочь работать с частично созданными объектами.

Например, класс PartialObject, который определяет метод delete, пусто ли свойство Data прежде, чем получить доступ к данным это свойство, содержит. Если ошибка происходит при присвоении аргумента конструктора свойству Name, MATLAB передает частично созданный объект удалить.

classdef PartialObject < handle
   properties
      % Restrict the Name property
      % to a cell array
      Name cell
      Data
   end
   methods
      function h = PartialObject(name)
         if nargin > 0
            h.Name = name;
            h.Data.a = rand(10,1);
         end
      end
      function delete(h)
         % Protect against accessing properties
         % of partially constructed objects
         if ~isempty(h.Data)
            t = h.Data.a;
            disp(t)
         else
            disp('Data is empty')
         end
      end
   end
end

Ошибка происходит, если вы вызываете конструктора с вектором char вместо необходимого массива ячеек:

obj = PartialObject('Test')

MATLAB передает частично созданный объект методу delete. Конструктор не устанавливал значение свойства Data, потому что ошибка произошла при установке свойства Name.

Data is empty
Error setting 'Name' property of 'PartialObject' class:
...

Когда задать метод деструктора

Используйте метод delete, чтобы выполнить операции очистки, прежде чем MATLAB уничтожит объект. MATLAB вызывает метод delete надежно, даже если выполнение прервано с Ctrl-c или ошибкой.

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

Например, предположите, что метод открывает файл для записи, и вы хотите закрыть файл в своем методе delete. Метод delete может вызвать fclose на идентификаторе файла что объектно-ориентированная память в его свойстве FileID:

function delete(obj)
   fclose(obj.FileID);
end 

Деструкторы в иерархиях классов

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

Объектный жизненный цикл

MATLAB вызывает метод delete, когда жизненный цикл объекта заканчивается. Жизненный цикл объекта заканчивается, когда объект:

classdef myClass < supclass1 & supclass2

Ограничьте доступ к объекту, удаляют метод

Уничтожьте объекты указателя путем явного вызова delete на объекте:

delete(obj)

Класс может предотвратить явное разрушение объекта путем установки его метода delete атрибут Access на private. Однако метод класса может вызвать метод delete private.

Если класс метод delete, атрибутом Access является protected, только методы класса и подклассов, может явным образом удалить объекты того класса.

Однако, когда объектный жизненный цикл заканчивается, MATLAB вызывает метод delete объекта при уничтожении объекта независимо от атрибута Access метода.

Недеструктор удаляет методы

Класс может реализовать метод под названием delete, который не является допустимым деструктором класса. MATLAB не вызывает этот метод неявно при уничтожении объекта. В этом случае delete ведет себя как обычный метод.

Например, если суперкласс реализует метод Sealed под названием delete, который не является допустимым деструктором, затем MATLAB не позволяет подклассам заменять этот метод.

Метод delete, заданный классом значения, не может быть деструктором класса.

Ссылка объектов Java объекты MATLAB

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

classdef CallbackWithJava < handle
   methods
      function obj = CallbackWithJava
         jo = com.mathworks.jmi.Callback;
         set(jo,'DelayedCallback',@obj.cbFunc); % Assign method as callback
         jo.postCallback
      end
      function cbFunc(obj,varargin)
         c = class(obj);
         disp(['Java object callback on class ',c])
      end
      function delete(obj)
         c = class(obj);
         disp(['ML object destructor called for class ',c])
      end
   end
end

function testDestructor
   cwj = CallbackWithJava
   ...
end

testDestructor

cwj = 

  CallbackWithJava with no properties.

Java object callback on class CallbackWithJava

clear classes

Warning: Objects of 'CallbackWithJava' class exist.  Cannot clear this class or
any of its superclasses. 

function testDestructor
   cwj = CallbackWithJava
   ...
   delete(cwj)
end