💡 [LIST command] LIST 명령어 구현하기

[Yudongwoo]

🔑 How

구현 사항

• 메시지 형식
  • LIST [채널 이름1],[채널 이름2],... 로 선택
  • 이유
    • 두 번째 파라미터가 없어도 LIST 명령어의 기본 역할은 충분함.
    • RFC 1459, RFC 2812의 경우는 다중 서버일 때 의미가 있음.
    • modern irc는 부가적인 기능임.
• Numeric reply
  • RPL_LIST와 RPL_LISTEND만 사용.
  • 이유
    • RPL_LISTSTART
      • LIST 명령어 응답이 시작되었다는 걸 알려주기 위함인데
        RPL_LIST가 바로 나와도 LIST 명령어 응답이 시작되었다는 걸 알 수 있어서
        별 필요 없다고 생각함.
      • modern irc에서도 클라이언트가 RPL_LISTSTART 응답에 의존하면 안된다고 나와 있음.(MUST NOT)
    • RPL_TOOMANYMATCHES : 설명 자체가 안 나와있어서 무시함.
    • ERR_NOSUCHSERVER : 다중 서버일 때 의미가 있어서 필요없음.
    • RPL_LIST
      • 채널 이름, 클라이언트 수, 채널 주제를 출력.
      • private 채널은 "Prv"로 채널 이름 대체하며 채널 주제는 있어도 출력 안 함.
      • secret 채널은 아예 출력하지 않음.
      • 단 보이지 않는 채널에 가입되어 있으면 일반 채널처럼 정보를 출력함.
• 클라이언트의 visible여부에 관계없이 클라이언트 수에 반영할 예정.
  • 이유
    • LIST 명령어는 채널의 정보를 나열해주는 역할을 함.
    • 클라이언트가 invisible 한 상태에 있다는 건
      클라이언트를 직접적인 대상으로 하는 명령어에
      영향을 받지 않는다는 의미로 해석됨.
    • 문서내의 LIST 명령어에는 invisible 클라이언트에 대한 언급이 없음.
• 채널 상태는 클라이언트가 채널에 가입되어 있지 않을 때는 따로 구분하지 않음.
  • 이유
    • secret은 아예 나열되지 않고,
    • private은 "Prv"라는 이름으로 출력할 예정.
    • public은 채널 이름을 그대로 출력할 것이라서
    • 굳이 "=", "@", "*"로 구분할 필요 없다고 생각함.
    • 단 클라이언트가 채널에 가입되어 있을 때는
      일반 채널처럼 채널 정보를 출력할 것이기 때문에
      "=", "@", "*"로 구분할 예정.
• 중복되는 경우 함수로 묶을 예정.

✔ To-dos

• LIST 파라미터가 0개일 때 1개일 때 나눠서 시작
  • LIST 파라미터 없을 시
    • 현재 개설되어 있는 채널 순회
      • 가입되어 있거나 가입 안되어있지만 public 채널일 때
        • 채널 상태를 채널 이름 앞에 붙임.
        • 클라이언트 수 체크
        • 주제 있으면 주제 출력.
        • 주제 없으면 비워둠.
        • RPL_LIST.
        • RPL_LISTEND.
      • 가입 안되어있을 때
        • private 채널이면
          • 채널 이름 : "Prv"
          • 클라이언트 수 체크
          • 주제는 무조건 비워둠.
          • RPL_LIST.
          • RPL_LISTEND.
        • secret 채널이면 무시.
  • LIST 파라미터 있을 시
    • 파라미터로 들어온 채널 이름을 ','로 분리해서 컨테이너에 저장.
    • 저장된 채널 이름 순회
      • 가입되어 있거나 가입 안되어있지만 public 채널일 때
        • 채널 상태를 채널 이름 앞에 붙임.
        • 클라이언트 수 체크
        • 주제 있으면 주제 출력.
        • 주제 없으면 비워둠.
        • RPL_LIST.
        • RPL_LISTEND.
      • 가입 안되어있을 때
        • private 채널이면
          • 채널 이름 : "Prv"
          • 클라이언트 수 체크
          • 주제는 무조건 비워둠.
          • RPL_LIST.
          • RPL_LISTEND.
        • secret 채널이면 무시.

📝 ETC

Originally posted by @Yudongwoo in #173 (comment)

[Yudongwoo]

development 브랜치에서 해당 이슈(#178) 브랜치 만들기
브랜치 이름 : 178/dyu/enhancement/Implement_list_command