Package java.beans
See: Description
-
Interface Summary Interface Description AppletInitializer This interface is designed to work in collusion with java.beans.Beans.instantiate.BeanInfo A bean implementor who wishes to provide explicit information about their bean may provide a BeanInfo class that implements this BeanInfo interface and provides explicit information about the methods, properties, events, etc, of their bean.Customizer A customizer class provides a complete custom GUI for customizing a target Java Bean.DesignMode This interface is intended to be implemented by, or delegated from, instances of java.beans.beancontext.BeanContext, in order to propagate to its nested hierarchy of java.beans.beancontext.BeanContextChild instances, the current "designTime" property.ExceptionListener An ExceptionListener is notified of internal exceptions.PropertyChangeListener A "PropertyChange" event gets fired whenever a bean changes a "bound" property.PropertyEditor A PropertyEditor class provides support for GUIs that want to allow users to edit a property value of a given type.VetoableChangeListener A VetoableChange event gets fired whenever a bean changes a "constrained" property.Visibility Under some circumstances a bean may be run on servers where a GUI is not available. -
Class Summary Class Description BeanDescriptor A BeanDescriptor provides global information about a "bean", including its Java class, its displayName, etc.Beans This class provides some general purpose beans control methods.DefaultPersistenceDelegate TheDefaultPersistenceDelegate
is a concrete implementation of the abstractPersistenceDelegate
class and is the delegate used by default for classes about which no information is available.Encoder AnEncoder
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.EventHandler TheEventHandler
class provides support for dynamically generating event listeners whose methods execute a simple statement involving an incoming event object and a target object.EventSetDescriptor An EventSetDescriptor describes a group of events that a given Java bean fires.Expression AnExpression
object represents a primitive expression in which a single method is applied to a target and a set of arguments to return a result - as in"a.getFoo()"
.FeatureDescriptor The FeatureDescriptor class is the common baseclass for PropertyDescriptor, EventSetDescriptor, and MethodDescriptor, etc.IndexedPropertyChangeEvent An "IndexedPropertyChange" event gets delivered whenever a component that conforms to the JavaBeans™ specification (a "bean") changes a bound indexed property.IndexedPropertyDescriptor An IndexedPropertyDescriptor describes a property that acts like an array and has an indexed read and/or indexed write method to access specific elements of the array.Introspector The Introspector class provides a standard way for tools to learn about the properties, events, and methods supported by a target Java Bean.MethodDescriptor A MethodDescriptor describes a particular method that a Java Bean supports for external access from other components.ParameterDescriptor The ParameterDescriptor class allows bean implementors to provide additional information on each of their parameters, beyond the low level type information provided by the java.lang.reflect.Method class.PersistenceDelegate The PersistenceDelegate class takes the responsibility for expressing the state of an instance of a given class in terms of the methods in the class's public API.PropertyChangeEvent A "PropertyChange" event gets delivered whenever a bean changes a "bound" or "constrained" property.PropertyChangeListenerProxy A class which extends theEventListenerProxy
specifically for adding aPropertyChangeListener
with a "bound" property.PropertyChangeSupport This is a utility class that can be used by beans that support bound properties.PropertyDescriptor A PropertyDescriptor describes one property that a Java Bean exports via a pair of accessor methods.PropertyEditorManager The PropertyEditorManager can be used to locate a property editor for any given type name.PropertyEditorSupport This is a support class to help build property editors.SimpleBeanInfo This is a support class to make it easier for people to provide BeanInfo classes.Statement AStatement
object represents a primitive statement in which a single method is applied to a target and a set of arguments - as in"a.setFoo(b)"
.VetoableChangeListenerProxy A class which extends theEventListenerProxy
specifically for adding aVetoableChangeListener
with a "constrained" property.VetoableChangeSupport This is a utility class that can be used by beans that support constrained properties.XMLDecoder TheXMLDecoder
class is used to read XML documents created using theXMLEncoder
and is used just like theObjectInputStream
.XMLEncoder TheXMLEncoder
class is a complementary alternative to theObjectOutputStream
and can used to generate a textual representation of a JavaBean in the same way that theObjectOutputStream
can be used to create binary representation ofSerializable
objects. -
Exception Summary Exception Description IntrospectionException Thrown when an exception happens during Introspection.PropertyVetoException A PropertyVetoException is thrown when a proposed change to a property represents an unacceptable value. -
Annotation Types Summary Annotation Type Description ConstructorProperties An annotation on a constructor that shows how the parameters of that constructor correspond to the constructed object's getter methods.Transient Indicates that an attribute called "transient" should be declared with the givenvalue
when theIntrospector
constructs aPropertyDescriptor
orEventSetDescriptor
classes associated with the annotated code element.
Package java.beans Description
PropertyChangeEvent
). However, most of the classes in this
package are meant to be used by a bean editor (that is, a development environment
for customizing and putting together beans to create an application). In
particular, these classes help the bean editor create a user
interface that the user can use to customize the bean. For example, a bean may
contain a property of a special type that a bean editor may not know how to handle.
By using the PropertyEditor
interface, a bean developer can
provide an editor for this special type.
To minimize the resources used by a bean, the classes used by bean editors are loaded only
when the bean is being edited. They are not needed while the bean is running in an application
and therefore not loaded. This information is kept in what's called a bean-info (see BeanInfo
).
Unless explicitly stated, null values or empty Strings are not valid parameters for the methods in this package. You may expect to see exceptions if these parameters are used.
Long-Term Persistence
As of v1.4, thejava.beans
package provides support for
long-term persistence -- reading and
writing a bean as a textual representation of its property values.
The property values are treated as beans,
and are recursively read or written to capture
their publicly available state.
This approach is suitable for long-term storage
because it relies only on public API,
rather than the likely-to-change private implementation.
Note:
The persistence scheme cannot automatically instantiate
custom inner classes, such as you might use for event handlers.
By using the EventHandler
class
instead of inner classes for custom event handlers,
you can avoid this problem.
You read and write beans in XML format using the
XMLDecoder
and
XMLEncoder
classes, respectively.
One notable feature of the persistence scheme is that
reading in a bean requires no special knowledge of the bean.
Writing out a bean, on the other hand,
sometimes requires special knowledge of the bean's type.
If the bean's state can be
expressed using only the no-argument constructor and
public getter and setter methods for properties,
no special knowledge is required.
Otherwise, the bean requires a custom persistence delegate --
an object that is in charge of writing out beans of a particular type.
All classes provided in the JDK that descend
from java.awt.Component
,
as well as all their properties,
automatically have persistence delegates.
If you need (or choose) to provide a persistence delegate for a bean,
you can do so either by using a
DefaultPersistenceDelegate
instance
or by creating your own subclass of PersistenceDelegate
.
If the only reason a bean needs a persistence delegate
is because you want to invoke the bean's constructor with
property values as arguments,
you can create the bean's persistence delegate
with the one-argument
DefaultPersistenceDelegate
constructor.
Otherwise,
you need to implement your own persistence delegate,
for which you're likely to need the following classes:
-
PersistenceDelegate
- The abstract class from which all persistence delegates descend.
Your subclass should use its knowledge of the bean's type to provide
whatever
Statement
s andExpression
s are necessary to create the bean and restore its state. -
Statement
- Represents the invocation of a single method on an object. Includes a set of arguments to the method.
-
Expression
- A subclass of
Statement
used for methods that return a value.
Once you create a persistence delegate,
you register it using the
setPersistenceDelegate
method of
XMLEncoder
.
Related Documentation
For overview, architecture, and tutorial documentation, please see:- JavaBeans, a trail in The Java Tutorial.
- Long-Term Persistence, an article in The Swing Connection.
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/beans/package-summary.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.