@jws:conversation-lifetime Tag

Specifies the maximum age and/or the maximum idle time for a service's conversations.

# Syntax

    @jws:conversation-lifetime
    	[maxIdleTime="duration"]
    	[maxAge="duration"]

# Attributes

maxIdleTime

The amount of time that the conversation may remain idle before it is finished by WebLogic Server. Note that only activity between a web service and its client will reset the idle timer; activity between a web service and controls does not reset the idle timer.

Default: 0 seconds. Conversations with 0-length idle timeout will never timeout due to inactivity.

maxAge

The amount of time (since it started) that the conversation may remain active before it is finished by WebLogic Server. Default: 1 day (24 hours).

# Remarks

Use the conversation-lifetime tag to set initial values for maximum idle time and maximum age.

Assign values in the form of expressions of time: "2 minutes," "5 days," and so on.

You may also set values for this tag using the conversation-lifetime property in the Properties pane.

This tag must precede any method or class declarations in the JWS file.

You may also set these values using the setMaxIdleTime and setMaxAge methods of the JwsContext interface. See JwsContext Interface.

The idle timer may be reset using the resetIdleTime method of the JwsContext interface.

When a conversation is terminated due to expiration of the idle time or maximum age, the conversation termination never occurs during the execution of a web service method. The conversation will actually terminate after completion of the method that is executing when the conversation is terminated.

When a conversation is terminated, the optional JwsContext onFinish callback is invoked. You may implement a handler for this callback to receive notification of conversation expiration. See JwsContext Interface.

Related Topics

@jws:conversation Tag

Managing Conversation Lifetime

JwsContext Interface