summaryrefslogtreecommitdiff
path: root/java/src/Ice/ThreadHookPlugin.java
blob: 80fa4747a4f9d98622ad3967893733a50ea4556d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
// **********************************************************************
//
// Copyright (c) 2003-2013 ZeroC, Inc. All rights reserved.
//
// This copy of Ice is licensed to you under the terms described in the
// ICE_LICENSE file included in this distribution.
//
// **********************************************************************

package Ice;

/**
 * Class to support thread notification hooks. Applications using thread
 * notifications hooks instantiate a <code>ThreadHookPlugin</code> with
 * a thread notification hook and return the instance from their
 * {@link PluginFactory} implementation.
 *
 * @see PluginFactory
 * @see Plugin
 **/
public class ThreadHookPlugin implements Ice.Plugin
{
    /**
     * Installs a thread notification hook for a communicator.
     *
     * @param communicator The communicator using the thread notification hook.
     * @param threadHook The thread notification hook for the communicator.
     **/
    public 
    ThreadHookPlugin(Communicator communicator, ThreadNotification threadHook)
    {
        if(communicator == null)
        {
            PluginInitializationException ex = new PluginInitializationException();
            ex.reason = "Communicator cannot be null";
            throw ex;
        }

        IceInternal.Instance instance = IceInternal.Util.getInstance(communicator);
        instance.setThreadHook(threadHook);
    }

    /**
     * Called by the Ice run time during communicator initialization. The derived class
     * can override this method to perform any initialization that might be required
     * by a custom thread notification hook.
     **/
    public void 
    initialize()
    {
    }

    /**
     * Called by the Ice run time when the communicator is destroyed. The derived class
     * can override this method to perform any finalization that might be required
     * by a custom thread notification hook.
     **/
    public void
    destroy()
    {
    }
}