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

Базовые знания

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

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

Жизненный цикл объекта

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

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

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

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

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

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

A delete метод, определенный классом значений, который совместим с дескриптором, не является деструктором, даже если delete метод наследуется подклассом дескриптора. Сведения о классах, совместимых с дескрипторами, см. в разделе Классы, совместимые с дескрипторами.

Объявить delete как обычный способ:

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

Обработать объект во время delete Выполнение метода

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

A 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 или ошибки.

Если при построении класса дескриптора возникает ошибка, 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. Однако метод класса может вызывать private delete способ.

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

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

Методы удаления неразрушающего управления

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

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

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

Внешние ссылки на объекты MATLAB

MATLAB не управляет жизненными циклами объектов, в которых используются внешние языки, выполняющие собственное управление жизненным циклом объектов (или сбор мусора). MATLAB не может определить, когда безопасно уничтожать объекты, используемые в циклических ссылках, поскольку внешняя среда не уведомляет MATLAB о том, что внешние ссылки были уничтожены.

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

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

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