Quick ORM
Search…
4.2.0
Introduction
Why Quick?
What's New?
Upgrade Guide
Contributing
Guide
Getting Started
Defining An Entity
Retrieving Entities
Working with Entities
Creating New Entities
Updating Existing Entities
Deleting Entities
Query Scopes and Subselects
Relationships
CBORM Compatibility Shim
Collections
Custom Getters & Setters
Serialization
Interception Points
Debugging
FAQ
Cookbook
Introduction
Dynamic Datasource
External Links
API Docs
Source Code
Issue Tracker
Powered By GitBook
Getting Started
qb is the engine that powers Quick. It is highly recommended that you become familiar with the qb documentation.​

Configure a default datasource in your CFML engine

You can do this any way you'd like: through the web admin, in Application.cfc, or using cfconfig.
Make sure to set this.datasource in your Application.cfc so Quick knows which datasource to use.
Quick can use multiple datasources, but it makes it easier to use when you don't have to deal with that.

Download Quick

The easiest way to download Quick is to use ForgeBox with CommandBox. Just run the following from the root of your application:
box install quick

Add a mapping for quick in your Application.cfc

For a default installation in a ColdBox template, the following line will do the trick.
this.mappings[ "/quick" ] = COLDBOX_APP_ROOT_PATH & "/modules/quick";

Configure your defaultGrammar in config/ColdBox.cfc

Quick will auto discover your grammar by default on startup. To avoid this check, set a BaseGrammar.
defaultGrammar is a module setting for Quick. Set it in your config/ColdBox.cfc like so:
moduleSettings = {
quick = {
defaultGrammar = "[email protected]"
}
};
Valid options are any of the qb supported grammars. At the time of writing valid grammar options are: [email protected], [email protected], [email protected] and [email protected]. You can also have qb discover your grammar on application init using [email protected]. Please check the qb docs for additional options.
If you want to use a different datasource and/or grammar for individual entitities you can do so by adding some metadata attributes to your entities.
Previous
Contributing
Next
Defining An Entity
Last modified 11mo ago
Copy link
Edit on GitHub
Outline
Configure a default datasource in your CFML engine
Download Quick
Add a mapping for quick in your Application.cfc
Configure your defaultGrammar in config/ColdBox.cfc