ExternalVendorCode/corda
1
0
Fork 0
mirror of https://github.com/corda/corda.git synced 2025-01-31 08:25:50 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

core: Add javadoc on how to be Java-compatible with the Kotlin DSL

Browse Source
This commit is contained in:
Andras Slemmer 2016-06-22 12:03:36 +01:00
parent 6109065dee
commit bec1ab7a7e
2 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
core/src/main/kotlin/com/r3corda/core/contracts/ContractsDSL.kt
View File

@ -5,7 +5,7 @@ import java.security.PublicKey
import java.util.*
/**
* Defines a simple domain specific language for the specificiation of financial contracts. Currently covers:
* Defines a simple domain specific language for the specification of financial contracts. Currently covers:
*
* - Some utilities for working with commands.
* - Code for working with currencies.

17
core/src/main/kotlin/com/r3corda/core/testing/TestUtils.kt
View File

@ -39,8 +39,19 @@ object TestUtils {
val keypair3 = generateKeyPair()
}
// A dummy time at which we will be pretending test transactions are created.
val TEST_TX_TIME = Instant.parse("2015-04-17T12:00:00.00Z")
/**
* JAVA INTEROP. Please keep the following points in mind when extending the Kotlin DSL
*
* - Annotate functions with Kotlin defaults with @JvmOverloads. This produces the relevant overloads for Java.
* - Void closures in arguments are inconvenient in Java, use overloading to define non-closure variants as well
* - Top-level vals should be defined in the [Java] object and annotated with @JvmField first and should be referred
* to from the global val. This allows static importing of [Java] in Java tests, which mimicks top-level vals.
* - Same goes for top-level funs. Define them in [Java] with annotation @JvmStatic and define a global alias later.
* - Infix functions work as regular ones from Java, but symbols with spaces in them don't! Define a camelCase variant
* as well.
* - varargs are exposed as array types in Java. Define overloads for common cases.
* - The Int.DOLLARS syntax doesn't work from Java. To remedy add a @JvmStatic DOLLARS(Int) function to [Java]
*/
// A few dummy values for testing.
val MEGA_CORP_KEY = TestUtils.keypair
@ -94,8 +105,6 @@ fun generateStateRef() = StateRef(SecureHash.randomSHA256(), 0)
// contract `fails requirement` "some substring of the error message"
// }
//
// TODO: Make it impossible to forget to test either a failure or an accept for each transaction{} block
class LabeledOutput(val label: String?, val state: TransactionState<*>) {
override fun toString() = state.toString() + (if (label != null) " ($label)" else "")
override fun equals(other: Any?) = other is LabeledOutput && state.equals(other.state)