    All Resources  All filters

# ConnectionProp

This resource provides editable access to the connectio properties defined by Jigsaw. As for the other property sheets, the resource just provides a nice way of describing a set of resources, and the way they should be edited, so each attribute below, really corresponds to a property defined in the property file of Jigsaw.

## Inherits

The ConnectionProp class inherits from the following classes:

- PropertySet (aka abstract class)

## Attributes description

The ConnectionProp defines the following attributes:

- w3c.jigsaw.keepAlive
- w3c.jigsaw.client.priority
- w3c.jigsaw.client.bufsize
- w3c.jigsaw.client.debug
- w3c.jigsaw.request.timeout
- w3c.jigsaw.http.ClientPool.minFree
- w3c.jigsaw.http.ClientPool.maxFree
- w3c.jigsaw.http.ClientPool.minIdle
- w3c.jigsaw.http.ClientPool.maxIdle
- w3c.jigsaw.http.ClientPool.maxThreads

`w3c.jigsaw.keepAlive`

semantics
  Should the server try to keep client connections alive. This boolean property, when true will make the server try to keep client connections alive, when possible.
  Client connections are candidate to be kept alive iff:

- The client has generated the appropriate headers,
- The server is configured to keep connections alive,
- The content length (if any) of the reply body is known,
- The target entity hasn't prohibited the use of keep-alive.

type
  This attribute is a computed BooleanAttribute
default value
  This attribute defaults to true.

`w3c.jigsaw.client.priority`

semantics
  This properties indicate the priority for client threads. Each client object is repsonsible for running a connection from its starting point (right after the accept) to its ending point (right before the connection is closed). For this duration, the client objects runs in its own thread of control, whose pririty can be indicated by this property.
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 5.

w3c.jigsaw.client.bufsize

semantics
  The size (in bytes) of the buffer to use to send back data to clients. This can improve/decrease the performance of your server; it should be at least big enough to hold small HTML documents (i.e., at least 4kb).
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 8192.

w3c.jigsaw.client.debug

semantics
  When set to true this property will make client objects emit some traces to the trace log while processing the request. This is usefull for debugging server-side entities.
type
  This attribute is a computed BooleanAttribute
default value
  This attribute defaults to false.

w3c.jigsaw.request.timeout

semantics
  What is the maximum duration of a request in the server? Once a request is received and parsed, and before it gets processed, the server starts a request timer. When this timer expires, the request is aborted. This property gives the number of milliseconds allowed for processing any request.
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 1200000 (or 20 minutes).

w3c.jigsaw.http.ClientPool.minFree

semantics
  The number of free (not working) client threads the server has to have in order to consider itself under very light load. When the server is running under that load, the server will keep connection opens as long as possible (with no time out).
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 5.

w3c.jigsaw.http.ClientPool.maxFree

semantics
  The number of free (not working) client threads the server has to have in order to go from the normal load state back into the light load state. The difference between that number and minFree avoids having the server yo-yoing from the light load state to the normal load state.
type
  This attribute is a computed IntegerAttribute
default value
  This attributes defaults to 10.

w3c.jigsaw.http.ClientPool.maxIdle

semantics
  The maximum number of idle client threads. An idle client thread is a thread waiting for the next request on a persistent connection. When the maxIdle number of idle client threads is reached, the server turns itself either into high load (if it still has free client threads), or dead load otherwise. Under normal load, the client pool will make sure to shutdown at least one persistent connection before accepting a new one. Under high load the server will start adjusting thread prorities (it will lower the accepting thread's priority under the normal client's thread priority, to give more CPU to client threads). On dead load, the server will reject incomming connections.
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 20.

w3c.jigsaw.http.ClientPool.maxThreads

semantics
  The maximum number of allowed threads, whatever happens. This is the number of threads the server will start with.
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 50.

Anselm Baird-Smith
$Id: w3c.jigsaw.http.ConnectionProp.html,v 1.1 1996/09/11 21:21:02 abaird Exp $