{"componentChunkName":"component---src-templates-blog-post-js","path":"/springboot/스프링-부트-API-인터페이스-및-결과-데이터-구조-설계/","result":{"data":{"site":{"siteMetadata":{"title":"Bottlehs Tech Blog","description":"웹·앱·AI 개발자 전병훈(bottlehs)의 기술 블로그. AI·LLM, JavaScript·Vue, Spring Boot, 알고리즘, 블록체인 실무 가이드를 다룹니다","siteUrl":"https://www.bottlehs.dev","author":{"name":"Jeon Byung Hun","summary":"개발을 즐기는 bottlehs - Engineer, MS, AI, FE, BE, OS, IOT, Blockchain, 설계, 테스트"},"social":{"github":"bottlehs","codepen":"bottlehs"}}},"markdownRemark":{"id":"1d265aed-cb89-52b1-bde2-48c14a1107ce","excerpt":"스프링 부트 API 인터페이스 및 결과 데이터 구조 설계 API 서버 개발 진행을 위해 api 인터페이스 및 결과 데이터의 구조를 살펴보고 확장 가능한 형태로 설계해 보자. api는 제공 대상이 클라이언트 App 또는 Web 개발자이다. 한번 배포되고 공유한 API…","html":"

\"스프링

\n

API 서버 개발 진행을 위해 api 인터페이스 및 결과 데이터의 구조를 살펴보고 확장 가능한 형태로 설계해 보자. api는 제공 대상이 클라이언트 App 또는 Web 개발자이다. 한번 배포되고 공유한 API는 구조를 쉽게 바꿀 수 없기 때문에, 처음부터 효율적이고 확장 가능한 형태로 모델을 설계하고 시작하는 것이 좋다. 그래서 아래와 같이 HttpMethod를 사용하고 Restful 한 API를 만들기 위해 몇 가지 규칙을 적용하도록 하겠다.

\n

API 인터페이스

\n

리소스의 사용목적에 따라 Http method 구분

\n

Http 프로토콜은 여러 가지 사용목적에 따라 HttpMethod를 제공하고 있다. 여기서는 그중 아래의 5가지 HttpMethod를 상황에 맞게 api 구현에 사용하도록 하겠다.

\n\n

리소스에 Mapping된 주소 체계 정형화

\n

주소 체계는 아래처럼 정형화된 구조로 구성하고 HttpMethod를 통해 리소스의 사용목적을 판단되도록 한다.

\n\n

결과 데이터 구조 표준화

\n

결과 데이터는 아래의 샘플처럼 결과 데이터 + api요청 결과 데이터로 구성한다.

\n

결과 모델의 정의

\n
// 기존 USER 정보\n{\n  \"email\": \"id@domain.com\",\n  \"name\": \"user name\"\n}
\n
// 표준화한 USER 정보\n{\n  \"data\": {\n    \"email\": \"id@doamin.com\",\n    \"name\": \"user name\"\n  },\n  \"success\": true,\n  \"code\": 0,\n  \"message\": \"성공하였습니다.\"\n}
\n

구현

\n

api의 실행 결과를 담는 공통 모델

\n

api의 처리 상태 및 메시지를 내려주는 데이터로 구성된다. success는 api의 성공실패 여부를 나타내고 code, msg는 해당 상황에서의 응답 코드와 응답 메시지를 나타낸다.

\n
@Getter\n@MappedSuperclass\n@EntityListeners(AuditingEntityListener.class)\npublic class BaseEntity implements Serializable {\n  private static final long serialVersionUID = 9141498463876264960L;\n\n  @CreationTimestamp\n  @Temporal(TemporalType.TIMESTAMP)\n  @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = \"yyyy-MM-dd HH:mm:ss\",\n      timezone = \"Asia/Seoul\")\n  @Column(name = \"reg_dt\", updatable = false)\n  private Date reg_dt;\n\n  @UpdateTimestamp\n  @Temporal(TemporalType.TIMESTAMP)\n  @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = \"yyyy-MM-dd HH:mm:ss\",\n      timezone = \"Asia/Seoul\")\n  @Column(name = \"mod_dt\", updatable = true)\n  private Date mod_dt;\n\n  // 변환 로직을 직접 구현\n\n  public Date getRegDt() {\n    return reg_dt;\n  }\n\n  public void setRegDt(Date reg_dt) {\n    this.reg_dt = reg_dt;\n  }\n\n  public Date getModDt() {\n    return mod_dt;\n  }\n\n  public void setModDt(Date mod_dt) {\n    this.mod_dt = mod_dt;\n  }\n}
\n

결과가 단일건인 api를 담는 모델

\n

Generic Interface에 를 지정하여 어떤 형태의 값도 넣을 수 있도록 구현합니다. 또한 CommonResult를 상속받으므로 api요청 결과도 같이 출력되도록 합니다.

\n
@RestController\n@Api(tags = \"공지사항\")\n@RequestMapping(value = \"/api\")\npublic class NoticeController {\n  ..code\n  @ManyToMany(fetch = FetchType.LAZY)\n  @ApiOperation(value = \"조회-단건\", notes = \"단건 조회\", tags = \"공지사항\")\n  @GetMapping(value = \"/notice/{id}\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public Notice get(@PathVariable Integer id) {\n    return noticeService.getId(id);\n  }\n  ..code\n}
\n

결과가 여러건인 api를 담는 모델

\n

api 결과가 다중 건인 경우에 대한 데이터 모델이다. 결과 필드를 List 형태로 선언하고 Generic Interface에 를 지정하여 어떤 형태의 List값도 넣을 수 있도록 구현합니다. 또한 CommonResult를 상속받으므로 api요청 결과도 같이 출력되도록 합니다.

\n
@RestController\n@Api(tags = \"공지사항\")\n@RequestMapping(value = \"/api\")\npublic class NoticeController {\n  ..code\n  @ManyToMany(fetch = FetchType.LAZY)\n  @ApiOperation(value = \"조회\", notes = \"전체 조회\", tags = \"공지사항\")\n  @GetMapping(value = \"/notice\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public List<Notice> getAll() {\n    return noticeService.getAll();\n  }\n  ..code\n}
\n

결과 모델을 처리할 Service 정의

\n

결과 모델에 데이터를 넣어주는 역할을 할 Service를 정의합니다. api.service 하위에 service package를 생성하고 아래의 Service Class를 생성합니다.

\n
public interface NoticeService {\n  ..code\n  // 조회\n  List<Notice> getAll();\n\n  // 조회-단건\n  Notice getId(Integer id);\n  ..code\n}
\n
@Service\npublic class NoticeServiceImpl implements NoticeService {\n  ..code\n  // 조회\n  @Override\n  public List<Notice> getAll() {\n    return noticeRepository.findAll();\n  }\n\n  // 조회-단건\n  @Override\n  public Notice getId(Integer id) {\n    return noticeRepository.getOne(id);\n  }\n  ..code\n}
\n

HttpMethod와 정형화된 주소체계를 Controller에 정의

\n

소스의 사용 목적에 따라 GetMapping, PostMapping, PutMapping, DeleteMapping, FetchMapping 사용

\n
@RestController\n@Api(tags = \"공지사항\")\n@RequestMapping(value = \"/api\")\npublic class NoticeController {\n  private final NoticeService noticeService;\n\n  public NoticeController(NoticeService noticeService) {\n    this.noticeService = noticeService;\n  }\n\n  @ManyToMany(fetch = FetchType.LAZY)\n  @ApiOperation(value = \"조회\", notes = \"전체 조회\", tags = \"공지사항\")\n  @GetMapping(value = \"/notice\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public List<Notice> getAll() {\n    return noticeService.getAll();\n  }\n\n  @ManyToMany(fetch = FetchType.LAZY)\n  @ApiOperation(value = \"조회-단건\", notes = \"단건 조회\", tags = \"공지사항\")\n  @GetMapping(value = \"/notice/{id}\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public Notice get(@PathVariable Integer id) {\n    return noticeService.getId(id);\n  }\n\n  @ApiOperation(value = \"등록\", notes = \"등록\", tags = \"공지사항\")\n  @PostMapping(value = \"/notice\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public Notice add(@RequestBody Notice notice) {\n    return noticeService.add(notice.getTitle(), notice.getCont(), notice.getTp());\n  }\n\n  @ApiOperation(value = \"삭제\", notes = \"전체 삭제\", tags = \"공지사항\")\n  @DeleteMapping(value = \"/notice\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public void removeAll() {\n    noticeService.removeAll();\n  }\n\n  @ApiOperation(value = \"삭제-단건\", notes = \"단건 삭제\", tags = \"공지사항\")\n  @DeleteMapping(value = \"/notice/{id}\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public void remove(@PathVariable Integer id) {\n    noticeService.remove(id);\n  }\n\n  @ApiOperation(value = \"수정\", notes = \"단건 수정\", tags = \"공지사항\")\n  @PutMapping(value = \"/notice/{id}\")\n  @ResponseStatus(value = HttpStatus.OK)\n  public Notice modify(@PathVariable Integer id, @RequestBody Notice notice) {\n    return noticeService.modify(id, notice.getTitle(), notice.getCont(), notice.getTp());\n  }\n}
\n

api 서비스를 구축하기 위한 인터페이스 및 결과 구조 설계 방법 이다.

\n

자세한 소스 코드는 ”https://github.com/bottlehs/springboot-vue-starter-kit” 참고 하길 바란다.

","tableOfContents":"","wordCount":{"words":377},"fields":{"slug":"/springboot/스프링-부트-API-인터페이스-및-결과-데이터-구조-설계/","image":"/assets/springboot.png","faq":[]},"frontmatter":{"title":"스프링 부트 API 인터페이스 및 결과 데이터 구조 설계","date":"2021년 4월 8일","dateISO":"2021-04-08T20:29:29.537Z","updatedISO":null,"category":"springboot","description":"Http 프로토콜은 여러 가지 사용목적에 따라 GET, POST, PUT, DELETE, FETCH.. 등 HttpMethod를 제공하고 있다. 주소 체계는 정형화된 구조로 구성하고 HttpMethod를 통해 리소스의 사용목적을 판단되도록 해야 한다.","tags":["스프링","스프링부트","Spring","SpringBoot","Java","프레임워크","스프링부트구조","아키텍쳐"]}}},"pageContext":{"slug":"/springboot/스프링-부트-API-인터페이스-및-결과-데이터-구조-설계/","previous":{"fields":{"slug":"/vue/vue-js-vuex의-개념-및-구조의-이해/"},"frontmatter":{"title":"Vue Js Vuex의 개념 및 구조의 이해","tags":["vue","javascript","framework","frontend","web","router"]}},"next":{"fields":{"slug":"/springboot/스프링-부트-controller-advice를-활용한-exception-처리/"},"frontmatter":{"title":"스프링 부트 ControllerAdvice를 활용한 Exception 처리","tags":["스프링","스프링부트","Spring","SpringBoot","Java","프레임워크","스프링부트구조","아키텍쳐","ControllerAdvice"]}}}},"staticQueryHashes":["213619243","3262363727"]}