Release Notes <b-frame/> 0.1.1

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,

• 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.