게시판 등록/검색

[1J-Choi]

마크업

• 게시판 등록 화면 마크업
• 게시판 검색 화면 마크업
• 게시판 출력 목록 페이지 기능 마크업

구현

• 게시판 등록 기능 구현
• 게시판 검색 기능 구현
• 게시판 출력 목록의 페이지 기능 구현

[1J-Choi]

복합키를 사용하는 table의 JPA 사용

게시판 생성이 진행 될 때
생성을 한 사용자가 메인 어드민이라는 정보가
저장되는 과정이 필요하였다.

이때 각 게시판의 어드민에 대한 정보를
가진 admin 테이블의 구조가 단순하였기 때문에
JPA를 사용하여 기능을 구현하려 하였다.

그러나 admin의 경우
게시판 아이디 boardId와 유저 아이디 userId를
복합키로 가진 형태였기 때문에
기존의 하나의 Id값을 가진 테이블과 같이 만들 수 없었다.

이를 해결할 수 있는 방법으로는
복합키를 하나의 객체로 선언한 뒤
이 객체 안에 복합키 들의 값을 넣는 것이였다.

우선 admin entity를 만들기 앞서
아래와 같이 복합키 들의 값을 가진
AdminId 객체를 생성하였다.

import java.io.Serializable;

import jakarta.persistence.Column;
import jakarta.persistence.Embeddable;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;

@Embeddable
@AllArgsConstructor
@NoArgsConstructor
@EqualsAndHashCode
@Data
public class AdminId implements Serializable {
	@Column(name = "boardId")
	private int boardId;
	
	@Column(name = "userId")
	private int userId;
}

그 후 entity를 만들 때
복합키들이 들어갈 자리에 AdminId 객체를 넣고
EmbeddedId 어노테이션을 붙였다.

public class AdminEntity {
	
	@EmbeddedId
	private AdminId adminId;
	
	@Column(name = "adminType")
	private boolean adminType;
	
	@Column(name = "createdAt")
	@CreationTimestamp
	private LocalDateTime createdAt;
}

마지막으로 해당 entity를 사용할 repository에서
상속받는 JpaRepository에서 사용할 키 값을 AdminId로 설정하였다.

public interface AdminRepository extends JpaRepository<AdminEntity, AdminId>{

}

[1J-Choi]

게시판 검색창의 페이징 구현

본래 Pagable을 사용한
페이징 구현을 진행할 예정이였지만
조사한 자료들이 JPA가 기준인 경우가 많아
Mybatis를 사용한 board에 적용하는 데 어려움이 있었고

Mybatis를 사용한 방식들도
짧은 시간 내에 이해하는 것에 어려움을 느껴
직접 페이징을 하는 방법을 선택하였다.

1. Controller

우선 컨트롤러에서 Requestparam으로
검색어인 name과 현재 페이지인 page를 받는다
name을 파라미터로 받지 않는 경우(맨 처음 게시판 검색 화면에 들어왔을 때)
name 대신해 String ""을 name이 들어갈 자리에 넣어줬으며
page의 defaultValue를 1로 설정해 BO로 넘겨준다.

위 과정을 통해 정해진 양의 BoardDTO가 담긴 List가 넘어오면
name을 바탕으로 해당 검색어를 이름에 포함하는 board의 갯수 totalCount를 가져오고
이를 사전에 정해둔 페이지당 출력 갯수인 10으로 나눈 뒤 올림한다.

마지막으로 아래 코드와 같이 각각의 정보들을
model로 올려주도록 하였다.

@GetMapping("/search")
public String searchBoard(
		@RequestParam("name") String name, 
		@RequestParam(value = "page", defaultValue = "1") int page, 
		Model model) {
	List<SearchBoardDTO> searchBoards = boardBO.getSearchBoards(name, page);
	int totalCount = boardBO.count(name);
	int totalPages = (int) Math.ceil((double) totalCount / 10);
	
	model.addAttribute("searchBoards", searchBoards);
	model.addAttribute("name", name);
	model.addAttribute("page", page);
	model.addAttribute("totalPages", totalPages);
	return "board/searchBoard";
}

2. BO

BO에서는 검색어 name과 현재 페이지 번호인 page를 바탕으로
offset을 통해 board들의 한 페이지를 가져오는 메소드와
검색어 name을 바탕으로 board의 갯수를 새는 메소드가 있다.

전자의 경우
받아온 page를 바탕으로 offset 값을 계산하여 보내주었다.

private static final int PAGE_SIZE = 10;

public List<SearchBoardDTO> getSearchBoards(String name, int page) {
	List<SearchBoardDTO> searchBoardDTOs = new ArrayList<>();
	int offset = (page - 1) * PAGE_SIZE;
	List<Board> searchBoard = boardMapper.selectBoardList(name, PAGE_SIZE, offset);

	// 검색된 searchBoard를 바탕으로 searchBoardDTOs를 세팅하는 과정은 생략한다

	return searchBoardDTOs;
}
	
public int count(String name) {
       return boardMapper.countBoards(name);
}

3. Mapper

위의 BO에서 받아온 값들을 바탕으로
아래와 같이 각각
offset 부터의 pageSize 갯수 게시판 이름에 name이 포함된 board들의 List와
게시판 이름에 name이 포함된 board의 갯수를 받아오는 sql를 작성하였다.

public List<Board> selectBoardList(
		@Param("name") String name, 
		@Param("pageSize") int pageSize, 
		@Param("offset") int offset);
public int countBoards(String name);

<select id="selectBoardList" 
	parameterType="map" 
	resultType="com.markepost.board.domain.Board">
	SELECT
		`id`
		, `name`
		, `introduce`
		, `imagePath`
		, `createdAt`
		, `updatedAt`
	FROM
		`board`
	WHERE
		`name` LIKE '%${name}%'
	LIMIT #{pageSize}
	OFFSET #{offset}
</select>
<select id="countBoards" 
	parameterType = "string"
	resultType="int">
	SELECT
		COUNT(*)
	FROM
		`board`
	WHERE
		`name` LIKE '%${name}%'
</select>

4. 이후 계획

이후에도 페이징 기능은
게시글과 신고 목록 출력에도 사용될 예정이기에
Page 객체를 따로 만들어 코드의 재활용성을 올릴 수 있도록 설계해볼 예정이다.

또한 검색에 사용되는 속성들에
MySQL의 Full-Text Index를 적용하여
검색 속도를 향상시켜보려 한다