| Server-side object | |
| Implemented in | LiveWire 1.0 |
Created by
The JavaScript runtime engine on the server automatically creates a single server object to store information common to all JavaScript applications running on the web server.
Description
The JavaScript runtime engine on the server creates a server object when the server starts and destroys it when the server stops. Every application on a server shares the same server object. Use the server object to maintain global data for the entire server. Many applications can run on a server simultaneously, and the server object lets them share information.
The runtime engine creates a server object for each distinct Netscape HTTPD process running on the server.
The properties listed below are read-only properties that are initialized automatically when a server object is created. These properties provide information about the server process. In addition to these predefined properties, you can create custom properties.
You can lock the server object to ensure that different applications do not change its properties simultaneously. When one application locks the server object, other applications must wait before they can lock it.
Property Summary
| Obtains the lock. |
| Releases the lock. |
Examples
The following example displays the values of the predefined server object properties:
<P>server.host = <SERVER>write(server.host);</SERVER>
The preceding code displays information such as the following:
<BR>server.hostname = <SERVER>write(server.hostname);</SERVER>
<BR>server.protocol = <SERVER>write(server.protocol);</SERVER>
<BR>server.port = <SERVER>write(server.port);</SERVER>server.host = www.myWorld.com
server.hostname = www.myWorld.com:85
server.protocol = http:
server.port = 85 See also
client, project, request
Properties
host
A string specifying the server name, subdomain, and domain name.
| Property of |
server
|
| Read-only | |
| Implemented in | LiveWire 1.0 |
Description
The host property specifies a portion of a URL. The host property is a substring of the hostname property. The hostname property is the concatenation of the host and port properties, separated by a colon. When the port property is 80 (the default), the host property is the same as the hostname property.
See Section 3.1 of RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) for complete information about the hostname and port.
See also
server.hostname, server.port, server.protocol
hostname
A string containing the full hostname of the server, including the server name, subdomain, domain, and port number.
| Property of |
server
|
| Read-only | |
| Implemented in | LiveWire 1.0 |
Description
The hostname property specifies a portion of a URL. The hostname property is the concatenation of the host and port properties, separated by a colon. When the port property is 80 (the default), the host property is the same as the hostname property.
See Section 3.1 of RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) for complete information about the hostname and port.
See also
server.host, server.port, server.protocol
port
A string indicating the port number used for the server.
| Property of |
server
|
| Read-only | |
| Implemented in | LiveWire 1.0 |
Description
The port property specifies a portion of the URL. The port property is a substring of the hostname property. The hostname property is the concatenation of the host and port properties, separated by a colon.
The default value of the port property is 80. When the port property is set to the default, the values of the host and hostname properties are the same.
See Section 3.1 of RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) for complete information about the port.
See also
server.host, server.hostname, server.protocol
protocol
A string indicating the communication protocol used by the server.
| Property of |
server
|
| Read-only | |
| Implemented in | LiveWire 1.0 |
Description
The protocol property specifies the beginning of the URL, up to and including the first colon. The protocol indicates the access method of the URL. For example, a protocol of "http:" specifies HyperText Transfer Protocol.
The protocol property represents the scheme name of the URL. See Section 2.1 of RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) for complete information about the protocol.
See also
server.host, server.hostname, server.port
Methods
lock
Obtains the lock. If another thread has the lock, this method waits until it can get the lock.
| Method of |
server
|
| Implemented in | LiveWire 1.0 |
Syntax
lock()
Parameters
None
Returns
Nothing.
Description
You can obtain a lock for an object to ensure that different clients do not access a critical section of code simultaneously. When an application locks an object, other client requests must wait before they can lock the object.
Note that this mechanism requires voluntary compliance by asking for the lock in the first place.
See also
Lock, server.lock
| Method of |
server
|
| Implemented in | LiveWire 1.0 |
Syntax
unlock()
Parameters
None.
Returns
False if it fails; otherwise, true. Failure indicates an internal JavaScript error or that you attempted to unlock a lock that you don't own.
Description
If you unlock a lock that is unlocked, the resulting behavior is undefined.
See also
Lock, server.unlock
Last Updated: 10/31/97 12:33:29