Installation

To install Transfer, the following steps must be followed.

1. Download Transfer.
2. Either place the directory '/transfer/' in the webroot of your server, or create a mapping called '/transfer' to the '/transfer/' folder.
3. Write an xml config file that outlines the database connectivity details.
   Datasource Configuration File

4. Write an xml config file that outlines the objects and classes for transfer to manufacture.
   Transfer Configuration File
5. Create a singleton of transfer.TransferFactory.

   The paths that are passed in as arguments to transfer.TransferFactory are all relative, and should be passed from root, i.e. starting with '/'.
   This is particularly important for the definitions directory, as it is used to cfinclude files from, so it must either be from the web root, or point to a ColdFusion Mapping

   For example:

   application.transferFactory = createObject("component", "transfer.TransferFactory").init(
    							"/myapp/configs/datasource.xml", 
    							"/myapp/configs/xml/transfer.xml",
    							"/myapp/definitions");
   

   The TransferFactory can also be instantiated by passing a transfer.com.config.Configuration object to the TransferFactory, for example:

   config = createObject("transfer.com.config.Configuration").init(
    							"/myapp/configs/datasource.xml", 
    							"/myapp/configs/xml/transfer.xml",
    							"/myapp/definitions");
    
   application.transferFactory = createObject("component", "transfer.TransferFactory").init(configuration=config);
   

6. All interaction with Transfer is now done through the instantiated transfer.TransferFactory.

Updating from a previous version

If you are updating from a previous version of Transfer,

1. You will need to delete all of your .transfer generated files. In each version of Transfer it is likely that the details written in these files will differ greatly from the previous version.
2. If the previous version of Transfer contains a Java Library (.jar) file, it is likely that you will not be able to delete it. Simply place the newer Transfer .jar files in the same library, and the previous version will be ignored by Transfer. Once the ColdFusion server is reset, or the garbage collector picks up the Object that references the file, you will be able to delete it.