Dynamic Finders

Make your model calls more readable by using dynamic finders.

Since the introduction of onMissingMethod() in CFML, we have been able to port over the concept of _dynamic finders_from Rails to CFWheels.

The concept is simple. Instead of using arguments to tell CFWheels what you want to do, you can use a dynamically-named method.

For example, the following code:

me = application.wo.model("user").findOne(where="email='me@myself.com'");

Can also be written as:

me = application.wo.model("user").findOneByEmail("me@myself.com");

Through the power of onMissingMethod(), CFWheels will parse the method name and figure out that the value supplied is supposed to be matched against the email column.

Dynamic Finders Involving More than One Column

You can take this one step further by using code such as:

me = application.wo.model("user").findOneByUserNameAndPassword("bob,pass");

In this case, CFWheels will split the function name on the And part and determine that you want to find the record where the username column is "bob" and the password column is "pass".

When you are passing in two values, make special note of the fact that they should be passed in as a list to one argument and not as two separate arguments.

Works with findAll() too

In the examples above, we've used the findOne() method, but you can use the same approach on a findAll() method as well.

Passing in Other Finder Parameters

In the background, these dynamically-named methods just pass along execution to findOne() or findAll(). This means that you can also pass in any arguments that are accepted by those two methods.

The below code, for example, is perfectly valid:

users = application.wo.model("user").findAllByState(value="NY", order="name", page=3);

When passing in multiple arguments like above, you have to start naming them instead of relying on the order of the arguments though. When doing so, you need to name the argument value if you're passing in just one value and values if you're passing in multiple values in a list. In other words, you need to name it values when calling an Andtype dynamic finder.

users = application.wo.model("user").findAllByCityAndState(
        values="Buffalo,NY", order="name", page=3
);

Avoid the Word "And" in Database Column Names

Keep in mind that this dynamic method calling will break down completely if you ever name a column firstandlastname or something similar because CFWheels will then split the method name incorrectly. So avoid using "And" in the column name if you plan on taking advantage of dynamically-named finder methods.

Last updated

Logo