01: package com.meterware.servletunit;
02:
03: /********************************************************************************************************************
04: * $Id: InvocationContextFactory.java,v 1.7 2004/09/09 00:16:40 russgold Exp $
05: *
06: * Copyright (c) 2001-2004, Russell Gold
07: *
08: * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
09: * documentation files (the "Software"), to deal in the Software without restriction, including without limitation
10: * the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
11: * to permit persons to whom the Software is furnished to do so, subject to the following conditions:
12: *
13: * The above copyright notice and this permission notice shall be included in all copies or substantial portions
14: * of the Software.
15: *
16: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
17: * THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18: * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
19: * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20: * DEALINGS IN THE SOFTWARE.
21: *
22: *******************************************************************************************************************/
23: import com.meterware.httpunit.WebRequest;
24: import com.meterware.httpunit.FrameSelector;
25:
26: import javax.servlet.http.HttpSession;
27: import java.io.IOException;
28: import java.net.MalformedURLException;
29: import java.util.Dictionary;
30:
31: /**
32: * An interface for an object which acts as a factory of InvocationContexts
33: *
34: * @author <a href="mailto:russgold@httpunit.org">Russell Gold</a>
35: **/
36: public interface InvocationContextFactory {
37:
38: /**
39: * Creates and returns a new invocation context to test calling of servlet methods.
40: **/
41: public InvocationContext newInvocation(ServletUnitClient client,
42: FrameSelector targetFrame, WebRequest request,
43: Dictionary clientHeaders, byte[] messageBody)
44: throws IOException, MalformedURLException;
45:
46: /**
47: * Returns the session with the specified ID; if none exists or the session is invalid, will create a new session if the create flag is true.
48: */
49: public HttpSession getSession(String sessionId, boolean create);
50: }
|