- * The Validator class is responsible for controlling the validation + * The {@code Validator} class is responsible for controlling the validation * of content trees during runtime. * *
@@ -69,19 +69,19 @@ * * *
- * The Validator class is responsible for managing On-Demand Validation. - * The Unmarshaller class is responsible for managing Unmarshal-Time + * The {@code Validator} class is responsible for managing On-Demand Validation. + * The {@code Unmarshaller} class is responsible for managing Unmarshal-Time * Validation during the unmarshal operations. Although there is no formal * method of enabling validation during the marshal operations, the - * Marshaller may detect errors, which will be reported to the - * ValidationEventHandler registered on it. + * {@code Marshaller} may detect errors, which will be reported to the + * {@code ValidationEventHandler} registered on it. * *
*
* Using the Default EventHandler
*
* If the client application does not set an event handler on their - * Validator, Unmarshaller, or Marshaller prior to + * {@code Validator}, {@code Unmarshaller}, or {@code Marshaller} prior to * calling the validate, unmarshal, or marshal methods, then a default event * handler will receive notification of any errors or warnings encountered. * The default event handler will cause the current operation to halt after @@ -98,24 +98,24 @@ *@@ -131,9 +131,9 @@ * cases, the JAXB Provider will set the severity of the ValidationEvent to * FATAL_ERROR to indicate that the unmarshal, validate, or marshal operations * should be terminated. The default event handler and - * ValidationEventCollector utility class must terminate processing + * {@code ValidationEventCollector} utility class must terminate processing * after being notified of a fatal error. Client applications that supply their - * own ValidationEventHandler should also terminate processing after + * own {@code ValidationEventHandler} should also terminate processing after * being notified of a fatal error. If not, unexpected behaviour may occur. * * @@ -195,7 +195,7 @@ throws JAXBException; /** - * Validate the Java content tree starting at subrootObj. + * Validate the Java content tree starting at {@code subrootObj}. **
*- Use the default event handler
*- The default event handler will be used if you do not specify one - * via the setEventHandler API's on Validator, - * Unmarshaller, or Marshaller. + * via the {@code setEventHandler} API's on {@code Validator}, + * {@code Unmarshaller}, or {@code Marshaller}. *
* *- Implement and register a custom event handler
*- Client applications that require sophisticated event processing - * can implement the ValidationEventHandler interface and - * register it with the Unmarshaller and/or - * Validator. + * can implement the {@code ValidationEventHandler} interface and + * register it with the {@code Unmarshaller} and/or + * {@code Validator}. *
* *- Use the {@link javax.xml.bind.util.ValidationEventCollector ValidationEventCollector} * utility
*- For convenience, a specialized event handler is provided that - * simply collects any ValidationEvent objects created + * simply collects any {@code ValidationEvent} objects created * during the unmarshal, validate, and marshal operations and * returns them to the client application as a - * java.util.Collection. + * {@code java.util.Collection}. *
*
* Client applications can use this method to validate Java content trees * on-demand at runtime. This method can be used to validate any arbitrary @@ -206,19 +206,19 @@ * @throws JAXBException if any unexpected problem occurs during validation * @throws ValidationException * If the {@link ValidationEventHandler ValidationEventHandler} - * returns false from its handleEvent method or the - * Validator is unable to validate the content tree rooted - * at subrootObj + * returns false from its {@code handleEvent} method or the + * {@code Validator} is unable to validate the content tree rooted + * at {@code subrootObj} * @throws IllegalArgumentException * If the subrootObj parameter is null - * @return true if the subtree rooted at subrootObj is valid, false + * @return true if the subtree rooted at {@code subrootObj} is valid, false * otherwise * @deprecated since JAXB2.0 */ public boolean validate( Object subrootObj ) throws JAXBException; /** - * Validate the Java content tree rooted at rootObj. + * Validate the Java content tree rooted at {@code rootObj}. *
* Client applications can use this method to validate Java content trees * on-demand at runtime. This method is used to validate an entire Java @@ -229,12 +229,12 @@ * @throws JAXBException if any unexpected problem occurs during validation * @throws ValidationException * If the {@link ValidationEventHandler ValidationEventHandler} - * returns false from its handleEvent method or the - * Validator is unable to validate the content tree rooted - * at rootObj + * returns false from its {@code handleEvent} method or the + * {@code Validator} is unable to validate the content tree rooted + * at {@code rootObj} * @throws IllegalArgumentException * If the rootObj parameter is null - * @return true if the tree rooted at rootObj is valid, false + * @return true if the tree rooted at {@code rootObj} is valid, false * otherwise * @deprecated since JAXB2.0 */ @@ -242,7 +242,7 @@ /** * Set the particular property in the underlying implementation of - * Validator. This method can only be used to set one of + * {@code Validator}. This method can only be used to set one of * the standard JAXB defined properties above or a provider specific * property. Attempting to set an undefined property will result in * a PropertyException being thrown. See @@ -264,7 +264,7 @@ /** * Get the particular property in the underlying implementation of - * Validator. This method can only be used to get one of + * {@code Validator}. This method can only be used to get one of * the standard JAXB defined properties above or a provider specific * property. Attempting to get an undefined property will result in * a PropertyException being thrown. See