> For the complete documentation index, see [llms.txt](https://programmingfundamental.gitbook.io/programmingwithjava/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://programmingfundamental.gitbook.io/programmingwithjava/internet-tekhnologii-2023/laboratorno-uprazhnenie-9-10/repository-sloi.md). # Repository слой Обикновено се реализират приложения за управление на данни, в които е необходимо да се съхраняват, редактират и изтриват данни. За тях е необходимо да внедрите CRUD операции (Create, Read, Update, Delete) за отделните обекти. Вместо да разписвате едни и същи CRUD операции отново и отново, Spring Data предоставя различни абстракции като CrudRepository, PagingAndSortingRepository и JpaRepository. Те предоставят готова поддръжка за CRUD операции, страниране и сортиране. Необходио е да създадем интерфейс, разширяващ JpaRepository: ```java public interface CityRepository extends JpaRepository { } ``` С това се постигат две цели: · Първо, чрез разширяване на JpaRepository ние получаваме набор от общи CRUD методи за нашия тип, който позволява запазване на градове, изтриването им и т.н., без да се налага да разписваме тяхната имплементация · Второ, с помощта на инфраструктурата на хранилището на Spring Data JPA този интерфейс автоматично ще бъде сканиран. Някои предоставяни общи методи: ```java //Съхранява в БД подадения обект S save(S entity); //Връща обекта по подаден id Optional findById(ID id); //Връща всички обекти от дадения тип List findAll(); //Изтрива зададения обект void delete(T entity); ``` Посочените методи се достъпват директно в обслужващия слой: ```java @Override public City createCity(City city) { City newCity = cityRepository.save(city); return newCity; } ``` ## Query методи Query методите са мощен инструмент за взаимодействие със записите от базата от данни, без да се налага да пишем SQL заявки. Зад кулисите, въз основа на метода на заявката, Spring Data JPA ще създаде SQL заявка и ще я изпълни вместо нас. Извиканата заявка се извлича от името на метода. Пример: ```java public interface UserRepository extends JpaRepository { List findByEmailAddressAndLastname(String emailAddress, String lastname); } ``` Spring Data JPA превежда името на метода в следната JPQL заявка: **select u from User u where u.emailAddress = ?1 and u.lastname = ?2** ### Правила за създаване на Query методи 1. Името да метода трябва да започва с един от посочените префикси: find…By, read…By, query…By, count…By, get…By и др. Примери: findByName, readByName, queryByName, getByName 2. Ако искаме да ограничим броя на върнатите резултати, можем да добавим ключовите думи First или Top преди By. Примери: findFirstByName, readFirst2ByName, findTop10ByName 3. Ако искаме да изберем уникални резултати, добавяме ключова дума Distinct преди By. Примери: findDistinctByName или findNameDistinctBy 4. Комбинирайте изрази с AND или OR. Примери: findByNameOrDescription, findByNameAndDescription [Списък на поддържаните ключови думи](https://docs.spring.io/spring-data/jpa/docs/3.0.x/reference/html/#repository-query-keywords). Още примерни методи: ```java Optional findById(Long id); List findByAgeAndHeight(Integer age, Double height); Integer countByName(String name); Dog findFirstByName(String name); List findTop10ByColor(String color); Dog findTopByOrderByBirthDateDesc(); List findByAgeLessThanOrHeightGreaterThan(Integer age, double height); ``` ### @Query анотация Използвайки Query методите при по-сложни заявки, можем да достигнем ситуация, при която методът ни да има следния вид: findAllByPostAndStatusAndReviewLikeAndVotesGreaterThanEqualOrderByCreatedOn Освен объркващия външен вид, подадена по този начин заявката ще бъде по-бавна за изпълнение. За разрешаване на този проблем можем да използваме анотацията @Query. Примери: 
@Query("SELECT t FROM Tutorial t")
List<Tutorial> findAll();

@Query("SELECT u FROM User u WHERE u.emailAddress = ?1")
User findByEmailAddress(String emailAddress);

@Query("SELECT * FROM tutorials t WHERE t.title LIKE %?1%")
List<Tutorial> findByTitleAndSort(String title, Sort sort);

@Query("SELECT MAX(eventId) AS eventId FROM Event")
Long lastProcessedEvent();

@Query("SELECT t FROM Tutorial t 
WHERE t.published=:isPublished AND t.level BETWEEN :start AND :end")
List<Tutorial> findByLevelBetween(
		@Param("start") int start, 
                @Param("end") int end, 
                @Param("isPublished") boolean isPublished
                );
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://programmingfundamental.gitbook.io/programmingwithjava/internet-tekhnologii-2023/laboratorno-uprazhnenie-9-10/repository-sloi.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.