RESTFul Extension Detection
ColdBox allows you to detect incoming extensions from incoming paths automatically for you. This is great for building multi-type responses or to just create virtual extensions for events.
http://localhost/usershttp://localhost/users.jsonhttp://localhost/users.xmlhttp://localhost/users.pdfhttp://localhost/users.html
If an extension is detected in the incoming URL, ColdBox will grab it and store it in the request collection (RC) as the variable format. If there is no extension, then rc.format will not be stored and thus will not exist.
http://localhost/users => rc.format is null, does not existhttp://localhost/users.json => rc.format = jsonhttp://localhost/users.xml => rc.format = xmlhttp://localhost/users.pdf => rc.format = pdfhttp://localhost/users.html => rc.format = html
You can configure the extension detection using the following configuration methods:
Method | Description |
| By default ColdBox detects URL extensions like |
| Tell the interceptor what valid extensions your application can listen to. By default it listens to: |
| By default ColdBox does not throw an exception when an invalid extension is detected. If true, then the interceptor will throw a 406 Invalid Requested Format Extension: {extension} exception. Default is false. |
Please note that if you have set to throw exceptions if an invalid extension is detected then a 406 exception will be thrown.