src-openjdk/test/java/beans/README

How to create regression tests for JavaBeans
============================================

All regression tests are developed to run under JavaTest 3.2.2.



TEST HIERARCHY
--------------

You should choose an appropriate folder from the following list:
 - The Beans folder contains tests for the java.beans.Beans class
 - The EventHandler folder contains tests for the java.beans.EventHandler class
 - The Introspector folder contains tests for introspection
 - The PropertyChangeSupport folder contains tests for the bound properties
 - The VetoableChangeSupport folder contains tests for the constrained properties
 - The PropertyEditor folder contains tests for all property editors
 - The Statement folder contains tests for statements and expressions
 - The XMLDecoder folder contains tests for XMLDecoder
 - The XMLEncoder folder contains tests for XMLEncoder
 - The Performance folder contains manual tests for performance
 - The beancontext folder contains tests for classes
   from the java.beans.beancontext package



NAME CONVENTIONS FOR TEST CLASSES
---------------------------------

Usually a class name should start with the "Test" word
followed by 7-digit CR number. For example:
	Beans/Test4067824.java

If your test contains additional files you should create
a subfolder with the CR number as its name. For example:
	Introspector/4168475/Test4168475.java
	Introspector/4168475/infos/ComponentBeanInfo.java

If you have several tests for the same CR number you should also
create a subfolder with the CR number as its name. For example:
	XMLEncoder/4741757/AbstractTest.java
	XMLEncoder/4741757/TestFieldAccess.java
	XMLEncoder/4741757/TestSecurityManager.java
	XMLEncoder/4741757/TestStackOverflow.java

Every JAR file should contain source files for all class files. For example:
	XMLDecoder/4676532/test.jar#test/Test.class
	XMLDecoder/4676532/test.jar#test/Test.java



USEFUL UTILITY CLASSES
----------------------

For Introspector tests you can use the BeanUtils class.
This class provides helpful methods to get
property descriptors for the specified type.


For XMLEncoder tests you can use the AbstractTest class.
This class is intended to simplify tests creating.
It contains methods to encode an object to XML,
decode XML and validate the result.
The validate() method is applied to compare
the object before encoding with the object after decoding.
If the test fails the Error is thrown.
1) The getObject() method should be implemented
   to return the object to test.
   This object will be encoded and decoded
   and the object creation will be tested.
2) The getAnotherObject() method can be overridden
   to return a different object to test.
   If this object is not null it will be encoded and decoded.
   Also the object updating will be tested in this case.
The test() method has a boolean parameter,
which indicates that the test should be started in secure context.