對(duì)標(biāo)蘋(píng)果的靈動(dòng)島 華為帶來(lái)實(shí)況窗功能
繼蘋(píng)果的靈動(dòng)島之后，華為也在今天正式推出了“實(shí)況窗”功能。據(jù)今天鴻蒙OS 4.0的現(xiàn)場(chǎng)演示顯示，華為的實(shí)況窗可以更高效的展現(xiàn)出實(shí)時(shí)通知，比如鎖屏上就能看到外賣、打車、銀行
在現(xiàn)代軟件開(kāi)發(fā)中，Spring Boot已成為構(gòu)建穩(wěn)健和可擴(kuò)展應(yīng)用程序的主要框架。當(dāng)涉及到與數(shù)據(jù)庫(kù)的交互時(shí)，Java持久化API（JPA）提供了一種方便高效的方式來(lái)管理關(guān)系型數(shù)據(jù)。為了確保Spring Boot應(yīng)用程序的可維護(hù)性、可讀性和可擴(kuò)展性，在創(chuàng)建使用JPA進(jìn)行數(shù)據(jù)訪問(wèn)的Repository接口時(shí)，遵循最佳實(shí)踐至關(guān)重要。
遵循Spring Data的Repository接口命名慣例。命名慣例應(yīng)為EntityNameRepository或
EntityNameRepositoryCustom（用于自定義Repository方法）。
public interface UserRepository extends JpaRepository<User, Long> { // 此處可以自定義方法}在軟件工程中，關(guān)注點(diǎn)分離是一個(gè)核心原則，強(qiáng)調(diào)每個(gè)組件應(yīng)具有明確定義的責(zé)任。在Spring Boot應(yīng)用程序的上下文中，使用領(lǐng)域特定的存儲(chǔ)庫(kù)接口與該原則一致，允許在不同實(shí)體類型及其相應(yīng)數(shù)據(jù)訪問(wèn)操作之間保持清晰的區(qū)分。
好處
考慮一個(gè)示例，有一個(gè)電子商務(wù)應(yīng)用程序，其中有兩個(gè)主要實(shí)體：產(chǎn)品和分類。通過(guò)使用領(lǐng)域特定的Repository接口，我們可以將每個(gè)實(shí)體的數(shù)據(jù)訪問(wèn)邏輯保持分離并組織良好。
public interface ProductRepository extends JpaRepository<Product, Long> { List<Product> findByCategory(Category category);}在此示例中，該P(yáng)roductRepository接口包括一個(gè)查詢方法findByCategory，該方法根據(jù)產(chǎn)品的關(guān)聯(lián)類別來(lái)檢索產(chǎn)品。
類似地，該CategoryRepository接口可以只關(guān)注與類別相關(guān)的數(shù)據(jù)訪問(wèn)操作。
public interface CategoryRepository extends JpaRepository<Category, Long> { Category findByName(String name);}通過(guò)利用領(lǐng)域特定的Repository接口，我們可以創(chuàng)建一個(gè)更有組織且易于理解的數(shù)據(jù)訪問(wèn)層，該層與應(yīng)用程序的實(shí)體結(jié)構(gòu)保持一致。這種關(guān)注點(diǎn)分離不僅提高了代碼質(zhì)量，而且隨著應(yīng)用程序隨著時(shí)間的推移而發(fā)展，也有利于維護(hù)和擴(kuò)展。
Spring Data JPA 提供了一種遵循命名約定來(lái)定義Repository方法的便捷方法，稱為“查詢方法”。這種方法通過(guò)方法名稱表達(dá)查詢，從而無(wú)需為常見(jiàn)操作編寫(xiě)顯式 SQL 或 JPQL 查詢。利用查詢方法可以增強(qiáng)代碼庫(kù)的可讀性和可維護(hù)性。
查詢方法的命名約定基于實(shí)體的屬性名稱。通過(guò)將findBy、getBy、readBy或 queryBy等前綴與屬性名稱組合，可以創(chuàng)建有意義的查詢方法。
@Entitypublic class Book { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String title; private String author; private int publicationYear; private String genre; // Getters and setters}public interface BookRepository extends JpaRepository<Book, Long> { List<Book> findByAuthorAndPublicationYearAndGenre(String author, int publicationYear, String genre);}也可以通過(guò)向查詢方法添加可選參數(shù)來(lái)進(jìn)一步擴(kuò)展。比如需要按作者和流派搜索書(shū)籍，而不指定出版年份：
public interface BookRepository extends JpaRepository<Book, Long> { List<Book> findByAuthorAndGenreAndPublicationYear(String author, String genre, int publicationYear); List<Book> findByAuthorAndGenre(String author, String genre);}Spring Data JPA 根據(jù)方法名稱和參數(shù)名稱自動(dòng)生成相應(yīng)的 SQL 查詢，使復(fù)雜的查詢場(chǎng)景變得更加容易，而無(wú)需編寫(xiě)原生 SQL 查詢。
雖然查詢方法提供了一種強(qiáng)大的機(jī)制，可以根據(jù)命名約定從方法名稱生成查詢，但在某些情況下需要更復(fù)雜的查詢。對(duì)于這些場(chǎng)景，Spring Data JPA 可以使用@Query注解定義自己的自定義查詢方法。
@Query注解能夠直接在Repository接口中定義 JPQL（Java 持久性查詢語(yǔ)言）或原生 SQL 查詢。這種方法可以更加靈活地構(gòu)建涉及多個(gè)實(shí)體、復(fù)雜聯(lián)接或其他非標(biāo)準(zhǔn)操作的查詢。
public interface UserRepository extends JpaRepository<User, Long> { @Query("SELECT u FROM User u WHERE CONCAT(u.firstName, ' ', u.lastName) LIKE %:keyword%") List<User> findUsersByFullNameKeyword(@Param("keyword") String keyword);}在使用 JPQL 還無(wú)法實(shí)現(xiàn)的特定于數(shù)據(jù)庫(kù)的功能時(shí)，還可以使用原生 SQL 查詢。以下是自定義原生 SQL 查詢方法的示例：
public interface ProductRepository extends JpaRepository<Product, Long> { @Query(value = "SELECT * FROM products p WHERE p.price > :minPrice", nativeQuery = true) List<Product> findProductsAboveMinPrice(@Param("minPrice") BigDecimal minPrice);}在此示例中，@Query 注解使用 nativeQuery = true來(lái)表示查詢是用原生 SQL 編寫(xiě)的。該查詢的意圖是檢索價(jià)格高于指定最低價(jià)格的產(chǎn)品。
自定義查詢方法有幾個(gè)好處：
使用原生 SQL 查詢時(shí)必須謹(jǐn)慎，因?yàn)槿绻幚聿划?dāng)，可能會(huì)導(dǎo)致特定于數(shù)據(jù)庫(kù)的代碼和潛在的安全漏洞（例如 SQL 注入）。
通過(guò)使用自定義查詢方法，我們可以在查詢方法命名約定的便利性和處理更復(fù)雜或?qū)ｉT的數(shù)據(jù)檢索場(chǎng)景的靈活性之間取得平衡。
在Repository層中分離關(guān)注點(diǎn)是一個(gè)好習(xí)慣，這意味著需要將標(biāo)準(zhǔn) Spring Data JPA 方法與自定義方法分開(kāi)。這種分離增強(qiáng)了代碼組織、可讀性和可維護(hù)性，并促進(jìn)了單一職責(zé)原則。
首先創(chuàng)建一個(gè)自定義Repository接口來(lái)保存專用方法。該接口不應(yīng)直接擴(kuò)展JpaRepository，因?yàn)檫@會(huì)導(dǎo)致自定義方法與標(biāo)準(zhǔn)方法混雜在一起。
public interface UserRepositoryCustom { List<User> findActiveUsers();}接下來(lái)，為自定義Repository接口創(chuàng)建一個(gè)實(shí)現(xiàn)類。實(shí)現(xiàn)類遵循命名規(guī)范<EntityName>RepositoryImpl，并且應(yīng)該放置在與Repository接口相同的包中。
@Repositorypublic class UserRepositoryImpl implements UserRepositoryCustom { @PersistenceContext private EntityManager entityManager; @Override public List<User> findActiveUsers() { TypedQuery<User> query = entityManager.createQuery("SELECT u FROM User u WHERE u.active = true", User.class); return query.getResultList(); }}最后，通過(guò)擴(kuò)展標(biāo)準(zhǔn) Spring Data JPA Repository接口 ( JpaRepository) 和自定義Repository接口 ( UserRepositoryCustom) 來(lái)創(chuàng)建主Repository接口。
public interface UserRepository extends JpaRepository<User, Long>, UserRepositoryCustom { // Spring Data JPA 方法與自定義方法}通過(guò)遵循這種方法，我們可以在 Spring Data JPA 提供的常見(jiàn) CRUD 操作與自定義專用方法之間保持清晰的分離。使代碼更加模塊化且更易于理解。
在處理大型數(shù)據(jù)集時(shí)，高效的分頁(yè)和排序機(jī)制對(duì)于提供流暢的用戶體驗(yàn)和優(yōu)化查詢性能至關(guān)重要。
分頁(yè)涉及將結(jié)果集劃分為較小的頁(yè)面，以避免一次獲取所有數(shù)據(jù)。Spring Data JPA 的Pageable接口提供了一種定義分頁(yè)參數(shù)的方法，包括所需的頁(yè)碼、每頁(yè)的條目數(shù)（頁(yè)面大小）和排序方式。
public interface ProductRepository extends JpaRepository<Product, Long> { Page<Product> findByCategory(Category category, Pageable pageable);}在此示例中，該方法findByCategory返回一個(gè)Page<Product>.
排序可以根據(jù)一個(gè)或多個(gè)字段以特定順序排列查詢結(jié)果。Spring Data JPA 的Sort類能夠?yàn)镽epository方法指定排序方式。
public interface ProductRepository extends JpaRepository<Product, Long> { List<Product> findByCategoryOrderByPriceAsc(Category category);}在此示例中，findByCategoryOrderByPriceAsc方法根據(jù)給定類別檢索產(chǎn)品，并按價(jià)格升序，后綴OrderByPriceAsc表示排序順序。
可以結(jié)合分頁(yè)和排序來(lái)按特定順序檢索分頁(yè)結(jié)果。例如：
public interface ProductRepository extends JpaRepository<Product, Long> { Page<Product> findByCategoryOrderByPriceAsc(Category category, Pageable pageable);}通過(guò)提供Pageable參數(shù)，可以指定頁(yè)碼、頁(yè)面大小和排序標(biāo)準(zhǔn)。Spring Data JPA 負(fù)責(zé)生成適當(dāng)?shù)牟樵儊?lái)獲取請(qǐng)求的數(shù)據(jù)。
@Servicepublic class ProductService { @Autowired private ProductRepository productRepository; public Page<Product> getProductsByCategoryWithPaginationAndSorting(Category category, int pageNumber, int pageSize) { // 創(chuàng)建 Pageable 對(duì)象來(lái)進(jìn)行分頁(yè)和排序 Pageable pageable = PageRequest.of(pageNumber, pageSize, Sort.by(Sort.Direction.ASC, "price")); return productRepository.findByCategoryOrderByPriceAsc(category, pageable); }}最后，我們可以在 Controller 中使用Service方法來(lái)檢索分頁(yè)和排序的結(jié)果，如下所示：
@RestController@RequestMapping("/products")public class ProductController { @Autowired private ProductService productService; @GetMapping public ResponseEntity<Page<Product>> getProductsByCategory( @RequestParam("category") Long categoryId, @RequestParam("page") int pageNumber, @RequestParam("size") int pageSize) { Category category = new Category(); category.setId(categoryId); Page<Product> products = productService.getProductsByCategoryWithPaginationAndSorting(category, pageNumber, pageSize); return ResponseEntity.ok(products); }}在設(shè)計(jì)和實(shí)現(xiàn)Repository方法時(shí)，特別是那些修改數(shù)據(jù)的方法時(shí)，遵循冪等原則非常重要，以確保多次調(diào)用具有相同參數(shù)的相同方法不會(huì)導(dǎo)致意外行為。
例如，在電子商務(wù)應(yīng)用程序中，如果多次下具有相同詳細(xì)信息的訂單，則應(yīng)該產(chǎn)生相同的結(jié)果，并且不會(huì)創(chuàng)建多個(gè)重復(fù)訂單。
修改數(shù)據(jù)時(shí)，使用事務(wù)操作是一個(gè)很好的做法。Spring Data JPA 提供開(kāi)箱即用的事務(wù)管理。使用事務(wù)確保操作期間發(fā)生錯(cuò)誤，則回滾更改，從而保持?jǐn)?shù)據(jù)的完整性。
@Servicepublic class OrderService { @Autowired private OrderRepository orderRepository; @Transactional public void placeOrder(User user, Product product) { // 檢查訂單是否已存在 Order existingOrder = orderRepository.findByUserAndProduct(user, product); if (existingOrder == null) { // 創(chuàng)建一個(gè)新訂單 Order newOrder = new Order(); newOrder.setUser(user); newOrder.setProduct(product); newOrder.setOrderDate(LocalDateTime.now()); orderRepository.save(newOrder); } else { // 如果訂單已存在，在不需要操作 } }}對(duì)于某些操作，我們可能需要實(shí)施冪等性檢查。意味著在執(zhí)行某個(gè)操作之前，需要檢查該操作是否已經(jīng)執(zhí)行過(guò)，以防止多余的操作。
@Servicepublic class OrderService { @Autowired private OrderRepository orderRepository; @Transactional public void processOrder(Long orderId) { Order order = orderRepository.findById(orderId).orElse(null); if (order != null && !order.isProcessed()) { // 執(zhí)行處理邏輯 order.setProcessed(true); } }}在此示例中，processOrder方法檢查訂單是否已被處理，以防止多次處理同一訂單。
通過(guò)遵循這些實(shí)踐，可以確保Repository方法保持冪等性。這不僅可以防止意外的副作用，還可以使應(yīng)用程序更加健壯和可預(yù)測(cè)，特別是在處理意外錯(cuò)誤或故障時(shí)。
為Repository接口編寫(xiě)單元測(cè)試對(duì)于確保其正確性至關(guān)重要。使用JUnit和Mockito等工具來(lái)模擬數(shù)據(jù)庫(kù)交互并驗(yàn)證Repository方法是否按預(yù)期運(yùn)行。
// User.java@Entitypublic class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String username; private String email; // getters and setters}// UserRepository.javapublic interface UserRepository extends JpaRepository<User, Long> { User findByUsername(String username);}import static org.junit.jupiter.api.Assertions.assertEquals;import static org.mockito.Mockito.when;@RunWith(MockitoJUnitRunner.class)public class UserRepositoryTest { @InjectMocks private UserService userService; @Mock private UserRepository userRepository; @Test public void testFindByUsername() { // Arrange String username = "zhangsan"; User user = new User(); user.setId(1L); user.setUsername(username); user.setEmail("zhangsan@example.com"); when(userRepository.findByUsername(username)).thenReturn(user); // Act User foundUser = userService.findByUsername(username); // Assert assertEquals(username, foundUser.getUsername()); }}@DataJpaTest是一個(gè)專門用于JPA測(cè)試的 Spring Boot 注解。當(dāng)使用 @DataJpaTest 時(shí)，Spring Boot 會(huì)設(shè)置一個(gè)最小的 Spring 應(yīng)用程序上下文，其中僅包含 JPA 測(cè)試所需的組件。這樣測(cè)試就可以訪問(wèn)已配置的內(nèi)存數(shù)據(jù)庫(kù)，并且 Spring 將自動(dòng)配置和管理 EntityManager 和Repository，這樣可以以更集成的方式進(jìn)行測(cè)試。
@DataJpaTestpublic class UserRepositoryTest { @Autowired private TestEntityManager entityManager; @Autowired private UserRepository userRepository; @Test public void testFindByUsername() { // Arrange String username = "zhangsan"; User user = new User(); user.setUsername(username); user.setEmail("zhangsan@example.com"); entityManager.persist(user); // Act User foundUser = userRepository.findByUsername(username); // Assert assertEquals(username, foundUser.getUsername()); }}使用@DataJpaTest優(yōu)點(diǎn)：
在進(jìn)行數(shù)據(jù)訪問(wèn)操作時(shí)，可能會(huì)發(fā)生異常，例如數(shù)據(jù)庫(kù)連接問(wèn)題、約束違規(guī)和數(shù)據(jù)完整性問(wèn)題。Spring Data JPA 通過(guò)自動(dòng)將 JPA 特定的異常轉(zhuǎn)換為 Spring 的DataAccessException來(lái)簡(jiǎn)化錯(cuò)誤處理，這樣就可以在整個(gè)應(yīng)用程序中以一致的方式處理異常。
考慮一個(gè)示例，嘗試將重復(fù)的用戶名插入數(shù)據(jù)庫(kù)，這時(shí)會(huì)發(fā)生唯一約束沖突。
@Entitypublic class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; @Column(unique = true) private String username; private String email; // getters and setters}public interface UserRepository extends JpaRepository<User, Long> { User findByUsername(String username);}在這種情況下，如果嘗試插入具有重復(fù)用戶名的新用戶名，則會(huì)拋出ConstraintViolationException異常。
@Servicepublic class UserService { @Autowired private UserRepository userRepository; public User createUser(User user) { try { return userRepository.save(user); } catch (DataAccessException ex) { // 處理異常 throw new CustomDataAccessException("An error occurred while saving the user.", ex); } }}在UserService中，我們使用一個(gè)try-catch塊來(lái)捕獲DataAccessException。Spring Data JPA 自動(dòng)將底層 JPA 異常轉(zhuǎn)換為更通用的DataAccessException. 然后，我們可以根據(jù)應(yīng)用程序的要求處理此異常。
為了使錯(cuò)誤處理的信息更豐富，我們可以創(chuàng)建擴(kuò)展 SpringDataAccessException或其子類的自定義異常類。例如：
public class CustomDataAccessException extends DataAccessException { public CustomDataAccessException(String msg, Throwable cause) { super(msg, cause); }}接下來(lái)，在Controller中處理異常：
@RestController@RequestMapping("/users")public class UserController { @Autowired private UserService userService; @PostMapping public ResponseEntity<?> createUser(@RequestBody User user) { try { User createdUser = userService.createUser(user); return ResponseEntity.status(HttpStatus.CREATED).body(createdUser); } catch (CustomDataAccessException ex) { return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(ex.getMessage()); } }}在 Spring Boot 應(yīng)用程序中使用 JPA 創(chuàng)建Repository接口時(shí)遵循最佳實(shí)踐對(duì)于實(shí)現(xiàn)可維護(hù)、可擴(kuò)展和有組織的代碼至關(guān)重要。通過(guò)遵循最佳實(shí)踐，開(kāi)發(fā)人員可以構(gòu)建強(qiáng)大的數(shù)據(jù)訪問(wèn)層，與更廣泛的應(yīng)用程序架構(gòu)無(wú)縫集成。這種方法促進(jìn)了模塊化，增強(qiáng)了可測(cè)試性，確保了明確的職責(zé)分離，并最終有助于開(kāi)發(fā)高質(zhì)量的 Spring Boot 應(yīng)用程序。
本文鏈接：http://www.tebozhan.com/showinfo-26-12271-0.html分享Spring Data JPA的一些技巧和優(yōu)秀實(shí)踐
聲明：本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí)，若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系，我們將在第一時(shí)間刪除處理。郵件：2376512515@qq.com
Copyright ? 2016-2023 天津谷騏科技有限公司 版權(quán)所有 sitemap.xml
違法及侵權(quán)請(qǐng)聯(lián)系：2376512515@qq.com 津ICP備18001702號(hào)
津公網(wǎng)安備 12010102000574號(hào)