================================================================================
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
================================================================================
====================================================
Building The Apache Tomcat 8.0 Servlet/JSP Container
====================================================
This subproject contains the source code for Tomcat 8.0, a container that
implements the Servlet 3.1, JSP 2.3, EL 3.0 and WebSocket 1.1 specifications
from the Java Community Process <https://www.jcp.org/>.
Note: If you just need to run Apache Tomcat, it is not necessary to build
it. You may simply download a binary distribution. It is cross-platform.
Read RUNNING.txt for the instruction on how to run it.
In order to build a binary distribution version of Apache Tomcat from a
source distribution, do the following:
(1) Download and Install a Java Development Kit
1. If the JDK is already installed, skip to (2).
2. Download a version 7 of Java Development Kit (JDK) release (use the
latest update available for your chosen version) from one of:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
http://openjdk.java.net/install/index.html
or another JDK vendor.
Note regarding later versions of Java:
As documented elsewhere, one of components in Apache Tomcat includes
a private copy of the Apache Commons DBCP library.
The JDBC interfaces implemented by DBCP frequently change in non-backwards
compatible ways between versions of the Java SE specification. Therefore,
it is likely that DBCP will only compile with the specific version of Java
listed above and that compilation will fail if a later version of Java is
used.
See Apache Commons DBCP project web site for more details on
available versions of the library and its requirements,
https://commons.apache.org/dbcp/
3. Install the JDK according to the instructions included with the release.
4. Set an environment variable JAVA_HOME to the pathname of the directory
into which you installed the JDK release.
(2) Install Apache Ant version 1.9.8 or later on your computer.
1. If Apache Ant version 1.9.8 or later is already installed on your
computer, skip to (3).
2. Download a binary distribution of Ant from:
https://ant.apache.org/bindownload.cgi
3. Unpack the binary distribution into a convenient location so that the
Ant release resides in its own directory (conventionally named
"apache-ant-[version]").
For the purposes of the remainder of this document, the symbolic name
"${ant.home}" is used to refer to the full pathname of the release
directory.
4. Create an ANT_HOME environment variable to point the directory
${ant.home}.
5. Modify the PATH environment variable to include the directory
${ant.home}/bin in its list. This makes the "ant" command line script
available, which will be used to actually perform the build.
(3) Building Tomcat 8.0
(3.1) Checkout or obtain the source code for Tomcat 8.0
Checkout the source using SVN, selecting a tag for released version or
trunk for the current development code, or download and unpack a source
package.
* Tomcat SVN repository URL:
https://svn.apache.org/repos/asf/tomcat/tc8.0.x/trunk/
* Source packages can be downloaded from:
https://tomcat.apache.org/download-80.cgi
The location where the source has been placed will be further referred as
${tomcat.source}.
The Tomcat local build process does not modify line-endings. The svn repository
is configured so that all files will be checked out with the line-ending
appropriate for the current platform. When using a source package you should
ensure that you use the source package that has the appropriate line-ending
for your platform:
zip -> CRLF
tar.gz -> LF
Note that the release build process does modify line-endings to ensure that
each release package has the appropriate line-endings.
(3.2) Building
1. The build is controlled by creating a ${tomcat.source}/build.properties
file.
It is recommended to always create the file, because of unfortunate
default value of base.path property. You may start with the following
content for the file:
# ----- Default Base Path for Dependent Packages -----
# Replace this path with the directory path where dependencies binaries
# should be downloaded
base.path=/home/me/some-place-to-download-to
2. Configure base.path property by adding it to the
${tomcat.source}/build.properties file.
The base.path property specifies the place where Tomcat dependencies
required by the build are downloaded. It is recommended to place this
directory outside of the source tree, so that you do not waste your
time re-downloading the libraries.
* NOTE: The default value of the base.path property configures the build script
to download the libraries required to build Tomcat to the
${user.home}/tomcat-build-libs directory.
* NOTE: Users accessing the Internet through a proxy must use the properties
file to indicate to Ant the proxy configuration.
The following properties should be added to the ${tomcat.source}/build.properties
file.
proxy.use=true
proxy.host=proxy.domain
proxy.port=8080
proxy.user=username
proxy.password=password
See Apache Ant documentation for the <setproxy> task for details.
3. Go to the sources directory and run Ant:
cd ${tomcat.source}
ant
This will execute the "deploy" target in build.xml.
Once the build has completed successfully, a usable Tomcat installation
will have been produced in the ${tomcat.source}/output/build directory,
and can be started and stopped with the usual scripts.
Note that the build includes Tomcat documentation, which can be found
in the output/build/webapps/docs directory.
The path of the output directory can be controlled by specifying the
"tomcat.output" property in the build.properties file.
* NOTE: Do not run the build as the root user. Building and running Tomcat
does not require root privileges.
(4) Updating sources and rebuilding
It is recommended that you regularly update the downloaded Tomcat 8.0
sources using your SVN client.
For a quick rebuild of only modified code you can use:
cd ${tomcat.source}
ant
(5) Special builds
There are several targets in Tomcat build files that are useful to be
called separately. They build components that you may want to build
quickly, or ones that are included in the full release and are not built
during the default "deploy" build.
(5.1) Building documentation
The documentation web application is built during the default "deploy"
build.
It can be built quickly by using the following commands:
cd ${tomcat.source}
ant build-docs
The output of this command will be found
Apache-tomcat-8.0.53（Windows64位） （647个子文件） 
catalina.bat 16KB service.bat 7KB tool-wrapper.bat 4KB setclasspath.bat 3KB digest.bat 2KB configtest.bat 2KB version.bat 2KB startup.bat 2KB shutdown.bat 2KB Room.class 8KB ChatServlet.class 7KB CompressionResponseStream.class 6KB DrawMessage.class 6KB Clock2.class 6KB CompressionFilter.class 5KB CompressionServletResponseWrapper.class 5KB Snake.class 5KB AsyncStockServlet.class 5KB Client.class 5KB SessionExample.class 5KB CookieExample.class 4KB SnakeAnnotation.class 4KB JspCalendar.class 4KB DrawboardEndpoint.class 4KB Room$Player.class 4KB ChatAnnotation.class 4KB RequestHeaderExample.class 4KB SnakeTimer.class 3KB JspCalendar.class 3KB Stockticker.class 3KB RequestInfoExample.class 3KB RequestParamExample.class 3KB NumberWriter$NumberWriterListener.class 3KB SessionListener.class 3KB EchoAsyncAnnotation.class 3KB ByteCounter$CounterListener.class 3KB ChatServlet$MessageSender.class 3KB Async0.class 3KB ShowSource.class 3KB Stockticker$Stock.class 3KB TableBean.class 3KB DrawboardEndpoint$3$1.class 2KB ExamplesConfig.class 2KB ExampleFilter.class 2KB HelloWorldExample.class 2KB ContextListener.class 2KB ColorGameBean.class 2KB DrawboardEndpoint$1.class 2KB NumberGuessBean.class 2KB Async2$1.class 2KB ValuesTag.class 2KB CompressionFilterTestServlet.class 2KB Entries.class 2KB CookieFilter.class 2KB FooTag.class 2KB EchoAttributesTag.class 2KB EchoStreamAnnotation.class 2KB ByteCounter.class 2KB Async0$1.class 2KB EchoAnnotation.class 2KB Client$1.class 2KB Async1$1.class 2KB EchoAsyncAnnotation$CompletedFuture.class 2KB EchoEndpoint$EchoMessageHandlerBinary.class 2KB EchoEndpoint$EchoMessageHandlerText.class 2KB DrawboardEndpoint$2.class 2KB NumberWriter.class 2KB DummyCart.class 2KB Async1.class 2KB Async2.class 2KB DebugValidator.class 2KB ShuffleSimpleTag.class 1KB LogTag.class 1KB Room$MessageType.class 1KB ExampleTagBase.class 1KB ServletToJsp.class 1KB Location.class 1KB DrawboardEndpoint$3.class 1KB EchoEndpoint.class 1KB TileSimpleTag.class 1KB AsyncStockContextListener.class 1KB Functions.class 1KB FindBookSimpleTag.class 1KB Direction.class 1KB RepeatSimpleTag.class 1KB HTMLFilter.class 1KB Async3.class 1015B ValuesBean.class 983B Entry.class 911B Room$2.class 899B DrawboardContextListener.class 890B SnakeTimer$1.class 838B Location$1.class 813B HelloWorldSimpleTag.class 764B Room$1.class 747B BookBean.class 736B Room$1$1.class 725B DrawMessage$ParseException.class 688B FooTagExtraInfo.class 658B CheckTest.class 604B共 647 条
- 1
- 2
- 3
- 4
- 5
- 6
- 7
资源评论
