Download
FAQ History |
![]() ![]() ![]() |
API
Search Feedback |
Installing Web Applications
A context is a name that gets mapped to a Web application. For example, the context of the
hello1
application is /hello1
. To install an application into Tomcat, you notify Tomcat that a new context is available. Note that an installed application is not available after Tomcat is restarted. To permanently deploy an application you invoke the manager application deploy command (see Deploying Web Applications). Installing an application is the recommended operation when you are iteratively developing an application because you do not have to package the WAR and because you can quickly reload an updated application.You install an application into Tomcat with the manager application
install
command invoked via theAnt
install
task. TheAnt
install
task tells the manager running at the location specified by theurl
attribute to install an application at the context specified by thepath
attribute and the location containing the Web application files specified with thewar
attribute. The value of thewar
attribute can be a WAR filejar:file:/path/to/bar.war!/
or an unpacked directoryfile:/path/to/foo
.The
username
andpassword
attributes are discussed in Appendix B.Instead of providing a
war
attribute, you can specify configuration information with theconfig
attribute:<install url="url
" path="mywebapp
" config="file:build/context.xml" username="username
" password="password
"/>The
config
attribute points to a configuration file that contains a context entry of the form:Note that the context entry specifies the location of the Web application through its
docBase
attribute.The tutorial example build files contain an
Ant
install
andinstall-config
targets that invoke theAnt
install
task:<target name="install" description="Install web application" depends="build"> <install url="${url
}" path="${mywebapp
}" war="file:build
" username="${username
}" password="${password
}"/> </target> <target name="install-config" description="Install web application" depends="build"> <install url="${url
}" path="${mywebapp
}" config="file:build/context.xml" username="${username
}" password="${password
}"/> </target>These tasks require that a Web application deployment descriptor be available. All of the tutorial examples are distributed with a deployment descriptor.
To install the
hello1
application described in Web Application Life Cycle:
Download
FAQ History |
![]() ![]() ![]() |
API
Search Feedback |
All of the material in The Java(TM) Web Services Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.