Класс DefaultPersistenceDelegate
public class DefaultPersistenceDelegate extends PersistenceDelegate
DefaultPersistenceDelegate представляет собой конкретную реализацию абстрактного класса PersistenceDelegate и является делегатом по умолчанию для классов, о которых нет информации. DefaultPersistenceDelegate обеспечивает, совместимую с версиями, основанную на публичном API, персистентность для классов, которые следуют соглашениям JavaBeans без какой-либо специфичной для класса конфигурации. Основные предположения заключаются в том, что класс имеет нулевой конструктор и что его состояние точно представлено соответствующими парами методов "setter" и "getter" в порядке, в котором они возвращаются интроспекцией. В дополнение к обеспечению персистентности для JavaBeans без кода, DefaultPersistenceDelegate предоставляет удобный способ для сохранения классов, у которых есть конструктор, который, хотя и не нулевой, просто требует некоторых значений свойств в качестве аргументов.
- С:
- 1.4
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
DefaultPersistenceDelegate() |
Создаёт делегат персистентности для класса с нулевым конструктором. |
DefaultPersistenceDelegate |
Создаёт делегат персистентности по умолчанию для класса с конструктором, аргументами которого являются значения имён свойств, указанных в constructorPropertyNames. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
initialize |
Эта реализация по умолчанию метода initialize предполагает, что все данные, хранящиеся в объектах данного типа, доступны через соответствующие пары методов "setter" и "getter" в порядке, в котором они возвращаются интроспекцией. |
protected Expression |
instantiate |
Эта реализация по умолчанию метода instantiate возвращает выражение, содержащее предопределённое имя метода "new", которое обозначает вызов конструктора с аргументами, как указано в конструкторе DefaultPersistenceDelegate. |
protected boolean |
mutatesTo |
Если количество аргументов в указанном конструкторе не равно нулю и класс oldInstance явно объявляет метод "equals", этот метод возвращает значение oldInstance.equals(newInstance). |
Методы, объявленные в классе java.beans.PersistenceDelegate
writeObject
Подробное описание конструкторов
DefaultPersistenceDelegate
public DefaultPersistenceDelegate()
- См. также:
DefaultPersistenceDelegate
public DefaultPersistenceDelegate(String[] constructorPropertyNames)
constructorPropertyNames. Аргументы конструктора создаются путём оценки имён свойств в указанном порядке. Для использования этого класса для указания предпочтительного конструктора для сериализации определённого типа, мы указываем имена свойств, которые составляют аргументы конструктора. Например, класс Font, который не определяет конструктор по умолчанию, может обрабатываться следующим делегатом персистентности:
new DefaultPersistenceDelegate(new String[]{"name", "style", "size"});
- Параметры:
-
constructorPropertyNames- Имена свойств для аргументов этого конструктора. - См. также:
Подробное описание методов
mutatesTo
protected boolean mutatesTo(Object oldInstance, Object newInstance)
oldInstance явно объявляет метод "equals", этот метод возвращает значение oldInstance.equals(newInstance). В противном случае, этот метод использует определение базового класса, которое возвращает true, если классы двух экземпляров равны.- Переопределяет:
-
mutatesToв классеPersistenceDelegate - Параметры:
-
oldInstance- Экземпляр, который нужно скопировать. -
newInstance- Экземпляр, который нужно изменить. - Возвращает:
- True, если эквивалентная копия
newInstanceможет быть создана путём применения серии мутаций кoldInstance. - См. также:
instantiate
protected Expression instantiate(Object oldInstance, Encoder out)
instantiate возвращает выражение, содержащее предопределённое имя метода "new", которое обозначает вызов конструктора с аргументами, как указано в конструкторе DefaultPersistenceDelegate.- Указано в:
-
instantiateв классеPersistenceDelegate - Параметры:
-
oldInstance- Экземпляр, подлежащий созданию. -
out- Поток кода вывода. - Возвращает:
- Выражение, значение которого является
oldInstance. - Исключения:
-
NullPointerException- еслиoutявляетсяnullи это значение используется в методе - См. также:
initialize
protected void initialize(Class<?> type, Object oldInstance, Object newInstance, Encoder out)
initialize предполагает, что все данные, хранящиеся в объектах этого типа, доступны через соответствующие пары методов "setter" и "getter" в порядке, в котором они возвращаются интроспекцией. Если описатель свойства определяет атрибут "transient" со значением, равным Boolean.TRUE, свойство игнорируется данной реализацией по умолчанию. Обратите внимание, что это использование слова "transient" совершенно независимо от модификатора поля, используемого в ObjectOutputStream. Для каждого не-transient свойства создаётся выражение, в котором применяется нулевой метод "getter" к oldInstance. Значение этого выражения равно значению свойства в экземпляре, который сериализуется. Если значение этого выражения в клонированной среде mutatesTo целевое значение, новое значение инициализируется для его эквивалентности старому значению. В этом случае, поскольку значение свойства не изменилось, нет необходимости вызывать соответствующий метод "setter", и ни одна инструкция не генерируется. В противном случае, выражение для этого значения заменяется другим выражением (обычно конструктором), и соответствующий метод "setter" вызывается для установки нового значения свойства в объекте. Эта схема удаляет информацию по умолчанию из вывода, производимого потоками с использованием этого делегата.
При передаче этих инструкций в поток вывода, где они будут выполнены, вносятся побочные эффекты в newInstance. В большинстве случаев это позволяет проблеме свойств, значения которых зависят друг от друга, фактически помочь процессу сериализации, уменьшив количество инструкций, которые необходимо записать в выходной поток. В общем случае проблема обработки взаимозависимых свойств сводится к нахождению порядка свойств в классе таким образом, чтобы ни одно значение свойства не зависело от значения последующего свойства.
- Переопределяет:
-
initializeв классеPersistenceDelegate - Параметры:
-
type- тип экземпляров -
oldInstance- Экземпляр, который нужно скопировать. -
newInstance- Экземпляр, который нужно изменить. -
out- Поток, в который должны быть записаны инструкции инициализации. - Исключения:
-
NullPointerException- еслиoutявляетсяnull - См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/beans/DefaultPersistenceDelegate.html