Boudoir

The Boudoir library is a small framework implemented in Java for training purposes, but can also be used as an utility library when developing Java Enterprise applications. The library was developed using the 1.6 Java platform.

The library is ready to handle connections to the Oracle, PostegreSQL and MySQL database and includes all the required drivers. To connect the library to another database, you must:

1) Modifiy the class adriani.boudoir.db.Database
2) Include the required JDBC drivers into the lib directory of the deploy enviroment
3) Specify the custom connection string to the database in the bd_config.properties file

The downloadable ZIP package containes:

• All the Java sources files necessary to compile the project
• Ant build.xml file useful to build the library
• JAR version of the library ready to be deployed
• PDF manual explaining how to test any single feature (in Italian)
• JAR libraries required to compile and run the project using Oracle, PostegreSQL, MySQL and Log4j
• Scripts BATCH/Shell allowing to test the library on a Windows/Linux terminal
• Scripts SQL for creating and populating test data on a Oracle, PostegreSQL or MySQL database

The main purpose of the library is to provide a lightweight alternative to the traditional and most popular frameworks such as Spring, Hibernate, Struts, etc.. Of course, being an amateur project, the library Boudoir is not comparable with a professional framework, especially in the case of large enterprise applications which require high flexibility, scalability, and adherence to the main specifications of the various Java technologies. Usage of the library may be useful in small projects, where it is necessary to make an application in a few days that has to perform just simple operations, for instance: connecting to a database, writing log files and collecting analysis of the overall performance. The current version of the library Boudoir offers following features:

• Highl level interface to database access, tested for Oracle, PostgreSQL and MySQL
• Highl level interface implementing a common logging system (Log4j and SystemLogger)
• Ant build file switching among three different environments (development, test, production)
• Test class allowing to test the library from the command line (SimpleClient)
• Test packages showing an example of library usage (Simple Application)
• Pool database connections management system (JDBCConnectionPool)
• Capability to use a mocked pool for testing or debugging (MockConnectionPool)
• Capability to configure the library at run-time sending simple messages (remote management)
• Error messages internationalization depending by the local user's machine (ErrorMessage)
• Collection of analysis and statistics data for performances evaluation (GeneralAnalyzer)
• Capability to measure execution times for each single query (service.benchmark)
• Project structure compatibile with Maven (Standard Directory Layout)