Класс DefaultPersistenceDelegate
public class DefaultPersistenceDelegate extends PersistenceDelegate
DefaultPersistenceDelegate — конкретная реализация абстрактного класса PersistenceDelegate и делегат, используемый по умолчанию для классов, сведения о которых отсутствуют. DefaultPersistenceDelegate обеспечивает устойчивое к изменениям версий сохранение на основе общедоступного API для классов, следующих соглашениям JavaBeans, без какой-либо специальной настройки класса. Основные предположения состоят в том, что у класса есть конструктор без аргументов, а его состояние точно представлено соответствующими парами методов «setter» и «getter» в порядке, в котором их возвращает Introspector. Помимо обеспечения сохранения JavaBeans без написания кода, DefaultPersistenceDelegate предоставляет удобный способ обеспечить постоянное хранение для классов, у которых есть конструктор, требующий в качестве аргументов значения некоторых свойств, но не являющийся конструктором без аргументов.
- Начиная с:
- 1.4
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
DefaultPersistenceDelegate() |
Создает делегат сохранения для класса с конструктором без аргументов. |
DefaultPersistenceDelegate |
Создает делегат сохранения по умолчанию для класса с конструктором, аргументами которого являются значения имен свойств, заданных с помощью constructorPropertyNames. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
initialize |
Эта реализация метода initialize по умолчанию предполагает, что все состояние объектов данного типа доступно через соответствующие пары методов «setter» и «getter» в порядке, в котором их возвращает Introspector. |
protected Expression |
instantiate |
Эта реализация метода instantiate по умолчанию возвращает выражение с предопределенным именем метода "new", обозначающим вызов конструктора с аргументами, указанными в конструкторе DefaultPersistenceDelegate. |
protected boolean |
mutatesTo |
Если число аргументов указанного конструктора не равно нулю, а класс oldInstance явно объявляет метод "equals", этот метод возвращает значение oldInstance.equals(newInstance). |
Методы, объявленные в классе PersistenceDelegate
writeObject | Модификатор и тип | Метод | Описание |
|---|---|---|
void |
writeObject |
writeObject — единственная точка входа в процесс сохранения; она используется Encoder в традиционном режиме делегирования. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Указывает, является ли другой объект «равным» этому объекту. |
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 |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Подробное описание конструкторов
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— экземпляр, который нужно изменить. - Возвращает:
- Истину, если эквивалентную копию
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» в порядке, в котором их возвращает Introspector. Если дескриптор свойства определяет атрибут "transient" со значением Boolean.TRUE, данная реализация по умолчанию игнорирует это свойство. Обратите внимание, что такое употребление слова "transient" никак не связано с модификатором поля, используемым ObjectOutputStream. Для каждого нетранзиентного свойства создается выражение, в котором к oldInstance применяется метод "getter" без аргументов. Значение этого выражения — значение свойства в сериализуемом экземпляре. Если значение этого выражения в клонированном окружении 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.