If the core validators are not sufficient for you, then you can create your own custom validators. You can either leverage the udf
validator and create your own closure/lambda to validate inline or create a reusable validator CFC
If you use the udf
validator, then you can declare your validation inline. Just create a closure/lambda that will be called for you at the time of validation. This closure/lambda will receive all the following arguments and MUST return a boolean indicator: true => passed, false => invalid
value
: The value to validate, can be null
target
: The object that is the target of validation
You can also create a reusable CFC that can be shared in any ColdBox app as a validator. Create the CFC and it should implement our interface which can be found here: cbvalidation.models.validators.IValidator
and it specifies just two functions your own validator must implement: getName(), validate():
Here is a sample validator:
You can use them in two approaches when defining them in your constraints:
Use the validator
constraints which points to the Wirebox ID of your own custom validator object. Please note that if you use this approach you will not be able to pass validation data into the validator.
Use the WireBox ID as they key of your validator. Then you can pass your own validation data into the validator.
Approach number 2 is much more flexible as it will allow you to declare multiple custom validators and each of those validators can receive validation data as well.
If you don't have any validation data to pass to a validator, just pass an empty struct ({}
) or an empty string