Quoting Janne Jalkanen <janne.jalkanen iki.fi>:
>
[...on exceptions thrown during WikiEngine startup...]
>
> It's a catch-all exception which gets thrown if the
WikiEngine
> objects can't be created. The trouble is that it's
always the last
> thing in the log, and therefore people often mistake it
for the real
> error message... The real error is usually a bit
before.
>
> But yes, you're absolutely right. The error message is
confusing, but
> I haven't figured out a good solution to this. I think
the right way
> would probably be to ditch the WikiEngine creation
methods in the
> jspInit()s of the different files and get it locally
instead; then we
> could throw a proper ServletException or do a proper
redirect
> explaining the problem and log something that would
make sense.
>
> Any other ideas?
Janne,
There are a variety of different problems that are common to
a
first-time install, particularly those that involve
unmodified
jspwiki.properties files. My suggestion would be to break
out
the known categories of errors and handle them in such a way
that the error message names the property that failed, why
the
failure occurred (if known), and any known other details of
the
problem.
E.g., use the same method for each directory-related
property
set during initialization. So if one of those directories
can't
be found, the error message would mention the property name
and
the missing directory path.
While initializing WikiEngine, could not locate
directory
'%1' as specified in wiki engine property '%2'.
as in
While initializing WikiEngine, could not locate
directory
'/home/altheim/work/ceryle/resource/webapps/wiki/storage'
as specified in wiki engine property
'jspwiki.basicAttachmentProvider.storageDir'.
et cetera. That alone would probably cover many of the
errors we
see with newbies/new installs. Another method for those
properties that expect one of an enumerated list of values,
in
case somebody misspelled something.
Don't know if this is of any help...
Murray
............................................................
...............
Murray Altheim <murray06 altheim.com>
=== = =
http://www.altheim.com
/murray/ = = ===
SGML Grease Monkey, Banjo Player, Wantanabe Zen Monk
= = = =
In the evening
The rice leaves in the garden
Rustle in the autumn wind
That blows through my reed hut. -- Minamoto no
Tsunenobu
_______________________________________________
Jspwiki-users mailing list
Jspwiki-users ecyrd.com
http://ecyrd.com/cgi-bin/mailman/listinfo/jspwiki-users
a>
|