6dfd4512d07d8511f10fb31aa55ca18c6f2113b7
[ldk-java] / src / main / java / org / ldk / structs / EventHandler.java
1 package org.ldk.structs;
2
3 import org.ldk.impl.bindings;
4 import org.ldk.enums.*;
5 import org.ldk.util.*;
6 import java.util.Arrays;
7 import java.lang.ref.Reference;
8 import javax.annotation.Nullable;
9
10 /**
11  * A trait implemented for objects handling events from [`EventsProvider`].
12  * 
13  * An async variation also exists for implementations of [`EventsProvider`] that support async
14  * event handling. The async event handler should satisfy the generic bounds: `F:
15  * core::future::Future, H: Fn(Event) -> F`.
16  */
17 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
18 public class EventHandler extends CommonBase {
19         final bindings.LDKEventHandler bindings_instance;
20         EventHandler(Object _dummy, long ptr) { super(ptr); bindings_instance = null; }
21         private EventHandler(bindings.LDKEventHandler arg) {
22                 super(bindings.LDKEventHandler_new(arg));
23                 this.ptrs_to.add(arg);
24                 this.bindings_instance = arg;
25         }
26         @Override @SuppressWarnings("deprecation")
27         protected void finalize() throws Throwable {
28                 if (ptr != 0) { bindings.EventHandler_free(ptr); } super.finalize();
29         }
30
31         public static interface EventHandlerInterface {
32                 /**
33                  * Handles the given [`Event`].
34                  * 
35                  * See [`EventsProvider`] for details that must be considered when implementing this method.
36                  */
37                 void handle_event(Event event);
38         }
39         private static class LDKEventHandlerHolder { EventHandler held; }
40         public static EventHandler new_impl(EventHandlerInterface arg) {
41                 final LDKEventHandlerHolder impl_holder = new LDKEventHandlerHolder();
42                 impl_holder.held = new EventHandler(new bindings.LDKEventHandler() {
43                         @Override public void handle_event(long event) {
44                                 org.ldk.structs.Event event_hu_conv = org.ldk.structs.Event.constr_from_ptr(event);
45                                 if (event_hu_conv != null) { event_hu_conv.ptrs_to.add(this); };
46                                 arg.handle_event(event_hu_conv);
47                                 Reference.reachabilityFence(arg);
48                         }
49                 });
50                 return impl_holder.held;
51         }
52         /**
53          * Handles the given [`Event`].
54          * 
55          * See [`EventsProvider`] for details that must be considered when implementing this method.
56          */
57         public void handle_event(org.ldk.structs.Event event) {
58                 bindings.EventHandler_handle_event(this.ptr, event.ptr);
59                 Reference.reachabilityFence(this);
60                 Reference.reachabilityFence(event);
61         }
62
63 }