ResourcePool 
============

What is it?
-----------

This package is a C++ library which can be used to pool resources of 
every kind. One very interesting side effect is that it can also be used
of abstraction layer by providing a unique API for different resources
of similar resource types. Most prominent example are SQL databases.
The ResourcePool does currently include a convenient way to
access MySQL and Oracle databases in the same way, so that changing
for MySQL to Oracle or vice-versa does not need big code changes.

Sounds difficult, show me the "Hello World" example!
----------------------------------------------------

Find the fully featured 24-line example "select.cc" in the examples 
directory of the distribution. It's an example to issue a simple select
statement against an SQL database. The connect parameters and the select 
statement are passed as arguments to the program. Including error handling 
and printing the result of the select, the complete source code for this 
program has just 24 lines.

If you want to run this example, please read the instructions in the 
INSTALL document included in this distribution.

After successful build change to the examples directory and issue the 
following command to compile the example

   c++ -lResourcePool -lrt -L../.libs -I../ -o select select.cc 

Now you can already run the program (but tell the liker where to find the 
library):

   LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:../.libs ./select oci:scott/tiger@TEST

You are done.

Where can I find more documentation?
------------------------------------

If you have doxygen installed you can `make doc' to build the documentation.
Afterwards you can find the HTML documentation in doc/html/.

The pregenerated documentation can also be found on the projects homepage:

   http://www.fatalmind.com/software/ResourcePool/cplusplus/


Status of this project
----------------------

This project was started mainly to proof the concept. Although it is
the plan to provide a industrial strength library there are some things
the Author is not willing to care about. Most prominent is that this library
is a ISO C++ library and it is NOT to goal to make this working with ancient
compilers, or even with a C compiler. But it is the goal to maintain a 
standard confirm program which can be compiled with a standard conform 
compiler. Currently development is done with GCC, and it is known that GCC 
versions previous to 3.3.0 do not have sufficient standard support to compile
ResourcePool.

Obtaining the most recent version
---------------------------------

Find the most recent version of this project on the projects homepage:

   http://www.fatalmind.com/software/ResourcePool/cplusplus/


Authors contact
---------------
       e-mail: mws@fatalmind.com
     homepage: http://www.fatalmind.com/
    whishlist: http://www.amazon.de/exec/obidos/wishlist/1JW6LC92SAK62/
               http://amazon.com/gp/registry/3BXRJP9W3WMDX

Copyright
---------

    ResourcePool Copyright (C) 2004-2008  Markus Winand 

    ResourcePool is free software; you can redistribute it 
    and/or modify it under the terms of the GNU General Public License 
    as published by the Free Software Foundation; either version 2 of 
    the License, or (at your option) any later version.

    ResourcePool is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with ResourcePool; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA