springboot 集成 knife4j 启动了打不开页面

转载

mob6454cc61981e 2024-09-12 15:53:14

一、spring data jpa介绍

1、首先了解JPA是什么？

JPA（Java Persistence API）是sun官方提出的Java持久化规范。它为java开发人员提供了一种对象/表之间关联映射工具来管理Java应用中的关系数据。它的出现主要是为了简化现有的持久化开发工作和整合ORM技术，结束现在Hibernate，TopLink，JDO等ORM框架各自为营的局面。值得注意的是，JPA是在充分吸收了现有Hibernate，TopLink，JDO等ORM框架优点的基础上发展而来的，具有易于使用，伸缩性强等优点。从目前的开发社区的反应上看，JPA收到了极大的支持和赞扬，其中就包括了Spring和EJB3.0的开发团队。

注意：JPA是一套规范，不是一套产品，那么像Hibernate,TopLink,JDO它们是一套产品，如果说这些产品实现了这个JPA规范，那么我们就可以叫他们为JPA的实现产品。

2、spring data jpa

Spring Data Jpa 是Spring基于ORM框架、JPA规范的基础上封装的一套JPA应用框架，可使开发者用极简的代码即可实现对数据的访问和操作。它提供了包括增删改查等在内的常用功能，且易于扩展！学习并使用Spring Data JPA可以极大提高开发效率！

二、基本查询

基本查询也分为两种，一种是spring data默认已经实现，一种是根据查询的方法来自动解析成SQL。

1. 预先生成方法

spring data jpa 默认预先生成了一些基本的CURD的方法。如何使用这些预先生成的基本方法呢？

1）继承JpaRepository

public interface UserRepository extends JpaRepository<User,Long>();

2）使用默认方法

@Test
public void testBaseQuery() throws Exception {
    User user=new User();
    userRepository.findAll();
    userRepository.findOne(1l);
    userRepository.save(user);
    userRepository.delete(user);
    userRepository.count();
    userRepository.exists(1l);
    // ...
}

上面的代码不解释了，根据方法名就可以看出意思来。

2. 自定义简单查询

自定义的简单查询就是根据方法名来自动生成SQL，主要的语法是：

findXXXBy，readAXXXBy，queryXXXBy，countXXXBy，getXXXBy后面跟属性名称：

User findByUserName（String userName）;

也使用一些关键字 AND、OR

User findByUserNameOrEmail（String userName,String email）;

修改、删除、统计也是类似语法

Long deleteById(Long id);
Long countByUserName(String userName);

基本上Sql体系中的关键词都可以使用，例如：Like、IgnoreCase、OrderBy。

List<User> findByEmailLike(String email);
User findByUserNameIgnoreCase(String userName);
List<User> findByUserNameOrderByEmailDesc(String email);

具体的关键字，使用方法和生成SQL如下表所示：

关键字

Keyword	Sample	JPQL snippet
And	findByLastnameAndFirstname	...where x.lastname=? and x.firstname=?
Or	findByLastnameOrFirstname	...where x.lastname=? or x.firstname=?
Is,Equals	findByFirstnameIs,findByFirstnameEquals	...where x.firstname=?
Between	findByStartDateBetween	where x.startDate between ? and ?
LessThan	findByAgeLessThan	...where x.age<?
LessThanEqual	findByAgeLessThanEqual	...where x.age<=?
GreaterThan	findByAgeGreaterThan	...where x.age>?
GreaterThanEqual	findByAgeGreaterThanEqual	...where x.age>=?
After	findByStartDateAfter	...where x.startDate>?
Before	findByStartDateBefore	...where x.startDate<?
IsNull	findByAgeIsNull	...where x.age is null
IsNotNull,NotNull	findByAge(Is)NotNull	...where x.age not null
Like	findByFirstnameLike	...where x.firstname like ?
NotLike	findByFirstnameNotLike	...where x.firstname not like ?
StartingWith	findByFirstnameStartingWith	...where x.firstname like ? (parameter bound with appended %)
EndingWith	findByFirstnameEndingWith	...where x.firstname like ？（parameter bound with prepended %）
Containing	findByFirstnameContaining	...where x.firstname like ? (parameter bound wrapped in %)
OrderBy	findByAgeOrderByLastnameDesc	...where x.age=? order by x.lastname desc
Not	findByLastnameNot	...where x.lastname <> ?
In	findByAgeIn(Collection ages)	...where x.age in ?
NotIn	findByAgeNotIn(Collection ages)	...where x.age not in ?
True	findByActiveTrue()	...where x.active=true
False	findByActiveFalse()	...where x.active=false
ignoreCase	findByFirstnameIgnoreCase	...where upper(x.firstname) = upper(?)

三、复杂查询

在实际的开发中我们需要用到分页、筛选、表连接等查询的时候就需要特殊的方法或者自定义的SQL

1. 分页查询

分页查询在实际使用中非常普遍了，spring data jpa已经帮我们实现了分页的功能，在查询的方法中，需要传入参数Pageable，当查询中有多个参数的时候Pageable建议作为最后一个参数传入。

Page<User> findAll(Pageable pageable);
Page<User> findByUsername(String userName,Pageable pageable);

Pageable是spring封装的分页实现类，使用的时候需要传入页数、每页条数和排序规则

@Test
public void testPageQuery() throws Exception{
    int page=1,size=10;
    Sort sort = new Sort(Direction.DESC,"id");
    Pageable pageable = new PageRequest(page,size,sort);
    userRepository.findAll(pageable);
    userRepository.findByUserName("testName",pageable);
}

2. 限制查询

有时候我们只需要查询前N个元素，或者只取前一个实体。

User findFirstByOrderByLastnameAsc();
User findTopByOrderByAgeDesc();
Page<User> queryFirst10ByLastname(String lastname, Pageable pageable);
List<User> findFirst10ByLastname(String lastname, Sort sort);
List<User> findTop10ByLastname(String lastname, Sort sort);

3. 自定义SQL查询

其实Spring data绝大部分的SQL都可以根据方法名定义的方式来实现，但是由于某些原因我们想使用自定义的SQL来查询，spring data也是完美支持的；在SQL的查询方法上面使用@Query注解，如涉及到删除和修改还需要加上@Modifying。也可以根据需要添加@Transactional来支持事务以及查询超时的设置等。

@Modifying
@Query("update User u set u.username=? where c.id=?")
int modifyByIdAndUserId(String userName, Long id);

@Trasactional
@Modifying
@Query("delete from User where id=?")
void deleteByUserId(Long id);

@Transactional(timeout=10)
@Query("select u from User u where u.emailAddress=?")
User findByEmailAddress(String emailAddress);

4. 多表查询

多表查询在spirng data jpa中有两种实现方式，第一种是利用hibernate的级联查询来实现，第二种是创建一个结果集的接口来接收表关联查询后的结果，这里主要第二种方式。

首先需要定义一个结果集的接口类。

public interface HotelSummary{
    City getCity();
    String getName();
    Double getAverageRating();
    default Integer getAverageRatingRounded(){
        return getAverageRating() == null? null:(int)Math.round(getAverageRating());
    }
}

查询的方法返回类型设置为新创建的接口

@Query("select h.city as city, h.name as name, avg(r.rating) as averageRating "
        - "from Hotel h left outer join h.reviews r where h.city = ?1 group by h")
Page<HotelSummary> findByCity(City city, Pageable pageable);

@Query("select h.name as name, avg(r.rating) as averageRating "
        - "from Hotel h left outer join h.reviews r  group by h")
Page<HotelSummary> findByCity(Pageable pageable);
@Query("select h.city as city, h.name as name, avg(r.rating) as averageRating "
        - "from Hotel h left outer join h.reviews r where h.city = ?1 group by h")
Page<HotelSummary> findByCity(City city, Pageable pageable);

@Query("select h.name as name, avg(r.rating) as averageRating "
        - "from Hotel h left outer join h.reviews r  group by h")
Page<HotelSummary> findByCity(Pageable pageable);

使用

Page<HotelSummary> hotels = this.hotelRepository.findByCity(new PageRequest(0, 10, Direction.ASC, "name"));
for(HotelSummary summay:hotels){
        System.out.println("Name" +summay.getName());
    }
Page<HotelSummary> hotels = this.hotelRepository.findByCity(new PageRequest(0, 10, Direction.ASC, "name"));
for(HotelSummary summay:hotels){
        System.out.println("Name" +summay.getName());
    }

在运行中Spring会给接口（HotelSummary）自动生产一个代理类来接受返回的结果，代码汇总使用getXXX的形式来获取。

四、多数据源的支持

1、同源数据库的多源支持

日常项目中因为使用的分布式开发模式，不同的服务有不同的数据源，常常需要在一个项目中使用多个数据源，因此需要配置spring data jpa对多数据源的使用，一般分以下三步：

1）配置多数据源

2）不同源的实体类放入不同包路径

3）生命不同的包路径下使用不同的数据源、事务支持

这里有一篇文章写的很清楚：Spring Boot多数据源配置与使用

2. 异构数据库多源支持

比如我们的项目中，既需要对mysql的支持，也需要对mongodb的查询等。

实体类声明@Entity关系型数据库支持类型、声明@Document为mongodb支持类型，不同的数据源使用不同的实体就可以了。

interface PersonRepository extends Repository<Person, Long> {
 …
}

@Entity
public class Person {
  …
}

interface UserRepository extends Repository<User, Long> {
 …
}

@Document
public class User {
  …
}
interface PersonRepository extends Repository<Person, Long> {
 …
}

@Entity
public class Person {
  …
}

interface UserRepository extends Repository<User, Long> {
 …
}

@Document
public class User {
  …
}

但是，如果User用户既使用mysql也使用mongodb呢，也可以做混合使用

interface JpaPersonRepository extends Repository<Person, Long> {
 …
}

interface MongoDBPersonRepository extends Repository<Person, Long> {
 …
}

@Entity
@Document
public class Person {
  …
}
interface JpaPersonRepository extends Repository<Person, Long> {
 …
}

interface MongoDBPersonRepository extends Repository<Person, Long> {
 …
}

@Entity
@Document
public class Person {
  …
}

也可以通过对不同的包路径进行声明，比如A包路径下使用mysql，B包路径下使用mongoDB

@EnableJpaRepositories(basePackages = "com.neo.repositories.jpa")
@EnableMongoRepositories(basePackages = "com.neo.repositories.mongo")
interface Configuration { }
@EnableJpaRepositories(basePackages = "com.neo.repositories.jpa")
@EnableMongoRepositories(basePackages = "com.neo.repositories.mongo")
interface Configuration { }

五、其它

1. 使用枚举

使用枚举的时候我们希望数据库中存储的是枚举对应的String类型，而不是枚举的索引值，需要在属性上面添加@Enumerated(EnumType.STRING)注解

@Enumerated(EnumType.STRING) 
@Column(nullable = true)
private UserType type;
@Enumerated(EnumType.STRING) 
@Column(nullable = true)
private UserType type;

不需要和数据库映射的属性

正常情况下我们在实体类上加入注解@Entity，就会让实体类和表相关联，如果其中某个属性我们不需要和数据库来关联指示在展示的时候做计算，只需要加上@Transient属性即可。

@Transient
private String  userName;
@Transient
private String  userName;

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。

上一篇：使用ssh连接redisserver

下一篇：spring 异步执行每个任务结束后停5s

提问和评论都可以，用心的回复会被更多人看到评论

发布评论

相关文章

官方博客	全部文章	热门标签	班级博客
了解我们	网站地图	意见反馈

鸿蒙开发者社区	51CTO学堂
51CTO	软考资讯

springboot 集成 knife4j 启动了打不开页面

springboot 集成 knife4j 启动了打不开页面

51CTO博客