APPLICATION (for a service)
This APPLICATION
element defines a service within the Genero Application Server configuration file or in an
external application configuration file.
Note:
Since Genero 2.0, Web services are named applications as they host several Web services in one DVM.
Syntax
<APPLICATION [
Id="app-name"]
Parent="parent-app-name"
xmlns:xsi="uri"
xsi:noNamespaceSchemaLocation="schema"
[
Abstract="{
TRUE|
FALSE}
"]
[
mode="mode-name"]
>
[
<DESCRIPTION>...</DESCRIPTION>]
[
<RESOURCE>...</RESOURCE>]
[...]
[
<PROXY>...</PROXY>]
[
<EXECUTION>...</EXECUTION>]
[
<TIMEOUT>...</TIMEOUT>]
</APPLICATION>
- The app-name attribute identifies the application.
The
Id
attribute is required for applications defined within the Genero Application Server configuration file. For external configuration files, theId
attribute is ignored. TheId
specified is compared to the application name in the request. - The parent-app-name attribute identifies the parent application, or the application from which this application will inherit its default configuration settings.
- The uri defines the URL of the XML schema. The default value is "http://www.w3.org/2001/XMLSchema-instance".
- The schema defines the XML schema instance. When defining external application files, the valid value for a Web service is "http://www.4js.com/ns/gas/version/cfextws.xsd"
- The
Abstract
attribute defines whether this application configuration element is for an abstract application or a real application. Valid values are "TRUE" and "FALSE". An abstract application acts as a template and can not instantiate Virtual Machines. - The mode-name attribute when set to "sticky", defines a web service as a sticky web service.
Child elements
When you define a Web service application, you can specify the following elements:
- Zero or one DESCRIPTION element.
- Zero or more RESOURCE elements.
- Zero or one PROXY (for a service) element
- Zero or one EXECUTION element.
- Zero or more TIMEOUT elements.
Usage
You use this element to configure Web services you wish to make accessible through the GAS.
Example usage
<APPLICATION Id="webapp" Parent="ws.abswebapp">
<EXECUTION>
<PATH>$(res.path.fgldir.demo)</PATH>
<MODULE>webapp.42r</MODULE>
</EXECUTION>
<TIMEOUT> </TIMEOUT>
</APPLICATION>
Parent elements
When used in an application configuration file (.xcf), it is the top-most element. When used in the GAS configuration file, this element is a child of the SERVICE_LIST element.