org.bitcoinj.jni

Class NativePaymentChannelServerConnectionEventHandler

java.lang.Object

org.bitcoinj.protocols.channels.ServerConnectionEventHandler

org.bitcoinj.jni.NativePaymentChannelServerConnectionEventHandler

public class NativePaymentChannelServerConnectionEventHandler
extends ServerConnectionEventHandler

An event listener that relays events to a native C++ object. A pointer to that object is stored in this class using JNI on the native side, thus several instances of this can point to different actual native implementations.

Field Summary

Fields

Modifier and Type	Field and Description
long	ptr

Constructor Summary

Constructors

Constructor and Description
NativePaymentChannelServerConnectionEventHandler()

Method Summary

Modifier and Type	Method and Description
void	channelClosed(PaymentChannelCloseException.CloseReason reason) Called when the channel was closed for some reason.
void	channelOpen(Sha256Hash channelId) Triggered when the channel is opened and application messages/payments can begin
ListenableFuture<com.google.protobuf.ByteString>	paymentIncrease(Coin by, Coin to, com.google.protobuf.ByteString info) Called when the payment in this channel was successfully incremented by the client

Methods inherited from class org.bitcoinj.protocols.channels.ServerConnectionEventHandler

closeChannel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ptr

public long ptr

Constructor Detail

NativePaymentChannelServerConnectionEventHandler

public NativePaymentChannelServerConnectionEventHandler()

Method Detail

channelOpen

public void channelOpen(Sha256Hash channelId)

Description copied from class: ServerConnectionEventHandler

Triggered when the channel is opened and application messages/payments can begin

Specified by:

channelOpen in class ServerConnectionEventHandler

Parameters:

channelId - A unique identifier which represents this channel (actually the hash of the multisig contract)

paymentIncrease

public ListenableFuture<com.google.protobuf.ByteString> paymentIncrease(Coin by,
                                                                        Coin to,
                                                                        com.google.protobuf.ByteString info)

Description copied from class: ServerConnectionEventHandler

Called when the payment in this channel was successfully incremented by the client

Specified by:

paymentIncrease in class ServerConnectionEventHandler

Parameters:

by - The increase in total payment

to - The new total payment to us (not including fees which may be required to claim the payment)

info - Information about this payment increase, used to extend this protocol.

Returns:

acknowledgment information to be sent to the client.

channelClosed

public void channelClosed(PaymentChannelCloseException.CloseReason reason)

Description copied from class: ServerConnectionEventHandler

Called when the channel was closed for some reason. May be called without a call to ServerConnectionEventHandler.channelOpen(Sha256Hash).

Note that the same channel can be reopened at any point before it expires if the client reconnects and requests it.

Specified by:

channelClosed in class ServerConnectionEventHandler