JOIN Command Flow

[alsksssass]

IRC JOIN 명령어 코딩 시나리오

목적

IRC 프로토콜의 JOIN 명령어를 구현하여 사용자가 채널에 참여할 수 있도록 합니다.

에러 처리

• ERR_NEEDMOREPARAMS (461): 파라미터 부족
• ERR_NOSUCHCHANNEL (403): 존재하지 않는 채널
• ERR_TOOMANYCHANNELS (405): 사용자가 가입한 채널 수 초과
• ERR_BADCHANNELKEY (475): 잘못된 채널 비밀번호
• ERR_BANNEDFROMCHAN (474): 채널에서 밴된 사용자 (미구현 예정)
• ERR_CHANNELISFULL (471): 채널 인원 초과
• ERR_INVITEONLYCHAN (473): 초대 전용 채널
• ERR_BADCHANMASK (476): 잘못된 채널 마스크 (구현 여부 고민 중)

코드 진행 순서

1. 파싱 에러 처리 (에러 시 461)
2. 채널 존재 확인 (403)
3. 사용자의 채널 가입 횟수 확인 (405)
4. 채널 비밀번호 확인 (475)
5. 사용자 밴 여부 확인 (474)
6. 채널 내 사용자 수 확인 (471)
7. 초대 모드 확인 (473)
8. 채널 클래스에 채널 추가 (신규 채널인 경우)
9. 클라이언트 클래스에 채널 추가
10. 성공 시 진입 메시지 출력
    • RPL_TOPIC (332) 또는 RPL_NOTOPIC (331)
    • RPL_TOPICWHOTIME (333) (수정시간과 수정한 유저닉 전송)
    • RPL_NAMREPLY (353)
    • RPL_ENDOFNAMES (366)

추가해야 할 메소드

Server 클래스

class Server {
 public:
  std::vector<std::string> ParseComma(const std::string& str);
  bool CheckChannelInServer(const std::string& channel_name);
  std::string GetUserListInChannel(const std::string& channel_name);
  // ...
};

Client 클래스

class Client {
 public:
  bool CheckPossibleToJoin();
  // ...
};

Channel 클래스

class Channel {
 public:
  void AddUserInChannel(const std::string& nickname);
  std::string GetTopic();
  std::string GetTopicEditTime();
  // ...
};

메소드 설명

Context::ParseComma

• 기능: 문자열을 콤마 기준으로 벡터로 파싱
• 인자: const std::string& str
• 반환: std::vector<std::string>

Server::IsChannelInList

• 기능: 해당 채널이 서버에 존재하는지 확인
• 인자: const std::string& channel_name
• 반환: bool

Server::GetChannel

• 기능: 해당 채널의 주소값 반환
• 인자: const std::string& channel_name
• 반환: IRCChannel *

Server::GetUserListInChannel

• 기능: 채널의 사용자 목록을 가져옴
• 인자: const std::string& channel_name
• 반환: std::string (353, 366 기준으로 모든 정보를 포함한 단일 문자열)

Client::CheckPossibleToJoin

• 기능: 사용자가 가입한 채널 수가 최대를 초과하는지 확인
• 인자: 없음
• 반환: bool

Channel::AddUserInChannel

• 기능: 사용자를 채널에 추가
• 인자: const std::string& nickname
• 반환: void
• 동작:
  1. 사용자 진입 가능 여부 확인
  2. 채널 사용자 수 최대값 확인
  3. 초대 모드인 경우 초대 여부 확인
  4. 사용자가 이미 채널에 있는지 확인
  5. 모든 조건 충족 시 사용자를 채널에 추가

Channel::GetTopic

• 기능: 채널 토픽 반환
• 인자: 없음
• 반환: std::string

Channel::GetTopicEditTime

• 기능: 토픽 수정 시간,유저닉 반환
• 인자: 없음
• 반환: std::string

주의사항

• 모든 에러 처리를 철저히 수행하여 안정성 확보
• 채널 이름 및 사용자 닉네임의 유효성 검사 필요
• 동시성 이슈를 고려한 설계 필요 (멀티스레드 환경 고려)

향후 개선 사항

• 밴 기능 구현 고려
• 채널 마스크 처리 방식 결정 및 구현
• 성능 최적화 (대규모 채널 및 사용자 처리)

[alsksssass]

서버클래스에서 채널을 생성하여 리스트에 추가하는 메소드 작성