[B-frame-devel] <b-frame/> 0.1.1

[Peter B. <pbe...@sn...>]

Hi,

<b-frame/> 0.1.1 improving how to deal with databases and data sources
has been released, visit http://www.b-frame.org/ and
http://sourceforge.net/projects/b-frame. Most notably, from now on you
have to maintain a property ds.name in your property file
"build.properties". On the other hand, the tag <bf-app:connect> is
deprecated for the <b-frame/> application descriptor.

One of the lessons learned from the 0.1 release is that having database
and data source information spread to at least four locations, i.e.

   * the properties file "build.properties",
   * the SQL scripts for creating or dropping the database,
   * the JBoss service descriptor for defining the data source, and
   * the <b-frame/> application descriptor,

is tedious and error prone. This has been improved, the database and
data source information is now bundled at one location, the properties
file "build.properties".

   * There is no need any longer to edit SQL scripts for creating or
     dropping a database or a database user, respectively. Now
     <b-frame/> has templates containing the necessary SQL statements,
     you may find them in the directories
     <b-frame-home>/xsl/sql/<database>. For automatically creating the
     SQL scripts, <b-frame/> merges information from the properties file
     "build.properties" with these templates.
   * There is no need any longer to create a JBoss service descriptor
     defining a data source corresponding to the database by hand.
     Instead now <b-frame/> has stylesheets for automatically merging
     information from the properties file "build.properties" with the
     appropriate template found in the directory
     <j-boss-home>/dos/examples/jca into the descriptor.
   * The data source information has been removed from the application
     descriptor, i.e. the <bf-app:connect> tag is not allowed there any
     longer.
     Note:  Unfortunately this breaks comptibility because the data
     source's name is now taken from the properties file
     "build.properties", so be sure to have the property ds.name defined
     there. On the other hand, changing the data source's name will no
     longer trigger a rebuild of the whole project.

The following ant targets are new or have a new implementation:

   * cre-user  creates a database (MySQL) or a database user (Oracle).
     Editing SQL scripts beforehand is not needed any longer. For
     Hypersonic the target is meaningless.
   * drop-user  drops a database (MySQL) or a database user (Oracle).
     Editing SQL scripts beforehand is not needed any longer. For
     Hypersonic the target is meaningless.
   * deploy-ds  creates a service descriptor definig a data source by
     using an appropriate template from the directory
     <j-boss-home>/dos/examples/jca and deploys it to JBoss.
   * undeploy-ds  removes a service descriptor from JBoss.
   * cre-ds  conveniently combines the cre-user and deploy-ds targets.
     For Hypersonic the target is meaningless.
   * drop-ds  conveniently combines the undeploy-ds and drop-user
     targets. For Hypersonic the target is meaningless.

The tutorial at http://www.b-frame.org/applications.pdf has been updated
accordingly.

Bye,

Peter