Retired Document
Important: This document may not represent best practices for current development. Links to downloads and other resources may no longer be valid.
Application Properties
This chapter describes the properties you can configure when launching a WebObjects application.
The application properties are described in Table 1. Note that some properties are for deployment, and others are for development only. Some properties are specific to certain types of WebObjects applications—for example, Direct to Web applications. Most properties correspond to a method in one of the WebObjects frameworks. See the property description for links to the related reference document.
There are several ways to set these properties. You can specify these arguments on the command line using Java-style command-line arguments with the following format:
<appName> -D<optionName>=<value> -D<optionName>=<value> ... |
For example, you set the WOAllowsConcurrentRequestHandling
property to true
as follows:
./myApp -DWOAllowsConcurrentRequestHandling=true |
You can also specify these properties in the application’s Properties
file. The Properties
file is located in the Contents/Resources
directory of an application folder. See the API reference for NSProperties
in WebObjects 5.3 Reference to learn more about property specifications in WebObjects.
Read WebObjects Deployment Guide Using JavaMonitor for how to set some of these properties using deployment tools.
Property | Type | Description |
---|---|---|
| boolean | A Boolean value that determines whether or not rule firing should be logged. Set to |
| boolean | A Boolean value that determines whether or not rule modifications should be logged. Set to |
| boolean | A Boolean value that determines whether or not SQL sent by an application’s |
| boolean | A Boolean value that determines whether or not the |
| boolean | A Boolean value that determines whether or not to launch the Direct to Java Client Assistant for Direct to Java Client applications. Set to |
| integer | The limit of the event logging stack. See the EOEventCenter class reference for details. |
| boolean | A Boolean value that determines whether or not event data should be logged when the event log limit is exceeded. Set to |
| string | The password that allows access to event logging data. See the EOEventCenter class reference for details. |
| string | The currency symbol to use in the application. See the currencySymbol method of |
| string or bit position | Indicates the debugging groups to enable. Groups are used to track individual issues. See the NSLog class reference for details. |
| integer or string | Represents the debug logging level. See the NSLog class reference for details. |
| array | An array of strings representing file system paths in which to look for projects for rapid turnaround mode. This property is not used by Xcode. See the projectSearchPath method of |
| boolean | A Boolean value that determines whether or not the XML parser performs validation while deserializing an XML document. Set to |
| boolean | A Boolean value that determines whether or not to control what happens when a malformed cookie is received in a request. Set to |
| string | The class name of the application’s primary adaptor. See the adaptor method of |
| array | An array of dictionaries representing the class names of the application’s additional adaptors. See the additionalAdaptors method of |
| boolean | A Boolean value that determines whether or not client-side page caching is on. Set to |
| boolean | A Boolean value that determines whether or not concurrent request handling is on. Set to |
| boolean | A Boolean value that determines whether or not rapid turnaround mode is on. Set to |
| string | A path indicating the location of the WebObjects application under the document root, not including the application name. See the applicationBaseURL method of |
| string | The WebObjects application name. The default value is the name of the executable file without any extensions. See the name method of This property is used by the HTTP adaptor to implement load balancing. The adaptor can load-balance only between instances with the same application name. This setting can be used to create groups of instances, even when the instances share the same executable file. This argument is set automatically for instances started by wotaskd. |
| boolean | A Boolean value that determines whether or not the application is automatically opened in a browser window. Set to |
| boolean | A Boolean value that determines whether or not the client-side application is automatically launched in a three-tier Java Client application. Set to |
| string | The URL for the web server including the path to the WebObjects CGI adaptor. See the cgiAdaptorURL method in |
| boolean | A Boolean value that determines whether or not component definition caching is enabled—whether or not a component’s |
| string | The class name of the application’s context class. See the contextClassName method of |
| boolean | A Boolean value that determines whether or not debug logging is enabled. Set to |
| integer | The default undo stack limit for the application’s sessions. See the defaultUndoStackLimit method of |
| string | The class name of the application’s direct action request handler. See the directActionRequestHandlerKey method of |
| boolean | A Boolean value that determines whether or not direct connect mode is enabled—whether or not a host name and port number can be used to connect from a browser to the application. Set to |
| boolean | A Boolean value that determines whether or not the generation of |
| boolean | A Boolean value that determines whether or not event logging in the application server is enabled. Set to |
| string | The URLs of the frameworks to use when generating URLs for web server resources. See the frameworksBaseURL method of |
| boolean | A Boolean value that determines whether or not to allow the generation of WSDL files in a web services application. Set to |
| string | The name of the host on which the application is running or, in a multihomed environment, the address of the adaptor the application should use. See the host method of |
| boolean | A Boolean value that determines whether or not HTML comments are included in the application’s responses. Set to |
| integer | The port to which lifebeat signals are sent. The default value is |
| boolean | A Boolean value that determines whether or not the application instance sends lifebeats. Set to |
| integer | The interval (in seconds) between lifebeats. The default value is |
| integer | The size of the application adaptor’s listen queue. See the listenQueueSize method of |
| integer | The maximum buffer size used when reading requests. A buffer larger than this value is truncated after the current request has finished processing. The default value is |
| integer | The maximum number of headers in a single request. The default value is |
| integer | The number of milliseconds for which a socket should be allowed to wait on incoming data. See the maxSocketIdleTime method of |
| boolean | A Boolean value that determines whether or not an application’s resource list is refreshed every time a resource cannot be found. Set to |
| boolean | A Boolean value that determines whether or not the application is started by JavaMonitor. Set to |
| string | A file system path indicating the location of logs. The default value is |
| integer | The port on which the application’s primary adaptor listens. The default value is |
| string | A file system path indicating the location of recording files. See the recordingPath method of |
| string | The name of the mail server used to send messages created by |
| string | The name of the class used to store sessions. See the sessionStoreClassName method of |
| integer | The number of seconds for which a session may be idle before it times out. The default value |
| string | The password that allows access to the application statistics—the password used to access the statistics page of an application instance. See the setPassword method of |
| boolean | A Boolean value that determines whether or not the Web Services Assistant in a Direct to Web Services application is launched. Set to |
Copyright © 2007 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2007-07-11