Category Selected:



REST 2016 - Testing your API with Jasmine

Gavin Pickin |  March 25, 2016

Are you writing APIs? Going to start writing APIs? Now is the time to start testing. Sounds familiar, it should, because you’ll be hearing that a LOT. Do it early, and often, and reap the benefits as the project grows. Whether you are using CFML or not, TestBox is a great way to test your APIs, like I showed you in a previous blog post. Today, we’ll look at Jasmine, and see how you can test your APIs with Javascript… and a couple of “gotchas” I ran into as well.

Read More

REST2016 - Route Conditions

Luis Majano |  March 23, 2016

Sometimes when you define an incoming API route, you want it to match certain environment or aspect conditions. The addRoute() has an argument called condition, which can be a closure or UDF pointer that must return a boolean and receives the incoming requestString. You can then decide if the route should execute or just be ignored.

So if a route matches via the pattern, then this closu...

Read More

Building Ionic Apps with ColdBox REST

Scott Steinbeck |  March 22, 2016

Are you ready to enter the exciting world of app building? In today's world, 60% of people are viewing your website on a mobile phone most sites are hard to navigate.  People constantly ha...

Read More

REST2016 - Testing your API with TestBox

Gavin Pickin |  March 18, 2016

Are you writing APIs? Going to start writing APIs? Now is the time to start testing. Do it early, and often, and reap the benefits as the project grows. TestBox, the defacto CFML test suite, can help your test your API, whether it’s CFML or not.

I will assume you have the basic TextBox installation setup.

Read More

REST2016 - Route Responses

Luis Majano |  March 14, 2016

You can route responses inline with ColdBox via the addRoute() function globally in your main routes.cfm template or within any Module as well. This will allow you to build simple response functions or even mock out or stub a RESTFul service very easily. The paremeters you will use for response routing will be: response, statusCode and statusText.

The response argument can be a string or a closure or UDF pointer. T...

Read More

REST2016 - Creating Sub-module URL entry points

Luis Majano |  March 11, 2016

In this entry I will go over how to leverage ColdBox's Modular architecture to RESTFul routing. In ColdBox, every module's ModuleConfig.cfc you create has two important facets for building RESTFul services: 1) The this.entryPoint and the 2) routes structure in the configure() method.

If you are creating ColdBox applications using modules, then you will benefit with the capability to nest entry points so they can match to nested sub-modules. Let's say you have the following module structure:

  + api
    + security
    + data
Read More

REST2016 - Versioning Your ColdBox REST API with Modules (Runnable Example)

Brad Wood |  March 09, 2016

In our ColdBox RESTFul RoadShow this month, we've been talking about why ColdBox is the fastest and easiest ways to build a robust REST API in CFML.  One of the very powerful features of the ColdBox MVC Platform is that you can use modules to break your apps and APIs up into management chunks  instead of building a monolith.  Modules also let you decouple pieces of your application so multiple teams can work on different parts.  And with the power of CommandBox's CLI and package manager to assemble your app's dependencies, you can even store modules in a completely separate code repository!   This is exactly what we're going to demo today.

Read More

REST2016 - ColdBox REST - BaseHandler Module

Gavin Pickin |  March 04, 2016

In our last blog post, we talked about the ColdBox REST Template, a great way to use Commandbox to spin up a REST Application Template, and get started with ColdBox RESTful services. That doesn’t work if you have an existing application, and you want to add to it. That is why we have created a easy to install Module that you can just plug into your application.

Read More

REST2016 - ColdBox REST Template

Luis Majano |  March 03, 2016

One of the newest additions to the ColdBox application templates and also the CommandBox generation templates is our REST application template.  This template will get you started with creating ColdBox RESTFul services. The best way to start with it is by downloading CommandBox, as we will use this for generation, scaffolding and as your integrated server. Then we can start working on our RESTFul service:

mkdir myservice
box coldbox create app skeleton=rest name=MyService --installColdBox

Once you execute these CLI commands, you will have a new RESTFul service application ready to go.  The next step is to startup an ad-hoc server and test it out:

box server start --rewritesEnable

This will open a browser window with the results of your first RESTFul service:

Read More