9:48 a.m.
Author: jfrederic.clere(a)jboss.com
Date: 2011-06-30 10:48:41 -0400 (Thu, 30 Jun 2011)
New Revision: 1753
Added:
trunk/webapps/docs/config/subsystem.xml
Log:
Add the general web system configuration description.
Added: trunk/webapps/docs/config/subsystem.xml
===================================================================
--- trunk/webapps/docs/config/subsystem.xml (rev 0)
+++ trunk/webapps/docs/config/subsystem.xml 2011-06-30 14:48:41 UTC (rev 1753)
@@ -0,0 +1,130 @@
+<?xml version="1.0"?>
+<!DOCTYPE document [
+ <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="host.html">
+
+ &project;
+
+ <properties>
+ <author email="jfclere(a)gmail.com">Jean-Frederic Clere</author>
+ <title>The WEB subsystem</title>
+ </properties>
+
+<body>
+
+
+<section name="Introduction">
+
+ <p>The <strong>subsystem=web</strong> describes how JBoss Web is
configured in AS7.</p>
+
+ <p>There should be only one <strong>jsp-configuration</strong>
element inside an
+ <a href="subsystem.html">subsystem=web</a> element.</p>
+
+</section>
+
+
+<section name="Attributes">
+
+ <subsection name="Common Attributes">
+
+ <p>The Web SubSystem supports the following attributes:</p>
+
+ <attributes>
+
+ <attribute name="configuration" required="false">
+ <p>That is the configuration of the JSP and Servlet containers.
+ The <code>configuration</code> is described below, there is only
one
+ <code>configuration</code> per subsystem.
+ </p>
+ </attribute>
+
+ <attribute name="connector" required="false">
+ <p>That is the description of the <code>connector</code>
element.
+ There could be more than one <code>connector</code> per subsystem.
+ See <a href="connector.html">connector</a> for more
information.
+ </p>
+ </attribute>
+
+ <attribute name="virtual-server" required="false">
+ <p>That is the description of the <code>virtual-server</code>
element.
+ There could be more than one <code>virtual-server</code> per
subsystem.
+ See <a href="host.html">virtual-server</a> for more
information.
+ </p>
+ </attribute>
+
+ <attribute name="default-virtual-server"
required="false">
+ <p>
+ Name of the default <code>virtual-server</code> to use.
+ </p>
+ </attribute>
+
+ <attribute name="native" required="false">
+ <p>
+ Native high performance should used if the libraries are installed.
+ The default value is <code>true</code>.
+ </p>
+ </attribute>
+ </attributes>
+ </subsection>
+</section>
+
+<section name="Nested Components">
+
+ <subsection name="configuration">
+
+ <p>The <code>configuration</code> of Web SubSystem supports the
following attributes:</p>
+
+ <attributes>
+ <attribute name="static-resources" required="false">
+ <p>A default service for all web applications, that serves static
resources.
+ There could be only one <code>static-resources</code> per
<code>configuration</code>.
+ </p>
+ </attribute>
+
+ <attribute name="jsp-configuration" required="false">
+ <p>Configuration of the JSP container.
+ There could be only one <code>jsp-configuration</code> per
<code>configuration</code>.
+ </p>
+ </attribute>
+
+ <attribute name="mime-mapping" required="false">
+ <p>That is the mapping of file extension to the Content-Type mime header.
+ Most of the current file extensions are already hard coded in the web subsystem,
you
+ only need to add a <code>mime-mapping</code> is you want to overwrite
the default mapping for
+ a file extension or add a new file extension to the mapping.
+ See below for more.
+ There could be more than one <code>mime-mapping</code> per
<code>configuration</code>.
+ </p>
+ </attribute>
+
+ <attribute name="welcome-file" required="false">
+ <p>Welcome files.
+ There could be more than one <code>welcome-file</code> per
<code>configuration</code>.
+ </p>
+ </attribute>
+ </attributes>
+ </subsection>
+
+ <subsection name="mime-mapping">
+ <p>The <code>mime-mapping</code> of
<code>configuration</code>Web SubSystem supports the following
attributes:</p>
+
+ <attributes>
+ <attribute name="name" required="true">
+ <p>File extension to map.
+ </p>
+ </attribute>
+
+ <attribute name="value" required="false">
+ <p>Value to use.
+ </p>
+ </attribute>
+ </attributes>
+ </subsection>
+</section>
+
+
+</body>
+
+
+</document>