강의 계획 레슨 148개 중 68번째 · 누구도 잘못 쓸 수 없는 API
누구도 잘못 쓸 수 없는 API

상태를 명시적으로 만들기

왜 중요한가 생애 주기가 있는 객체(연결, 파일, 트랜잭션, 결제)가 "내 컴퓨터에서는 됐는데"가 사는 곳이에요. 잘못된 순서의 호출은 나중에 무언가를 망가뜨리지 말고 바로 거기서 실패해야 해요.

팀의 나머지를 위해 네트워크 전송을 감싸고 있어요. 전송 자체는 저수준이에요: connect(), write(data), disconnect(), 그리고 시키는 대로 해요. 지난 분기의 사후 분석에서 닫은 뒤에 데이터를 보내고 조용히 잘못된 서버에 다시 연결한 작업이 발견됐어요. 감싸개는 그걸 불가능하게 만들어야 해요.

상태 기계: 작은 상태 집합(new, open, closed)과 각 상태에서 허용되는 호출. 그 밖의 것은 거부돼요.

c = Connection(transport)
c.open()
c.send(b"hello")
c.close()

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
내 차례

__init__(self, transport), open(), send(data), close(), 그리고 with 지원(들어갈 때 열고, 블록이 예외를 일으켜도 나갈 때 닫기)이 있는 class Connection을 쓰세요. 이것들은 전송의 connect(), write(data), disconnect()를 불러요.

숨은 잘못된 사용 스크립트가 이것들을 하나씩 시도해요. 각각은 무엇이든 전송에 닿기 전에, 잘못된 호출에서 예외를 일으켜야 해요:

  • RuntimeError(또는 하위 클래스): open 전의 send나 close, 두 번 open, close 뒤의 send, close, 또는 다시 open(닫힌 연결은 끝난 것이니, 새로 만드세요), with 블록 뒤의 send.
  • TypeError: 바이트류(bytes나 bytearray)가 아닌 것을 send. 호출자 대신 문자열을 인코딩하지 마세요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.