Medical Imaging Interaction Toolkit
2024.12.99-0da743f6
Medical Imaging Interaction Toolkit
|
In Example 4, we created a more robust client bundle for our dictionary service. Due to the complexity of dealing with dynamic service availability, even that client may not sufficiently address all situations. To deal with this complexity the C++ Micro Services library provides the ServiceTracker
utility class. In this example we create a client for the dictionary service that uses the ServiceTracker
class to monitor the dynamic availability of the dictionary service, resulting in an even more robust client.
The functionality of the new dictionary client is essentially the same as the one from Example 4. Our module uses its module context to create a ServiceTracker
instance to track the dynamic availability of the dictionary service on our behalf. Our client uses the dictionary service returned by the ServiceTracker
, which is selected based on a ranking algorithm defined by the C++ Micro Services library. The source code for our modules is as follows in a file called dictionaryclient3/Activator.cpp
:
Since this client uses the ServiceTracker
utility class, it will automatically monitor the dynamic availability of the dictionary service. Again, we must link our module to the dictionaryservice
module:
After running the usCoreExamplesDriver
executable, and loading the event listener module, we can use the l dictionaryclient3
command to load our robust dictionary client module:
CppMicroServices-debug> bin/usCoreExamplesDriver > l eventlistener Starting to listen for service events. > l dictionaryclient3 Ex1: Service of type IDictionaryService/1.0 registered. Enter a blank line to exit. Enter word:
The above command loads the module and its dependencies (the dictionaryservice
module) in a single step. When we load the module, it will use the main thread to prompt us for words. Enter one word at a time to check the words and enter a blank line to stop checking words. To reload the module, we must use the s
command to get the module identifier number for the module and first use the u <id>
command to unload the module, then the l <id>
command to re-load it. To test the dictionary service, enter any of the words in the dictionary (e.g., "welcome", "to", "the", "micro", "services", "tutorial") or any word not in the dictionary.
Since this client monitors the dynamic availability of the dictionary service, it is robust in the face of sudden departures of the the dictionary service. Further, when a dictionary service arrives, it automatically gets the service if it needs it and continues to function. These capabilities are a little difficult to demonstrate since we are using a simple single-threaded approach, but in a multi-threaded or GUI-oriented application this robustness is very useful.