Skip to content

Latest commit

 

History

History
218 lines (184 loc) · 8.21 KB

readme_zh_CN.md

File metadata and controls

218 lines (184 loc) · 8.21 KB
Raw

Spring PetClinic（宠物诊所）示例应用 Build Status

通过几张图理解Spring Petclinic应用

英文原版讲义

中文讲义（部分有更新）

在本地运行petclinic应用

	git clone https://github.com/spring-projects/spring-petclinic.git
	cd spring-petclinic
    ./mvnw tomcat7:run

您可以通过右边的链接访问petclinic应用： http://localhost:9966/petclinic/

如果发现了bug，或者有什么改进的建议，应该怎么办

请访问我们的issue追踪系统： https://github.com/spring-projects/spring-petclinic/issues

数据库配置

Petclinic默认采用内存数据库(HSQLDB)，在启动时初始化数据。对于MySQL数据库，我们也提供了类似的配置，如果需要可以打开相应选项。 注意，如果数据库类型切换为MySQL，则需要更新data-access.properties文件，并在pom.xml中把关于mysql-connector-java包的注释去掉。

您可以用docker启动一个MySql数据库实例:

docker run -e MYSQL_ROOT_PASSWORD=petclinic -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:5.7.8

在Eclipse/STS中开发Petclinic应用

先决条件

在您的系统中需要安装以下组件:

注意: m2e插件装好之后，在Eclipse的 “帮助” -> “关于”对话框中会出现一个 m2 的图标。 请依据右边链接中描述的方法安装m2e插件: http://eclipse.org/m2e/download/

步骤:

  1. 在命令行中
git clone https://github.com/spring-projects/spring-petclinic.git
  1. 在Eclipse中
File -> Import -> Maven -> Existing Maven project

要查找一些特定的东西?

Java配置
Java Config分支 Petclinic默认使用基于XML的配置方式。如果您更喜欢使用Java Config（基于注解），这里有个Java Config分支 链接。Antoine Rey贡献了这个分支，在此向他致谢。
在'Web'层中文件
Spring MVC - XML集成 mvc-view-config.xml
Spring MVC - ContentNegotiatingViewResolver mvc-view-config.xml
JSP自定义标签 WEB-INF/tags createOrUpdateOwnerForm.jsp
Bower bower-install maven profile 在 pom.xml 中声明
JavaScript库在bower.json中定义
Bower采用JSON格式的配置文件
在Spring配置中的资源映射
Dandelion-datatables ownersList.jsp vetList.jsp web.xml datatables.properties
Thymeleaf分支 参见此处
采用GemFire和Spring Data GemFire代替ehcache (向Bijoy Choudhury致谢) 参见此处
'Service'和'Repository'层文件
事务（Transactions） business-config.xml ClinicServiceImpl.java
缓存（Cache） tools-config.xml ClinicServiceImpl.java
Bean Profiles business-config.xml ClinicServiceJdbcTests.java web.xml
JdbcTemplate business-config.xml jdbc目录
JPA business-config.xml jpa目录
Spring Data JPA business-config.xml springdatajpa目录
其它文件
Gradle 分支 参见此处

与其它开源项目的交互

在开发Spring Petclinic应用的过程中，最有意思的部分之一是我们能有机会和许多其它开源项目直接联系。我们发现了一些bug/改进的建议，涉及到了Spring、Spring Data、Bean Validation甚至Eclipse项目！ 在多数情况下，这些问题都在几天之内就被修复／实现了。 以下是有关列表:

名称 事项
Spring JDBC: simplify usage of NamedParameterJdbcTemplate SPR-10256 及 SPR-10257
Bean Validation / Hibernate Validator: simplify Maven dependencies and backward compatibility HV-790 及 HV-792
Spring Data: provide more flexibility when working with JPQL queries DATAJPA-292
Eclipse: validation bug when working with .tag/.tagx files (has only been fixed for Eclipse 4.3 (Kepler)). See here for more details. STS-3294

贡献

我们建议使用issue tracker来报告bug、提交新功能请求及合并代码请求。

对于合并代码的请求，请参考editor config中的编辑器设置。想要了解更多关于信息、或者要下载相关插件，请移步至http://editorconfig.org。