cvs commit: jakarta-servletapi-4/src/share/javax/servlet/jsp/tagext TagLibraryValidator.java

[ed...@apache.org]

eduardop    01/07/10 13:18:34

  Modified:    src/share/javax/servlet/jsp/tagext TagLibraryValidator.java
  Log:
  Changed signature and interpretation for TagLibraryValidator.validate().
  
  Revision  Changes    Path
  1.2       +24 -4     jakarta-servletapi-4/src/share/javax/servlet/jsp/tagext/TagLibraryValidator.java
  
  Index: TagLibraryValidator.java
  ===================================================================
  RCS file: /home/cvs/jakarta-servletapi-4/src/share/javax/servlet/jsp/tagext/TagLibraryValidator.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- TagLibraryValidator.java	2001/01/09 03:24:22	1.1
  +++ TagLibraryValidator.java	2001/07/10 20:18:30	1.2
  @@ -83,6 +83,24 @@
    * may create auxiliary objects internally to perform
    * the validation (e.g. an XSchema validator) and may reuse it for all
    * the pages in a given translation run.
  + *
  + * <p>
  + * The JSP container is not guaranteed to serialize invocations of
  + * validate() method, and TagLibraryValidators should perform any
  + * synchronization they may require.
  + *
  + * <p>
  + * A JSP container may optionally support a jsp:id attribute to
  + * provide higher quality validation errors.
  + * When supported, the container will track the JSP pages
  + * as passed to the container, and will assign to each element
  + * a unique "id", which is passed as the value of the jsp:id
  + * attribute.  Each XML element in the XML view available will
  + * be extended with this attribute.  The TagLibraryValidator
  + * can then use the attribute in one or more ValidationMessage
  + * objects.  The container then, in turn, can use these
  + * values to provide more precise information on the location
  + * of an error.
    */
   
   abstract public class TagLibraryValidator {
  @@ -111,15 +129,17 @@
       /**
        * Validate a JSP page.
        * This will get invoked once per directive in the JSP page.
  -     * This method will return a null String if the page passed through
  -     * is valid; otherwise an error message.
  +     * This method will return null if the page is valid; otherwise
  +     * the method should return an array of ValidationMessage objects.
  +     * An array of length zero is also interpreted as no errors.
        *
        * @param prefix the value of the prefix argument in the directive
        * @param uri the value of the uri argument in the directive
        * @param thePage the JspData page object
  -     * @return A string indicating whether the page is valid or not.
  +     * @return A null object, or zero length array if no errors, an array
  +     * of ValidationMessages otherwise.
        */
  -    public String validate(String prefix, String uri, PageData page) {
  +    public ValidationMessage[] validate(String prefix, String uri, PageData page) {
   	return null;
       }