Proxy

The Proxy interface represents the operation of proxying a SIP request in SIP servlet applications. To control how the proxying is carried out it uses a number of parameters: 

• The addToPath parameter determines whether the application adds a Path header to REGISTER requests, with a default value of false.
• The recurse parameter specifies whether the proxy automatically recurses to the next target on failure, and its default is true. 
• The recordRoute parameter controls whether the proxy includes a Record-Route header to ensure subsequent requests in the same dialog traverse the proxy, defaulting to false.
• The parallel parameter determines if the proxy operates in parallel (sending requests to multiple destinations simultaneously) or sequentially (trying one destination at a time), with the default set to true.
• The stateful parameter ensures that the proxy remains transaction stateful throughout the operation, providing reliability and consistency, with a default value of true.
• The supervised parameter specifies whether the application will be invoked for incoming responses related to the proxying operation and defaults to false.
• The proxyTimeout parameter sets the general timeout for the proxy operation, applying to both parallel and sequential proxying. In parallel proxying, it defines the maximum wait time for all branches before sending the best final response upstream, while in sequential proxying, it replaces the deprecated sequentialSearchTimeout parameter.
• The sequentialSearchTimeout, though deprecated, determines the time to wait for a final response from a branch before canceling and trying the next destination. 

These parameters collectively allow applications to customize key aspects of proxying, including failure handling, transaction state management, and routing behavior.