Java applications can safely interrupt a thread that calls a blocking Ice API.
You must enable the
Ice.ThreadInterruptSafe property to use interrupts. Enabling interrupts causes Ice to disable message buffer caching, which may incur a slight performance penalty.
With interrupt support enabled, Ice guarantees that every call into the run time that could potentially block indefinitely is an interruption point. On entry, an interruption point raises the unchecked exception
OperationInterruptedException immediately if the current thread's interrupted flag is true. If the application interrupts the run time after the interruption point has begun its processing, the interruption point will either raise
OperationInterruptedException or return control to the application with the thread's interrupted flag set. Under no circumstances will Ice silently discard an interrupt.
For example, the following code shows how to interrupt a thread that's blocked while making a synchronous proxy invocation:
Here is a similar example that uses the asynchronous proxy API instead:
Synchronous proxy invocations are interruption points. For an asynchronous proxy invocation, the
Async method never blocks and therefore it is not an interruption point.
Additionally, all of the methods listed in Blocking API Calls are also interruption points. In the specific case of
Communicator.destroy(), we recommend calling
destroy in a loop as shown below:
Interrupting a call to
destroy could leave the Ice run time in a partially-destroyed state; calling
destroy again as we've done here ensures Ice can finish reclaiming the communicator's resources.