1 package org.ldk.structs;
3 import org.ldk.impl.bindings;
4 import org.ldk.enums.*;
6 import java.util.Arrays;
7 import java.lang.ref.Reference;
8 import javax.annotation.Nullable;
12 * Provides references to trait impls which handle different types of messages.
14 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
15 public class MessageHandler extends CommonBase {
16 MessageHandler(Object _dummy, long ptr) { super(ptr); }
17 @Override @SuppressWarnings("deprecation")
18 protected void finalize() throws Throwable {
20 if (ptr != 0) { bindings.MessageHandler_free(ptr); }
24 * A message handler which handles messages specific to channels. Usually this is just a
25 * [`ChannelManager`] object or an [`ErroringMessageHandler`].
27 * [`ChannelManager`]: crate::ln::channelmanager::ChannelManager
29 public ChannelMessageHandler get_chan_handler() {
30 long ret = bindings.MessageHandler_get_chan_handler(this.ptr);
31 Reference.reachabilityFence(this);
32 if (ret >= 0 && ret <= 4096) { return null; }
33 ChannelMessageHandler ret_hu_conv = new ChannelMessageHandler(null, ret);
34 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); };
39 * A message handler which handles messages specific to channels. Usually this is just a
40 * [`ChannelManager`] object or an [`ErroringMessageHandler`].
42 * [`ChannelManager`]: crate::ln::channelmanager::ChannelManager
44 public void set_chan_handler(org.ldk.structs.ChannelMessageHandler val) {
45 bindings.MessageHandler_set_chan_handler(this.ptr, val.ptr);
46 Reference.reachabilityFence(this);
47 Reference.reachabilityFence(val);
48 if (this != null) { this.ptrs_to.add(val); };
52 * A message handler which handles messages updating our knowledge of the network channel
53 * graph. Usually this is just a [`P2PGossipSync`] object or an [`IgnoringMessageHandler`].
55 * [`P2PGossipSync`]: crate::routing::gossip::P2PGossipSync
57 public RoutingMessageHandler get_route_handler() {
58 long ret = bindings.MessageHandler_get_route_handler(this.ptr);
59 Reference.reachabilityFence(this);
60 if (ret >= 0 && ret <= 4096) { return null; }
61 RoutingMessageHandler ret_hu_conv = new RoutingMessageHandler(null, ret);
62 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); };
67 * A message handler which handles messages updating our knowledge of the network channel
68 * graph. Usually this is just a [`P2PGossipSync`] object or an [`IgnoringMessageHandler`].
70 * [`P2PGossipSync`]: crate::routing::gossip::P2PGossipSync
72 public void set_route_handler(org.ldk.structs.RoutingMessageHandler val) {
73 bindings.MessageHandler_set_route_handler(this.ptr, val.ptr);
74 Reference.reachabilityFence(this);
75 Reference.reachabilityFence(val);
76 if (this != null) { this.ptrs_to.add(val); };
80 * A message handler which handles onion messages. This should generally be an
81 * [`OnionMessenger`], but can also be an [`IgnoringMessageHandler`].
83 * [`OnionMessenger`]: crate::onion_message::OnionMessenger
85 public OnionMessageHandler get_onion_message_handler() {
86 long ret = bindings.MessageHandler_get_onion_message_handler(this.ptr);
87 Reference.reachabilityFence(this);
88 if (ret >= 0 && ret <= 4096) { return null; }
89 OnionMessageHandler ret_hu_conv = new OnionMessageHandler(null, ret);
90 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); };
95 * A message handler which handles onion messages. This should generally be an
96 * [`OnionMessenger`], but can also be an [`IgnoringMessageHandler`].
98 * [`OnionMessenger`]: crate::onion_message::OnionMessenger
100 public void set_onion_message_handler(org.ldk.structs.OnionMessageHandler val) {
101 bindings.MessageHandler_set_onion_message_handler(this.ptr, val.ptr);
102 Reference.reachabilityFence(this);
103 Reference.reachabilityFence(val);
104 if (this != null) { this.ptrs_to.add(val); };
108 * A message handler which handles custom messages. The only LDK-provided implementation is
109 * [`IgnoringMessageHandler`].
111 public CustomMessageHandler get_custom_message_handler() {
112 long ret = bindings.MessageHandler_get_custom_message_handler(this.ptr);
113 Reference.reachabilityFence(this);
114 if (ret >= 0 && ret <= 4096) { return null; }
115 CustomMessageHandler ret_hu_conv = new CustomMessageHandler(null, ret);
116 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(this); };
121 * A message handler which handles custom messages. The only LDK-provided implementation is
122 * [`IgnoringMessageHandler`].
124 public void set_custom_message_handler(org.ldk.structs.CustomMessageHandler val) {
125 bindings.MessageHandler_set_custom_message_handler(this.ptr, val.ptr);
126 Reference.reachabilityFence(this);
127 Reference.reachabilityFence(val);
128 if (this != null) { this.ptrs_to.add(val); };
132 * Constructs a new MessageHandler given each field
134 public static MessageHandler of(org.ldk.structs.ChannelMessageHandler chan_handler_arg, org.ldk.structs.RoutingMessageHandler route_handler_arg, org.ldk.structs.OnionMessageHandler onion_message_handler_arg, org.ldk.structs.CustomMessageHandler custom_message_handler_arg) {
135 long ret = bindings.MessageHandler_new(chan_handler_arg.ptr, route_handler_arg.ptr, onion_message_handler_arg.ptr, custom_message_handler_arg.ptr);
136 Reference.reachabilityFence(chan_handler_arg);
137 Reference.reachabilityFence(route_handler_arg);
138 Reference.reachabilityFence(onion_message_handler_arg);
139 Reference.reachabilityFence(custom_message_handler_arg);
140 if (ret >= 0 && ret <= 4096) { return null; }
141 org.ldk.structs.MessageHandler ret_hu_conv = null; if (ret < 0 || ret > 4096) { ret_hu_conv = new org.ldk.structs.MessageHandler(null, ret); }
142 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(ret_hu_conv); };
143 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(chan_handler_arg); };
144 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(route_handler_arg); };
145 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(onion_message_handler_arg); };
146 if (ret_hu_conv != null) { ret_hu_conv.ptrs_to.add(custom_message_handler_arg); };