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 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 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 when set to "sticky", defines a Web service as a sticky Web service. See Configure sticky Web services.
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.