Commit Graph

27 Commits

Author SHA1 Message Date
Arshad Mahmood
1b4189b2b3 Added explicit publishing configuration for projects bundled as jars, this change was required when upgrading to kotlin 1.9.0 2023-11-08 10:48:10 +00:00
Arshad Mahmood
6dd33fb8f7 Upgrade to gradle 7.6, kotlin 1.8 and jdk 17
Major changes due to JDK 17:
1. JDK17 JCE Provider now has built-in support for eddsas, corda uses
   the bouncycastle (i2p) implementation. This PR removes the conflicting
   algorithms from the built-in JCE provider.

2. JavaScript scripting has been removed from the JDK, the corda log4j config was using
   scripting to conditionally output additional diagnostic info if the MDC
   was populated. This PR has removed the scripting.

3. The artifactory plug-ins used are now deprecated, this PR has removed them
   and uses the same code as Corda 5 for publishing to artifactory.

4. Javadoc generation has been modified to use the latest dokka plug-ins.

5. Gradle 7.6 has implemented an incredibly annoying change where transitive
   dependencies are not put on the compile classpath, so that they have to be
   explicitly added as dependencies to projects.

6. Mockito has been updated, which sadly meant that quite a few source files
   have to changes to use the new (org.mockito.kotlin) package name. This makes
   this PR appear much larger than it is.

7. A number of tests have been marked as ignored to get a green, broadly they fall
   into 3 classes.

   The first is related to crypto keypair tests, it appears some logic
   in the JDK prefers to use the SunJCE implementation and we prefer to use
   bouncycastle. I believe this issue can be fixed with better test setup.

   The second group is related to our use of a method called "uncheckedCast(..)",
   the purpose of this method was to get rid of the annoying unchecked cast compiler
   warning that would otherwise exist. It looks like the Kotlin 1.9 compiler type
   inference differs and at runtime sometimes the type it infers is "Void" which causes
   an exception at runtime. The simplest solution is to use an explicit cast instead of
   unchecked cast, Corda 5 have removed unchecked cast from their codebase.

   The third class are a number of ActiveMQ tests which appear to have a memory leak somewhere.
2023-11-06 10:24:17 +00:00
Rick Parker
9c30d5a2cc
ENT-6498 Fix API docs dependencies (#7054) 2022-02-08 10:25:07 +00:00
Ross Nicoll
bab99e2fb4
NOTICK Move docs external links to HTTPS (#6835) 2020-12-15 15:27:52 +00:00
Euan Cairncross
1660e7674b
INFRA-270 Publish archived API docs to Artifactory when tagged (#6309)
* Reintroduce `build.gradle` from 4.4
* Add Jenkins publication logic

Co-authored-by: Waldemar Zurowski <waldemar.zurowski@r3.com>
Co-authored-by: Ross Nicoll <ross.nicoll@r3.com>
2020-07-16 10:46:42 +01:00
ivanterziev
73d5fc4db6
EG-1404 - Retired the rst doc source structure under /docs and update… (#6147)
* Retired the rst doc source structure under /docs and updated the /docs/README.md
*Rollback of /example-code and /whitepaper dirs back under /docs dir until new code example process is in place
2020-04-23 09:56:57 +01:00
grogsaxle
4d082556d9 updated jackson-core api documentation to 2.9 2019-05-08 11:48:09 +02:00
Dimos Raptis
49fb03bf6b
Fix documentation issues (#4721) 2019-02-06 12:49:47 +00:00
Stefano Franz
b5d80e0c3c add --rm flag for the windows docs build 2019-01-30 15:33:46 +00:00
Stefano Franz
875d2eb02a run docs build as local user 2019-01-30 15:33:46 +00:00
Stefano Franz
1dcc1c6e05 fix issue with api docs 2019-01-30 15:33:46 +00:00
Stefano Franz
fe0cafd06e dockerize docs building 2019-01-30 15:33:46 +00:00
szymonsztuka
4aaefb4fe9 CORDA-2331 Split Workflow and contracts of Finance App into separate Cordapps (#4422)
* Split Workflow and contracts of Finance App into separate Cordapps, part 1 - content which is different between OS and ENT is still in contract Cordapp.

* Move CashSelection implementations to workflow module.

* Move CashSelection implmentations to workflow module.

* Move finance module to finance-flows, top level finance module is empty.

* Move finance module to finance-flows, top level finance module is empty.

* Updated build comment.

* Revert publication of combined (contracts and flows) corda-finance.jar (to maintain backwards compatibility with 3rd party cordapps dependent on finance)

* Added backwards compatibility clarification comment.

* Re-instate new cordapp metadata.

* Global rename of `finance-flows` to `finance-workflows` to follow adopted naming conventions.

* Addressed final review comments.

* Rename application to "Corda Finance Demo"

* Generation of original corda-finance jar from new sub-modules.

* Fixed and tested demobench with new split finance contract and workflow jars.

* Renamed finance sub-modules to contracts and workflows.

* Remove Michele!!!

* Minor fix to filtering logic.

* Align CorDapp configuration filename with workflows jar.

* Fix breaks caused by finance module naming changes.

* Final alignment between OS/ENT of finance contract code.
2018-12-19 18:02:51 +00:00
Andrzej Cichocki
242d9cf7ad
CORDA-692 Don't include internal packages in API documentation (#2415)
* Use G1 for gradle daemon
2018-01-25 15:26:13 +00:00
Andrzej Cichocki
005ce349a7 * Retire MockServiceHubInternal (#1909)
* Introduce rigorousMock
* Add test-utils and node-driver to generated documentation
2017-10-20 10:06:53 +01:00
Mike Hearn
f03699d1a3 Docs: more package descriptions and take non-stabilised APIs out of the docs build. (#1774) 2017-10-03 11:57:12 +01:00
Mike Hearn
e49da94418 Minor: use package descriptions in Kotlin build of api docs too, not just javadocs. 2017-09-27 11:47:34 +02:00
Ross Nicoll
6f4d183858 Add testing classes to Dokka (#1507) 2017-09-14 12:55:23 +01:00
Ross Nicoll
3ceee23901 Add external documentation
Add references to Bouncy Castle, Jackson and JavaFX documentation for Dokka to link
to.
2017-09-04 15:52:45 +01:00
Ross Nicoll
923fe16392 Update Dokka configuration
* Switch documentation JDK version to 8
* Add node-api package to Dokka includes
* Remove node package from Dokka includes
2017-08-30 14:53:37 +01:00
Mike Hearn
d22cdac2dd Move some extension methods for summing to new locations.
This improves the Java API and makes it more idiomatic. The methods
were not moved to be static methods of the relevant types in all cases
due to a bad interaction with a Kotlin auto-completion bug, and because
static methods on interfaces are new in Java 8 and Kotlin is not yet
emitting Java 8 bytecode.

Also, introduce a packages.md file so packages can be documented.
2017-08-18 12:39:12 +02:00
Clinton Alexander
c0d2e3ec04 Fixed docsite building on Ubuntu by explicitly calling bash. Due to sh mapping to dash and not bash. 2017-04-03 16:45:55 +01:00
Clinton Alexander
796d475e0b Removed repositories from docs build.gradle. 2017-03-30 12:24:06 +01:00
Clinton Alexander
5ef66d8fd6 Removed old information about Dokka from the building docs documentation.
Make docsite no longer cleans. Now gradle should be used for cleaning the docs.

Corrected docs building gradle script.
2017-03-30 12:23:20 +01:00
Clinton Alexander
1b5182fe24 Removed robots.txt from repo and added docs/build back to the gitignore list. 2017-03-30 12:23:14 +01:00
Clinton Alexander
8862920f9a Removed docs build directory from repo.
Make docsite is back in a shell file due to issues invokving outside of the virtualenv.
2017-03-30 12:22:59 +01:00
Clinton Alexander
b80aaa0e9d Moved the build docs functionality into build.gradle.
Removed redundant parts of the docsite generator.

Gradle now calls the docsite requirements installation script when building docs via buildDocs

Added docs build script and moved all docs building related code into it

Corrected directories for build.
2017-03-30 12:22:15 +01:00