Hibernate 项目小组提供了一系列发布组合（bundles），这些发布组合发布在 SourceForge 文件发布系统中。这些发布的包有 TGZ 和ZIP 格式。 每一个发布组合包含有 JAR 文件，文档，源代码和其他一些有用的内容。 你可以选择你需要的格式来下载 Hibernate 的发布版本，有关发布版本的列表，请参考 https://sourceforge.net/projects/hibernate/files/hibernate-orm/。发布版本的结构请参考下面的内容： lib/required/ 目录包含有 hibernate-core Jar 和所有需要的依赖。不管你需要使用 Hibernate 的何种功能，所有的这些都需要设置到你的  classpath 路径中。 lib/envers 目录包含有 hibernate-envers Jar 和需要的依赖（这些依赖，不包含在 lib/required/ 和lib/jpa/ 中）。 lib/spatial/ 目录包含有 hibernate-spatial Jar 和需要的依赖（这些依赖，不包含在 lib/required/ 和lib/jpa/ 中）。 lib/osgi/ 目录包含有 hibernate-osgi Jar 和需要的依赖（这些依赖，不包含在 lib/required/ 和lib/jpa/ 中）。 lib/jpa-metamodel-generator/ 目录包含了创建 Criteria API type-safe 元模型（Metamodel）所需要的 Jar。 lib/optional/ 包含了各个连接池和 Hibernate 提供的二级缓存所需要的 Jar，已经它们所需要的依赖。   https://www.cwiki.us/display/HIBERNATE/Obtaining+Hibernate

Hibernate 的功能被拆分成一系列的模块/包（modules/artifacts），其目的是为了对依赖进行独立（模块化）。 模块名称 说明 hibernate-core 这个是 Hibernate 的主要（main (core)）模块。定义了 ORM 的特性和 API 以及一系列整合的 SPIs。 hibernate-envers Hibernate 历史的实体版本特性 hibernate-spatial Hibernate 的 Spatial/GIS 数据类型支持 hibernate-osgi Hibernate 支持运行 OSGi 容器 hibernate-agroal 整合 Agroal 连接池库到 Hibernate hibernate-c3p0 整合 C3P0 连接池库到 Hibernate hibernate-hikaricp 整合 HikariCP 连接池库到 Hibernate hibernate-vibur 整合 Vibur DBCP 连接池库到 Hibernate hibernate-proxool 整合 Proxool 连接池库到 Hibernate hibernate-jcache 整合 JCache 缓存特性到 Hibernate，使任何与其兼容的缓存实现能够成为 Hibernate 二级缓存的提供者 hibernate-ehcache 整合 Ehcache 缓存库到 Hibernate 中成为 Hibernate 的二级缓存提供者 https://www.cwiki.us/display/HIBERNATE/Obtaining+Hibernate

同时在面向对象软件和关系型数据库进行工作，可能会非常复杂和费时。数据在对象和数据库之间可能会不一致，然后导致开发成本会非常高。 Hibernate 是一个针对 Java 环境的对象关系映射（Object/Relational Mapping (ORM)）。对象关系映射的定义为从技术上在数据模型和关系数据库模型之间进行映射。请参考 http://en.wikipedia.org/wiki/Object-relational_mapping 来获得更高层次的讨论。同时，Martin Fowler 的 OrmHate 文章讨论了很多映射不吻合的问题。 尽管在使用 Hibernate 的时候不需要你具有很强的 SQL 背景，但是具有一些对 SQL 和相关概念的的基本了解能够帮助你更加快速和全面的理解 Hibernate。对数据模型（data modeling）原理的了解对使用 Hibernate 非常重要。http://www.agiledata.org/essays/dataModeling101.html 和 http://en.wikipedia.org/wiki/Data_modeling 能够帮助你从开始了解数据模型的原理。 Hibernate 对 Java 类到数据库表中的映射进行实现，同时也实现了 Java 数据类型到 SQL 数据类型。更进一步，Hibernate 能够对数据进行查询和检索。Hibernate 能够显著的减少针对 SQL 和 JDBC 的手动数据处理。Hibernate 的目标是通过尽量减少针对 SQL 和 JDBC 需要的手动操作，来减少 95% 的通用数据持久性相关程序开发任务。与其他持久性解决方案不同的是，Hibernate 并不隐藏 SQL 的强大功能，并保证你对关系技术和知识的投资与往常一样并有效。 Hibernate 可能不是针对数据中心的最佳解决方案。数据中心的意思是在数据库中实现所有的商业逻辑。Hibernate 针对面向对象域模型和基于 Java 中间层的商业逻辑非更有效率。Hibernate 能够帮助你删除和封装供应商特定 SQL 代码和简化从返回结果集从表格展示转换为对象。 如果你希望参与项目，请参考 http://hibernate.org/orm/contribute/ 链接。 针对本指南参考可用的项目和代码请参考 hibernate-tutorials.zip 中的内容。 https://www.cwiki.us/display/HIBERNATE/Preface

Git 如果不进行修改的话，在默认情况下将会使用全局的用户名称和电子邮件。 但是在 GitHub 中是通过用户邮件来进行提交人匹配的。 如何针对项目来修改提交的用户信息？   针对 TortoiseGit， 你可以在项目中选择 settings。 然后选择 Git 的 local 选项。 在 Local 中填入你希望使用的用户名和邮件地址，然后保存即可。 如果你不是使用 TortoiseGit，你可以在你项目 Check out 的目录中，打开文件： .git\config 在这个文件中的最下面，输入： [user] name = YuCheng Hu email = yhu@ossez.com 你可以根据你的用户名和密码换成你的。 然后保存即可。 一个大致的示例文件如下图：

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