Upgrade to Gradle 7.0.1

Consolidate markdown files (stop usign docs/)

Intent to make projects standalone.

docs/README.md → README.md

@@ -43,6 +43,27 @@ Instructions:
 
 General clean-ups, changes and things I wish to implement for this project:
 
+* Make the sub-projects completely standalone and adhere to the convention I have in my other playground repos.
+* Add a stub with a custom handler that uses custom Java code to respond to the request.
 * Create a WireMock-in-Docker example
 * DONE create a sub-project that declares dependency constraint versions and which will be used as a `platform(...)`
   from the other projects. For details of this feature, see the [Gradle docs about "platform"](https://docs.gradle.org/current/userguide/platforms.html)
+
+## Notes
+
+* Create a JDK Flight Recording
+  * (see `java` options at <https://docs.oracle.com/en/java/javase/15/docs/specs/man/java.html> and scroll down to `-XX:StartFlightRecording`)
+  * For the `programmatic` program:
+    * Build the distribution with `./gradlew programmatic:installDist`
+    * Set the JRE options with `export PROGRAMMATIC_OPTS="-XX:StartFlightRecording,dumponexit=true"`
+    * Run the program with `programmatic/build/install/programmatic/bin/programmatic`
+  * For the `standalone` program:
+    * Build the distribution with `./gradlew standalone:installDist`
+    * Set the JRE options with `export STANDALONE_OPTS="-XX:StartFlightRecording,dumponexit=true"`
+    * Run the program with `standalone/build/install/standalone/bin/standalone`
+  * After the program exits, the .jfr file will be captured. Visualize it using Mission Control <https://github.com/openjdk/jmc>
+  * Clone Mission Control and build it
+  * You must run it with a JDK 8 (and it must be installed at `/Library/Java/JavaVirtualMachines...` for some reason. I couldn't get an SDKMAN installed Java to work)
+    * E.g. `JAVA_HOME=/Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home/ target/products/org.openjdk.jmc/macosx/cocoa/x86_64/JDK\ Mission\ Control.app/Contents/MacOS/jmc -vm $JAVA_HOME/bin`
+* Can we run WireMock on Graal? If Jetty can run on Graal, then WireMock should be pretty easy to run on Graal. See an
+  example for running Jetty on Graal at <https://github.com/tipsy/javalin/issues/286>

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.8.3-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists