TIL (Today I LeTIL (Today I Learned) 2022.05.07 오늘 읽은 범위 2부 사용자를 위한 API 디자인하기 책에서 기억하고 싶은 내용 API는 무조건 사용자들의 목표를 달성하기 위해서 존재합니다. 올바른 입장, 올바른 관점을 선택하는 것이 인터페이스와 API를 디자인하는데 있어서 가장 중요합니다. 작업 방식(내부 동작 원리)에 집중하면 인터페이스가 복잡해진다. 사용자가 할 수 있는 일에 집중해 인터페이스를 단순하게 해라. API는 반드시 컨슈머의 관점에서 디자인되어야 합니다. 프로바이더의 관점이 아니라. API 디자인 시 체크 사항 누가 API를 사용하는가? 무엇을 할 수 있는가? 어떻게 하는가? 하기 위해서 무엇이 필요한가? (입력에 대한 질문) 끝나면 무엇을 반환하는가..
TIL (Today I LeTIL (Today I Learned) 2022.05.02 오늘 읽은 범위 1부 API 디자인 기초 책에서 기억하고 싶은 내용 책에서 말하는 API는 웹 API다. 소프트웨어를 위한 웹 인터페이스다. API는 소프트웨어를 레고처럼 만들어준다. 이 의미는 API를 사용해 더 거대하고 새롭고 다양한 것을 만들 수 있다는 의미다. 다양한 컨슈머가 사용하는 것은 퍼블릭 API고, 정해진 컨슈머들만 사용할 수 있는 API는 프라이빗 API다. (내부망, 인터넷으로 결정되지 않는다) API는 구현, 처리 과정을 숨기고 원하는 응답만 컨슈머에게 전해준다. 언젠가 API를 노출하면 해당 API 소프트웨어 개발 과정에 전혀 관련 없었던 사람들이 API를 사용한다. 그렇기 때문에 API를 사용하..
TIL (Today I LeTIL (Today I Learned) 2022.03.06 오늘 읽은 범위 9장. 단위 테스트 책에서 기억하고 싶은 내용을 써보세요. 코드에 유연성, 유지보수성, 재사용성을 제공하는 버팀목이 바로 단위 테스트다. (p.157) 테스트 코드는 실제 코드 못지 않게 중요하다. (p.157) 테스트 코드에서 제일 중요한 것은 가독성이다. (p.158) 오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요 사실 요즘 제일 궁금하고 배워야한다고 느끼는 것이 바로 이 테스트 코드다. 클린 코드에서도 테스트 코드에 관해서는 책 한 권으로도 부족할 정도로 많은 얘기를 할 수 있다고 한다. 이 책에서는 테스트 코드에 할당된 부분이 너무 적은 것 같다. 사실 이부분에서는 저번 장들만큼 정보와 깨..
TIL (Today I LeTIL (Today I Learned) 2022.03.03 오늘 읽은 범위 7장. 오류처리 책에서 기억하고 싶은 내용을 써보세요. try 블록에서 무슨 일이 생기든지 catch 블록은 프로그램 상태를 일관성 있게 유지해야 한다. (p.132) 먼저 강제로 예외를 일으키는 테스트 케이스를 작성한 후 테스트를 통과하게 코드를 작성하는 방법을 권장한다. 그러면 자연스럽게 try 블록의 트랜잭션 범위부터 구현하게 되므로 범위 내에서 트랜잭션 본질을 유지하기 쉬워진다. (p.133) 오류 메시지에 정보를 담아 예외와 함께 던진다. (p.135) 오류는 많고 분류하는 방법도 다양하다. 그러나 애플리케이션에서 오류를 정의할 때 프로그래머에게 가장 중요한 관심사는 오류를 잡아내는 방법이다. ..
