This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push:
new 16b0320db5 Re-draw first of six sequence diagrams showing how Tomcat
starts.
16b0320db5 is described below
commit 16b0320db55d3c50a9d09d3034a77b358ca633cd
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Fri Jul 5 17:08:41 2024 +0100
Re-draw first of six sequence diagrams showing how Tomcat starts.
---
webapps/docs/architecture/startup.xml | 40 ++++++++++++++++++++---
webapps/docs/architecture/startup/1_overview.png | Bin 0 -> 74703 bytes
webapps/docs/architecture/startup/1_overview.vpd | 1 +
3 files changed, 37 insertions(+), 4 deletions(-)
diff --git a/webapps/docs/architecture/startup.xml
b/webapps/docs/architecture/startup.xml
index 3f821b6ce9..5fbcfc57e5 100644
--- a/webapps/docs/architecture/startup.xml
+++ b/webapps/docs/architecture/startup.xml
@@ -44,15 +44,47 @@ different ways to start tomcat, including:
<subsection name="description">
<p>
-A text description of the startup procedure is available
-<a href="startup/serverStartup.txt">here.</a>
+A <a href="startup/serverStartup.txt">text description</a> of the startup
+procedure created for Tomcat 5. The updated version of this description for
+Tomcat 11 will be included in the updated diagrams and diagram descriptions in
+the following section. This text file will be removed when that update is
+complete.
</p>
</subsection>
<subsection name="diagram">
<p>
-A UML sequence diagram of the startup procedure is available
-<a href="startup/serverStartup.pdf">here.</a>
+The <a href="startup/serverStartup.pdf">UML sequence diagram</a> of the startup
+procedure created for Tomcat 5 is gradually being replaced with updated
diagrams
+based on Tomcat 11. The scope of these diagrams may be adjusted as they are
+produced.
+</p>
+<p>
+A series of UML diagrams have been created to document the start-up process for
+Tomcat.
+</p>
+<p>
+<a href="startup/1_overview.png">Diagram 1</a> shows an overview of how Tomcat
+start, serves requests and then stops. Once the class loaders have been
+initialized, Tomcat parses server.xml using the Digester and the Digester
+creates the objects defined in server.xml, configures them using the property
+values defined in server.xml and the starts the Server. The main Java thread
+waits in the await() method for a shutdown signal. Once a shutdown signal is
+received, the Server object is stopped and then destroyed. The JVM then exits.
+</p>
+<p>
+Diagram 2 will show how the Server initialises the Connectors and associated
+objects.
+</p>
+<p>
+Diagram 3 will show how the Server initialises the Service(s), Engine(s) and
+Host(s).
+</p>
+<p>
+Diagram 4 will show how the Host initialises the Context(s).
+</p>
+<p>
+Diagram 5 will show how the Context initialises the Filters, Servlets etc.
</p>
</subsection>
diff --git a/webapps/docs/architecture/startup/1_overview.png
b/webapps/docs/architecture/startup/1_overview.png
new file mode 100644
index 0000000000..2c130168b5
Binary files /dev/null and b/webapps/docs/architecture/startup/1_overview.png
differ
diff --git a/webapps/docs/architecture/startup/1_overview.vpd
b/webapps/docs/architecture/startup/1_overview.vpd
new file mode 100644
index 0000000000..083325348d
--- /dev/null
+++ b/webapps/docs/architecture/startup/1_overview.vpd
@@ -0,0 +1 @@
+3cU2FsddGVkX1m8qyJvCmbQ45f5RMzVMYxS+OtBawSwaWtA+PrPB8=s8NGgRx5nMKgY1hQkLc0l2LqiRpcpyinKZfwCUAmEsVcSLNFuH41WXSWmfwnQj2rNkpFe+9indI4MBZ+ZTqmw77I7quY0lY66s5NyEMhYH9u58cKn1lzd6iVlqs1zLuJDgmAF1WnTxq8gGd1K1Pq9VMw2BP+WOPhft772ekgv4xlGJOP9n3X6KEf+mYHbfTXZnJK4coOLJ3jadjmJdm2MtRjTIwtvnUejTmVgB1mCAIcL+EiVJAGHcz9GrNzrXakwzwv/xOsw8oWCtR+vUCra1+DARJzEew55xQb/yJDbYT86T7SSkPncaxectV6UdziYNW/Y50w0Pf4WBdWJbfKenqUbcC2JtnE0bmbxNnqu00Py1/gLYaWkVO7vH3doj4De0GCT/eSU9MNHmnaj2hHOIyg4knr6+w0antzbaB5wgrAjb2KQZy3Wv
[...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
