Hi John,
Yes you are right, the transition to version 2 has involved a big step forward as the interface offered is completely different to implement the Unified Client API model.
Over time, almost all client libraries have implemented the Unified model in such a way the same consistent interface and behavior are guaranteed across different client platforms.
In other words, the same abstractions and internal mechanisms are provided for very different platforms, while respecting the conventions, styles, and best practice of each platform.
Unfortunately there is no specific guide for migration between the two API models relating to Java/Android client lib, but you could still take a look at the one relating to the JavaScript library (
http://blog.lightstreamer.com/2012/09/how-to-upgrade-to-javascript-client.html).
I am aware that there are big differences between the two libraries but the migration concepts about connecting and converting old tables to the new subscription concept could be still useful.
But maybe what could be even more effective is to compare our StockList demo in the old and new version. Please refer to this for the old style lib:
https://github.com/Lightstreamer/Lightstreamer-example-StockList-client-java/blob/latest-for-client-2.x/src/javasedemo/swing/StockFeed.java
and this for the unified version of the same:
https://github.com/Lightstreamer/Lightstreamer-example-StockList-client-java/blob/master/src/javasedemo/swing/StockFeed.java
Please let us know if you need any further clarifications.
Regards,
Giuseppe