Spring Data 魔法实现的原理（以Spring Data JPA为例）

最新推荐文章于 2026-07-20 09:55:43 发布

原创

最新推荐文章于 2026-07-20 09:55:43 发布 · 1.1k 阅读

本文深入探讨Spring Data JPA的两大特性：通过Repository接口获取数据库操作方法及根据方法名推导查询的实现原理。从Repository接口的继承到PartTree解析方法名构造JPA查询，揭示Spring Data JPA的内部工作机制。

在Spring Data中，Spring Data提供了两大魔法：

通过继承Repository接口获得数据库操作的常用方法
通过方法名即可进行推导查询

我们下面将以Spring Data JPA为例深入理解这两大魔法的实现（下面的类都没有写包名，在Intellij IDEA下双击SHIFT，将类名复制进去可便捷查找）：

1、Repository接口如何获得常用的数据库操作方法

在Spring Data JPA中我们将我们的实体Repository继承了JpaRepository接口便能获得大量的数据库操作方法，如：

public interface PersonRepository extends JpaRepository<Person, Long> {
   
    }

但JpaRepository只是一个接口：

@NoRepositoryBean
public interface JpaRepository<T, ID> extends PagingAndSortingRepository<T, ID>, QueryByExampleExecutor<T> {
   
   
	@Override
	List<T> findAll();
  
	@Override
	List<T> findAll(Sort sort);
  
	@Override
	List<T> findAllById(Iterable<ID> ids);
  
	@Override
	<S extends T> List<S> saveAll(Iterable<S> entities);
  
	void flush();
  
	<S extends T> S saveAndFlush(S entity);

	void deleteInBatch(Iterable<T> entities);

	void deleteAllInBatch();

	T getOne(ID id);

	@Override
	<S extends T> List<S> findAll(Example<S> example);

	@Override
	<S extends T> List<S> findAll(Example<S> example, Sort sort);
}

它不具备任何实际的可执行代码，它的功能实现都是由SimpleJpaRepository类来提供的，那我们自定义的Repository（PersonRepository）是如何获得SimpleJpaRepository中提供的实现的呢，

请看下面调用过程的分析：

1.1 `@EnableJpaRepositories`

在@EnableJpaRepositories中：指定默认的JpaRepositoryFactoryBean

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(JpaRepositoriesRegistrar.class)
public @interface EnableJpaRepositories {
   
   
	/**
	 * Returns the {@link FactoryBean} class to be used for each repository instance. Defaults to
	 * {@link JpaRepositoryFactoryBean}.
	 *
	 * @return
	 */
	Class<?> repositoryFactoryBeanClass() default JpaRepositoryFactoryBean.class;

}

1.2 `JpaRepositoryFactoryBean`

在JpaRepositoryFactoryBean中创建JpaRepositoryFactory（RepositoryFactorySupport的子类）

protected RepositoryFactorySupport createRepositoryFactory(EntityManager entityManager) {
   
   
	
		JpaRepositoryFactory jpaRepositoryFactory = new JpaRepositoryFactory(entityManager);
		jpaRepositoryFactory.setEntityPathResolver(entityPathResolver);
		jpaRepositoryFactory.setEscapeCharacter(escapeCharacter);

		if (queryMethodFactory != null) {
   
   
			jpaRepositoryFactory.setQueryMethodFactory(queryMethodFactory);
		}

		return jpaRepositoryFactory;
	}

1.3 `JpaRepositoryFactory`

在JpaRepositoryFactory中：指定默认的repositoryBaseClass，为SimpleJpaRepository

public class JpaRepositoryFactory extends RepositoryFactorySupport {
   
   
  //...
  @Override
    protected Class<?> getRepositoryBaseClass(RepositoryMetadata metadata) {
   
   
      return SimpleJpaRepository.class;
    }
  //..
}

1.4 `RepositoryFactorySupport`

RepositoryFactorySupport：它是JpaRepositoryFactory的父类，它通过JpaRepositoryFactory中指定的SimpleJpaRepository，将SimpleJpaRepository代理给我们自定义的Repository接口

public <T> T getRepository(Class<T> repositoryInterface, RepositoryFragments fragments) {
   
   
	//...
		Object target = getTargetRepository(information); //1	target为SimpleJpaRepository
  
		// Create proxy
		ProxyFactory result = new ProxyFactory();
		result.setTarget(target);
		result.setInterfaces(repositoryInterface, Repository.class, TransactionalProxy.class); //2 repositoryInterface为我们自定义的Repository（PersonRepository）接口

		//..
		return repository;
	}

2、如何实现根据方法名推导查询(Derived Query)

Spring Data JPA的另外一个神奇之处是可以根据实体接口中定义的方法名而自动进行查询。这个又是如何实现的呢，我们继续分析：

2.1 `@EnableJpaRepositories`

@EnableJpaRepositories中：指定默认的JpaRepositoryFactoryBean和查询策略

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(JpaRepositoriesRegistrar.class)
public @interface EnableJpaRepositories {
   
   

	/**
	 * Returns the key of the {@link QueryLookupStrategy} to be used for lookup queries for query methods. Defaults to
	 * {@link Key#CREATE_IF_NOT_FOUND}.
	 *
	 * @return
	 */
	Key queryLookupStrategy() default Key.CREATE_IF_NOT_FOUND;

	/**
	 * Returns the {@link FactoryBean} class to be used for each repository instance. Defaults to
	 * {@link JpaRepositoryFactoryBean}.
	 *
	 * @return
	 */
	Class<?> repositoryFactoryBeanClass() default JpaRepositoryFactoryBean.class;

}