上QQ阅读APP看书,第一时间看更新
关于代码
本书几乎每章都有源代码示例,它们有的在带编号的代码清单中,有的在普通的文本中。在这两种情况下,源代码都以等宽字体印刷,以将其与普通文本分开。
每章在配套源代码中都有一个对应的文件夹。本书中的所有代码使用Maven作为主要构建工具进行构建,并使用Docker作为容器工具以运行在Java 11上。每章的README.md文件中包含以下信息:
● 本章的简要介绍;
● 初始配置所需的工具;
● “如何使用”部分;
● 示例的构建命令;
● 示例的运行命令;
● 联系方式和贡献信息。
我们在整本书中遵循的一个核心概念是,每章的代码示例应该能够完全独立于其他任何一章运行。这是什么意思呢?例如,读者应该能够获取第10章中的代码,并在不需要遵循前几章示例的情况下运行它。每章中构建的每个服务都有一个对应的Docker镜像,并且都使用Docker Compose来执行Docker镜像,以确保每章都有一个可复制的运行时环境。
在很多情况下,原始的源代码已被重新调整了格式。我们添加了换行符,重新加工了缩进,以适应书的页面空间。在极少数情况下,甚至还不止如此,代码清单还包括行连续标记(➥)。此外,在文本中描述代码时,源代码中的注释通常会从代码清单中移除。许多代码清单附带了代码注解,突出重要的概念。