I like the summary by Johan much more. Specifically the page should mention:

- Wicket Pages are just normal Java objects
- Links allow one to move from one Page to another. There are two ways to do this:

1) Construct a Page like any normal Java object and pass it into the Link.

2) Pass in the Page class and use Link's built-in mechanisms for lazy page construction. These assume that bookmarkable pages have a PageParameters constructor and non-bookmarkable pages have a default constructor.

- We absolutely should have sample code in this page (like Johan provided) so it is clearer what we're talking about. You can copy/paste this directly from his email.


Finally, we need to make it clear in this wiki page what happens if you have a bookmarkable page that is missing a PageParameters constructor and query arguments are passed in. Does this result in a runtime error? In fact, I suggest we disallow users to provide a default constructor for bookmarkable pages. They should *always* provide a PageParameters constructor. I also found the existing documentation confusing because it said they may have either a default constructor or a PageParameters one and I was left asking... "but why?! What's the difference between the two constructors? when is each called?" We should just simplify it into a single constructor.

Thank you,
Gili

Eelco Hillenius wrote:
Hope this http://wicket.sourceforge.net/wiki/index.php/Bookmarkable_nonBookmarkable_pages helps,

Eelco

Gili wrote:


On this topic... can someone *please* post a page in the Wicket Wiki about Bookmarkable Pages vs normal Pages? Something similar to our "all about Models" page?

I absolutely lost here. I keep on getting lost on this exact same topic every couple of weeks and I can't find any decent documentation on it.

Specifically, what differentiates a bookmarkable page from a normal one? Why does a bookmarkable page take one constructor with PageParameters and one without? Which constructor is called if you hit the URL of a bookmarkable page with and without query arguments? How do you pass arguments to a non-bookmarkable page if its constructor does not take a PageParameters argument?

I would really appreciate this as it's rather basic stuff and I'm totally lost on it. I wish you guys had some sort of irc channel or something we could discuss things on because often I have really simple questions I would appreciate help with and there is just nowhere to ask (chat vs mailing list yield different results).

Thanks,
Gili





-------------------------------------------------------
SF.Net email is Sponsored by the Better Software Conference & EXPO September
19-22, 2005 * San Francisco, CA * Development Lifecycle Practices
Agile & Plan-Driven Development * Managing Projects & Teams * Testing & QA
Security * Process Improvement & Measurement * http://www.sqe.com/bsce5sf
_______________________________________________
Wicket-develop mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/wicket-develop


--
http://www.desktopbeautifier.com/


-------------------------------------------------------
SF.Net email is Sponsored by the Better Software Conference & EXPO September
19-22, 2005 * San Francisco, CA * Development Lifecycle Practices
Agile & Plan-Driven Development * Managing Projects & Teams * Testing & QA
Security * Process Improvement & Measurement * http://www.sqe.com/bsce5sf
_______________________________________________
Wicket-develop mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/wicket-develop

Reply via email to