_ Git - ldk-java/blob - src/main/java/org/ldk/structs/MessageHandler.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 /**
  12  * Provides references to trait impls which handle different types of messages.
  13  */
  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 {
  19                 super.finalize();
  20                 if (ptr != 0) { bindings.MessageHandler_free(ptr); }
  21         }
  22
  23         /**
  24          * A message handler which handles messages specific to channels. Usually this is just a
  25          * [`ChannelManager`] object or an [`ErroringMessageHandler`].
  26          *
  27          * [`ChannelManager`]: crate::ln::channelmanager::ChannelManager
  28          */
  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); };
  35                 return ret_hu_conv;
  36         }
  37
  38         /**
  39          * A message handler which handles messages specific to channels. Usually this is just a
  40          * [`ChannelManager`] object or an [`ErroringMessageHandler`].
  41          *
  42          * [`ChannelManager`]: crate::ln::channelmanager::ChannelManager
  43          */
  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); };
  49         }
  50
  51         /**
  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`].
  54          *
  55          * [`P2PGossipSync`]: crate::routing::gossip::P2PGossipSync
  56          */
  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); };
  63                 return ret_hu_conv;
  64         }
  65
  66         /**
  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`].
  69          *
  70          * [`P2PGossipSync`]: crate::routing::gossip::P2PGossipSync
  71          */
  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); };
  77         }
  78
  79         /**
  80          * A message handler which handles onion messages. This should generally be an
  81          * [`OnionMessenger`], but can also be an [`IgnoringMessageHandler`].
  82          *
  83          * [`OnionMessenger`]: crate::onion_message::OnionMessenger
  84          */
  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); };
  91                 return ret_hu_conv;
  92         }
  93
  94         /**
  95          * A message handler which handles onion messages. This should generally be an
  96          * [`OnionMessenger`], but can also be an [`IgnoringMessageHandler`].
  97          *
  98          * [`OnionMessenger`]: crate::onion_message::OnionMessenger
  99          */
 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); };
 105         }
 106
 107         /**
 108          * A message handler which handles custom messages. The only LDK-provided implementation is
 109          * [`IgnoringMessageHandler`].
 110          */
 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); };
 117                 return ret_hu_conv;
 118         }
 119
 120         /**
 121          * A message handler which handles custom messages. The only LDK-provided implementation is
 122          * [`IgnoringMessageHandler`].
 123          */
 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); };
 129         }
 130
 131         /**
 132          * Constructs a new MessageHandler given each field
 133          */
 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); };
 147                 return ret_hu_conv;
 148         }
 149
 150 }