Author: jdonnerstag
Date: Thu Mar 24 20:42:15 2011
New Revision: 1085127
URL: http://svn.apache.org/viewvc?rev=1085127&view=rev
Log:
javadoc only: avoid warnings
Modified:
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/BaseWicketTester.java
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/WicketTester.java
Modified:
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/BaseWicketTester.java
URL:
http://svn.apache.org/viewvc/wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/BaseWicketTester.java?rev=1085127&r1=1085126&r2=1085127&view=diff
==============================================================================
---
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/BaseWicketTester.java
(original)
+++
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/BaseWicketTester.java
Thu Mar 24 20:42:15 2011
@@ -113,6 +113,7 @@ import org.apache.wicket.session.ISessio
import org.apache.wicket.settings.IRequestCycleSettings.RenderStrategy;
import org.apache.wicket.util.IProvider;
import org.apache.wicket.util.lang.Classes;
+import org.apache.wicket.util.lang.Generics;
import org.apache.wicket.util.resource.ResourceStreamNotFoundException;
import org.apache.wicket.util.string.Strings;
import org.apache.wicket.util.visit.IVisit;
@@ -175,12 +176,11 @@ public class BaseWicketTester
private MockHttpServletRequest lastRequest;
private MockHttpServletResponse lastResponse;
- private final List<MockHttpServletRequest> previousRequests = new
ArrayList<MockHttpServletRequest>();
- private final List<MockHttpServletResponse> previousResponses = new
ArrayList<MockHttpServletResponse>();
+ private final List<MockHttpServletRequest> previousRequests =
Generics.newArrayList();
+ private final List<MockHttpServletResponse> previousResponses =
Generics.newArrayList();
- /** current request */
+ /** current request and response */
private MockHttpServletRequest request;
- /** current response */
private MockHttpServletResponse response;
/** current session */
@@ -198,7 +198,7 @@ public class BaseWicketTester
private IRequestHandler forcedHandler;
// Simulates the cookies maintained by the browser
- private final List<Cookie> browserCookies = new ArrayList<Cookie>();
+ private final List<Cookie> browserCookies = Generics.newArrayList();
// The root component used for the start. Usually the Page, but can
also be a Panel
// see https://issues.apache.org/jira/browse/WICKET-1214
@@ -356,7 +356,8 @@ public class BaseWicketTester
}
/**
- * @return
+ * @param servletWebRequest
+ * @return servlet web response
*/
private ServletWebResponse createServletWebResponse(ServletWebRequest
servletWebRequest)
{
@@ -364,7 +365,7 @@ public class BaseWicketTester
}
/**
- * @return
+ * @return servlet web request
*/
private ServletWebRequest createServletWebRequest()
{
@@ -377,13 +378,13 @@ public class BaseWicketTester
private void createNewSession()
{
ThreadContext.setSession(null);
+
// the following will create a new session and put it in the
thread context
session = Session.get();
}
/**
- *
- * @return
+ * @return request object
*/
public MockHttpServletRequest getRequest()
{
@@ -391,17 +392,15 @@ public class BaseWicketTester
}
/**
- *
* @param request
*/
- public void setRequest(MockHttpServletRequest request)
+ public void setRequest(final MockHttpServletRequest request)
{
this.request = request;
applyRequest();
}
/**
- *
* @return session
*/
public Session getSession()
@@ -450,8 +449,7 @@ public class BaseWicketTester
}
/**
- *
- * @return
+ * @return true, if process was executed successfully
*/
public boolean processRequest()
{
@@ -463,7 +461,6 @@ public class BaseWicketTester
*
* @param request
* request to process
- *
*/
public void processRequest(MockHttpServletRequest request)
{
@@ -475,10 +472,10 @@ public class BaseWicketTester
*
* @param request
* request to process
- *
* @param forcedRequestHandler
* optional parameter to override parsing the request URL
and force
* {@link IRequestHandler}
+ * @return true, if process was executed successfully
*/
public boolean processRequest(MockHttpServletRequest request,
IRequestHandler forcedRequestHandler)
@@ -487,9 +484,8 @@ public class BaseWicketTester
}
/**
- *
* @param forcedRequestHandler
- * @return
+ * @return true, if process was executed successfully
*/
public boolean processRequest(IRequestHandler forcedRequestHandler)
{
@@ -501,10 +497,10 @@ public class BaseWicketTester
* @param forcedRequest
* @param forcedRequestHandler
* @param redirect
- * @return
+ * @return true, if process was executed successfully
*/
- private boolean processRequest(MockHttpServletRequest forcedRequest,
- IRequestHandler forcedRequestHandler, boolean redirect)
+ private boolean processRequest(final MockHttpServletRequest
forcedRequest,
+ final IRequestHandler forcedRequestHandler, final boolean
redirect)
{
if (forcedRequest != null)
{
@@ -634,6 +630,7 @@ public class BaseWicketTester
* @see #startPage(IPageProvider)
*
* @param page
+ * @return Page
*/
public Page startPage(Page page)
{
@@ -724,7 +721,7 @@ public class BaseWicketTester
XmlPullParser parser = new XmlPullParser();
parser.parse(getLastResponseAsString());
XmlTag tag;
- while ((tag = (XmlTag)parser.nextTag()) != null)
+ while ((tag = parser.nextTag()) != null)
{
if (tag.isOpen() && tag.getName().equals("script") &&
"wicket-ajax-base-url".equals(tag.getAttribute("id")))
@@ -791,7 +788,7 @@ public class BaseWicketTester
* @param link
* @return url for Link
*/
- public String urlFor(Link link)
+ public String urlFor(Link<?> link)
{
return link.urlFor(ILinkListener.INTERFACE).toString();
}
@@ -831,7 +828,7 @@ public class BaseWicketTester
* @param component
* @param listener
*/
- public void executeListener(Component component,
RequestListenerInterface listener)
+ public void executeListener(final Component component, final
RequestListenerInterface listener)
{
// there are two ways to do this. RequestCycle could be forced
to call the handler
// directly but constructing and parsing the URL increases the
chance of triggering bugs
@@ -852,7 +849,7 @@ public class BaseWicketTester
* @param component
* the listener to invoke
*/
- public void executeListener(Component component)
+ public void executeListener(final Component component)
{
for (RequestListenerInterface iface :
RequestListenerInterface.getRegisteredInterfaces())
{
@@ -883,9 +880,9 @@ public class BaseWicketTester
/**
*
* @param link
- * @return
+ * @return Url
*/
- public Url urlFor(AjaxLink<?> link)
+ public Url urlFor(final AjaxLink<?> link)
{
AbstractAjaxBehavior behavior =
WicketTesterHelper.findAjaxEventBehavior(link, "onclick");
Url url = Url.parse(behavior.getCallbackUrl().toString(),
@@ -898,7 +895,7 @@ public class BaseWicketTester
*
* @param url
*/
- public void executeAjaxUrl(Url url)
+ public void executeAjaxUrl(final Url url)
{
transform(url);
request.setUrl(url);
@@ -911,12 +908,11 @@ public class BaseWicketTester
* Renders a <code>Page</code> from its default constructor.
*
* @param <C>
- *
* @param pageClass
* a test <code>Page</code> class with default constructor
* @return the rendered <code>Page</code>
*/
- public final <C extends Page> Page startPage(Class<C> pageClass)
+ public final <C extends Page> Page startPage(final Class<C> pageClass)
{
startComponent = null;
request.setUrl(application.getRootRequestMapper().mapHandler(
@@ -929,14 +925,14 @@ public class BaseWicketTester
* Renders a <code>Page</code> from its default constructor.
*
* @param <C>
- *
* @param pageClass
* a test <code>Page</code> class with default constructor
* @param parameters
* the parameters to use for the class.
* @return the rendered <code>Page</code>
*/
- public final <C extends Page> Page startPage(Class<C> pageClass,
PageParameters parameters)
+ public final <C extends Page> Page startPage(final Class<C> pageClass,
+ final PageParameters parameters)
{
startComponent = null;
request.setUrl(application.getRootRequestMapper().mapHandler(
@@ -1021,7 +1017,6 @@ public class BaseWicketTester
* be relative to the panel. Not relative to the Page which will
automatically be added for you.
*
* @param <C>
- *
* @param panelClass
* a test <code>Panel</code> class with <code>Panel(String
id)</code> constructor
* @return a rendered <code>Panel</code>
@@ -1838,7 +1833,8 @@ public class BaseWicketTester
* Modified version of BaseWicketTester#getTagByWicketId(String) that
returns all matching tags
* instead of just the first.
*
- * @see BaseWicketTester#getTagByWicketId(String)
+ * @param wicketId
+ * @return List of Tags
*/
public List<TagTester> getTagsByWicketId(String wicketId)
{
@@ -1992,7 +1988,7 @@ public class BaseWicketTester
*
* @param message
* @param condition
- * @return
+ * @return fail with message if false
*/
private Result isTrue(String message, boolean condition)
{
@@ -2007,7 +2003,7 @@ public class BaseWicketTester
*
* @param message
* @param condition
- * @return
+ * @return fail with message if true
*/
private Result isFalse(String message, boolean condition)
{
@@ -2022,7 +2018,7 @@ public class BaseWicketTester
*
* @param expected
* @param actual
- * @return
+ * @return fail with message if not equal
*/
protected final Result isEqual(Object expected, Object actual)
{
@@ -2055,7 +2051,7 @@ public class BaseWicketTester
*
* @param message
* @param object
- * @return
+ * @return fail with message if not null
*/
private Result isNull(String message, Object object)
{
@@ -2087,7 +2083,6 @@ public class BaseWicketTester
}
/**
- *
* @param message
*/
protected final void fail(String message)
@@ -2106,8 +2101,7 @@ public class BaseWicketTester
}
/**
- *
- * @return
+ * @return request cycle
*/
public RequestCycle getRequestCycle()
{
@@ -2115,8 +2109,7 @@ public class BaseWicketTester
}
/**
- *
- * @return
+ * @return servlet response
*/
public MockHttpServletResponse getResponse()
{
@@ -2124,8 +2117,7 @@ public class BaseWicketTester
}
/**
- *
- * @return
+ * @return last request
*/
public MockHttpServletRequest getLastRequest()
{
@@ -2133,8 +2125,7 @@ public class BaseWicketTester
}
/**
- *
- * @return
+ * @return true, if exceptions are exposed
*/
public boolean isExposeExceptions()
{
@@ -2159,6 +2150,7 @@ public class BaseWicketTester
}
/**
+ * @param setBaseUrl
* @param useRequestUrlAsBase
*/
public void setUseRequestUrlAsBase(boolean setBaseUrl)
@@ -2170,7 +2162,7 @@ public class BaseWicketTester
*
* @param _url
*/
- public void executeUrl(String _url)
+ public void executeUrl(final String _url)
{
Url url = Url.parse(_url,
Charset.forName(request.getCharacterEncoding()));
transform(url);
@@ -2285,7 +2277,6 @@ public class BaseWicketTester
return delegate.mapRequest(request);
}
}
-
}
/**
@@ -2381,7 +2372,6 @@ public class BaseWicketTester
{
webResponse.addCookie(cookie);
}
-
}
@Override
Modified:
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/WicketTester.java
URL:
http://svn.apache.org/viewvc/wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/WicketTester.java?rev=1085127&r1=1085126&r2=1085127&view=diff
==============================================================================
---
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/WicketTester.java
(original)
+++
wicket/trunk/wicket-core/src/main/java/org/apache/wicket/util/tester/WicketTester.java
Thu Mar 24 20:42:15 2011
@@ -541,6 +541,10 @@ public class WicketTester extends BaseWi
}
}
+ /**
+ *
+ * @param link
+ */
public void clickLink(Component link)
{
clickLink(link.getPageRelativePath());
@@ -619,6 +623,24 @@ public class WicketTester extends BaseWi
* Use <code>-Dwicket.replace.expected.results=true</code> to
automatically replace the expected
* output file.
*
+ * @param testClass
+ * @param component
+ * @param filename
+ * @throws Exception
+ */
+ public void executeTest(final Class<?> testClass, final Component
component,
+ final String filename) throws Exception
+ {
+ log.info("=== " + component.getClass().getName() + " ===");
+
+ startComponent(component);
+ assertResultPage(testClass, filename);
+ }
+
+ /**
+ * Use <code>-Dwicket.replace.expected.results=true</code> to
automatically replace the expected
+ * output file.
+ *
* @param <T>
* @param testClass
* @param pageClass