X-Git-Url: http://git.bitcoin.ninja/index.cgi?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FRouteHop.java;fp=src%2Fmain%2Fjava%2Forg%2Fldk%2Fstructs%2FRouteHop.java;h=ace10a9b2eea39fe6705324d07f856de303ca55f;hb=fed2245c60159f6c074c9ed5c0f3ce273ad9841b;hp=fe13c7b52a9933b09a5483c38ee9386d97f1496e;hpb=e9c2970adecaa14b3e83e11eb160a7bcbdae20da;p=ldk-java diff --git a/src/main/java/org/ldk/structs/RouteHop.java b/src/main/java/org/ldk/structs/RouteHop.java index fe13c7b5..ace10a9b 100644 --- a/src/main/java/org/ldk/structs/RouteHop.java +++ b/src/main/java/org/ldk/structs/RouteHop.java @@ -17,6 +17,7 @@ public class RouteHop extends CommonBase { public RouteHop clone() { long ret = bindings.RouteHop_clone(this.ptr); RouteHop ret_hu_conv = new RouteHop(null, ret); + ret_hu_conv.ptrs_to.add(this); return ret_hu_conv; } @@ -32,12 +33,21 @@ public class RouteHop extends CommonBase { public NodeFeatures get_node_features() { long ret = bindings.RouteHop_get_node_features(this.ptr); NodeFeatures ret_hu_conv = new NodeFeatures(null, ret); + ret_hu_conv.ptrs_to.add(this); return ret_hu_conv; } public void set_node_features(NodeFeatures val) { bindings.RouteHop_set_node_features(this.ptr, val == null ? 0 : val.ptr & ~1); this.ptrs_to.add(val); + // Due to rust's strict-ownership memory model, in some cases we need to "move" + // an object to pass exclusive ownership to the function being called. + // In most cases, we avoid this being visible in GC'd languages by cloning the object + // at the FFI layer, creating a new object which Rust can claim ownership of + // However, in some cases (eg here), there is no way to clone an object, and thus + // we actually have to pass full ownership to Rust. + // Thus, after this call, val is reset to null and is now a dummy object. + val.ptr = 0; } public long get_short_channel_id() { @@ -52,12 +62,21 @@ public class RouteHop extends CommonBase { public ChannelFeatures get_channel_features() { long ret = bindings.RouteHop_get_channel_features(this.ptr); ChannelFeatures ret_hu_conv = new ChannelFeatures(null, ret); + ret_hu_conv.ptrs_to.add(this); return ret_hu_conv; } public void set_channel_features(ChannelFeatures val) { bindings.RouteHop_set_channel_features(this.ptr, val == null ? 0 : val.ptr & ~1); this.ptrs_to.add(val); + // Due to rust's strict-ownership memory model, in some cases we need to "move" + // an object to pass exclusive ownership to the function being called. + // In most cases, we avoid this being visible in GC'd languages by cloning the object + // at the FFI layer, creating a new object which Rust can claim ownership of + // However, in some cases (eg here), there is no way to clone an object, and thus + // we actually have to pass full ownership to Rust. + // Thus, after this call, val is reset to null and is now a dummy object. + val.ptr = 0; } public long get_fee_msat() { @@ -81,8 +100,25 @@ public class RouteHop extends CommonBase { public static RouteHop constructor_new(byte[] pubkey_arg, NodeFeatures node_features_arg, long short_channel_id_arg, ChannelFeatures channel_features_arg, long fee_msat_arg, int cltv_expiry_delta_arg) { long ret = bindings.RouteHop_new(pubkey_arg, node_features_arg == null ? 0 : node_features_arg.ptr & ~1, short_channel_id_arg, channel_features_arg == null ? 0 : channel_features_arg.ptr & ~1, fee_msat_arg, cltv_expiry_delta_arg); RouteHop ret_hu_conv = new RouteHop(null, ret); + ret_hu_conv.ptrs_to.add(ret_hu_conv); ret_hu_conv.ptrs_to.add(node_features_arg); + // Due to rust's strict-ownership memory model, in some cases we need to "move" + // an object to pass exclusive ownership to the function being called. + // In most cases, we avoid ret_hu_conv being visible in GC'd languages by cloning the object + // at the FFI layer, creating a new object which Rust can claim ownership of + // However, in some cases (eg here), there is no way to clone an object, and thus + // we actually have to pass full ownership to Rust. + // Thus, after ret_hu_conv call, node_features_arg is reset to null and is now a dummy object. + node_features_arg.ptr = 0; ret_hu_conv.ptrs_to.add(channel_features_arg); + // Due to rust's strict-ownership memory model, in some cases we need to "move" + // an object to pass exclusive ownership to the function being called. + // In most cases, we avoid ret_hu_conv being visible in GC'd languages by cloning the object + // at the FFI layer, creating a new object which Rust can claim ownership of + // However, in some cases (eg here), there is no way to clone an object, and thus + // we actually have to pass full ownership to Rust. + // Thus, after ret_hu_conv call, channel_features_arg is reset to null and is now a dummy object. + channel_features_arg.ptr = 0; return ret_hu_conv; }