Removed xercesImpl.jar, updated site, added tests to sample tree

Author: Jim Weaver

jWebUnit/doc/css/jwebunit.css

@@ -12,4 +12,6 @@ h2 {color: #3333ff;
     text-align: left;}
 
 .default {font-family: Helvetica, Arial, sans-serif; font-size: 10pt;}
+.blueText {font-family: Helvetica, Arial, sans-serif; font-size: 10pt; color: #3333ff;}
+.smallCode {font-family: sans-serif; font-size: 8pt; background-color: #CCCCCC;}
 

jWebUnit/doc/index.html

@@ -33,13 +33,75 @@ <h2>What is jWebUnit?</h2>
 <br>
 <br>
     <h2>What does jWebUnit provide?</h2>
-jWebUnit provides a high-level API for navigating a web application, and a set
+jWebUnit provides a high-level API for navigating a web application combined with a set
 of assertions to verify the application's correctness. This includes navigation
 via links, form entry and submission, validation of table contents, and other
-typical business web application features. This code is using HttpUnit behind
+typical business web application features. This code utilizes HttpUnit behind
 the scenes. The simple navigation methods and ready-to-use assertions allow for
 more rapid test creation than using only JUnit and HttpUnit.
+<p>
+The following sample testcases illustrate the conciseness of jWebUnit versus HttpUnit
+and JUnit alone.  The tests perform a google search
+for the HttpUnit home page, navigate to that page from Google, and validate that
+there is a link to the user manual on the HttpUnit home page.  The code in the
+first column is pure HttpUnit / JUnit, while the second column uses the jWebUnit framework.
+<p>
 <br>
+<table class="default" cellspacing="2" border="0">
+<tr class="blueText"><td>JUnit/HttpUnit Test</td><td>jWebUnit Test</td></tr>
+<tr>
+<td valign="top" class="smallCode" NOWRAP>
+package net.sourceforge.jwebunit.sample;<br>
+<br>
+import junit.framework.TestCase;<br>
+import com.meterware.httpunit.WebResponse;<br>
+import com.meterware.httpunit.WebConversation;<br>
+import com.meterware.httpunit.WebForm;<br>
+import com.meterware.httpunit.WebRequest;<br>
+<br>
+public class SearchExample extends TestCase {<br>
+<br>
+    &nbsp;&nbsp;&nbsp;public void testSearch() throws Exception {<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WebConversation wc = new WebConversation();<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WebResponse resp = wc.getResponse( "http://www.google.com");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WebForm form = resp.getForms()[0];<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;form.setParameter("q", "HttpUnit");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WebRequest req = form.getRequest("btnG");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;resp = wc.getResponse(req);<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertNotNull(resp.getLinkWith("HttpUnit"));<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;resp = resp.getLinkWith("HttpUnit").click();<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertEquals(resp.getTitle(), "HttpUnit");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertNotNull(resp.getLinkWith("User's Manual"));<br>
+    &nbsp;&nbsp;&nbsp;}<br>
+}<br>
+</td>
+<td valign="top" class="smallCode" NOWRAP>
+package net.sourceforge.jwebunit.sample;<br>
+<br>
+import net.sourceforge.jwebunit.WebTestCase;<br>
+<br>
+public class JWebUnitSearchExample extends WebTestCase {<br>
+<br>
+    &nbsp;&nbsp;&nbsp;public JWebUnitSearchExample(String name) {<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;super(name);<br>
+    &nbsp;&nbsp;&nbsp;}<br>
+<br>
+    &nbsp;&nbsp;&nbsp;public void setUp() {<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;getTestContext().setBaseUrl("http://www.google.com");<br>
+    &nbsp;&nbsp;&nbsp;}<br>
+<br>
+    &nbsp;&nbsp;&nbsp;public void testSearch() {<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;beginAt("/");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;setFormElement("q", "httpunit");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;submit("btnG");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;clickLinkWithText("HttpUnit");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertTitleEquals("HttpUnit");<br>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;assertLinkPresentWithText("User's Manual");<br>
+    &nbsp;&nbsp;&nbsp;}<br>
+}<br>
+</td>
+</tr>
+</table>
 <!-- End Main -->
         </td>
     </tr>

jWebUnit/doc/installation.html

@@ -28,10 +28,13 @@
         </td>
         <td valign="top">
 <!-- Begin Main -->
-First download jWebUnit from the <a href="http://sourceforge.net/projects/jwebunit/files">files area</a>.
-Expand the zip onto your machine.  There is a jWebUnit jar in the root directory.  You can use this
-jar to run jWebUnit, but only if you already have all of jWebUnit's dependencies in your target project.
-jWebUnit includes jars for the projects it is dependent on in its lib directory.
+First download jWebUnit from the <a href="http://sourceforge.net/projects/jwebunit/files">files area</a>
+and expand to a local directory.<p>
+Next, copy the jars needed below to the project you wish to test, or include them in that
+project's classpath from where you expanded them too.  There is a jWebUnit jar in the root directory.  You can use this
+jar alone to run jWebUnit, but only if you already have the jars for jWebUnit's dependencies in your target project.
+jWebUnit includes jars for the projects it is dependent on in its lib directory, so if your project
+is not already using them you can get them there.  The dependencies are as follows:
 <p>
 <h2>Dependencies</h2>
 <table class="default" cellspacing="2" border="1">
@@ -40,6 +43,7 @@ <h2>Dependencies</h2>
 <tr><td><a href="http://www.mozilla.org/rhino/">Rhino</a></td><td>js.jar</td><td>Java javascript implementation used by httpunit.  Only needed if javascript in target application must be tested.</td></tr>
 <tr><td><a href="http://sourceforge.net/projects/jtidy">jTidy</a></td><td>Tidy.jar</td><td>Java html parser and beautifier used by httpunit.</td></tr>
 <tr><td><a href="http://www.junit.org">JUnit 3.8.1</a></td><td>junit.jar, optional.jar</td><td>Java testing framework.</td></tr>
+<tr><td><a href="http://www.apache.org">Apache XML API</a></td><td>xml-apis.jar</td><td>Common XML stuff needed by Tidy/HttpUnit.</td></tr>
 </table>
 <br>
 <!-- End Main -->

jWebUnit/lib/xercesImpl.jar

@@ -0,0 +1,28 @@
+package net.sourceforge.jwebunit.sample;
+
+import net.sourceforge.jwebunit.WebTestCase;
+
+/**
+ * Google search test with jWebUnit.
+ *
+ * @author Jim Weaver
+ */
+public class JWebUnitSearchExample extends WebTestCase {
+
+    public JWebUnitSearchExample(String name) {
+        super(name);
+    }
+
+    public void setUp() {
+        getTestContext().setBaseUrl("http://www.google.com");
+    }
+
+    public void testSearch() {
+        beginAt("/");
+        setFormElement("q", "httpunit");
+        submit("btnG");
+        clickLinkWithText("HttpUnit");
+        assertTitleEquals("HttpUnit");
+        assertLinkPresentWithText("User's Manual");
+    }
+}

jWebUnit/lib/xml-apis.jar

@@ -0,0 +1,28 @@
+package net.sourceforge.jwebunit.sample;
+
+import junit.framework.TestCase;
+import com.meterware.httpunit.WebResponse;
+import com.meterware.httpunit.WebConversation;
+import com.meterware.httpunit.WebForm;
+import com.meterware.httpunit.WebRequest;
+
+/**
+ * HttpUnit and JUnit search test.
+ *
+ * @author Jim Weaver
+ */
+public class SearchExample extends TestCase {
+
+    public void testSearch() throws Exception {
+        WebConversation wc = new WebConversation();
+        WebResponse resp = wc.getResponse( "http://www.google.com");
+        WebForm form = resp.getForms()[0];
+        form.setParameter("q", "HttpUnit");
+        WebRequest req = form.getRequest("btnG");
+        resp = wc.getResponse(req);
+        assertNotNull(resp.getLinkWith("HttpUnit"));
+        resp = resp.getLinkWith("HttpUnit").click();
+        assertEquals(resp.getTitle(), "HttpUnit");
+        assertNotNull(resp.getLinkWith("User's Manual"));
+    }
+}