Spec-Zone.ru › OpenJDK 27

Класс DefaultPersistenceDelegate

java.lang.Object
java.beans.PersistenceDelegate
java.beans.DefaultPersistenceDelegate
public class DefaultPersistenceDelegate extends PersistenceDelegate
DefaultPersistenceDelegate — конкретная реализация абстрактного класса PersistenceDelegate и делегат, используемый по умолчанию для классов, сведения о которых отсутствуют. DefaultPersistenceDelegate обеспечивает устойчивое к изменениям версий сохранение на основе общедоступного API для классов, следующих соглашениям JavaBeans, без какой-либо специальной настройки класса.

Основные предположения состоят в том, что у класса есть конструктор без аргументов, а его состояние точно представлено соответствующими парами методов «setter» и «getter» в порядке, в котором их возвращает Introspector. Помимо обеспечения сохранения JavaBeans без написания кода, DefaultPersistenceDelegate предоставляет удобный способ обеспечить постоянное хранение для классов, у которых есть конструктор, требующий в качестве аргументов значения некоторых свойств, но не являющийся конструктором без аргументов.

Начиная с:
1.4
См. также:
  • DefaultPersistenceDelegate(String[])
  • Introspector

Краткое описание конструкторов

Конструктор Описание
DefaultPersistenceDelegate()
Создает делегат сохранения для класса с конструктором без аргументов.
DefaultPersistenceDelegate(String[] constructorPropertyNames)
Создает делегат сохранения по умолчанию для класса с конструктором, аргументами которого являются значения имен свойств, заданных с помощью constructorPropertyNames.

Краткое описание методов

Модификатор и тип Метод Описание
protected void initialize(Class<?> type, Object oldInstance, Object newInstance, Encoder out)
Эта реализация метода initialize по умолчанию предполагает, что все состояние объектов данного типа доступно через соответствующие пары методов «setter» и «getter» в порядке, в котором их возвращает Introspector.
protected Expression instantiate(Object oldInstance, Encoder out)
Эта реализация метода instantiate по умолчанию возвращает выражение с предопределенным именем метода "new", обозначающим вызов конструктора с аргументами, указанными в конструкторе DefaultPersistenceDelegate.
protected boolean mutatesTo(Object oldInstance, Object newInstance)
Если число аргументов указанного конструктора не равно нулю, а класс oldInstance явно объявляет метод "equals", этот метод возвращает значение oldInstance.equals(newInstance).

Методы, объявленные в классе PersistenceDelegate

writeObject
Модификатор и тип Метод Описание
void writeObject(Object oldInstance, Encoder out)
writeObject — единственная точка входа в процесс сохранения; она используется Encoder в традиционном режиме делегирования.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, является ли другой объект «равным» этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удален в будущей версии.
Финализация признана устаревшей и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

DefaultPersistenceDelegate

public DefaultPersistenceDelegate()
Создает делегат сохранения для класса с конструктором без аргументов.
См. также:
  • DefaultPersistenceDelegate(java.lang.String[])

DefaultPersistenceDelegate

public DefaultPersistenceDelegate(String[] constructorPropertyNames)
Создает делегат сохранения по умолчанию для класса с конструктором, аргументами которого являются значения имен свойств, заданных с помощью constructorPropertyNames. Аргументы конструктора создаются путем вычисления имен свойств в указанном порядке. Чтобы использовать этот класс для указания единственного предпочтительного конструктора, который будет применяться при сериализации определенного типа, указываются имена свойств, составляющих аргументы конструктора. Например, класс Font, в котором не определен конструктор без аргументов, можно обработать с помощью следующего делегата сохранения:
    new DefaultPersistenceDelegate(new String[]{"name", "style", "size"});
Параметры:
constructorPropertyNames — имена свойств, соответствующие аргументам этого конструктора.
См. также:
  • instantiate(Object, Encoder)

Подробное описание методов

mutatesTo

protected boolean mutatesTo(Object oldInstance, Object newInstance)
Если число аргументов указанного конструктора не равно нулю, а класс oldInstance явно объявляет метод "equals", этот метод возвращает значение oldInstance.equals(newInstance). В противном случае метод использует определение суперкласса, которое возвращает true, если классы двух экземпляров совпадают.
Переопределяет:
mutatesTo в классе PersistenceDelegate
Параметры:
oldInstance — экземпляр, который нужно скопировать.
newInstance — экземпляр, который нужно изменить.
Возвращает:
Истину, если эквивалентную копию newInstance можно создать, применив к oldInstance ряд изменений.
См. также:
  • DefaultPersistenceDelegate(String[])

instantiate

protected Expression instantiate(Object oldInstance, Encoder out)
Эта реализация метода instantiate по умолчанию возвращает выражение с предопределенным именем метода "new", обозначающим вызов конструктора с аргументами, указанными в конструкторе DefaultPersistenceDelegate.
Определено в:
instantiate в классе PersistenceDelegate
Параметры:
oldInstance — экземпляр, который нужно создать.
out — поток вывода кода.
Возвращает:
Выражение, значением которого является oldInstance.
Выбрасывает:
NullPointerException — если out равен null и это значение используется в методе
См. также:
  • DefaultPersistenceDelegate(String[])

initialize

protected void initialize(Class<?> type, Object oldInstance, Object newInstance, Encoder out)
Эта реализация метода initialize по умолчанию предполагает, что все состояние объектов данного типа доступно через соответствующие пары методов «setter» и «getter» в порядке, в котором их возвращает Introspector. Если дескриптор свойства определяет атрибут "transient" со значением Boolean.TRUE, данная реализация по умолчанию игнорирует это свойство. Обратите внимание, что такое употребление слова "transient" никак не связано с модификатором поля, используемым ObjectOutputStream.

Для каждого нетранзиентного свойства создается выражение, в котором к oldInstance применяется метод "getter" без аргументов. Значение этого выражения — значение свойства в сериализуемом экземпляре. Если значение этого выражения в клонированном окружении mutatesTo целевому значению, новое значение инициализируется так, чтобы оно стало эквивалентным старому. В этом случае, поскольку значение свойства не изменилось, вызывать соответствующий метод "setter" не нужно, и оператор не формируется. В противном случае выражение для этого значения заменяется другим выражением (обычно конструктором), а соответствующий метод "setter" вызывается для установки нового значения свойства в объекте. Эта схема исключает из вывода потоков, использующих данный делегат, информацию по умолчанию.

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

Переопределяет:
initialize в классе PersistenceDelegate
Параметры:
type — тип экземпляров
oldInstance — экземпляр, который нужно скопировать.
newInstance — экземпляр, который нужно изменить.
out — поток, в который следует записать операторы инициализации.
Выбрасывает:
NullPointerException — если out равен null
См. также:
  • Introspector.getBeanInfo(Class)
  • PropertyDescriptor

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, общие сведения, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API