欢迎来到 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
无论是一个图片 —— 例如一个模拟的新市场计划需要反馈，还是一个 PDF 文件，一个演讲稿，或者任何你可以在 Confluence 中预览的文件。你可以在预览的的任何位置放置一个热点然后添加你的评论后开始对话。 希望对一个文件进行评论： 单击文件预览中缩略图或者链。 从预览文件的底部拖动一个热点（Pin）图标放置到任何你希望进行评论的地方。 添加的你评论后 保存（Save）。 热点的评论与页面的评论是相同的（inline comments）。你可以使用 @mentions 和 links，然后放置然后数量的热点图标。你甚至可以简单的添加宏 macros，例如使用 Wiki 标记的自动完成添加代码宏。任何具有对页面添加评论的用户都可以对文件的评论进行操作。 当你对文件进行预览的时候，你可以看到在这个版本文件中已经存在的热点评论。选择一个热点来查看评论。 一旦针对评论的对话完成的话，你可以在查看中关闭评论来隐藏（或者任何回复）。如果你需要再次对评论进行解决，你可以选择重新打他们。在查看视图中进入 > 解决评论（Resolved comments）。 解决的评论（Resolved comments）： 选择 更多选项（more options）按钮来显示或者隐藏已经解决的评论。 评论（Comments）：拖动一个热点到文件中来进行评论。 如果你的文件是存储在 Web 服务器上并且是添加 URL 到 Confluence 中或者你的文件不能够被预览（例如视频，压缩文件和一些其他文件类型），你就不能添加评论到这个文件中你不能添加到文件中。 当你上传文件新版本后，你的评论将会发生什么？ 评论只针对一个特定文件中的版本。这个主要是为了避免文件或者图片热点被多次修改二产生的混乱。 为了查看文件前一个版本的列表方式评论： 单击缩略图或者链接来对文件进预览。 在顶部左侧下拉选择中文件名，并且选择前一个版本。 针对前一个版本的的所有热点的评论将会显示出来。 你可以在一个文件中添加多少评论？ 实际上，针对 Confluence 的文件评论数量是没有限制的。但是 Confluence 只显示100 条评论。请参考 CONFSERVER-43397 - Prevent users from adding more than 100 pinned comments and document it GATHERING INTEREST 来获得更多的信息。 https://www.cwiki.us/display/CONF6ZH/Share+and+Comment+on+Files