Added a readme and run script to all examples

paulbakker · paulbakker · commit 75620253faf3 · 2017-09-04T18:44:18.000-07:00
diff --git a/chapter10/generate_moduledescriptor/README.md b/chapter10/generate_moduledescriptor/README.md
@@ -0,0 +1 @@
+This example shows the usage of jdeps to generate a module descriptor.
diff --git a/chapter10/generate_moduledescriptor/addmoduledescriptor.sh b/chapter10/generate_moduledescriptor/addmoduledescriptor.sh
@@ -2,8 +2,8 @@
 cd out
 mkdir mylibrary-classes
 cd mylibrary-classes
-jar -xf ../mylibrary.jar
+$JAVA_HOME/bin/jar -xf ../mylibrary.jar
 cd ..
-javac -d mylibrary-classes mylibrary/module-info.java
-jar -uf mylibrary.jar -C mylibrary-classes module-info.class
+$JAVA_HOME/bin/javac -d mylibrary-classes mylibrary/module-info.java
+$JAVA_HOME/bin/jar -uf mylibrary.jar -C mylibrary-classes module-info.class
 cd ..
diff --git a/chapter10/generate_moduledescriptor/build.sh b/chapter10/generate_moduledescriptor/build.sh
@@ -1,7 +1,7 @@
 rm -rf out
-javac -d out src/com/javamodularity/mylibrary/internal/Util.java src/com/javamodularity/mylibrary/MyLibrary.java
+$JAVA_HOME/bin/javac -d out src/com/javamodularity/mylibrary/internal/Util.java src/com/javamodularity/mylibrary/MyLibrary.java
 
-jar -cf out/mylibrary.jar -C out/ .
+$JAVA_HOME/bin/jar -cf out/mylibrary.jar -C out/ .
 
-jdeps --generate-module-info ./out out/mylibrary.jar
+$JAVA_HOME/bin/jdeps --generate-module-info ./out out/mylibrary.jar
 cat out/mylibrary/module-info.java
diff --git a/chapter10/generate_moduledescriptors_jackson/README.md b/chapter10/generate_moduledescriptors_jackson/README.md
@@ -0,0 +1 @@
+This example shows using jdeps to generate module descriptors for a set of libraries.
diff --git a/chapter10/generate_moduledescriptors_jackson/generate.sh b/chapter10/generate_moduledescriptors_jackson/generate.sh
@@ -1 +1 @@
-jdeps --generate-module-info ./out *.jar
+$JAVA_HOME/bin/jdeps --generate-module-info ./out *.jar
diff --git a/chapter10/modulename/README.md b/chapter10/modulename/README.md
@@ -0,0 +1 @@
+This example shows naming an automatic module using the `Automatic-Module-Name` manifest entry.
diff --git a/chapter10/modulename/build.sh b/chapter10/modulename/build.sh
diff --git a/chapter10/modulename/run.sh b/chapter10/modulename/run.sh
@@ -0,0 +1,7 @@
+rm -rf out
+$JAVA_HOME/bin/javac -d out src/modulename/Main.java
+
+$JAVA_HOME/bin/jar -cfem out/modulename.jar modulename.Main src/META-INF/MANIFEST.MF -C out/ .
+
+# start modulename.jar as automatic module
+$JAVA_HOME/bin/java -ea --module-path out/modulename.jar -m com.javamodularity.modulename
diff --git a/chapter10/multirelease/README.md b/chapter10/multirelease/README.md
@@ -0,0 +1,2 @@
+This example demonstrates the multirelease feature. The META-INF/versions directory contains version specific code.
+The run.sh file demonstrates the commands to create the different releases.
diff --git a/chapter10/multirelease/build.sh b/chapter10/multirelease/build.sh
diff --git a/chapter10/multirelease/run.sh b/chapter10/multirelease/run.sh
@@ -0,0 +1,7 @@
+rm -rf out
+$JAVA_HOME/bin/javac --release 7 -d out/7 src/mrlib/Main.java src/mrlib/Helper.java
+$JAVA_HOME/bin/javac --release 9 -d out/9 src/META-INF/versions/9/mrlib/Helper.java
+
+$JAVA_HOME/bin/jar -cfem out/mrlib.jar mrlib.Main src/META-INF/MANIFEST.MF -C out/7 .
+$JAVA_HOME/bin/jar -uf out/mrlib.jar --release 9 -C out/9 .
+$JAVA_HOME/bin/java -jar out/mrlib.jar
diff --git a/chapter11/multi-module/README.md b/chapter11/multi-module/README.md
@@ -0,0 +1,2 @@
+This example is the EasyText application as a multi module Maven project.
+It also demonstrates using the Maven exec plugin to run a modular application (see cli/pom.xml).
diff --git a/chapter11/multi-module/run.sh b/chapter11/multi-module/run.sh
@@ -0,0 +1,3 @@
+mvn install
+cd cli
+mvn exec:exec
diff --git a/chapter11/single-module/README.md b/chapter11/single-module/README.md
@@ -0,0 +1 @@
+This example is a minimal single module Maven setup.
diff --git a/chapter11/single-module/run.sh b/chapter11/single-module/run.sh
@@ -0,0 +1 @@
+mvn install exec:exec
diff --git a/chapter12/blackbox/README.md b/chapter12/blackbox/README.md
@@ -0,0 +1 @@
+This example demonstrates testing modules from the outside (blackbox testing). The tests live in their own module.
diff --git a/chapter12/blackbox/run.test.junit.sh b/chapter12/blackbox/run.test.junit.sh
@@ -1,6 +1,6 @@
 rm -rf out*/
-javac --module-source-path src -d out -m easytext.syllablecounter
-javac --module-path lib:out --module-source-path src-test -d out-test -m easytext.syllablecounter.junit
-java --module-path lib:out:out-test \
+$JAVA_HOME/bin/javac --module-source-path src -d out -m easytext.syllablecounter
+$JAVA_HOME/bin/javac --module-path lib:out --module-source-path src-test -d out-test -m easytext.syllablecounter.junit
+$JAVA_HOME/bin/java --module-path lib:out:out-test \
      --add-modules easytext.syllablecounter.junit \
      -m junit/org.junit.runner.JUnitCore javamodularity.easytext.test.JUnitTestSyllableCounter
diff --git a/chapter12/blackbox/run.test.sh b/chapter12/blackbox/run.test.sh
@@ -1,5 +1,5 @@
 rm -rf out*/
-javac --module-source-path src -d out -m easytext.syllablecounter
-javac --module-path out --module-source-path src-test -d out-test -m easytext.syllablecounter.test
-java -ea --module-path out:out-test \
+$JAVA_HOME/bin/javac --module-source-path src -d out -m easytext.syllablecounter
+$JAVA_HOME/bin/javac --module-path out --module-source-path src-test -d out-test -m easytext.syllablecounter.test
+$JAVA_HOME/bin/java -ea --module-path out:out-test \
      -m easytext.syllablecounter.test/javamodularity.easytext.test.TestSyllableCounter
diff --git a/chapter12/whitebox/README.md b/chapter12/whitebox/README.md
@@ -0,0 +1,2 @@
+This example demonstrates testing code in a module without respecting the module boundaries (whitebox testing).
+There's both an example of whitebox testing by using the classpath, and an example that uses the module-path with extra flags to break encapsulation.
diff --git a/chapter12/whitebox/run.test.junit.classpath.sh b/chapter12/whitebox/run.test.junit.classpath.sh
@@ -1,7 +1,7 @@
 rm -rf out*/
-javac --module-source-path src -d out -m easytext.syllablecounter
-javac -cp lib/junit-4.12.jar:out/easytext.syllablecounter -d out-test \
+$JAVA_HOME/bin/javac --module-source-path src -d out -m easytext.syllablecounter
+$JAVA_HOME/bin/javac -cp lib/junit-4.12.jar:out/easytext.syllablecounter -d out-test \
       src-test/javamodularity/easytext/syllablecounter/vowel/JUnitTestVowelHelper.java
 
-java -cp lib/junit-4.12.jar:lib/hamcrest-core-1.3.jar:out/easytext.syllablecounter:out-test \
+$JAVA_HOME/bin/java -cp lib/junit-4.12.jar:lib/hamcrest-core-1.3.jar:out/easytext.syllablecounter:out-test \
      org.junit.runner.JUnitCore javamodularity.easytext.syllablecounter.vowel.JUnitTestVowelHelper
diff --git a/chapter12/whitebox/run.test.junit.modulepath.sh b/chapter12/whitebox/run.test.junit.modulepath.sh
@@ -1,11 +1,11 @@
 rm -rf out*/
-javac --module-source-path src -d out -m easytext.syllablecounter
-javac --patch-module easytext.syllablecounter=src-test \
+$JAVA_HOME/bin/javac --module-source-path src -d out -m easytext.syllablecounter
+$JAVA_HOME/bin/javac --patch-module easytext.syllablecounter=src-test \
       --module-path lib:out \
       --add-modules junit \
       --add-reads easytext.syllablecounter=junit \
       -d out-test src-test/javamodularity/easytext/syllablecounter/vowel/JUnitTestVowelHelper.java
-java --patch-module easytext.syllablecounter=out-test \
+$JAVA_HOME/bin/java --patch-module easytext.syllablecounter=out-test \
      --add-reads easytext.syllablecounter=junit \
      --add-opens easytext.syllablecounter/javamodularity.easytext.syllablecounter.vowel=junit \
      --module-path lib:out \
diff --git a/chapter2/README.md b/chapter2/README.md
@@ -0,0 +1 @@
+This example demonstrates that the classpath still exists. We can build and run code without modules.
diff --git a/chapter2/run.sh b/chapter2/run.sh
@@ -0,0 +1,4 @@
+mkdir -p out
+
+$JAVA_HOME/bin/javac -d out -sourcepath src $(find src -name '*.java')
+$JAVA_HOME/bin/java -cp out NotInModule
diff --git a/chapter3/easytext-singlemodule/README.md b/chapter3/easytext-singlemodule/README.md
@@ -0,0 +1 @@
+This example shows EasyText as a single module.
diff --git a/chapter3/easytext-singlemodule/run.sh b/chapter3/easytext-singlemodule/run.sh
@@ -0,0 +1,4 @@
+mkdir -p out
+
+$JAVA_HOME/bin/javac -d out --module-source-path src -m easytext
+$JAVA_HOME/bin/java --module-path out -m easytext/javamodularity.easytext.Main
diff --git a/chapter3/easytext-threemodules/README.md b/chapter3/easytext-threemodules/README.md
@@ -0,0 +1 @@
+This example shows EasyText with both a cli and gui, both using the same analysis module.
diff --git a/chapter3/easytext-threemodules/run.sh b/chapter3/easytext-threemodules/run.sh
@@ -0,0 +1,4 @@
+mkdir -p out
+
+$JAVA_HOME/bin/javac -d out --module-source-path src -m easytext.cli,easytext.gui,easytext.analysis
+$JAVA_HOME/bin/java --module-path out -m easytext.cli/javamodularity.easytext.cli.Main
diff --git a/chapter3/easytext-twomodules/README.md b/chapter3/easytext-twomodules/README.md
@@ -0,0 +1 @@
+This example demonstrates EasyText split into a cli and analysis module.
diff --git a/chapter3/easytext-twomodules/run.sh b/chapter3/easytext-twomodules/run.sh
@@ -0,0 +1,4 @@
+mkdir -p out
+
+$JAVA_HOME/bin/javac -d out --module-source-path src -m easytext.cli,easytext.analysis
+$JAVA_HOME/bin/java --module-path out -m easytext.cli/javamodularity.easytext.cli.Main
diff --git a/chapter3/helloworld/README.md b/chapter3/helloworld/README.md
@@ -0,0 +1,2 @@
+This is the first module example in the book. It's a single module application, that's packaged as a modular JAR file.
+A custom runtime image can be created using jlink (see [link.sh](link.sh)).
diff --git a/chapter3/helloworld/link.sh b/chapter3/helloworld/link.sh
@@ -0,0 +1,4 @@
+$JAVA_HOME/bin/jlink --module-path mods/:$JAVA_HOME/jmods \
+    --add-modules helloworld \
+    --launcher hello=helloworld \
+    --output helloworld-image
diff --git a/chapter3/helloworld/run.sh b/chapter3/helloworld/run.sh
@@ -0,0 +1,11 @@
+mkdir -p out
+mkdir -p mods
+
+$JAVA_HOME/bin/javac -d out/helloworld \
+    src/helloworld/com/javamodularity/helloworld/HelloWorld.java \
+    src/helloworld/module-info.java
+
+$JAVA_HOME/bin/jar -cfe mods/helloworld.jar com.javamodularity.helloworld.HelloWorld -C out/helloworld .
+
+$JAVA_HOME/bin/java --module-path out \
+    --module helloworld/com.javamodularity.helloworld.HelloWorld
diff --git a/chapter4/easytext-factory/README.md b/chapter4/easytext-factory/README.md
@@ -0,0 +1,2 @@
+The example demonstrates implementation hiding using a factory.
+Note that this is not ideal, and is primarily an example for the need for services.
diff --git a/chapter4/easytext-factory/run.sh b/chapter4/easytext-factory/run.sh
@@ -0,0 +1,4 @@
+mkdir -p out
+
+$JAVA_HOME/bin/javac -d out --module-source-path src -m easytext.cli,easytext.gui,easytext.analysis.api,easytext.analysis.coleman,easytext.analysis.factory,easytext.analysis.kincaid
+$JAVA_HOME/bin/java --module-path out -m easytext.cli/javamodularity.easytext.cli.Main ../exampletext.txt
diff --git a/chapter4/easytext-filtering/READEME.md b/chapter4/easytext-filtering/READEME.md
@@ -0,0 +1 @@
+This example demonstrates the ServiceLoader.stream() method to select services based on a custom annotation.
diff --git a/chapter4/easytext-filtering/build.sh b/chapter4/easytext-filtering/build.sh
diff --git a/chapter4/easytext-filtering/run.sh b/chapter4/easytext-filtering/run.sh
@@ -1 +1,5 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac -d mods --module-source-path src -m easytext.analysis.api,easytext.analysis.coleman,easytext.analysis.kincaid,easytext.filtering
+
 $JAVA_HOME/bin/java --module-path mods -m easytext.filtering/javamodularity.easytext.filtering.Main
diff --git a/chapter4/easytext-services-factory/README.md b/chapter4/easytext-services-factory/README.md
@@ -0,0 +1,2 @@
+This example is an example of providing a factory like API on an interface.
+The `Analyzer` interface provides the static `getAnalyzers()` method to easily get a list of implementations.
diff --git a/chapter4/easytext-services-factory/build.sh b/chapter4/easytext-services-factory/build.sh
diff --git a/chapter4/easytext-services-factory/run-cli.sh b/chapter4/easytext-services-factory/run-cli.sh
diff --git a/chapter4/easytext-services-factory/run.sh b/chapter4/easytext-services-factory/run.sh
@@ -0,0 +1,5 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m easytext.analysis.api,easytext.analysis.coleman,easytext.analysis.kincaid,easytext.cli
+
+$JAVA_HOME/bin/java --module-path mods -m easytext.cli/javamodularity.easytext.cli.Main ../exampletext.txt
diff --git a/chapter4/easytext-services/README.md b/chapter4/easytext-services/README.md
@@ -0,0 +1,2 @@
+This example demonstrates the use of services in the EasyText application.
+The application has both a gui and cli, both using services to use the analyzer implementations.
diff --git a/chapter4/easytext-services/build.sh b/chapter4/easytext-services/build.sh
diff --git a/chapter4/easytext-services/run-cli.sh b/chapter4/easytext-services/run-cli.sh
@@ -1 +1,5 @@
-$JAVA_HOME/bin/java --module-path mods -m easytext.cli/javamodularity.easytext.cli.Main ../../../chapter4.asciidoc
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m easytext.analysis.api,easytext.analysis.coleman,easytext.analysis.kincaid,easytext.cli
+
+$JAVA_HOME/bin/java --module-path mods -m easytext.cli/javamodularity.easytext.cli.Main ../exampletext.txt
diff --git a/chapter4/easytext-services/run-gui.sh b/chapter4/easytext-services/run-gui.sh
@@ -1 +1,5 @@
-$JAVA_HOME/bin/java --module-path mods -m easytext.gui/javamodularity.easytext.gui.Main
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m easytext.analysis.api,easytext.analysis.coleman,easytext.analysis.kincaid,easytext.gui
+
+$JAVA_HOME/bin/java --module-path mods -m easytext.gui/javamodularity.easytext.gui.Main ../exampletext.txt
diff --git a/chapter4/exampletext.txt b/chapter4/exampletext.txt
@@ -0,0 +1,9 @@
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi quis feugiat augue, nec pulvinar leo. Etiam rhoncus congue tellus, quis iaculis sapien facilisis in. Praesent suscipit odio at tortor fermentum placerat. Proin elementum nisi diam, ut volutpat neque placerat quis. Cras id tellus iaculis orci tempor semper. Proin eleifend, neque nec finibus euismod, sapien enim convallis dui, quis tempus sapien turpis sit amet diam. Fusce a dui posuere dolor aliquam eleifend. Aenean eu lacus ut mi interdum scelerisque. Sed malesuada mauris erat.
+
+Integer dictum aliquet placerat. Phasellus dapibus odio quis magna pulvinar volutpat. Integer diam tortor, ultricies quis elementum in, lobortis et neque. Nam varius imperdiet gravida. In tellus nulla, aliquet vel purus et, finibus varius mi. Aenean condimentum tristique urna. Phasellus vitae sagittis neque. Integer nec sagittis lorem, sed dignissim est. Donec consectetur justo vel erat dictum, et mollis dui cursus. Sed nisl nunc, ornare nec libero sed, lobortis porttitor libero. Sed nec maximus magna, quis dignissim metus. Duis ac iaculis velit. Duis accumsan nibh at urna porttitor, dictum laoreet magna volutpat.
+
+Duis convallis erat dolor, in porta ante sollicitudin ac. Phasellus rhoncus velit nec consequat placerat. Maecenas commodo accumsan ultricies. Mauris finibus sodales fringilla. Aliquam malesuada neque eget ante sodales, quis tempor nulla egestas. Ut viverra lacinia ultrices. Etiam convallis nisl augue, at luctus orci dignissim commodo. Etiam sed nisl ornare, rhoncus eros sit amet, malesuada nisi. Curabitur tristique justo et tellus scelerisque, tempor imperdiet nisl pretium. Nulla non urna a neque blandit dictum. Curabitur mollis est vel hendrerit porta. Mauris id finibus arcu, id elementum lacus.
+
+Nunc facilisis justo tincidunt sapien rhoncus, in cursus sapien sollicitudin. Quisque malesuada neque at posuere faucibus. Sed luctus ipsum nec tellus vehicula tempus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nam erat est, feugiat in ante ac, dignissim imperdiet sapien. Nam non lorem lacus. Integer maximus diam bibendum mauris scelerisque, in congue metus laoreet. Cras aliquam, velit finibus ullamcorper semper, felis nulla vulputate nulla, id mattis neque erat quis quam. Nullam rutrum massa sed ultricies ullamcorper. Aenean sed ultricies mauris, vel rhoncus odio. Interdum et malesuada fames ac ante ipsum primis in faucibus. Sed tristique imperdiet dui, rutrum tempor sapien iaculis ac.
+
+Nunc id sodales turpis. Nulla sollicitudin, risus at scelerisque cursus, nunc sem aliquam dolor, et finibus ipsum quam non felis. Quisque sodales vel odio sit amet bibendum. Sed et felis justo. Fusce pretium placerat massa vitae ullamcorper. Etiam metus massa, semper vehicula odio eget, fermentum viverra metus. Vivamus dignissim molestie nisi, non venenatis neque consequat eget. Cras ultricies mollis quam, et egestas quam elementum non. Aenean in accumsan sapien. Morbi dapibus, tellus ac placerat placerat, risus turpis mollis augue, vitae vestibulum urna lectus pretium urna. Donec nisi augue, mollis vel vehicula et, lacinia elementum magna. Praesent id purus eget ante facilisis tristique. Donec placerat augue id nibh auctor, vitae posuere dui ultrices.
diff --git a/chapter4/providers/README.md b/chapter4/providers/README.md
@@ -0,0 +1,2 @@
+This example demonstrates the use of service provider methods.
+The `provider.factory.example` uses a provider method on a separate class to provide a service instance, while `provider.method.example` uses a provider method on the service implementation itself.
diff --git a/chapter4/providers/run.sh b/chapter4/providers/run.sh
@@ -1,2 +1,4 @@
+mkdir -p mods
+
 $JAVA_HOME/bin/javac --module-source-path src -d mods -m main,provider.method.example,provider.factory.example
 $JAVA_HOME/bin/java --module-path mods -m main/javamodularity.providers.main.Main
diff --git a/chapter5/cyclic_dependencies/README.md b/chapter5/cyclic_dependencies/README.md
@@ -0,0 +1 @@
+This is an example of code that contains a cycle, and a possible way to refactor the code. The `cycle` example can't compile without refactoring.
diff --git a/chapter5/cyclic_dependencies/without_cycle/run.sh b/chapter5/cyclic_dependencies/without_cycle/run.sh
@@ -0,0 +1,3 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m authors,books
diff --git a/chapter5/implied_readability/README.md b/chapter5/implied_readability/README.md
@@ -0,0 +1 @@
+This example demonstrates the need for `requires transitive`. The example demonstrates the error, so it does not compile without changes.
diff --git a/chapter5/implied_readability/run.sh b/chapter5/implied_readability/run.sh
@@ -0,0 +1,3 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m easytext.client,easytext.domain.api,easytext.repository.api
diff --git a/chapter5/optional_dependencies/README.md b/chapter5/optional_dependencies/README.md
@@ -0,0 +1,2 @@
+This example demonstrates the use of `requries static` to create optional dependencies.
+This requires loading code dynamically as well, which is demonstrated in `framework/javamodularity.framework.Main.java`.
diff --git a/chapter5/optional_dependencies/run.sh b/chapter5/optional_dependencies/run.sh
@@ -0,0 +1,4 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m fastjsonlib,framework
+$JAVA_HOME/bin/java --module-path mods --add-modules fastjsonlib -m framework/javamodularity.framework.Main
diff --git a/chapter5/optional_dependencies_annotations/README.md b/chapter5/optional_dependencies_annotations/README.md
@@ -0,0 +1 @@
+This example demonstrates the use of `requries static` for compile time annotation processing.
diff --git a/chapter5/optional_dependencies_annotations/run.sh b/chapter5/optional_dependencies_annotations/run.sh
@@ -1,4 +1,4 @@
-javac --module-source-path src -d out $(find . -name '*.java')
+javac --module-source-path src -d out -m application,schemagenerator
 
 # Exclude myannotations module from the run-time classpath
 java -ea --module-path out/application -m application/javamodularity.application.Main
diff --git a/chapter5/optional_dependencies_service/README.md b/chapter5/optional_dependencies_service/README.md
@@ -0,0 +1 @@
+This example demonstrates an alternative approach for optional dependencies based on services.
diff --git a/chapter5/optional_dependencies_service/run.sh b/chapter5/optional_dependencies_service/run.sh
@@ -0,0 +1,5 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m fastjsonlib,framework
+
+$JAVA_HOME/bin/java --module-path mods -m framework/javamodularity.framework.Main
diff --git a/chapter5/optional_dependencies_service/src/framework/javamodularity/framework/Main.java b/chapter5/optional_dependencies_service/src/framework/javamodularity/framework/Main.java
@@ -11,7 +11,13 @@ public static void main(String... args) {
     FastJson fastJson =
       ServiceLoader.load(FastJson.class)
                    .findFirst()
-                   .orElse(getFallBack())
+                   .orElse(getFallBack());
+
+      if(fastJson == null) {
+        System.out.println("Using a fallback");
+      } else {
+        System.out.println("Found a service");
+      }
   }
 
   private static FastJson getFallBack() {
diff --git a/chapter5/resource_encapsulation/README.md b/chapter5/resource_encapsulation/README.md
@@ -0,0 +1,2 @@
+This example demonstrates different ways of loading resources from modules.
+Note that running the example doesn't print anything.
diff --git a/chapter5/resource_encapsulation/run.sh b/chapter5/resource_encapsulation/run.sh
diff --git a/chapter5/resourcebundles/README.md b/chapter5/resourcebundles/README.md
@@ -0,0 +1 @@
+This example demonstrates providing resources from a module using services and the `ResourceBundleProvider` API.
diff --git a/chapter5/resourcebundles/run.sh b/chapter5/resourcebundles/run.sh
diff --git a/chapter6/annotated_module/README.md b/chapter6/annotated_module/README.md
@@ -0,0 +1 @@
+This is an exmaple of using an (custom) annotation on a module definition.
diff --git a/chapter6/bootlayer/README.md b/chapter6/bootlayer/README.md
@@ -0,0 +1 @@
+This example prints all modules in the boot layer, and module's classloader.
diff --git a/chapter6/bootlayer/run.sh b/chapter6/bootlayer/run.sh
@@ -0,0 +1,5 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac --module-source-path src -d mods -m application
+
+$JAVA_HOME/bin/java --module-path mods -m application/javamodularity.application.Main
diff --git a/chapter6/container/README.md b/chapter6/container/README.md
@@ -0,0 +1,3 @@
+This is an example implementation of a container.
+The two example apps are loaded in the container.
+After starting the container, the example apps can be deployed/undeployed with the `deploy <n>` and `undeploy <n> commands`.
diff --git a/chapter6/container/run.sh b/chapter6/container/run.sh
@@ -1,13 +1,13 @@
 rm -rf out-app/ out-container/
 
 # Compile container and platform API first
-javac -Xlint:deprecation -Xlint:unchecked --module-source-path src-container -d out-container $(find src-container -name '*.java')
+javac -Xlint:deprecation -Xlint:unchecked --module-source-path src-container -d out-container -m platform.api,platform.container
 
 # Compile app a with platform API in separate output directory
-javac -Xlint:deprecation --module-path out-container/platform.api --module-source-path src-appa -d out-appa $(find src-appa -name '*.java')
+javac -Xlint:deprecation --module-path out-container/platform.api --module-source-path src-appa -d out-appa -m app.a
 
 # Compile app b with platform API in separate output directory
-javac -Xlint:deprecation --module-path out-container/platform.api --module-source-path src-appb -d out-appb $(find src-appb -name '*.java')
+javac -Xlint:deprecation --module-path out-container/platform.api --module-source-path src-appb -d out-appb -m app.b
 
 # Run the container app, without putting the compiled modules of the app on the module path.
 # These are loaded by the container as applications!
diff --git a/chapter6/introspection/README.md b/chapter6/introspection/README.md
@@ -0,0 +1 @@
+This exmaple demonstrates the introspection APIs available for modules.
diff --git a/chapter6/introspection/run.sh b/chapter6/introspection/run.sh
@@ -0,0 +1,4 @@
+mkdir -p mods
+
+$JAVA_HOME/bin/javac -d out -sourcepath src $(find src -name '*.java')
+$JAVA_HOME/bin/java -cp out javamodularity.introspection.Introspection
diff --git a/chapter6/introspection/src/javamodularity/introspection/Introspection.java b/chapter6/introspection/src/javamodularity/introspection/Introspection.java
diff --git a/chapter6/lookup/README.md b/chapter6/lookup/README.md
diff --git a/chapter6/lookup/run.sh b/chapter6/lookup/run.sh
diff --git a/chapter6/plugins/README.md b/chapter6/plugins/README.md
diff --git a/chapter6/plugins/run.sh b/chapter6/plugins/run.sh
diff --git a/chapter7/encapsulation/README.md b/chapter7/encapsulation/README.md
diff --git a/chapter7/encapsulation/run.sh b/chapter7/encapsulation/run.sh
diff --git a/chapter7/jaxb/README.md b/chapter7/jaxb/README.md
diff --git a/chapter7/jaxb/run.sh b/chapter7/jaxb/run.sh
diff --git a/chapter7/removedtypes/README.md b/chapter7/removedtypes/README.md
diff --git a/chapter7/removedtypes/run.sh b/chapter7/removedtypes/run.sh
diff --git a/chapter8/jackson-classpath/README.md b/chapter8/jackson-classpath/README.md
diff --git a/chapter8/jackson/README.md b/chapter8/jackson/README.md
diff --git a/chapter8/jackson/run.sh b/chapter8/jackson/run.sh
diff --git a/chapter8/readability_rules/README.md b/chapter8/readability_rules/README.md
diff --git a/chapter8/readability_rules/run.sh b/chapter8/readability_rules/run.sh
diff --git a/chapter8/runtime_loading/README.md b/chapter8/runtime_loading/README.md
diff --git a/chapter8/runtime_loading/run.sh b/chapter8/runtime_loading/run.sh
diff --git a/chapter9/spring-hibernate-refactored/README.md b/chapter9/spring-hibernate-refactored/README.md
diff --git a/chapter9/spring-hibernate-starter/README.md b/chapter9/spring-hibernate-starter/README.md
diff --git a/chapter9/spring-hibernate-starter/run.sh b/chapter9/spring-hibernate-starter/run.sh
diff --git a/chapter9/spring-hibernate/README.md b/chapter9/spring-hibernate/README.md
diff --git a/chapter9/spring-hibernate/run.sh b/chapter9/spring-hibernate/run.sh

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-jdeps --generate-module-info ./out *.jar`
	`1`	`+$JAVA_HOME/bin/jdeps --generate-module-info ./out *.jar`