Next-level integration with Spring Data Elasticsearch

1
ElasticON Global
Peter-Josef Meisch
Spring Data Elasticsearch Project Lead

2
This presentation and the accompanying oral presentation contain forward-looking statements, including statements
concerning plans for future offerings; the expected strength, performance or benefits of our offerings; and our future
operations and expected performance. These forward-looking statements are subject to the safe harbor provisions
under the Private Securities Litigation Reform Act of 1995. Our expectations and beliefs in light of currently
available information regarding these matters may not materialize. Actual outcomes and results may differ materially
from those contemplated by these forward-looking statements due to uncertainties, risks, and changes in
circumstances, including, but not limited to those related to: the impact of the COVID-19 pandemic on our business
and our customers and partners; our ability to continue to deliver and improve our offerings and successfully
develop new offerings, including security-related product offerings and SaaS offerings; customer acceptance and
purchase of our existing offerings and new offerings, including the expansion and adoption of our SaaS offerings;
our ability to realize value from investments in the business, including R&D investments; our ability to maintain and
expand our user and customer base; our international expansion strategy; our ability to successfully execute our
go-to-market strategy and expand in our existing markets and into new markets, and our ability to forecast customer
retention and expansion; and general market, political, economic and business conditions.
Additional risks and uncertainties that could cause actual outcomes and results to differ materially are included in
our filings with the Securities and Exchange Commission (the “SEC”), including our Annual Report on Form 10-K for
the most recent fiscal year, our quarterly report on Form 10-Q for the most recent fiscal quarter, and any
subsequent reports filed with the SEC. SEC filings are available on the Investor Relations section of Elastic’s
website at ir.elastic.co and the SEC’s website at www.sec.gov.
Any features or functions of services or products referenced in this presentation, or in any presentations, press
releases or public statements, which are not currently available or not currently available as a general availability
release, may not be delivered on time or at all. The development, release, and timing of any features or functionality
described for our products remains at our sole discretion. Customers who purchase our products and services
should make the purchase decisions based upon services and product features and functions that are currently
available.
All statements are made only as of the date of the presentation, and Elastic assumes no obligation to, and does not
currently intend to, update any forward-looking statements or statements relating to features or functions of services
or products, except as required by law.
Forward-Looking Statements

3
Nothing will stop you being creative more
effectively as the fear of making a mistake.
John Cleese

4
Next Level
Elasticsearch
Integration with Spring
Data Elasticsearch

What is Spring Data
Elasticsearch?

“Spring Data’s mission is to provide a
familiar and consistent, Spring-based
programming model for data access
while still retaining the special traits of
the underlying data store.”

Configure the connection
to Elasticsearch

Configure the connection to Elasticsearch
@Configuration
public class RestClientConfig extends
AbstractElasticsearchConfiguration {
@Override @Bean public RestHighLevelClient elasticsearchClient() {
ClientConfiguration clientConfiguration =
ClientConfiguration.builder()
.connectedTo("localhost:9200")
.build();
return RestClients.create(clientConfiguration).rest();
}
}

@Configuration
.withProxy("localhost:8080")
.build();
}
}

@Configuration
.usingSsl()
.build();
}
}

@Configuration
.withBasicAuth("myuser", "mypassword")
.build();
}
}

@Configuration
.withPathPrefix("customer1")
.build();
}
}

Supplier<HttpHeaders> currentTimeHeaders = () -> {
HttpHeaders headers = new HttpHeaders();
headers.add("currentTime",
LocalDateTime.now()
.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME));
return headers;
};
.withHeaders(currentTimeHeaders)
.build();

Entity definition
public class Person {
@Id
private String id;
private String lastName;
private String firstName;
private LocalDate birthDate;
}

Entity definition
@Document(indexName = "person")
@Id
private String id;
}

Entity definition
@Id
private String id;
@Field(type = FieldType.Text)
}

Entity definition
@Id
private String id;
@Field(type = FieldType.Date, format = DateFormat.basic_date)
}

IndexOperations
● index creation and deletion
● index settings
● index mappings
● index templates
● alias management
● refresh operation

IndexOperations
private ElasticsearchOperations operations ; // injected by Spring
IndexOperations indexOps = operations.indexOps(Person.class);
indexOps.create();
indexOps.putMapping();
PutTemplateRequest putTemplateRequest =
PutTemplateRequest.builder("template-name", "log-*")
.withSettings(settings)
.withMappings(mapping)
.withAliasActions(aliasActions)
.build();
indexOps.putTemplate(putTemplateRequest);

IndexOperations
private ElasticsearchOperations operations; // injected by Spring
IndexOperations indexOps = operations.indexOps(Person.class) ;
indexOps.create();
.build();

IndexOperations
indexOps.create();
.build();

IndexOperations
indexOps.create();
.build();
indexOps.putTemplate(putTemplateRequest) ;

DocumentOperations
● save
● get
● delete
● exists
● update

SearchOperations
● count
● search
Query based operations

NativeSearchQuery
import static org.elasticsearch.index.query.QueryBuilders.*;
import static
org.elasticsearch.search.aggregations.AggregationBuilders.*;
Query query =
new NativeSearchQueryBuilder()
.addAggregation( terms("lastNames").field("lastName").size(10) )
.withQuery( matchQuery("firstName", firstName) )
.build();
SearchHits<Person> searchHits = operations.search(query,
Person.class);

StringQuery
Query query = new StringQuery( "{" +
" "bool": {" +
" "must": [" +
" {" +
" "match": {" +
" "lastName": "Smith"" +
" }" +
" }" +
" ]" +
" }" +
"}");
Person.class);

CriteriaQuery
Criteria criteria =
new Criteria("lastName").is("Smith")
.and("firstName").is("James");
Query query = new CriteriaQuery(criteria);
Person.class);

SearchHit<T
● id
● index name
● the entity of type T
● score
● sort values
● highlight fields
● inner hits

SearchHits<T
● number of total hits
● total hits relation (eq, gte)
● list of SearchHit<T> objects
● max score
● aggregations

Repository
interface PersonRepository extends
ElasticsearchRepository< Person, String > {
}
// ElasticsearchRepository
// +PagingAndSortingRepository
// + CrudRepository
// + Repository

Repository
count()
delete(T)
deleteAll()
deleteAll(Iterable<? extends T)
deleteById(ID)
existsById(ID)
findAll()
findAll(Pageable)
findAll(Sort)
findAllById(Iterable<ID>)
findById(ID)
save(T)
saveAll(Iterable<T>)
searchSimilar(T entity, String[] fields, Pageable pageable)

Repository methods
ElasticsearchRepository< Person, String > {
List<Person> searchByFirstName(String name);
List<Person> findByFirstNameOrderByLastNameAsc(String name);
List<Person> queryByBirthDateBefore(LocalDate date);
}

Repository methods
ElasticsearchRepository<Person, String> {
@Query(value = "{"fuzzy":{"lastName":"?0"}}")
List<Person> findByLastNameFuzzy(String lastName);
}

Repository method return types
List<Person> searchByFirstName(String name);
}

Stream<Person> searchByFirstName(String name);
}

List<SearchHit<Person>> searchByFirstName(String name);
}

Stream<SearchHit<Person>> searchByFirstName(String name);
}

SearchHits<Person> searchByFirstName(String name);
}

SearchPage<Person> searchByFirstName(String name, Pageable page);
}

Repository usage
@RestController @RequestMapping(”/persons”)
public class PersonController {
private PersonRepository repository;
public PersonController(PersonRepository repository) {
this.repository = repository;
}
@GetMapping(”/firstName/{name}”)
List<Person> byFirstName( @PathVariable(”name”) String name) {
return repository.searchByFirstName(name) ;
}
}

Repository method with highlight definition
@Highlight(fields = {
@HighlightField(name = "firstName")
})
SearchHits<Person> searchByFirstName(String name);
}
repository.searchByFirstName(”James”)
.forEach(searchHit -> {
List<String> highlights =
searchHit.getHighlightField("firstName");
// ...
});

Lifecycle events
@Component
public class PersonBeforeConvertCallback implements
BeforeConvertCallback<Person> {
@Override
public Person onBeforeConvert(Person person,
IndexCoordinates indexCoordinates) {
if (person.getId() == null) {
person.setId(UUID.randomUUID().toString());
}
return person;
}
}

Auditable Entity
public class Person implements Persistable<String> {
@Id private String id;
@CreatedDate @Field(type = FieldType.Date, format =
DateFormat.basic_date_time)
private Instant created;
@CreatedBy
private String createdBy;
@Override
public boolean isNew() {
return id == null || (createdBy == null && created == null);
}
}

We need contributors!
Spring Data Elasticsearch is a
community-driven project

50
Thank You!
https://spring.io/projects/spring-data-elasticsearch
https://github.com/spring-projects/spring-data-elasticsearch
@sothawo
pj.meisch@sothawo.com

Next-level integration with Spring Data Elasticsearch

More Related Content

What's hot (18)

Similar to Next-level integration with Spring Data Elasticsearch (20)

More from Elasticsearch (20)

Recently uploaded (20)

Next-level integration with Spring Data Elasticsearch