Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Maurice Marrink
I'll let one of the developers go into more detail about the
documentation issue :)
Regarding security there are several sub projects for you to choose.
and i would like to refer to this page for an overview of the
differences 
http://wicketstuff.org/confluence/display/STUFFWIKI/Security+Framework+Comparison
From there you should be able to find more information although a good
place to look is also the old sourceforge mailinglist.

Maurice

On 8/9/07, Alexander Schatten [EMAIL PROTECTED] wrote:
 Greetings to all Wicket experts

 I try to get Wicket running for some rather simple web-application.
 First (no offense, but have to say that), Wicket has the worst
 documentation of an apparently good open source project I have seen in a
 long time; and this is really a pity, because it seems, that if one
 would know how to do it, many things can be performed quite easily.

 Now to my current issue: I want to add a loginpage to my project and
 protect some of the pages.

 My first thought was to make a base class (worked) and somehow hook into
 the lifecycle, check if the user is checked in (MySessio works) but this
 is not running at all. lot of redirection errors, incoherent
 documentation and so on. e.g.:

 Javadoc 1.3 of Page talks about checkAccess() method... however, this
 methdod can be found nowhere.

 Now I check the mailing list archive, only useful thing I find is a
 posting from 9.2.2006 suggesting:

 protected void init()
  {
  getSecuritySettings().setAuthorizationStrategy(new
 IAuthorizationStrategy()
  {
  public boolean authorizeAction(...) ...
  public boolean authorizeInstantiation(...) ...
  }

 starting with 1.2. Well, this interface is still here, but these methods
 are not available any longer.

 There is no documentation about this strategy I could find and the
 Javadoc (which is btw. not linked from the wicket website, and just this
 made me search for an hour) is very unconclusive.


 btw. another thing: when the documentation of a project is so bad, at
 least the javadoc should be accessible: I tried to build mvn site with
 wicket and got the error that you use a special template or somthing and
 it does not build, and this template is apparently not in the repository
 ARRRGGHHH.


 sorry, but Wicket experience was far away from beeing pleasent. I am
 quite willing to check several sources, but this here is really bad.
 outdated information is not easy to distinguish from actual
 documentation, the reference to the component doc is nice, but component
 doc very incomplete and so on...

 Wicket seems to be a quite productive and powerful framework (one of the
 best I have seen so far, at least so it seems), but getting into it is a
 damn frustrating experience, I can tell you...

 (I did not even know where to start. happyily there is a maven archetype
 at the Jetty website which was helpful.)



 So, sorry for that outburst, but I was so frustrated...


 best greetings


 Alex


 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]



-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Martijn Dashorst
http://cwiki.apache.org/WICKET/framework-documentation.html

On 8/9/07, Alexander Schatten [EMAIL PROTECTED] wrote:
 I completly agree; just one addition: best-practices are completly
 missing in the introduction. at least a list what is available!!

 how should I know, that there is apparently an authentication framework?
 how do I access DAOs properly? there is support for working with
 databases (is there?)

 there is apparently a validation framework. I cam so far to understand
 (by browsing javadocs and a lot of trial and error, as again,
 documentation is not coherent, wiki, javadoc) that I can add validation
 rules to form elements, like this field should be min 5 max 10 chars and
 the like. ok, I have it running so far, that no other entries are
 excepted in this field, but I have no idea how I can react within the
 application for wrong entries, missing entries (you would want to give
 the user feedback that an entry was wrong). so where is the hook?

 how is the lifecycle of objects? where do I hook in to do special
 things? always in the constructor? somewhere else...? (there was a
 similar posting on this list recently)

 these are just examples: accidentally you stumble over a feature, that
 you were just on implementing yourself, and then it takes hours or days
 to figure out how to use it properly.

 again: extremly frustrating.



 Johan Maasing wrote:
  I have been playing with wicket for the last week. I must agree with
  what Alexander says. The documentation is rather lacking and quite
  frustrating. To bad because wicket is cool. So +1 for better docs.
  As a newbie to wicket I can't help in writing it but I can tell you
  what I find frustrating:
 
  The javadocs is not linked from the wicket site, it was hard to find
  even using google.
 
  The component reference is not complete. The examples have a link to
  'view source' but it does not say which files to look at for a given
  example. It would be helpful if the component reference said which
  component belonged in which jar-file (wicket or wicket-extension).
  Personally I think that tapestrys component reference is helpful
  (http://tapestry.apache.org/tapestry4.1/components/index.html)
  Perhaps there could evolve some kind of javadoc convention or other
  documentation-convention for components that describes the component,
  the parameters, the css-classes the component renders and so on.
  Oh yeah, the component reference app is stateful so I constantly get
  session expired when looking at the examples, I can't for the life of
  me figure out why :-)
 
  It was a bit hard to find a reference to the wicket-tags, at least it
  is linked from wiki, but a schema-file would be helpful to get command
  completion in the HTML-editor.
 


 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]




-- 
Wicket joins the Apache Software Foundation as Apache Wicket
Apache Wicket 1.3.0-beta2 is released
Get it now: http://www.apache.org/dyn/closer.cgi/wicket/1.3.0-beta2/

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Igor Vaynberg
On 8/8/07, Alexander Schatten [EMAIL PROTECTED] wrote:

 Greetings to all Wicket experts

 I try to get Wicket running for some rather simple web-application.
 First (no offense, but have to say that), Wicket has the worst
 documentation of an apparently good open source project I have seen in a
 long time; and this is really a pity, because it seems, that if one
 would know how to do it, many things can be performed quite easily.


have you seen the wiki?

Now to my current issue: I want to add a loginpage to my project and
 protect some of the pages.

 My first thought was to make a base class (worked) and somehow hook into
 the lifecycle, check if the user is checked in (MySessio works) but this
 is not running at all. lot of redirection errors, incoherent
 documentation and so on. e.g.:


have you started by checking out Signin, Signin2, Authentication,
Authorization examples in wicket-examples?

Javadoc 1.3 of Page talks about checkAccess() method... however, this
 methdod can be found nowhere.


yes the javadoc is outdated, fixed

Now I check the mailing list archive, only useful thing I find is a
 posting from 9.2.2006 suggesting:

 protected void init()
  {
  getSecuritySettings().setAuthorizationStrategy(new
 IAuthorizationStrategy()
  {
  public boolean authorizeAction(...) ...
  public boolean authorizeInstantiation(...) ...
  }

 starting with 1.2. Well, this interface is still here, but these methods
 are not available any longer.

 There is no documentation about this strategy I could find and the
 Javadoc (which is btw. not linked from the wicket website, and just this
 made me search for an hour) is very unconclusive.


we are working on linking the javadoc...you do know wicket is a maven
project right? so there is of course javadoc in the maven repo:

http://repo1.maven.org/maven2/org/apache/wicket/wicket/1.3.0-beta2/

further, since it is open source simply attach the sources to your ide and
you are set.
if you are using maven2 and eclipse add the wicket dep to your pom and do
mvn eclipse:eclipse -DdownloadSources=true - and you are all set.

now that you have found IAuthorizationStrategy have you even looked at it?
for example have you pulled up its class hieararchy to see an example
implementation? for example when i do it it leads me directly to
SimplePageAuthorizationStrategy - which will probably get you started - even
if you havent looked at the 4 examples i have mentioned.

btw. another thing: when the documentation of a project is so bad, at
 least the javadoc should be accessible: I tried to build mvn site with
 wicket and got the error that you use a special template or somthing and
 it does not build, and this template is apparently not in the repository
 ARRRGGHHH.


yes working on that too. maven2 site generation is a pita and eats up a lot
of time to get working.

sorry, but Wicket experience was far away from beeing pleasent. I am
 quite willing to check several sources, but this here is really bad.


have you gotten the Pro Wicket book?

outdated information is not easy to distinguish from actual
 documentation, the reference to the component doc is nice, but component
 doc very incomplete and so on...


you are more then welcome to help out.

Wicket seems to be a quite productive and powerful framework (one of the
 best I have seen so far, at least so it seems), but getting into it is a
 damn frustrating experience, I can tell you...


you are meant to look at examples first. they cover all the basic usecases.
learn-by-example has been our philosophy so far.

(I did not even know where to start. happyily there is a maven archetype
 at the Jetty website which was helpful.)

So, sorry for that outburst, but I was so frustrated...


no problem

-igor


best greetings


 Alex


 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]




Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Alexander Schatten

Martijn Dashorst wrote:

http://cwiki.apache.org/WICKET/framework-documentation.html




thank you; but you see, this is again one of the things I mentioned!!

when you follow the link (wiki) from the main Wicket page, you come here:

http://cwiki.apache.org/WICKET/reference-library.html

the link you suggested (thanks for that one) is:


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Alexander Schatten

Martijn Dashorst wrote:

http://cwiki.apache.org/WICKET/framework-documentation.html



sorry, I sent the last email to quick, was a Mistake; what I wanted to 
point out is this:


http://cwiki.apache.org/WICKET/framework-documentation.html

this is your link, and it apparently has interesting information, 
whereas when you search (as probably every newbie would) starting from 
the wicket website, you go to the wiki and reference info, you come to:


http://cwiki.apache.org/WICKET/reference-library.html


now: this is what I meant before with very confusing documentation: 
these two pages apparently cover similar topics, but are different in 
details. then there is the confusing component reference plus the 
javadoc which is also misleading sometimes (see the authentication stuff 
with reference to non-existing methods).


don't you think this information base should be consolidated?



thank you very much



Alex


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Igor Vaynberg
so how do you propose we consolidate it?

instead of javadoc have links to the wiki?

/**
 * see wicket.apache.org/wiki/authstrat
 */
public interface IAuthorizationStrategy {...}

that would really really suck.

-igor


On 8/9/07, Alexander Schatten [EMAIL PROTECTED] wrote:

 Martijn Dashorst wrote:
  http://cwiki.apache.org/WICKET/framework-documentation.html
 

 sorry, I sent the last email to quick, was a Mistake; what I wanted to
 point out is this:

 http://cwiki.apache.org/WICKET/framework-documentation.html

 this is your link, and it apparently has interesting information,
 whereas when you search (as probably every newbie would) starting from
 the wicket website, you go to the wiki and reference info, you come to:

 http://cwiki.apache.org/WICKET/reference-library.html


 now: this is what I meant before with very confusing documentation:
 these two pages apparently cover similar topics, but are different in
 details. then there is the confusing component reference plus the
 javadoc which is also misleading sometimes (see the authentication stuff
 with reference to non-existing methods).

 don't you think this information base should be consolidated?



 thank you very much



 Alex


 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]




Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Alexander Schatten
I am sorry I do completly understand your last mail. See, you pointed me 
to the interesting page


http://cwiki.apache.org/WICKET/framework-documentation.html

(1) now, from the wicket website the reference link (was changed I 
think?) points to the other page, with the similar information. It might 
be a first start to figure out (you as experts) which of the two pages 
is the relevant one and link the right one.


(2) plus at the moment, there is still no link at all to the javadoc 
from the main website: I only found this one by accident.


this might be a second very helpful step.

(3) a third one would be best-practice guide on the main website listing 
typical issues like:


-- database connection / DAOs
-- Ajax
-- authentication
-- build management (Maven)
-- logging
...
...

and make references to the existing documentation, examples plus javadoc

(4) bring a conclusive list of examples; it seems, that there are 
several sets of examples distributed on the website, the wiki, the 
distribution... also confusing. at least a conclusive list with examples 
and where to find them would be very helpful




thank you



Alex



Igor Vaynberg wrote:

so how do you propose we consolidate it?

instead of javadoc have links to the wiki?

/**
 * see wicket.apache.org/wiki/authstrat
 */
public interface IAuthorizationStrategy {...}

that would really really suck.

-igor


On 8/9/07, Alexander Schatten [EMAIL PROTECTED] wrote:

Martijn Dashorst wrote:

http://cwiki.apache.org/WICKET/framework-documentation.html


sorry, I sent the last email to quick, was a Mistake; what I wanted to
point out is this:

http://cwiki.apache.org/WICKET/framework-documentation.html

this is your link, and it apparently has interesting information,
whereas when you search (as probably every newbie would) starting from
the wicket website, you go to the wiki and reference info, you come to:

http://cwiki.apache.org/WICKET/reference-library.html


now: this is what I meant before with very confusing documentation:
these two pages apparently cover similar topics, but are different in
details. then there is the confusing component reference plus the
javadoc which is also misleading sometimes (see the authentication stuff
with reference to non-existing methods).

don't you think this information base should be consolidated?



thank you very much



Alex


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]







-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Eelco Hillenius
 honestly spoken, this is not the best strategy for everyone...

Obviously. But we have limited resources (no-one is paid for working
on Wicket), so it is hard to cater to everyone. We have tried to
attract writers (for a reference guide) from the very early start
(even offered some money) but it just doesn't seem to be a task many
people seem to be interested in doing.

 moreover,
 I think you are speaking of examples coming with the download; this
 dowload was again rather confusing (see my site problem); I am looking
 first at the exampleson the website, and there I could not find any of
 the examples you were mentioning.

What I don't get - as a regular user of open source software - what is
so difficult about just getting it from source control or creating a
quick maven based project for that? I typically dive into several
projects I didn't know before a month, and I just start with getting
it from the repo, looking at the test cases and examples and Javadocs
(which unfortunately is something most open source projects do a lot
worse at than Wicket).

 btw. this is I see now one of the real issues with the wicket docs; it
 seems, that there is actually lot available, but very cluttered, not
 properly linked and partly redundant in different versions...

We really depend on our users helping us out with that (and they have
been quite a help already). The framework is in constant development,
so this is something that needs constant attention. Help is very
welcome.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: Authentication in Webapp and Wicket documentation...

2007-08-09 Thread Eelco Hillenius
 No, actually I was not aware of that, was waiting for the Wicket in
 Action book...

http://manning.com/dashorst/

You can get the first chapters now. Two more chapters will be released
early next week.

 maybe one should also start writing some proper articles as a starting
 point; I might do that when I see clearer.

There are quite a few articles you can find if you google for it. Many
of them are for 1.2, so a bit stale if you plan to use 1.3 (which we
recommend). So keep http://cwiki.apache.org/WICKET/migrate-13.html
next to them. It's often more about the idea than that it is important
that the examples are still completely recent.

Eelco

Eelco

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]