kinman      2003/10/01 15:44:02

  Modified:    jasper2/src/share/org/apache/jasper/compiler Compiler.java
  Log:
  - Some Javadoc improvements.
  
  Revision  Changes    Path
  1.71      +15 -13    
jakarta-tomcat-jasper/jasper2/src/share/org/apache/jasper/compiler/Compiler.java
  
  Index: Compiler.java
  ===================================================================
  RCS file: 
/home/cvs/jakarta-tomcat-jasper/jasper2/src/share/org/apache/jasper/compiler/Compiler.java,v
  retrieving revision 1.70
  retrieving revision 1.71
  diff -u -r1.70 -r1.71
  --- Compiler.java     26 Sep 2003 23:19:32 -0000      1.70
  +++ Compiler.java     1 Oct 2003 22:44:02 -0000       1.71
  @@ -188,7 +188,7 @@
   
   
       /** 
  -     * Compile the jsp file from the current engine context
  +     * Compile the jsp file into equivalent servlet in .java file
        * @return a smap for the current JSP page, if one is generated,
        *         null otherwise
        */
  @@ -249,10 +249,6 @@
            return null;
        }
   
  -     // Generate FunctionMapper (used for validation of EL expressions and
  -     // code generation)
  -     // pageInfo.setFunctionMapper(new FunctionMapperImpl(this));
  -
        // Validate and process attributes
        Validator.validate(this, pageNodes);
   
  @@ -294,7 +290,7 @@
                         (t4-t1) + " generate=" + ( t4-t3 ) + " validate=" + ( t2-t1 
));
           }
           
  -        //JSR45 Support - note this needs to be checked by a JSR45 guru
  +        // JSR45 Support
           if (! options.isSmapSuppressed()) {
               smapStr = SmapUtil.generateSmap(ctxt, pageNodes);
           }
  @@ -311,7 +307,7 @@
       }
   
       /** 
  -     * Compile the jsp file from the current engine context
  +     * Compile the servlet from .java file to .class file
        */
       private void generateClass(String smap)
           throws FileNotFoundException, JasperException, Exception {
  @@ -431,7 +427,7 @@
            return;
        }
   
  -        //JSR45 Support - note this needs to be checked by a JSR45 guru
  +        // JSR45 Support
           if (! options.isSmapSuppressed()) {
               SmapUtil.installSmap(ctxt.getClassFileName(), smap);
           }
  @@ -447,7 +443,10 @@
       }
   
       /**
  -     * Compile the jsp file from the current engine context
  +     * Compile the jsp file from the current engine context.  As an side-
  +     * effect, tag files that are referenced by this page are also compiled.
  +     * @param compileClass If true, generate both .java and .class file
  +     *                     If false, generate only .java file
        */
       public void compile(boolean compileClass)
           throws FileNotFoundException, JasperException, Exception
  @@ -492,10 +491,13 @@
       }
   
       /**
  -     * This is a protected method intended to be overridden by 
  -     * subclasses of Compiler. This is used by the compile method
  -     * to do all the compilation.
  -     * @param checkClass Verify the class file if true, only the .java file if 
false.
  +     * Determine if a compilation is necessary by checking the time stamp
  +     * of the JSP page with that of the corresponding .class or .java file.
  +     * If the page has dependencies, the check is also extended to its
  +     * dependeants, and so on.
  +     * This method can by overidden by a subclasses of Compiler.
  +     * @param checkClass If true, check against .class file,
  +     *                   if false, check against .java file.
        */
       public boolean isOutDated(boolean checkClass) {
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to