org.apache.tools.ant.taskdefs.optional.jsp
Class WLJspc
public
class
WLJspc
extends MatchingTask
Precompiles JSP's using WebLogic's JSP compiler (weblogic.jspc).
Tested only on Weblogic 4.5.1 - NT4.0 and Solaris 5.7
required attributes
src : root of source tree for JSP, ie, the document root for your weblogic server
dest : root of destination directory, what you have set as
WorkingDir in the weblogic properties
package : start package name under which your JSP's would be compiled
other attributes
classpath
A classpath should be set which contains the weblogic classes as well as all
application classes referenced by the JSP. The system classpath is also
appended when the jspc is called, so you may choose to put everything in
the classpath while calling Ant. However, since presumably the JSP's will
reference classes being build by Ant, it would be better to explicitly add
the classpath in the task
The task checks timestamps on the JSP's and the generated classes, and compiles
only those files that have changed.
It follows the weblogic naming convention of putting classes in
_dirName/_fileName.class for dirname/fileName.jsp
Limitation: It compiles the files thru the Classic compiler only.
Limitation: Since it is my experience that weblogic jspc throws out of
memory error on being given too many files at one go, it is
called multiple times with one jsp file each.
example
<target name="jspcompile" depends="compile">
<wljspc src="c:\\weblogic\\myserver\\public_html"
dest="c:\\weblogic\\myserver\\serverclasses" package="myapp.jsp">
<classpath>
<pathelement location="${weblogic.classpath}" />
<pathelement path="${compile.dest}" />
</classpath>
</wljspc>
</target>
Method Summary |
Path | createClasspath()
Maybe creates a nested classpath element. |
void | execute()
Run the task. |
protected String | replaceString(String inpString, String escapeChars, String replaceChars)
Replace occurances of a string with a replacement string. |
protected void | scanDir(String[] files)
Scan the array of files and add the jsp
files that need to be compiled to the filesToDo field. |
void | setClasspath(Path classpath)
Set the classpath to be used for this compilation. |
void | setDest(File dirName)
Set the directory containing the source jsp's
|
void | setPackage(String packageName)
Set the package under which the compiled classes go
|
void | setSrc(File dirName)
Set the directory containing the source jsp's
|
public
Path createClasspath()
Maybe creates a nested classpath element.
Returns: a path to be configured.
public void execute()
Run the task.
Throws: BuildException if there is an error.
protected String replaceString(String inpString, String escapeChars, String replaceChars)
Replace occurances of a string with a replacement string.
Parameters: inpString the string to convert. escapeChars the string to replace. replaceChars the string to place.
Returns: the converted string.
protected void scanDir(String[] files)
Scan the array of files and add the jsp
files that need to be compiled to the filesToDo field.
Parameters: files the files to scan.
public void setClasspath(
Path classpath)
Set the classpath to be used for this compilation.
Parameters: classpath the classpath to use.
public void setDest(File dirName)
Set the directory containing the source jsp's
Parameters: dirName the directory containg the source jsp's
public void setPackage(String packageName)
Set the package under which the compiled classes go
Parameters: packageName the package name for the clases
public void setSrc(File dirName)
Set the directory containing the source jsp's
Parameters: dirName the directory containg the source jsp's