Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Velocity Wiki" for 
change notification.

The following page has been changed by NathanBubna:
http://wiki.apache.org/velocity/VelocityTools2

The comment on the change is:
add some background info on Tools2

------------------------------------------------------------------------------
  
  It is worth noting that these tools, being POJOs (though some require a 
little configuration) are generally useful and may be used within your java 
classes or even other template languages, though you may need to instantiate 
and configure them manually (not difficult) to do so.  VelocityTools2 has been 
designed with this in mind.  Ask on the user mailing list if you have questions 
about using VelocityTools without Velocity.
  
+ == Why 2.0? ==
+ 
+ Those already familiar with VelocityTools 1.x may be curious about the goals 
and motivations behind developing VelocityTools2.  In planning and developing 
the 2.0 release, there were three main goals:
+  * Transparent, on-demand tool instantiation (aka lazy loading for tools) - 
This allows you to have many tools available (even ones that are expensive to 
instantiate), but not waste time instantiating or initializing/configuring 
those you don't use for every request.
+  * More accessible, reusable infrastructure - This allows easier access to 
tools outside of your templates and provides better means to integrate 
VelocityTools support into other web frameworks or even other view technologies 
(e.g. VelocityViewTag).
+  * Simpler, more flexible toolbox configuration - Now you can configure via a 
properties file, plain java, or really whatever you want (though perhaps with a 
bit more work).  No XML required anymore; though, if you do use it, it's a lot 
better than it was.
+ 
+ These things could not have been accomplished without rewriting most of the 
core infrastructure and configuration code.  At the same time, we wanted to 
make it easy for people to upgrade from the 1.x series.  This led to the 
decision to aim for complete backwards compatibility.  Granted much has been 
deprecated and those who directly used or extended the 1.x infrastructure will 
have to update their code in just a few releases, but for the time being they 
should be able to use 2.0 in their applications with few problems.  Those who 
merely used the old toolbox.xml format or the old tools directly will be 
immediately able to take advantage of the new infrastructure without even 
updating their configuration, though eventually even the old toolbox.xml format 
may be retired.  Don't cry.  You'll like the new one better once you get to 
know it!  It can do much more with much less typing.
+ 
+ See our [wiki:/Planning planning and progress tracking page] for more 
specific details on the goals and changes that went into VelocityTools2.
+ 

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

Reply via email to