Upgrading from version 6.6 to version 6.7
Consider the following information when upgrading from Diffusion™ Cloud version 6.6 to version 6.7.
Upgrading your applications
- Clients
-
You can choose not to recompile your client applications and continue to use client libraries from a previous release. If you choose to use client libraries from a previous release, ensure that the libraries are compatible with the new server. For more information, see Interoperability.
You can choose to upgrade your client applications to use the new client libraries. To do this, recompile the client applications against the client libraries located in the clients directory of your new Diffusion Cloud server installation and repackage your client application with the new library.
Your client applications may use features that have been removed or deprecated. Review the API changes information in the following section to see if these changes affect your applications.
The minimum Xcode version for the Apple SDK is now 12.4.
Note that the local install method for the Python SDK has changed. See the Client basics page for Python for details.
API changes
Further information about removed or deprecated features is available in the release notes provided online at http://docs.pushtechnology.com/docs/6.7.4/ReleaseNotice.html
API affected | Deprecated feature | Suggested alternative |
---|---|---|
All SDKs | Routing topics | Use session trees. |
All SDKs | Fan-out | Use remote topic views. |
Java & NET clients | All methods that use callbacks | Use CompletableFutures (for Java) or task based variants (for .NET). |
Java client | ClientControl.sessionIdFromString | Diffusion.sessionIdFromString |
Java client | ClientControl.setQueueEventHandler(QueueEventHandler) | setQueueEventHandler(QueueEventStream) |
Java client | ClientControl.setSessionPropertiesListener(SessionPropertiesListener) | setSessionPropertiesListener(SessionPropertiesStream) |
Java client | TopicControl.addMissingTopicHandler(String, MissingTopicHandler) | addMissingTopicHandler(String, MissingTopicNitificationStream) |
Java client | TopicControl.newSpecification | Diffusion.newTopicSpecification |
API affected | Removed feature | Suggested alternative |
---|---|---|
All SDKs | MessagingControl feature interface | All functionality is available through the Messaging feature. |
Java, Android, C, JavaScript clients | Unused TopicAddFailReason values: INITIALISE_ERROR, TOPIC_NOT_FOUND, USER_CODE_ERROR | none |