To create objects you will use the ReactorFactory object. The ReactorFactory requires that you pass the path to the config file via it's init() method when you instantiate it. Here's an example:
<!--- create the reactorFactory --->
<cfset Reactor = CreateObject("Component", "reactor.reactorFactory").init(expandPath("reactor.xml"))
/>
You will now have an instance of the ReactorFactory. This object provides several methods to create objects, including the following:
createRecord() – Creates Record Objects which represent one row in the database.
createGateway() – Creates Table Data Gateway Objects (Gateways) which are used to act on multiple rows in the database.
createDao() – Creates Data Access Objects (DAOs) which are not typically used directly by developers, but provide methods for loading, saving and deleting single rows in the database.
createTo() – Creates Transfer Objects (TOs) which are not typically used directly by developers, but are used behind the scenes to move data around.
createMetadata() - Creates Metadata Objects which are not typically used directly by developers, but are used to describe the database structure and configuration programmatically.
The first thing I think that most people will want to do is simply list data from their database. We added a record to the User table above, let's go ahead and list it out now.
To do this, we'll need to create a gateway object using the ReactorFactory we created above.
<!--- create a userGateway --->
<cfset UserGateway = Reactor.createGateway("User") />
Gateway Objects provide a getAll() method (among others) which returns all the records in the table. The following code gets all of the records in the User table and dumps it out.
<!--- get all records --->
<cfset qUsers = UserGateway.getAll() />
<!--- dump the results --->
<cfdump var="#qUsers#" />
Here are the results:
For a complete list of Gateway methods, see the Gateway Objects section.