JBoss, Home of Professional Open Source Copyright 2005, JBoss Inc., and
individual contributors as indicated by the @authors tag. See the copyright.txt in the
distribution for a full listing of individual contributors. This is free software; you can
redistribute it and/or modify it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the License, or (at your
option) any later version. This software is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should
have received a copy of the GNU Lesser General Public License along with this software; if
not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
02110-1301 USA, or see the FSF site: http://www.fsf.org.
...
Instance documents may indicate the published version of
the schema using the xsi:schemaLocation attribute for the
Java EE namespace with the following location:
http://www.jboss.org/j2ee/schema/jboss-web_5_1.xsd
]]>
The following conventions apply to all Java EE deployment descriptor
elements unless indicated otherwise. - In elements that specify a pathname to a file within
the same JAR file, relative filenames (i.e., those not starting with "/") are considered
relative to the root of the JAR file's namespace. Absolute filenames (i.e., those starting
with "/") also specify names in the root of the JAR file's namespace. In general, relative
names are preferred. The exception is .war files where absolute names are preferred for
consistency with the Servlet API.
This is the root element of jboss-web deployment descriptor.
The jboss-web element is the root element of jboss-web.xml file. It contains
all the information used by jboss but not described in the web.xml file. All of it is optional.
...
]]>
The java2ClassLoadingCompliance attribute indicates if the normal Java2
parent first class loading model should be used over the servlet 2.3 web
container first model.
(JBAS-1824) The jacc-star-role-allow element specifies whether the
jacc permission generating agent in the web layer needs to generate a
WebResourcePermission(url,null) permission such that the jacc provider can
make a decision as to bypass authorization or not.
The context-root element specifies the context root of a web
application. This is normally specified at the ear level using the standard
J2EE application.xml descriptor, but it may be given here for standalone wars.
This should not override the application.xml level specification.
www.jboss-store.org
]]>
true
]]>
SET_AND_GET
or
SET_AND_NON_PRIMITIVE_GET
or
SET
]]>
SESSION
or
ATTRIBUTE
or
FIELD
]]>
TRUE
or
FALSE
]]>
...
Default value if not explicitly set is the overall web container default
as set in the deployers/jbossweb.deployer service. By default that is set
to "false".
]]>
SESSION, the session's
attribute map is replicated along with the metadata, so it can be fairly
costly. With other granularities, the metadata object is replicated
separately from the attributes and only contains a String, and a few longs,
ints and booleans.
A value of 0 means the metadata will be replicated whenever the session is
accessed. A value of -1 means the metadata will be replicated only if some
other activity during the request (e.g. modifying an attribute) has
resulted in other replication work involving the session. A positive value
greater than the HttpSession.getMaxInactiveInterval() value will be treated
as a likely misconfiguration and converted to 0; i.e. replicate the
metadata on every request.
]]>
The run-as-principal element specifies whether a specific run-as identity is
to be used. If there is a run-as role defined for a servlet, there can also
be a run-as-principal defined here. If you don't define a run-as principal
the callee will see ctx.getUserPrincipal() == 'anonymous'
30 (seconds)
]]>
300 (seconds)
]]>
true
or
false (default value)
]]>