HttpUnit

Installation

nekohtml.jar

The NekoHTML parser, used to convert raw HTML into an XML DOM. This is required for handling HTML.

js.jar

The Rhino JavaScript interpreter, required for any JavaScript processing.

xmlParserAPIs.jar

The interfaces for a W3-compliant XML parser. Required for interpreting either HTML or XML pages.

xercesImpl.jar

The Xerces 2 implementation of an XML parser. NekoHTML requires this implementation.

servlet.jar

The APIs and common classes for the Java Servlet 1.3 standard. Required for use with ServletUnit.

junit.jar

JUnit, the unit test framework. Used to test HttpUnit and recommended for writing tests that use HttpUnit.

tidy.jar

JTidy, an alternate HTML parser/validator. JTidy is a lot pickier about HTML structure than NekoHTML, and uses its own implementation of the DOM classes, rather than using those found in the xerces jar. Some JavaScript features, such as document.write() will only work with NekoHTML.

Example

import com.meterware.httpunit.*;

import java.io.IOException;
import java.net.MalformedURLException;

import org.xml.sax.*;

public class Example {


    public static void main( String[] params ) {
        try {
            WebConversation     conversation = new WebConversation();
            
            WebResponse response = conversation.getResponse( "http://www.meterware.com/servlet/TopSecret" );
            System.out.println( response );

            WebForm loginForm = response.getForms()[0];

            loginForm.setParameter( "name", "master" );
            response = loginForm.submit();
            System.out.println( response );

        } catch (Exception e) {
            System.err.println( "Exception: " + e );
        }
    }
}

Classes to support cookie handling. Supports the HTTP state mechanism. The central class of this package is the {@link com.meterware.httpunit.cookies.CookieJar}, which acts as a repository of {@link com.meterware.httpunit.cookies.Cookie} objects. There are two main ways to get cookies into the CookieJar. The first is to construct the CookieJar, passing a {@link com.meterware.httpunit.cookies.CookieSource} to its constructor. This will cause the CookieJar to parse the Set-Cookie headers from the source object. The second is to copy them from another CookieJar through use of the {@link com.meterware.httpunit.cookies.CookieJar#updateCookies updateCookies(CookieJar)} method.

The CookieJar can also produce a Cookie header to be sent as part of a request. The {@link com.meterware.httpunit.cookies.CookieJar#getCookieHeaderField} method will select any cookies that it has which can be sent to the specified URL and assemble them into an appropriate header.

Classes to control HTML parsing. The primary access to this package is through {@link com.meterware.httpunit.parsing.HTMLParserFactory}, which allows a user to select the HTML parser that will be used to parse HTML pages returned by a {@link com.meterware.httpunit.WebClient}. In addition to selecting the actual class, the factory also permits various options to be set on whichever parser is chosen - with the caveat that not every parser supports every property. If the current parser does not in fact support a property, setting it on the factory will have no effect.