1 /* 2 * Copyright (c) 2002, 2005 Gargoyle Software Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are met: 6 * 7 * 1. Redistributions of source code must retain the above copyright notice, 8 * this list of conditions and the following disclaimer. 9 * 2. Redistributions in binary form must reproduce the above copyright notice, 10 * this list of conditions and the following disclaimer in the documentation 11 * and/or other materials provided with the distribution. 12 * 3. The end-user documentation included with the redistribution, if any, must 13 * include the following acknowledgment: 14 * 15 * "This product includes software developed by Gargoyle Software Inc. 16 * (http://www.GargoyleSoftware.com/)." 17 * 18 * Alternately, this acknowledgment may appear in the software itself, if 19 * and wherever such third-party acknowledgments normally appear. 20 * 4. The name "Gargoyle Software" must not be used to endorse or promote 21 * products derived from this software without prior written permission. 22 * For written permission, please contact info@GargoyleSoftware.com. 23 * 5. Products derived from this software may not be called "HtmlUnit", nor may 24 * "HtmlUnit" appear in their name, without prior written permission of 25 * Gargoyle Software Inc. 26 * 27 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, 28 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 29 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GARGOYLE 30 * SOFTWARE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 31 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 32 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 33 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 34 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 35 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 36 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 37 */ 38 package com.gargoylesoftware.htmlunit; 39 40 import java.io.IOException; 41 42 /** 43 * An abstract page that represents some content returned from a server 44 * 45 * @version $Revision: 100 $ 46 * @author <a HREF="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a> 47 * @author David K. Taylor 48 */ 49 public interface Page { 50 51 /** 52 * Initialize this page. 53 * @throws IOException If an IO problem occurs. 54 */ 55 void initialize() throws IOException; 56 57 /** 58 * Clean up this page. 59 * @throws IOException If an IO problem occurs. 60 */ 61 void cleanUp() throws IOException; 62 63 64 /** 65 * Return the web response that was originally used to create this page. 66 * 67 * @return The web response 68 */ 69 WebResponse getWebResponse(); 70 71 72 /** 73 * Return the window that this page is sitting inside. 74 * 75 * @return The enclosing frame or null if this page isn't inside a frame. 76 */ 77 WebWindow getEnclosingWindow(); 78 } 79 80