kallasoft

Work on Beta 5 of the kallasoft SmugMug Java API is progressing really well.

We took this opportunity to solidify the API foundation and partition off the more functionally-generic portions of it off by themselves so sub-classes of custom method implementations or future API classes could easily reuse them.

This is most noticeable in the Upload method implementations where previously the methods were implemented so version-specifically that each new version of the Upload method (1.2.1, 1.2.2, etc.) had to provide an almost complete duplicate of the Upload logic over and over.

Now the relationships between sub-classes and super-classes has been organized so much better for all methods that the only parts necessary to include for future API methods are just a diff of whatever new behavior is provided by the API.

We also optimized logging quite a bit, removing a lot of logging memory and cpu overhead (what little there was) in addition to improving the Javadoc detail and clarity across the board with the more complex classes and methods. This should hopefully make it even easier for implementors to hit the ground running when extending the API.

Be sure to check out the Changelog to get an idea of what all has changed so far. There haven’t been any big breaks, just a few method argument adjustments in UploadHTTPPut, so this should be a mostly smooth update for a lot of folks.

Also we are waiting to finish rounding out the test cases for the 1.2.1 classes and adding support for 1 more package of methods from 1.2.1 before making the Beta 5 release.

Beta 6 will likely include 1 major method argument change in that APIKey is currently required for every method call, but it seems on the SmugMug side it’s actually only needed for the login methods and ignored everywhere else. We will take a look at removing that across the board if we can do it cleanly in a way that makes sense.

we also expect to have the rest of the Beta 6 changes be almost completely new-method support from 1.2.1 and no more API changes.