* This is one of the kinds of descriptor returned by a BeanInfo object, * which also returns descriptors for properties, method, and events. + * + * @since 1.1 */ public class BeanDescriptor extends FeatureDescriptor { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/BeanInfo.java --- a/jdk/src/share/classes/java/beans/BeanInfo.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/BeanInfo.java Thu Jun 05 10:37:24 2014 -0700 @@ -48,6 +48,8 @@ * the {@code SimpleBeanInfo} class to define specific information. *
* See also the {@link Introspector} class to learn more about bean behavior. + * + * @since 1.1 */ public interface BeanInfo { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/Beans.java --- a/jdk/src/share/classes/java/beans/Beans.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/Beans.java Thu Jun 05 10:37:24 2014 -0700 @@ -56,6 +56,8 @@ /** * This class provides some general purpose beans control methods. + * + * @since 1.1 */ public class Beans { @@ -96,6 +98,7 @@ * @exception ClassNotFoundException if the class of a serialized * object could not be found. * @exception IOException if an I/O error occurs. + * @since 1.2 */ public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext) throws IOException, ClassNotFoundException { @@ -152,6 +155,7 @@ * @exception ClassNotFoundException if the class of a serialized * object could not be found. * @exception IOException if an I/O error occurs. + * @since 1.2 */ public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext, AppletInitializer initializer) diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/Customizer.java --- a/jdk/src/share/classes/java/beans/Customizer.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/Customizer.java Thu Jun 05 10:37:24 2014 -0700 @@ -33,6 +33,8 @@ * it can be instantiated inside an AWT dialog or panel. *
* Each customizer should have a null constructor. + * + * @since 1.1 */ public interface Customizer { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/EventSetDescriptor.java --- a/jdk/src/share/classes/java/beans/EventSetDescriptor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/EventSetDescriptor.java Thu Jun 05 10:37:24 2014 -0700 @@ -36,6 +36,8 @@ * The given group of events are all delivered as method calls on a single * event listener interface, and an event listener object can be registered * via a call on a registration method supplied by the event source. + * + * @since 1.1 */ public class EventSetDescriptor extends FeatureDescriptor { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/FeatureDescriptor.java --- a/jdk/src/share/classes/java/beans/FeatureDescriptor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/FeatureDescriptor.java Thu Jun 05 10:37:24 2014 -0700 @@ -46,6 +46,8 @@ *
* In addition it provides an extension mechanism so that arbitrary * attribute/value pairs can be associated with a design feature. + * + * @since 1.1 */ public class FeatureDescriptor { @@ -145,6 +147,7 @@ * important for presenting to humans. * * @return True if this feature should be preferentially shown to human users. + * @since 1.2 */ public boolean isPreferred() { return preferred; @@ -156,6 +159,7 @@ * * @param preferred True if this feature should be preferentially shown * to human users. + * @since 1.2 */ public void setPreferred(boolean preferred) { this.preferred = preferred; diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/IndexedPropertyDescriptor.java --- a/jdk/src/share/classes/java/beans/IndexedPropertyDescriptor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/IndexedPropertyDescriptor.java Thu Jun 05 10:37:24 2014 -0700 @@ -36,6 +36,8 @@ * An indexed property may also provide simple non-indexed read and write * methods. If these are present, they read and write arrays of the type * returned by the indexed read method. + * + * @since 1.1 */ public class IndexedPropertyDescriptor extends PropertyDescriptor { @@ -209,6 +211,8 @@ * @param readMethod The new indexed read method. * @throws IntrospectionException if an exception occurs during * introspection. + * + * @since 1.2 */ public synchronized void setIndexedReadMethod(Method readMethod) throws IntrospectionException { @@ -288,6 +292,8 @@ * @param writeMethod The new indexed write method. * @throws IntrospectionException if an exception occurs during * introspection. + * + * @since 1.2 */ public synchronized void setIndexedWriteMethod(Method writeMethod) throws IntrospectionException { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/IntrospectionException.java --- a/jdk/src/share/classes/java/beans/IntrospectionException.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/IntrospectionException.java Thu Jun 05 10:37:24 2014 -0700 @@ -32,6 +32,8 @@ * to a Class object, not being able to resolve a string method name, * or specifying a method name that has the wrong type signature for * its intended use. + * + * @since 1.1 */ public diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/Introspector.java --- a/jdk/src/share/classes/java/beans/Introspector.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/Introspector.java Thu Jun 05 10:37:24 2014 -0700 @@ -90,6 +90,8 @@ * For more information about introspection and design patterns, please * consult the * JavaBeans™ specification. + * + * @since 1.1 */ public class Introspector { @@ -97,14 +99,17 @@ // Flags that can be used to control getBeanInfo: /** * Flag to indicate to use of all beaninfo. + * @since 1.2 */ public final static int USE_ALL_BEANINFO = 1; /** * Flag to indicate to ignore immediate beaninfo. + * @since 1.2 */ public final static int IGNORE_IMMEDIATE_BEANINFO = 2; /** * Flag to indicate to ignore all beaninfo. + * @since 1.2 */ public final static int IGNORE_ALL_BEANINFO = 3; @@ -214,6 +219,7 @@ * @return A BeanInfo object describing the target bean. * @exception IntrospectionException if an exception occurs during * introspection. + * @since 1.2 */ public static BeanInfo getBeanInfo(Class beanClass, int flags) throws IntrospectionException { @@ -354,6 +360,8 @@ * not normally required. It is normally only needed by advanced * tools that update existing "Class" objects in-place and need * to make the Introspector re-analyze existing Class objects. + * + * @since 1.2 */ public static void flushCaches() { @@ -377,6 +385,7 @@ * * @param clz Class object to be flushed. * @throws NullPointerException If the Class object is null. + * @since 1.2 */ public static void flushFromCaches(Class clz) { if (clz == null) { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/MethodDescriptor.java --- a/jdk/src/share/classes/java/beans/MethodDescriptor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/MethodDescriptor.java Thu Jun 05 10:37:24 2014 -0700 @@ -34,6 +34,8 @@ /** * A MethodDescriptor describes a particular method that a Java Bean * supports for external access from other components. + * + * @since 1.1 */ public class MethodDescriptor extends FeatureDescriptor { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/ParameterDescriptor.java --- a/jdk/src/share/classes/java/beans/ParameterDescriptor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/ParameterDescriptor.java Thu Jun 05 10:37:24 2014 -0700 @@ -32,6 +32,8 @@ * class. *
* Currently all our state comes from the FeatureDescriptor base class. + * + * @since 1.1 */ public class ParameterDescriptor extends FeatureDescriptor { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyChangeEvent.java --- a/jdk/src/share/classes/java/beans/PropertyChangeEvent.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyChangeEvent.java Thu Jun 05 10:37:24 2014 -0700 @@ -43,6 +43,8 @@ * An event source may send a null object as the name to indicate that an * arbitrary set of if its properties have changed. In this case the * old and new values should also be null. + * + * @since 1.1 */ public class PropertyChangeEvent extends EventObject { private static final long serialVersionUID = 7042693688939648123L; diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyChangeListener.java --- a/jdk/src/share/classes/java/beans/PropertyChangeListener.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyChangeListener.java Thu Jun 05 10:37:24 2014 -0700 @@ -29,6 +29,7 @@ * A "PropertyChange" event gets fired whenever a bean changes a "bound" * property. You can register a PropertyChangeListener with a source * bean so as to be notified of any bound property updates. + * @since 1.1 */ public interface PropertyChangeListener extends java.util.EventListener { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyChangeSupport.java --- a/jdk/src/share/classes/java/beans/PropertyChangeSupport.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyChangeSupport.java Thu Jun 05 10:37:24 2014 -0700 @@ -77,6 +77,7 @@ * non-serializable listeners will be skipped during serialization. * * @see VetoableChangeSupport + * @since 1.1 */ public class PropertyChangeSupport implements Serializable { private PropertyChangeListenerMap map = new PropertyChangeListenerMap(); @@ -191,6 +192,7 @@ * * @param propertyName The name of the property to listen on. * @param listener The PropertyChangeListener to be added + * @since 1.2 */ public void addPropertyChangeListener( String propertyName, @@ -216,6 +218,7 @@ * * @param propertyName The name of the property that was listened on. * @param listener The PropertyChangeListener to be removed + * @since 1.2 */ public void removePropertyChangeListener( String propertyName, @@ -277,6 +280,7 @@ * @param propertyName the programmatic name of the property that was changed * @param oldValue the old value of the property * @param newValue the new value of the property + * @since 1.2 */ public void firePropertyChange(String propertyName, int oldValue, int newValue) { if (oldValue != newValue) { @@ -297,6 +301,7 @@ * @param propertyName the programmatic name of the property that was changed * @param oldValue the old value of the property * @param newValue the new value of the property + * @since 1.2 */ public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue) { if (oldValue != newValue) { @@ -312,6 +317,7 @@ * No event is fired if the given event's old and new values are equal and non-null. * * @param event the {@code PropertyChangeEvent} to be fired + * @since 1.2 */ public void firePropertyChange(PropertyChangeEvent event) { Object oldValue = event.getOldValue(); @@ -410,6 +416,7 @@ * * @param propertyName the property name. * @return true if there are one or more listeners for the given property + * @since 1.2 */ public boolean hasListeners(String propertyName) { return this.map.hasListeners(propertyName); diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyDescriptor.java --- a/jdk/src/share/classes/java/beans/PropertyDescriptor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyDescriptor.java Thu Jun 05 10:37:24 2014 -0700 @@ -32,6 +32,7 @@ /** * A PropertyDescriptor describes one property that a Java Bean * exports via a pair of accessor methods. + * @since 1.1 */ public class PropertyDescriptor extends FeatureDescriptor { @@ -244,6 +245,7 @@ * * @param readMethod The new read method. * @throws IntrospectionException if the read method is invalid + * @since 1.2 */ public synchronized void setReadMethod(Method readMethod) throws IntrospectionException { @@ -314,6 +316,7 @@ * * @param writeMethod The new write method. * @throws IntrospectionException if the write method is invalid + * @since 1.2 */ public synchronized void setWriteMethod(Method writeMethod) throws IntrospectionException { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyEditor.java --- a/jdk/src/share/classes/java/beans/PropertyEditor.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyEditor.java Thu Jun 05 10:37:24 2014 -0700 @@ -51,6 +51,8 @@ * or support setAsText. *
* Each PropertyEditor should have a null constructor. + * + * @since 1.1 */ public interface PropertyEditor { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyEditorManager.java --- a/jdk/src/share/classes/java/beans/PropertyEditorManager.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyEditorManager.java Thu Jun 05 10:37:24 2014 -0700 @@ -48,6 +48,8 @@ * Default PropertyEditors will be provided for the Java primitive types * "boolean", "byte", "short", "int", "long", "float", and "double"; and * for the classes java.lang.String. java.awt.Color, and java.awt.Font. + * + * @since 1.1 */ public class PropertyEditorManager { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyEditorSupport.java --- a/jdk/src/share/classes/java/beans/PropertyEditorSupport.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyEditorSupport.java Thu Jun 05 10:37:24 2014 -0700 @@ -31,6 +31,8 @@ * This is a support class to help build property editors. *
* It can be used either as a base class or as a delegate. + * + * @since 1.1 */ public class PropertyEditorSupport implements PropertyEditor { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/PropertyVetoException.java --- a/jdk/src/share/classes/java/beans/PropertyVetoException.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/PropertyVetoException.java Thu Jun 05 10:37:24 2014 -0700 @@ -29,6 +29,7 @@ /** * A PropertyVetoException is thrown when a proposed change to a * property represents an unacceptable value. + * @since 1.1 */ public diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/SimpleBeanInfo.java --- a/jdk/src/share/classes/java/beans/SimpleBeanInfo.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/SimpleBeanInfo.java Thu Jun 05 10:37:24 2014 -0700 @@ -34,6 +34,8 @@ * When the introspector sees the "noop" values, it will apply low * level introspection and design patterns to automatically analyze * the target bean. + * + * @since 1.1 */ public class SimpleBeanInfo implements BeanInfo { diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/VetoableChangeListener.java --- a/jdk/src/share/classes/java/beans/VetoableChangeListener.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/VetoableChangeListener.java Thu Jun 05 10:37:24 2014 -0700 @@ -29,6 +29,7 @@ * A VetoableChange event gets fired whenever a bean changes a "constrained" * property. You can register a VetoableChangeListener with a source bean * so as to be notified of any constrained property updates. + * @since 1.1 */ public interface VetoableChangeListener extends java.util.EventListener { /** diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/VetoableChangeSupport.java --- a/jdk/src/share/classes/java/beans/VetoableChangeSupport.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/VetoableChangeSupport.java Thu Jun 05 10:37:24 2014 -0700 @@ -77,6 +77,7 @@ * non-serializable listeners will be skipped during serialization. * * @see PropertyChangeSupport + * @since 1.1 */ public class VetoableChangeSupport implements Serializable { private VetoableChangeListenerMap map = new VetoableChangeListenerMap(); @@ -191,6 +192,7 @@ * * @param propertyName The name of the property to listen on. * @param listener The VetoableChangeListener to be added + * @since 1.2 */ public void addVetoableChangeListener( String propertyName, @@ -216,6 +218,7 @@ * * @param propertyName The name of the property that was listened on. * @param listener The VetoableChangeListener to be removed + * @since 1.2 */ public void removeVetoableChangeListener( String propertyName, @@ -292,6 +295,7 @@ * @param oldValue the old value of the property * @param newValue the new value of the property * @throws PropertyVetoException if one of listeners vetoes the property update + * @since 1.2 */ public void fireVetoableChange(String propertyName, int oldValue, int newValue) throws PropertyVetoException { @@ -320,6 +324,7 @@ * @param oldValue the old value of the property * @param newValue the new value of the property * @throws PropertyVetoException if one of listeners vetoes the property update + * @since 1.2 */ public void fireVetoableChange(String propertyName, boolean oldValue, boolean newValue) throws PropertyVetoException { @@ -343,6 +348,7 @@ * * @param event the {@code PropertyChangeEvent} to be fired * @throws PropertyVetoException if one of listeners vetoes the property update + * @since 1.2 */ public void fireVetoableChange(PropertyChangeEvent event) throws PropertyVetoException { @@ -399,6 +405,7 @@ * * @param propertyName the property name. * @return true if there are one or more listeners for the given property + * @since 1.2 */ public boolean hasListeners(String propertyName) { return this.map.hasListeners(propertyName); diff -r 3961e8fcb668 -r adfaa02ea516 jdk/src/share/classes/java/beans/Visibility.java --- a/jdk/src/share/classes/java/beans/Visibility.java Wed Jun 04 17:24:13 2014 +0400 +++ b/jdk/src/share/classes/java/beans/Visibility.java Thu Jun 05 10:37:24 2014 -0700 @@ -34,6 +34,8 @@ * This interface is for expert developers, and is not needed * for normal simple beans. To avoid confusing end-users we * avoid using getXXX setXXX design patterns for these methods. + * + * @since 1.1 */ public interface Visibility {