net.corda.core.flows

Class FinalityFlow

FlowLogic

net.corda.core.flows.FinalityFlow

public class FinalityFlow
extends FlowLogic

Verifies the given transaction, then sends it to the named notary. If the notary agrees that the transaction is acceptable then it is from that point onwards committed to the ledger, and will be written through to the vault. Additionally it will be distributed to the parties reflected in the participants list of the states.

The transaction is expected to have already been resolved: if its dependencies are not available in local storage, verification will fail. It must have signatures from all necessary parties other than the notary.

If specified, the extra recipients are sent the given transaction. The base set of parties to inform are calculated from the contract-given set of participants.

The flow returns the same transaction but with the additional signatures from the notary.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FinalityFlow.Companion

Field Summary

Fields

Modifier and Type	Field and Description
static FinalityFlow.Companion	Companion

Constructor Summary

Constructors

Constructor and Description
FinalityFlow(SignedTransaction transaction, java.util.Set<net.corda.core.identity.Party> extraRecipients, ProgressTracker progressTracker) Verifies the given transaction, then sends it to the named notary. If the notary agrees that the transaction is acceptable then it is from that point onwards committed to the ledger, and will be written through to the vault. Additionally it will be distributed to the parties reflected in the participants list of the states.
FinalityFlow(SignedTransaction transaction, java.util.Set<net.corda.core.identity.Party> extraParticipants)
FinalityFlow(SignedTransaction transaction)
FinalityFlow(SignedTransaction transaction, ProgressTracker progressTracker)

Method Summary

Modifier and Type	Method and Description
SignedTransaction	call() This is where you fill out your business logic.
ProgressTracker	getProgressTracker() Override this to provide a class ProgressTracker. If one is provided and stepped, the framework will do something helpful with the progress reports e.g record to the audit service. If this flow is invoked as a subflow of another, then the tracker will be made a child of the current step in the parent. If it's null, this flow doesn't track progress.
SignedTransaction	getTransaction()
static ProgressTracker	tracker()

Methods inherited from class net.corda.core.flows.FlowLogic

call, checkFlowPermission, flowStackSnapshot, getCurrentTopLevel, getFlowInfo, getLogger, getOurIdentity, getOurIdentityAndCert, getProgressTracker, getRunId, getServiceHub, initiateFlow, persistFlowStackSnapshot, receive, recordAuditEvent, send, sendAndReceive, sleep, subFlow, track, waitForLedgerCommit

Field Detail

Companion

public static FinalityFlow.Companion Companion

Constructor Detail

FinalityFlow

public FinalityFlow(SignedTransaction transaction,
                    java.util.Set<net.corda.core.identity.Party> extraRecipients,
                    ProgressTracker progressTracker)

Verifies the given transaction, then sends it to the named notary. If the notary agrees that the transaction is acceptable then it is from that point onwards committed to the ledger, and will be written through to the vault. Additionally it will be distributed to the parties reflected in the participants list of the states.

The transaction is expected to have already been resolved: if its dependencies are not available in local storage, verification will fail. It must have signatures from all necessary parties other than the notary.

If specified, the extra recipients are sent the given transaction. The base set of parties to inform are calculated from the contract-given set of participants.

The flow returns the same transaction but with the additional signatures from the notary.

Parameters:

progressTracker -

Override this to provide a class ProgressTracker. If one is provided and stepped, the framework will do something helpful with the progress reports e.g record to the audit service. If this flow is invoked as a subflow of another, then the tracker will be made a child of the current step in the parent. If it's null, this flow doesn't track progress.

Note that this has to return a tracker before the flow is invoked. You can't change your mind half way through.

transaction - What to commit.

extraRecipients - A list of additional participants to inform of the transaction.

FinalityFlow

public FinalityFlow(SignedTransaction transaction,
                    java.util.Set<net.corda.core.identity.Party> extraParticipants)

FinalityFlow

public FinalityFlow(SignedTransaction transaction)

FinalityFlow

public FinalityFlow(SignedTransaction transaction,
                    ProgressTracker progressTracker)

Method Detail

call

public SignedTransaction call()

This is where you fill out your business logic.

getTransaction

public SignedTransaction getTransaction()

getProgressTracker

public ProgressTracker getProgressTracker()

Override this to provide a class ProgressTracker. If one is provided and stepped, the framework will do something helpful with the progress reports e.g record to the audit service. If this flow is invoked as a subflow of another, then the tracker will be made a child of the current step in the parent. If it's null, this flow doesn't track progress.

Note that this has to return a tracker before the flow is invoked. You can't change your mind half way through.

See Also:

class ProgressTracker

tracker

public static ProgressTracker tracker()