Spring Batch 4.2 的发行版主要增强了下面的改进： 使用 Micrometer 来支持批量指标（batch metrics） 支持从 Apache Kafka topics 读取/写入（reading/writing） 数据 支持从 Apache Avro 资源中读取/写入（reading/writing） 数据 改进支持文档 使用 Micrometer 的批量指标 本发行版本介绍了可以让你通过使用 Micrometer 来监控你的批量作业。在默认的情况下，Spring Batch 将会收集相关批量指标（包括，作业时间，步骤的时间，读取和写入的项目，以及其他的相关信息），和将这些指标通过 spring.batch 前缀（prefix）注册到 Micrometer 的全局指标中。 这些指标可以发布到任何能够支持 Micrometer 的  监控系统（monitoring system）中。 有关这个新特性的更多细节，请参考 Monitoring and metrics 章节中的内容。 Apache Kafka item 读取/写入 本发行版本添加了一个新的 KafkaItemReader 和 KafkaItemWriter ，用来从 Kafka 的 topics 中读取和写入。 有关更多这个新组建的信息，请参考：Javadoc。 Apache Avro item 读取/写入 本发行版本添加了一个新的 AvroItemReader 和 AvroItemWriter，用来从 Avro 资源中读取和写入。 有关更多这个新组建的信息，请参考： Javadoc。 文档更新 对参考的文档进行更新，以便于与其他 Spring 项目的文档风格保持一致。 4.1 版本的文档更新 下面的内容是 4.1 文档版本中的更新，我们没有将这部分内容从我们的 WIKI 中删除已保持历史信息的一致。 请参考下面链接获得 4.1 文档版本中的更新，在官方的文档中，下面的内容已经不在 4.2 的文档中了。 @SpringBatchTest Annotation @EnableBatchIntegration Annotation JSON support Bean Validation API support JSR-305 Support FlatFileItemWriterBuilder Enhancements https://www.cwiki.us/pages/viewpage.action?pageId=41685600

欢迎来到 Spring 批量（Spring Batch）文档！本文档的内容同时还提供单一 html 和 pdf 文档。 本参考文档被分列为下面的部分： 文档内容链接 文档介绍 Spring Batch Introduction 背景，使用场景和一些常用使用指引。 What’s New in Spring Batch 4.2 4.2 版本中的新特性。 The Domain Language of Batch 核心概念和有关批处理域语言（Batch Domain Language）的抽象 Configuring and Running a Job 作业（Job）配置，执行和管理 Configuring a Step 步骤（Step）配置，不同类型的步骤，控制步骤流 ItemReaders and ItemWriters 条目（Item）读和写接口以及如何使用它们 Scaling and Parallel Processing 多线程步骤（Steps），并行步骤，远程分块（Chunking）和分区（Partitioning） Repeat 重复行为（Repetitive Actions）的完成策略和异常处理 Retry 可重试操作的重做和退出策略 Unit Testing 作业和步骤的测试策略和 APIs Common Batch Patterns 通用批量处理模式和使用指引 JSR-352 Support JSR-352 支持，与 Spring Batch 相似和不同之处 Spring Batch Integration Spring Batch 与 Spring 其他项目的整合 Monitoring and metrics 批量作业的监控和指标 有下列有关的可用附录： 附录名称和链接 文档介绍 List of ItemReaders and ItemWriters 提供的开箱即用（out-of-the box）项目读和写的完整列表 Meta-Data Schema 批量域模式使用的核心表 Batch Processing and Transactions Spring Batch 中使用的事务边界（Transaction Boundaries），事务传播（Transaction propagation）和事务隔离级别（Transaction Isolation Levels） Glossary 批量域中使用的常用术语，概念和词汇。 文档的中文版本由 CWIKI.US 进行翻译和整理。请访问 Spring Batch 文档和手册（中文）   https://www.cwiki.us/display/SpringBatchZH/Reference+Documentation

修改历史（Change-History）宏显示了页面一个的更新历史：版本号，作者，日期和备注。这些内容将会在同一栏中进行显示。 屏幕截图：Confluence 中的修改历史（Change-History）宏 为了向页面中插入修改历史宏：  从编辑工具栏中，选择 插入（Insert）   > 其他宏（Other Macros） 找到并且选择需要的宏。 可用使用自动完成加快这个过程：输入 { 然后开始输入你希望插入的宏的名字，你将会看到建议的宏的列表。在这个列表中，我们插入 cheese 宏（cheese macro）。 如果需要对已经存在的宏进行编辑：单击宏的占位符，然后选择 编辑（Edit）。这将打开宏的细节，你可以对宏的参数进行编辑。 注意：这个宏没有参数 Wiki markup example 宏名称：change-history 宏内容：None {change-history} https://www.cwiki.us/display/CONF6ZH/Change-History+Macro

参数是让你可以用来控制宏的格式和输出的选项。在 Confluence 存储格式或者 Wiki 标记（wikimarkup）中使用的参数名与在宏浏览器中使用的标签名是不同的，在下面我们将会用括号列出  （example）。 参数 是否是必须 默认值 说明 显示的内容类型（Content Type to Display） (content) No titles 可用的值： titles — 在博客页面中仅显示标题。 excerpts — 为美国博客显示短摘要。如果博客有包含摘要宏，那么博客页面宏将会显示博客摘要中的内容。如果博客没有摘要宏，那么博客页面将会显示博客的前几个句子。 entire - 为每一个博客显示完整的内容。 时间帧（Time Frame） (time) No 无限制 指定 Confluence 在博客中查找的时间范围。可用的值： m — 分钟 h — 小时, 如果你指定为 '12h' 的话，那么将会显示最新 12 个小时添加的博客。 d — 天，如果你指定为 '7d' 的话，那么将会显示博客最新七天的博客。 w — 周 标签限制（Restrict to these Labels） (label) No None 通过标签过来结果。宏将会仅仅显示包含有你指定标签的博客，换句话说就是按照标签过滤。你可以通过逗号分隔符来指定一个或者多个标签。 如果你希望扩展标签的的匹配内容，你可以在标签名字前加一个横线（-）。例如：如果你指定一个标签的名字为 -badpage 那么你将会找到所有没有标记为 'badpage' 标签的页面。 如果你希望某一个页面必须包含有某一个标签值，你需要在标签值之前加一个加号（+）。例如：如果你指定一个标签 +superpage，+goodpage 你将会找到页面至少包含有 2 个标签，而且这些页面的标签中都包含有字符 'superpage' 和 'goodpage'。 作者限制（Restrict to theseAuthors ） (author) No None 对返回的结果通过作者过滤。博客页面宏将会仅仅将你指定的作者的博客显示出来。 空间限制（Restrict to these Spaces） (spaces) No @self 例如，在宏中显示空间包含的页面。 这个参数允许你通过空间过滤内容。如果这个参数被使用的话，将会显示你指定空间中的博客页面。你可以通过逗号分隔符来指定一个或者多个空间。 如果希望不包含某一个空间，可以在空间名前面加一个横线（-）。例如：如果你不希望包含有一个空间 BADSPACE，那么你可以使用 -BADSPACE 定义。 如果希望你的结果必须从某一个空间里面来，那么你可以在空间名字的前面加一个加号（+）。例如：如果你指定一个空间名字为 +GOODSPACE ，你将会仅仅得到从 GOODSPACE 中来的内容。（请注意：这个功能不是必须的，因为每一个博客必须得属于一个空间。如果这个加号标记在一个空间名字前同时也在其他空间名字前面，那么这个标记将会被忽略）。 特殊值： @self — 当前空间 @personal — 所有的个人空间 @global — 所有的站点空间 @favorite — 所有你标记为关注的空间 @favourite — 与上面 @favorite 是一样的 @all — Confluence 站点的所有空间 * — 与上面 @all 是一样的 当你指定一个个人空间的时候，请记住在个人空间名字前加一个波浪符（~）例如 ~jblogs 或者 ~jbloggs@example.com 。 博客页面的最大数量（Maximum Number of Blog Posts） (max) No 15 指定可以显示的的最大结果数量。请注意，在结果显示的时候，首先会对结果进行排序，然后在对结果输出的数量进行限制。 排序方式（Sort By） (sort)  No creation 指定结果如何被排序。如果这个参数没有被指定的话，那么将会按照内容的创建时间采用降序的方式进行排序（最新的在前面）。值： title — 按照标题字母排序 creation — 按照内容被添加的时间进行排序 modified — 按照内容被最后修改的时间进行排序 反向排序（Reverse Sort） (reverse)  No false 选择将排序从降序切换到升序（最老的在前面）。与参数 排序方式（Sort By）结合使用，如果你不指定排序方式的话，这个参数将会被忽略。 在存储格式和 Wiki 格式中，可以使用边栏 true 来激活排序方式。 Wiki markup example 宏名称： blog-posts 宏内容：None {blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies} https://www.cwiki.us/display/CONF6ZH/Blog+Posts+Macro

博客页面宏允许你 Confluence 页面中显示博客页面。通过单击博客的标题将会把你链接到博客页面中。 使用博客页面宏 为了将博客页面宏添加到页面中：  从编辑工具栏中，选择 插入（Insert）   > 其他宏（Other Macros） 找到并且选择需要的宏。 可用使用自动完成加快这个过程：输入 { 然后开始输入你希望插入的宏的名字，你将会看到建议的宏的列表。在这个列表中，我们插入 cheese 宏（cheese macro）。 如果需要对已经存在的宏进行编辑：单击宏的占位符，然后选择 编辑（Edit）。这将打开宏的细节，你可以对宏的参数进行编辑。 https://www.cwiki.us/display/CONF6ZH/Blog+Posts+Macro

参数 参数名称 默认值 描述 Filename Patterns (patterns) all Attachment Labels (labels) (None) 标签（labels）的列表，用来过滤附件的显示。如果你希望输入多个标签的话，请使用逗号分隔符来分隔需要使用的标签。Confluence 将会仅显示附件，这个附件具有所有（all）标记的标签。匹配条件是是 AND 而不是 OR。有关对附件进行标签的相关信息，请参考 Add, Remove and Search for Labels 页面中的内容。 Include Old Attachment Versions (old) false 如果设置值为 true 的话，将会包含前期的所有版本在列表中。 Sort By (sortBy)  date 为了对附件进行排序，请注意，用户对页面进行查看的时候，用户可以通过单击每一个列表的头部来对列表进行排序。可以进行排序的变量有： 日期（date） – 对日期进行排序（最新的排在前面） 大小（size）– 按照从大到小的顺序进行排序 名字（name）– 按照字符顺序进行排序 创建日期（created date） - 按照创建日期的倒序进行排序（最新的排在前面） Sort Order (sortOrder)  ascending 使用组合的排序（ Sort By ）参数进行排序，来对附件按照升序或者降序进行排序。 Allow Upload (upload)  true 如果被选中，附件的列表将会包含运行用户进行浏览和附加一个新文件的选项。 Page Title (page)  (None) 被用来从其他页面中显示附件。如果你不输入页面的标题的话，宏将会显示附加到当前页面的所有文件。 Show Previews (preview)  true 被用来显示一个附件文件的预览。如果是 true 的话，当列表项目被展开的时候预览将会显示。 Wiki 标记（markup） 示例 宏名称： attachments 宏内容： None {attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false} https://www.cwiki.us/display/CONF6ZH/Attachments+Macro

希望添加附件宏到一个页面中： 从编辑工具栏中，选择 插入（Insert）   > 其他宏（Other Macros） 找到并且选择需要的宏。 可用使用自动完成加快这个过程：输入 { 然后开始输入你希望插入的宏的名字，你将会看到建议的宏的列表。在这个列表中，我们插入 cheese 宏（cheese macro）。 如果需要对已经存在的宏进行编辑：单击宏的占位符，然后选择 编辑（Edit）。这将打开宏的细节，你可以对宏的参数进行编辑。 https://www.cwiki.us/display/CONF6ZH/Attachments+Macro

附件宏显示添加到一个页面中的所有文件列表。 同时附件宏允许用户（用户需要具有正确的权限）来进行下面的操作： 直接从列表中上传一个文件到页面 编辑附件属性和标签 删除一个附件文件（这个将会删除文件的所有版本） 预览图片附件 下载附加到页面中的所有文件， 注意：如果你的附件非常大的话，你可用使用宏参数来关闭预览功能。 屏幕截图：附件宏显示一个附件的细节   https://www.cwiki.us/display/CONF6ZH/Attachments+Macro

允许你链接到页面的特定部分。有关如何使用锚点的内容，请参考页面 Anchors 页面中的详细内容。 Wiki 标记（markup） 示例 宏名称： anchor 宏内容：None。 {anchor:here} https://www.cwiki.us/display/CONF6ZH/Anchor+Macro

活动流宏是小工具（Gadget）宏的一个特定实现。你可以在你的页面中插入活动流宏。有关其他更多内容请参考 Confluence 活动流小工具 页面的说明。 https://www.cwiki.us/display/CONF6ZH/Activity+Stream+Macro