ExternalVendorCode/corda
1
0
Fork 0
mirror of https://github.com/corda/corda.git synced 2024-12-19 21:17:58 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

CORDA-2528 Update contract testing documentation (#4977)

Browse Source
This commit is contained in:
Dan Newton 2019-04-08 12:16:19 +01:00 committed by Shams Asari
parent 76d738c452
commit 40e0e6d5f7
1 changed files with 33 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/source/tutorial-test-dsl.rst
View File

@ -15,6 +15,33 @@ This tutorial will take you through the steps required to write a contract test
The testing DSL allows one to define a piece of the ledger with transactions referring to each other, and ways of
verifying their correctness.
Setting up the test
-------------------
Before writing the individual tests, the general test setup must be configured:
.. container:: codeset
.. sourcecode:: kotlin
class CommercialPaperTest {
private val miniCorp = TestIdentity(CordaX500Name("MiniCorp", "London", "GB"))
private val megaCorp = TestIdentity(CordaX500Name("MegaCorp", "London", "GB"))
private val ledgerServices = MockServices(listOf("net.corda.finance.schemas"), megaCorp, miniCorp)
...
}
.. sourcecode:: java
public class CommercialPaperTest {
private TestIdentity megaCorp = new TestIdentity(new CordaX500Name("MegaCorp", "London", "GB"));
private TestIdentity miniCorp = new TestIdentity(new CordaX500Name("MiniCorp", "London", "GB"));
MockServices ledgerServices = new MockServices(Arrays.asList("net.corda.finance.schemas"), megaCorp, miniCorp);
...
}
The ``ledgerServices`` object will provide configuration to the ``ledger`` DSL in the individual tests.
Testing single transactions
---------------------------
@ -24,25 +51,22 @@ We start with the empty ledger:
.. sourcecode:: kotlin
class CommercialPaperTest{
class CommercialPaperTest {
@Test
fun emptyLedger() {
ledger {
ledgerServices.ledger {
...
}
}
...
}
.. sourcecode:: java
import org.junit.Test;
import static net.corda.testing.NodeTestUtils.ledger;
public class CommercialPaperTest {
@Test
public void emptyLedger() {
ledger(l -> {
ledger(ledgerServices, l -> {
...
return null;
});
}
@ -90,7 +114,7 @@ Let's add a ``CommercialPaper`` transaction:
@Test
public void simpleCPDoesntCompile() {
ICommercialPaperState inState = getPaper();
ledger(l -> {
ledger(ledgerServices, l -> {
l.transaction(tx -> {
tx.input(inState);
});