1600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/*
2600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Conditions Of Use
3600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
4600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* This software was developed by employees of the National Institute of
5600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Standards and Technology (NIST), an agency of the Federal Government.
6600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Pursuant to title 15 Untied States Code Section 105, works of NIST
7600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* employees are not subject to copyright protection in the United States
8600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* and are considered to be in the public domain.  As a result, a formal
9600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* license is not needed to use the software.
10600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
11600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* This software is provided by NIST as a service and is expressly
12600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
13600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
14600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
15600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* AND DATA ACCURACY.  NIST does not warrant or make any representations
16600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* regarding the use of the software or the results thereof, including but
17600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* not limited to the correctness, accuracy, reliability or usefulness of
18600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* the software.
19600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
20600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Permission to use this software is contingent upon your acceptance
21600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* of the terms of this agreement
22600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
23600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* .
24600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
25600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*/
26600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/*******************************************************************************
27600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Product of NIST/ITL Advanced Networking Technologies Division (ANTD).        *
28600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*******************************************************************************/
29600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpackage gov.nist.javax.sip.stack;
30600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport gov.nist.javax.sip.message.*;
31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/*
33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *  Salvador Rey Calatayud suggested adding a parameter to the processRequest/processResponse
34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *  methods.
35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */
36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/**
38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * An interface for a genereic message processor for SIP Response messages.
39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * This is implemented by the application. The stack calls the message
40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * factory with a pointer to the parsed structure to create one of these
41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * and then calls processResponse on the newly created SIPServerResponse
42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * It is the applications responsibility to take care of what needs to be
43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * done to actually process the response.
44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.4 $ $Date: 2009/07/17 18:58:15 $
46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan   <br/>
48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */
52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic interface ServerResponseInterface {
53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /**
54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * Process the Response.
55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @param  incomingChannel is the incoming message channel
56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @param sipResponse is the responseto process.
57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @param sipDialog -- dialog for this response
58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    public void processResponse(
60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        SIPResponse sipResponse,
61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        MessageChannel incomingChannel,
62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        SIPDialog sipDialog);
63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /**
68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * This method is called prior to dialog assignment.
69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @param sipResponse
70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @param incomingChannel
71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    public void processResponse(
73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang            SIPResponse sipResponse,
74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang            MessageChannel incomingChannel);
75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang}
79