Encoder (Java Platform SE 8 ) (original) (raw)
- java.beans.Encoder
Direct Known Subclasses:
XMLEncoder
public class Encoder
extends Object
An Encoder is a class which can be used to create files or streams that encode the state of a collection of JavaBeans in terms of their public APIs. The Encoder, in conjunction with its persistence delegates, is responsible for breaking the object graph down into a series of Statementss and Expressions which can be used to create it. A subclass typically provides a syntax for these expressions using some human readable form - like Java source code or XML.
Since:
1.4
Constructor Summary
Constructors
Constructor Description Encoder() Method Summary
All Methods Instance Methods Concrete Methods
Modifier and Type Method Description Object get(Object oldInstance) Returns a tentative value for oldInstance in the environment created by this stream. ExceptionListener getExceptionListener() Gets the exception handler for this stream. PersistenceDelegate getPersistenceDelegate(Class<?> type) Returns the persistence delegate for the given type. Object remove(Object oldInstance) Removes the entry for this instance, returning the old entry. void setExceptionListener(ExceptionListener exceptionListener) Sets the exception handler for this stream to exceptionListener. void setPersistenceDelegate(Class<?> type,PersistenceDelegate delegate) Associates the specified persistence delegate with the given type. void writeExpression(Expression oldExp) The implementation first checks to see if an expression with this value has already been written. protected void writeObject(Object o) Write the specified object to the output stream. void writeStatement(Statement oldStm) Writes statement oldStm to the stream. * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang") `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [toString](../../java/lang/Object.html#toString--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`Constructor Detail
* #### Encoder public Encoder()Method Detail
* #### writeObject protected void writeObject([Object](../../java/lang/Object.html "class in java.lang") o) Write the specified object to the output stream. The serialized form will denote a series of expressions, the combined effect of which will create an equivalent object when the input stream is read. By default, the object is assumed to be a _JavaBean_ with a nullary constructor, whose state is defined by the matching pairs of "setter" and "getter" methods returned by the Introspector. Parameters: `o` \- The object to be written to the stream. See Also: [XMLDecoder.readObject()](../../java/beans/XMLDecoder.html#readObject--) * #### setExceptionListener public void setExceptionListener([ExceptionListener](../../java/beans/ExceptionListener.html "interface in java.beans") exceptionListener) Sets the exception handler for this stream to `exceptionListener`. The exception handler is notified when this stream catches recoverable exceptions. Parameters: `exceptionListener` \- The exception handler for this stream; if `null` the default exception listener will be used. See Also: [getExceptionListener()](../../java/beans/Encoder.html#getExceptionListener--) * #### getExceptionListener public [ExceptionListener](../../java/beans/ExceptionListener.html "interface in java.beans") getExceptionListener() Gets the exception handler for this stream. Returns: The exception handler for this stream; Will return the default exception listener if this has not explicitly been set. See Also: [setExceptionListener(java.beans.ExceptionListener)](../../java/beans/Encoder.html#setExceptionListener-java.beans.ExceptionListener-) * #### getPersistenceDelegate public [PersistenceDelegate](../../java/beans/PersistenceDelegate.html "class in java.beans") getPersistenceDelegate([Class](../../java/lang/Class.html "class in java.lang")<?> type) Returns the persistence delegate for the given type. The persistence delegate is calculated by applying the following rules in order: 1. If a persistence delegate is associated with the given type by using the [setPersistenceDelegate(java.lang.Class<?>, java.beans.PersistenceDelegate)](../../java/beans/Encoder.html#setPersistenceDelegate-java.lang.Class-java.beans.PersistenceDelegate-) method it is returned. 2. A persistence delegate is then looked up by the name composed of the the fully qualified name of the given type and the "PersistenceDelegate" postfix. For example, a persistence delegate for the `Bean` class should be named `BeanPersistenceDelegate` and located in the same package. public class Bean { ... } public class BeanPersistenceDelegate { ... } The instance of the `BeanPersistenceDelegate` class is returned for the `Bean` class. 3. If the type is `null`, a shared internal persistence delegate is returned that encodes `null` value. 4. If the type is a `enum` declaration, a shared internal persistence delegate is returned that encodes constants of this enumeration by their names. 5. If the type is a primitive type or the corresponding wrapper, a shared internal persistence delegate is returned that encodes values of the given type. 6. If the type is an array, a shared internal persistence delegate is returned that encodes an array of the appropriate type and length, and each of its elements as if they are properties. 7. If the type is a proxy, a shared internal persistence delegate is returned that encodes a proxy instance by using the [Proxy.newProxyInstance(java.lang.ClassLoader, java.lang.Class<?>\[\], java.lang.reflect.InvocationHandler)](../../java/lang/reflect/Proxy.html#newProxyInstance-java.lang.ClassLoader-java.lang.Class:A-java.lang.reflect.InvocationHandler-) method. 8. If the [BeanInfo](../../java/beans/BeanInfo.html "interface in java.beans") for this type has a [BeanDescriptor](../../java/beans/BeanDescriptor.html "class in java.beans") which defined a "persistenceDelegate" attribute, the value of this named attribute is returned. 9. In all other cases the default persistence delegate is returned. The default persistence delegate assumes the type is a _JavaBean_, implying that it has a default constructor and that its state may be characterized by the matching pairs of "setter" and "getter" methods returned by the [Introspector](../../java/beans/Introspector.html "class in java.beans") class. The default constructor is the constructor with the greatest number of parameters that has the [ConstructorProperties](../../java/beans/ConstructorProperties.html "annotation in java.beans") annotation. If none of the constructors has the `ConstructorProperties` annotation, then the nullary constructor (constructor with no parameters) will be used. For example, in the following code fragment, the nullary constructor for the `Foo` class will be used, while the two-parameter constructor for the `Bar` class will be used. public class Foo { public Foo() { ... } public Foo(int x) { ... } } public class Bar { public Bar() { ... } @ConstructorProperties({"x"}) public Bar(int x) { ... } @ConstructorProperties({"x", "y"}) public Bar(int x, int y) { ... } } Parameters: `type` \- the class of the objects Returns: the persistence delegate for the given type See Also: [setPersistenceDelegate(java.lang.Class<?>, java.beans.PersistenceDelegate)](../../java/beans/Encoder.html#setPersistenceDelegate-java.lang.Class-java.beans.PersistenceDelegate-), [Introspector.getBeanInfo(java.lang.Class<?>)](../../java/beans/Introspector.html#getBeanInfo-java.lang.Class-), [BeanInfo.getBeanDescriptor()](../../java/beans/BeanInfo.html#getBeanDescriptor--) * #### setPersistenceDelegate public void setPersistenceDelegate([Class](../../java/lang/Class.html "class in java.lang")<?> type, [PersistenceDelegate](../../java/beans/PersistenceDelegate.html "class in java.beans") delegate) Associates the specified persistence delegate with the given type. Parameters: `type` \- the class of objects that the specified persistence delegate applies to `delegate` \- the persistence delegate for instances of the given type See Also: [getPersistenceDelegate(java.lang.Class<?>)](../../java/beans/Encoder.html#getPersistenceDelegate-java.lang.Class-), [Introspector.getBeanInfo(java.lang.Class<?>)](../../java/beans/Introspector.html#getBeanInfo-java.lang.Class-), [BeanInfo.getBeanDescriptor()](../../java/beans/BeanInfo.html#getBeanDescriptor--) * #### remove public [Object](../../java/lang/Object.html "class in java.lang") remove([Object](../../java/lang/Object.html "class in java.lang") oldInstance) Removes the entry for this instance, returning the old entry. Parameters: `oldInstance` \- The entry that should be removed. Returns: The entry that was removed. See Also: [get(java.lang.Object)](../../java/beans/Encoder.html#get-java.lang.Object-) * #### get public [Object](../../java/lang/Object.html "class in java.lang") get([Object](../../java/lang/Object.html "class in java.lang") oldInstance) Returns a tentative value for `oldInstance` in the environment created by this stream. A persistence delegate can use its `mutatesTo` method to determine whether this value may be initialized to form the equivalent object at the output or whether a new object must be instantiated afresh. If the stream has not yet seen this value, null is returned. Parameters: `oldInstance` \- The instance to be looked up. Returns: The object, null if the object has not been seen before. * #### writeStatement public void writeStatement([Statement](../../java/beans/Statement.html "class in java.beans") oldStm) Writes statement `oldStm` to the stream. The `oldStm` should be written entirely in terms of the callers environment, i.e. the target and all arguments should be part of the object graph being written. These expressions represent a series of "what happened" expressions which tell the output stream how to produce an object graph like the original. The implementation of this method will produce a second expression to represent the same expression in an environment that will exist when the stream is read. This is achieved simply by calling `writeObject` on the target and all the arguments and building a new expression with the results. Parameters: `oldStm` \- The expression to be written to the stream. * #### writeExpression public void writeExpression([Expression](../../java/beans/Expression.html "class in java.beans") oldExp) The implementation first checks to see if an expression with this value has already been written. If not, the expression is cloned, using the same procedure as `writeStatement`, and the value of this expression is reconciled with the value of the cloned expression by calling `writeObject`. Parameters: `oldExp` \- The expression to be written to the stream.
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.