ArcGIS REST API / OpenLayers / Unit Testing = Fun In The Sun
Until today, I had never truly appreciated the value of unit testing. I recently had the need to bring these ArcGIS REST controls, designed for version 2.6 of OpenLayers, into the current development version. Having no real idea how to get started on this process, I looked to the unit tests as a guide to what needed to be changed. One might be asking why this was necessary, when the team over at Avencia just put together a great ArcGIS REST Plugin that has made its way into the trunk for the upcoming 2.8 release. The answer is that both plugins do different things well. The older AGSControls can perform 'Identify' and 'Geoprocessing' operations rather well, while the Avencia plugin does a great job at displaying and querying a subset of a layer resource.
In two steps I was able to begin the debugging process.
First, adding the unit test for the AGSControl to the 'list-tests.html' file located in the 'tests' folder of a development version of OpenLayers. This unit test, written by the developer, needs to manually downloaded and incorporated into the standard series of tests that come with OpenLayers. As we can see from the image below, this particular test was written as an html file and placed into the 'Control' sub-directory of the 'tests' directory.
[caption id="attachment_256" align="alignnone" width="224" caption="Above: Adding a link to the unit test for use by Test.AnotherWay"][/caption]
After adding the test, we open up 'run-tests.html' in the browser and select 'AgsControl' from the list. After the test has executed, the results are provided to us. With the red light of failure burning bright, we might think to abandon all hope. We are, however, given the cause and location of the failure, an invaluable clue as to where to start debugging. Time to soldier on.
[caption id="attachment_257" align="alignnone" width="300" caption="Above: Unit Test Failure"][/caption]
Using these test results as a road map, even I can eventually debug a plugin. The green light of success offers a reassuring reminder that all is well in the GIS world.
[caption id="attachment_259" align="alignnone" width="300" caption="Above: Successful Unit Test"][/caption]
In the words of Dave Bouwman, who has a whopping fourteen posts in his tag cloud on the subject:
Unit testing is quite possibly the single best practice for ensuring that your code is bug free (or very nearly bug free!).
His 'fundamentals' article provides a great introduction on the subject: which can be read here.