XML DTD - jrun-web.dtd
Schema has:
 40 element definitions and 0 element attribute definitions.
Possible root elements: < jrun-web-app >

Element list

Element jrun-web-app
diagram element image
description The jrun-web-app element is the root element of the JRun web application deployment descriptor. It contains additional information used by JRun, but not specified in the web.xml file.
attributes
uses context-root  reload  compile  load-system-classes-first  session-config  ejb-ref  ejb-local-ref  resource-env-ref  resource-ref  virtual-mapping 
content a sequence of elements
occurrence required (default)

Element context-root
diagram element image
description The context-root element specifies the context root of the web application. If the web application is within an ear, the context-root element in application.xml should be used instead. The context-root defaults to the name of the directory or WAR file that contains the web application.

Used in: jrun-web-app

attributes
uses
content character data
occurrence

Element uri-character-encoding
diagram element image
description The uri-character-encoding element specifies the character encoding used for request uri's. If not supplied the default system character encoding will be used when decoding the uri.

Used in: jrun-web-app

attributes
uses
content character data
occurrence

Element reload
diagram element image
description The reload element specifies whether to automatically reload servlets, servlet helper classes, and JSP helper classes. This degrades performance but can be useful during development. Defaults to false.

Used in: jrun-web-app

attributes
uses
content character data
occurrence

Element compile
diagram element image
description The compile element specifies whether to automatically compile servlets, servlet helper classes, and JSP helper classes. This degrades performance but can be useful during development. Defaults to false.

Used in: jrun-web-app

attributes
uses
content character data
occurrence

Element load-system-classes-first
diagram element image
description The load-system-classes-first element specifies whether system classes should be loaded before enterprise and web application classes. The normal classloader delegation model is to load the system classes first. However, the servlet specification suggests that you load web application classes first. Defaults to true.

Used in: jrun-web-app

attributes
uses
content character data
occurrence

Element session-config
diagram element image
description The session-config element holds the servlet session config settings

Used in: jrun-web-app

attributes
uses persistence-config  replication-config  cookie-config 
content a sequence of elements
occurrence required (default)

Element persistence-config
diagram element image
description The persistence-config element holds the settings for persisting sessions when the server stops.

Used in: session-config

attributes
uses active  persistence-type  persistence-class  persistence-synchronized  session-swapping  session-swap-interval  session-max-resident  init-param 
content a sequence of elements
occurrence required (default)

Element active
diagram element image
description The active element indicates whether the given feature should be enabled. Defaults to true for persistence-config and cookie-config. Defaults to false for replication-config.

Used in: persistence-config, replication-config, cookie-config

attributes
uses
content character data
occurrence

Element persistence-type
diagram element image
description The persistence-type element specifies default session storage provider to use. The only valid values are 'file' or 'jdbc'. See the JRun documentation for more information on these included session storage providers. Defaults to 'file'.

Used in: persistence-config

attributes
uses
content character data
occurrence

Element persistence-class
diagram element image
description The persistence-class element specifies the class to be used as the session storage provider. This element should be used when the persistence-type is not specified. The class specified here must implement jrun.servlet.session.SessionStorage. Defaults to nothing- the persistence-type element is used by default.

Used in: persistence-config

attributes
uses
content character data
occurrence

Element persistence-synchronized
diagram element image
description The persistence-synchronized element specifies whether session persistence writing should be synchronized. This only matters when session-max-resident is 0. Defaults to true.

Used in: persistence-config

attributes
uses
content character data
occurrence

Element session-swapping
diagram element image
description The session-swapping element specifies if sessions should be swapped out of memory to a storage service. Defaults to false.

Used in: persistence-config

attributes
uses
content character data
occurrence

Element session-swap-interval
diagram element image
description The session-swap-interval element specifies if how often the session pool should be checked for sessions that should swapped to a storage service. This is specified in seconds. Defaults to 10.

Used in: persistence-config

attributes
uses
content character data
occurrence

Element session-max-resident
diagram element image
description The session-max-resident element specifies the approximate number of sessions that will be allowed in memory before swapping to a storage service. Due to delays in the session-swap-interval and sessions that may not be serializable, the actual maximum may differ. If 0, all session data will be written out immediately upon the completion of the request. session-swapping must be 'true' in order for this property to take effect. Defaults to 9999999.

Used in: persistence-config

attributes
uses
content character data
occurrence

Element init-param
diagram element image
description The init-param element specifies initilization parameters to pass to the session storage provider. See the JRun documentation for more information on init-params for the jdbc and file persistence-types.

Used in: persistence-config

attributes
uses param-name  param-value 
content a sequence of elements
occurrence required (default)

Element param-name
diagram element image
description The param-name element is the name of the parameter.

Used in: init-param

attributes
uses
content character data
occurrence

Element param-value
diagram element image
description The param-name element is the value of the parameter.

Used in: init-param

attributes
uses
content character data
occurrence

Element replication-config
diagram element image
description The replication-config element specifies the configuration of session replication, which allows for session failover. Session replication only works when clustering is enabled and all of the buddies specified are within the given cluster.

Used in: session-config

attributes
uses active  buddy-name 
content a sequence of elements
occurrence required (default)

Element buddy-name
diagram element image
description Specify a specific server within the cluster you wish to have local sessions replicated to.

Used in: replication-config

attributes
uses
content character data
occurrence

Element cookie-config
diagram element image
description The session-config element specifies settings for the cookies used for session tracking.

Used in: session-config

attributes
uses active  cookie-max-age  cookie-secure  cookie-domain  cookie-comment  cookie-path  cookie-name 
content a sequence of elements
occurrence required (default)

Element cookie-max-age
diagram element image
description Sets the maximum age of the cookie in seconds. A positive value indicates that the cookie will expire after that many seconds have passed. Note that the value is the maximum age when the cookie will expire, not the cookie's current age. A negative value means that the cookie is not stored persistently and will be deleted when the Web browser exits. A zero value causes the cookie to be deleted. The default value is -1.

Used in: cookie-config

attributes
uses
content character data
occurrence

Element cookie-secure
diagram element image
description Indicates to the browser whether the cookie should only be sent using a secure protocol, such as HTTPS or SSL. The default value is false.

Used in: cookie-config

attributes
uses
content character data
occurrence

Element cookie-domain
diagram element image
description Sets the domain within which this cookie should be presented. The form of the domain name is specified by RFC 2109. A domain name begins with a dot (.foo.com) and means that the cookie is visible to servers in a specified Domain Name System (DNS) zone (for example, www.foo.com, but not a.b.foo.com). By default, cookies are only returned to the server that sent them.

Used in: cookie-config

attributes
uses
content character data
occurrence

Element cookie-comment
diagram element image
description Specifies a comment that describes a cookie's purpose. The comment is useful if the web browser presents the cookie to the user. Comments are not supported by Netscape Version 0 cookies.

Used in: cookie-config

attributes
uses
content character data
occurrence

Element cookie-path
diagram element image
description Sets a path to which the client should return the cookie. The cookie is visible to all the pages in the directory you specify, and all the pages in that directory's subdirectories. A cookie's path must include the servlet that set the cookie, for example, /catalog, which makes the cookie visible to all directories on the server under /catalog. The default is "/".

Used in: cookie-config

attributes
uses
content character data
occurrence

Element cookie-name
diagram element image
description Sets the session cookie name. The name must conform to RFC 2109. That means it can contain only ASCII alphanumeric characters and cannot contain commas, semicolons, or white space, or begin with a $ character. The default value is "jsessionid".

Used in: cookie-config

attributes
uses
content character data
occurrence

Element ejb-ref
diagram element image
description The ejb-ref element describes a mapping between the ejb-ref-name that the bean developer provides and its JNDI name. The deployer supplies the actual JNDI name.

Used in: jrun-web-app

attributes
uses ejb-ref-name  jndi-name 
content a sequence of elements
occurrence required (default)

Element ejb-ref-name
diagram element image
description The ejb-ref-name element gives the name of an EJB from the web application context. The bean developer provides this information.

Used in: ejb-ref, ejb-local-ref

attributes
uses
content character data
occurrence

Element ejb-local-ref
diagram element image
description The ejb local ref element describes a mapping between the ejb-ref-name that the bean developer and its JNDI name. The deployer supplies the actual JNDI name.

Used in: jrun-web-app

attributes
uses ejb-ref-name  jndi-name 
content a sequence of elements
occurrence required (default)

Element resource-ref
diagram element image
description The resource-ref element describes a mapping between the resource name that the bean developer provides and its JNDI name. The deployer supplies the actual JNDI name.

Used in: jrun-web-app

attributes
uses res-ref-name  jndi-name  user  password 
content a sequence of elements
occurrence required (default)

Element res-ref-name
diagram element image
description The res-ref-name element gives the name of a resource from EJB view. The bean developer provides this information.

Used in: resource-ref

attributes
uses
content character data
occurrence

Element jndi-name
diagram element image
description The jndi-name element gives the JNDI name where the bean or resource will be bound.

Used in: resource-ref, resource-env-ref

attributes
uses
content character data
occurrence

Element user
diagram element image
description The user element assigns user identity to be used with a specified resource.
attributes
uses
content character data
occurrence

Element password
diagram element image
description The password element provides user credentials to be used with the user element to identify and authenticate specified resource.
attributes
uses
content character data
occurrence

Element resource-env-ref
diagram element image
description The resource-env-ref element describes a mapping between the resource-env-name that the bean developer provides and its JNDI name. The deployer supplies the actual JNDI name.

Used in: session, entity, message-driven

attributes
uses resource-env-ref-name  jndi-name 
content a sequence of elements
occurrence required (default)

Element resource-env-ref-name
diagram element image
description The resource-env-ref-name element gives the name of a managed object from EJB view. The bean developer provides this information.

Used in: resource-env-ref

attributes
uses
content character data
occurrence

Element virtual-mapping
diagram element image
description The virtual-mapping element allows a virtual path to be mapped to a system directory.

Used in: jrun-web-app

attributes
uses resource-path  system-path 
content a sequence of elements
occurrence required (default)

Element resource-path
diagram element image
description The resource-path element specifies a relative resource path. This may include a global path (*) or a path that ends with a wildcard (*).

Used in: virtual-mapping

attributes
uses
content character data
occurrence

Element system-path
diagram element image
description The system-path element specifies an absolute system path.

Used in: virtual-mapping

attributes
uses
content character data
occurrence