关于spring:Spring认证中国教育管理中心Spring认证干货教程

原题目：Spring Data LDAP 参考文档(内容起源：Spring 中国教育管理中心）

本章指出了 LDAP 存储库反对的个性。它建设在应用 Spring Data Repositories 中解释的外围存储库反对上。您应该对那里解释的基本概念有充沛的理解。

在应用 Spring LDAP 存储库时，您应该记住以下几点：

Spring LDAP 存储库能够通过 <data-ldap:repositories> 在 XML 配置中应用标记或 @EnableLdapRepositories 在配置类上应用正文来启用。
要 LdapQuery 在主动生成的存储库中蕴含对参数的反对，请让您的界面扩大 LdapRepository 而不是 CrudRepository.
所有 Spring LDAP 存储库都必须与应用 ODM 正文正文的实体一起应用，如 Object-Directory Mapping 中所述。
因为所有 ODM 托管类都必须有一个专有名称作为 ID，因而所有 Spring LDAP 存储库都必须将 ID 类型参数设置为 javax.naming.Name。实际上，内置 LdapRepository 函数只承受一个类型参数：托管实体类，它的 ID 默认为 javax.naming.Name。
因为 LDAP 协定的特殊性，Spring LDAP 存储库不反对分页和排序。
您必须应用 ODM 正文，例如
org.springframework.ldap.odm.annotations.Id. 应用 Spring Data 的注解是行不通的，因为 Spring LDAP 应用了本人的映射层。

7.1. 用法
要拜访存储在 LDAP 兼容目录中的域实体，您能够应用咱们简单的存储库反对，这大大简化了施行。为此，请为您的存储库创立一个接口，如以下示例所示：

示例 54. 示例 Person 实体

@Entry(objectClasses = { “person”, “top”}, base=”ou=someOu”) public class Person {@Id private Name dn; @Attribute(name=”cn”) @DnAttribute(value=”cn”, index=1) private String fullName; @Attribute(name=”firstName”) private String firstName; // No @Attribute annotation means this is bound to the LDAP attribute // with the same value private String firstName; @DnAttribute(value=”ou”, index=0) @Transient private String company; @Transient private String someUnmappedField; // …more attributes below }

Spring 认证中国教育管理中心 -Spring 认证干货教程
咱们这里有一个简略的域对象。请留神，它有一个名为 dntype 的属性 Name。应用该域对象，咱们能够通过为它定义一个接口来创立一个存储库来长久化该类型的对象，如下所示：

示例 55. 用于长久化 Person 实体的根本存储库接口

public interface PersonRepository extends CrudRepository<Person, Long> {

// additional custom finder methods go here
}
目前，此接口仅用于键入目标，但咱们能够稍后为其增加其余办法。在您的 Spring 配置中，增加以下内容：

示例 56. 惯例 LDAP 存储库 Spring 配置

<beans xmlns=”http://www.springframework.org/schema/beans” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:ldap=”http://www.springframework.org/schema/ldap” xmlns:data-ldap=”http://www.springframework.org/schema/data/ldap” xsi:schemaLocation=”http://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/ldap https://www.springframework.org/schema/ldap/spring-ldap.xsd http://www.springframework.org/schema/data/ldap https://www.springframework.org/schema/data/ldap/spring-ldap.xsd”> <ldap:context-source url=”ldap://127.0.0.1:389″ username=”cn=Admin” password=”secret” /> <ldap:ldap-template /> <data-ldap:repositories base-package=”com.acme.*.repositories” /> </beans>

Spring 认证中国教育管理中心 -Spring 认证干货教程
此命名空间元素会导致扫描根底包以查找 LdapRepository 为找到的每个扩大和创立 Spring bean 的接口。默认状况下，存储库会取得一个主动拆卸的 LdapTemplateSpring bean，该 bean 称为 ldapTemplate，因而 ldap-template-ref 如果您偏离此约定，则只须要显式配置。

如果要应用 Java 配置，请应用 @EnableLdapRepositories 正文。正文带有与命名空间元素雷同的属性。如果没有配置根本包，基础设施会扫描带正文的配置类的包。以下示例显示了如何设置 Java 配置：

示例 57. 存储库的 Java 配置

@Configuration
@EnableLdapRepositories
class ApplicationConfig {

@Bean
ContextSource contextSource() {LdapContextSource ldapContextSource = new LdapContextSource();
    ldapContextSource.setUrl("ldap://127.0.0.1:389");

    return ldapContextSource;
}

@Bean
LdapTemplate ldapTemplate(ContextSource contextSource) {return new LdapTemplate(contextSource);
}

}
Spring 认证中国教育管理中心 -Spring 认证干货教程
因为咱们的域存储库扩大了 CrudRepository，它为您提供了 CRUD 操作以及拜访实体的办法。应用存储库实例是将其注入客户端的依赖关系。

咱们能够为咱们的存储库增加分页拜访，如下所示：

示例 58. 对 Person 实体的分页拜访

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration
public class PersonRepositoryTests {

@Autowired PersonRepository repository;

@Test
public void readAll() {List<Person> persons = repository.findAll();
  assertThat(persons.isEmpty(), is(false));
}

}
Spring 认证中国教育管理中心 -Spring 认证干货教程
该示例应用 Spring 的单元测试反对创立了一个应用程序上下文，它将执行基于注解的依赖注入到测试用例中。在测试方法中，咱们应用存储库来查问数据存储。

7.2. 查询方法
您通常在存储库上触发的大多数数据拜访操作都会导致对 LDAP 目录运行查问。定义这样的查问就是在存储库接口上申明一个办法，如以下示例所示：

示例 59. 带有查询方法的 PersonRepository

public interface PersonRepository extends PagingAndSortingRepository<Person, String> {

List<Person> findByLastname(String lastname);                            

List<Person> findByLastnameFirstname(String lastname, String firstname); 

}
该办法显示对所有具备给定 的人的查问 lastname。该查问是通过解析能够与 And 和连贯的束缚的办法名称来派生的 Or。因而，办法名称导致查问表达式为(&(objectclass=person)(lastname=lastname))。

该办法显示了对所有具备给定 lastname 和 的人的查问 firstname。查问是通过解析办法名称得出的。因而，办法名称导致查问表达式为(&(objectclass=person)(lastname=lastname)(firstname=firstname))。

Spring 认证中国教育管理中心 -Spring 认证干货教程
下表提供了可用于查询方法的关键字示例：

Spring 认证中国教育管理中心 -Spring 认证干货教程
7.2.1. 查问 DSL 反对
Spring LDAP 中蕴含根本的 QueryDSL 反对。这种反对包含以下内容：

Annotation Processor，LdapAnnotationProcessor 用于基于 Spring LDAP ODM 正文生成 QueryDSL 类。无关 ODM 正文的更多信息，请参阅对象目录映射。
查问实现，QueryDslLdapQuery 用于在代码中构建和运行 QueryDSL 查问。
Spring Data 存储库反对 QueryDSL 谓词。QueryDslPredicateExecutor 包含许多具备适当参数的附加办法。您能够扩大此接口（连同 LdapRepository）以将此反对蕴含在您的存储库中。
7.3. 各种各样的
7.3.1.CDI 集成
存储库接口的实例通常由容器创立，因而在应用 Spring Data 时，Spring 是最天然的抉择。从 version 2.1 开始，Spring Data LDAP 蕴含一个自定义 CDI 扩大，容许您在 CDI 环境中应用存储库形象。该扩大是 JAR 的一部分。要激活它，请将 Spring Data LDAP JAR 放入您的类门路中。您当初能够通过为 实现 CDI Producer 来设置根底构造 LdapTemplate，如以下示例所示：

class LdapTemplateProducer {

@Produces
@ApplicationScoped
public LdapOperations createLdapTemplate() {

    ContextSource contextSource = …
    return new LdapTemplate(contextSource);
}

}
Spring 认证中国教育管理中心 -Spring 认证干货教程
LdapTemplate 每当容器申请存储库类型的 bean 时，Spring Data LDAP CDI 扩大都会将其作为 CDI bean 并为 Spring Data 存储库创立代理。因而，获取 Spring Data 存储库的实例是申明注入属性的问题，如以下示例所示：

class RepositoryClient {

@Inject
PersonRepository repository;

public void businessMethod() {

List<Person> people = repository.findAll();

}
}
内容起源：Spring 中国教育管理中心（Spring 认证）

Spring 认证中国教育管理中心 -Spring 认证干货教程
2021 年 2 月，VMware 公司正式与北京中科卓望网络科技有限公司（以下简称：中科卓望）达成策略单干，授予其 Spring 中国教育管理中心，携手 VMware 寰球最新 Spring 技术和认证体系，帮忙中国院校构建业余教学内容，全面赋能将来开发人。