ExternalVendorCode/corda
1
0
Fork 0
mirror of https://github.com/corda/corda.git synced 2025-06-05 17:01:45 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

testing changes batch

Browse Source 
Signed-off-by: Ed Prosser <edward.prosser@r3.com>
This commit is contained in:
Ed Prosser 2019-07-02 14:43:17 +01:00 committed by Mike Hearn
parent a5ad24fc00
commit e3e16c0f52
2 changed files with 65 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

128
docs/source/quickstart-build.rst
View File

@ -25,7 +25,7 @@ The first thing you need to do is clone a CorDapp template to modify.
Step Two: Creating states Step Two: Creating states
------------------------- -------------------------
Since the CorDapp models a car dealership network, a state must be created to represent cars. Since the CorDapp models a car dealership network, a state must be created to represent cars. States are immutable objects representing on-ledger facts. A state might represent a physical asset like a car, or an intangible asset or agreement like an IOU. For more information on states, see the `state documentation <./key-concepts-states.html>`_.
1. From IntelliJ expand the source files and navigate to ``contracts > src > main > kotlin > com.template > states > TemplateState.kt``. 1. From IntelliJ expand the source files and navigate to ``contracts > src > main > kotlin > com.template > states > TemplateState.kt``.
@ -46,32 +46,34 @@ Since the CorDapp models a car dealership network, a state must be created to re
* ``dealershipLocation`` of type ``String`` * ``dealershipLocation`` of type ``String``
* ``linearId`` of type ``UniqueIdentifier`` * ``linearId`` of type ``UniqueIdentifier``
Don't worry if you're not sure exactly how these should appear, you can check your code shortly.
5. Remove the ``data`` and ``participants`` parameters. 5. Remove the ``data`` and ``participants`` parameters.
6. Add a body to the ``CarState`` class that overrides participants to contain a list of ``owningBank``, ``holdingDealer``, and ``manufacturer``. 6. Add a body to the ``CarState`` class that overrides participants to contain a list of ``owningBank``, ``holdingDealer``, and ``manufacturer``.
7. The ``CarState`` file should now appear as follows: 7. The ``CarState`` file should now appear as follows:
.. container:: codeset .. container:: codeset
.. sourcecode:: kotlin .. sourcecode:: kotlin
@BelongsToContract(TemplateContract::class) @BelongsToContract(TemplateContract::class)
data class CarState(val owningbank: Party, data class CarState(val owningbank: Party,
val holdingDealer: Party, val holdingDealer: Party,
val manufacturer: Party, val manufacturer: Party,
val vin: String, val vin: String,
val licensePlateNumber: String, val licensePlateNumber: String,
val make: String, val make: String,
val model: String, val model: String,
val dealershipLocation: String, val dealershipLocation: String,
val linearId: UniqueIdentifier) : ContractState { val linearId: UniqueIdentifier) : ContractState {
override val participants: List<AbstractParty> = listOf(owningBank, holdingDealer, manufacturer) override val participants: List<AbstractParty> = listOf(owningBank, holdingDealer, manufacturer)
} }
8. Save the ``CarState.kt`` file. 8. Save the ``CarState.kt`` file.
The ``CarState`` definition has now been created. It lists the properties required of all instances of this state and their types. The ``CarState`` definition has now been created. It lists the properties and associated types required of all instances of this state.
Step Three: Creating contracts Step Three: Creating contracts
@ -102,32 +104,32 @@ After creating a state, you must create a contract to dictate how the state can
9. The ``CarContract.kt`` file should look as follows: 9. The ``CarContract.kt`` file should look as follows:
.. container:: codeset .. container:: codeset
.. sourcecode:: kotlin .. sourcecode:: kotlin
class CarContract : Contract { class CarContract : Contract {
companion object { companion object {
const val ID = "com.template.contracts.CarContract" const val ID = "com.template.contracts.CarContract"
} }
override fun verify(tx: LedgerTransaction) { override fun verify(tx: LedgerTransaction) {
val command = tx.commands.requireSingleCommand<Commands.Issue>() val command = tx.commands.requireSingleCommand<Commands.Issue>()
requireThat { requireThat {
"There should be no input state" using (tx.inputs.isEmpty()) "There should be no input state" using (tx.inputs.isEmpty())
"There should be one input state" using (tx.outputs.size == 1) "There should be one input state" using (tx.outputs.size == 1)
"The output state must be of type CarState" using (tx.outputs.get(0).data is CarState) "The output state must be of type CarState" using (tx.outputs.get(0).data is CarState)
val outputState = tx.outputs.get(0).data as CarState val outputState = tx.outputs.get(0).data as CarState
"The licensePlateNumber must be seven characters long" using (outputState.licensePlateNumber.length == 7) "The licensePlateNumber must be seven characters long" using (outputState.licensePlateNumber.length == 7)
}
}
interface Commands : CommandData {
class Issue : Commands
} }
} }
interface Commands : CommandData {
class Issue : Commands
}
}
10. Save the ``CarContract.kt`` file. 10. Save the ``CarContract.kt`` file.
Step Four: Creating a flow Step Four: Creating a flow
@ -163,38 +165,38 @@ Step Four: Creating a flow
12. The ``CarFlow.kt`` file should look like this: 12. The ``CarFlow.kt`` file should look like this:
.. container:: codeset .. container:: codeset
.. sourcecode:: kotlin .. sourcecode:: kotlin
@InitiatingFlow @InitiatingFlow
@StartableByRPC @StartableByRPC
class CarIssueInitiator(val owningBank: Party, class CarIssueInitiator(val owningBank: Party,
val holdingDealer: Party, val holdingDealer: Party,
val manufacturer: Party, val manufacturer: Party,
val vin: String, val vin: String,
val licensePlateNumber: String, val licensePlateNumber: String,
val make: String, val make: String,
val model: String, val model: String,
val dealershipLocation: String) : FlowLogic<Unit>() { val dealershipLocation: String) : FlowLogic<Unit>() {
override val progressTracker = ProgressTracker() override val progressTracker = ProgressTracker()
@Suspendable @Suspendable
override fun call() { override fun call() {
val notary = serviceHub.networkMapCache.notaryIdentities.single() val notary = serviceHub.networkMapCache.notaryIdentities.single()
val command = Command(CarContract.Commands.Issue(), listOf(owningBank, holdingDealer, manufacturer).map { it.owningKey }) val command = Command(CarContract.Commands.Issue(), listOf(owningBank, holdingDealer, manufacturer).map { it.owningKey })
val carState = CarState(owningBank, holdingDealer, manufacturer, vin, licensePlateNumber, make, model, dealershipLocation, UniqueIdentifier()) val carState = CarState(owningBank, holdingDealer, manufacturer, vin, licensePlateNumber, make, model, dealershipLocation, UniqueIdentifier())
} }
} }
@InitiatedBy(CarIssueInitiator::class) @InitiatedBy(CarIssueInitiator::class)
class CarIssueResponder(val counterpartySession: FlowSession) : FlowLogic<Unit>() { class CarIssueResponder(val counterpartySession: FlowSession) : FlowLogic<Unit>() {
@Suspendable @Suspendable
override fun call(){ override fun call(){
} }
} }
} }
**So far you've...** **So far you've...**
@ -406,8 +408,6 @@ Now that the the CorDapp code has been completed and the build file updated, the
3. Run ``build/nodes/runNodes`` 3. Run ``build/nodes/runNodes``
The nodes should open in terminal windows.
4. To run flows in your CorDapp, enter the following flow command from any node terminal window: ``flow start CarIssueInitiator owningBank: Bank of America, holdingDealer: Dealership, manufacturer: Manufacturer, vin:"abc", licensePlateNumber: "abc1234", make: "Honda", model: "Civic", dealershipLocation: "NYC"`` 4. To run flows in your CorDapp, enter the following flow command from any node terminal window: ``flow start CarIssueInitiator owningBank: Bank of America, holdingDealer: Dealership, manufacturer: Manufacturer, vin:"abc", licensePlateNumber: "abc1234", make: "Honda", model: "Civic", dealershipLocation: "NYC"``
5. To check that the state was correctly issued, query the node using the following command: 5. To check that the state was correctly issued, query the node using the following command:

2
docs/source/quickstart-deploy.rst
View File

@ -38,4 +38,4 @@ Step Two: Run a CorDapp transaction
Next steps Next steps
---------- ----------
After deploying the example CorDapp, the next step is to start writing a CorDapp containing your own contract, states, and flows. After deploying the example CorDapp, the next step is to start `writing a CorDapp <./quickstart-build.html>`_ containing your own contract, states, and flows.