Przejdź do treści
Dialova

Dokumentacja IRC · Zaawansowany

Batch: grupowanie powiązanych zdarzeń IRC

batch wskazuje, że kilka wiadomości IRC należy do jednego zestawu. Typ pakietu określa ich związek, na przykład netsplit lub fragment historii. Pakiet batch nie jest automatycznie wiadomością wielowierszową.

Zespół Dialovy · Sprawdzono

Otwarcie, przypisanie i zamknięcie pakietu #

Wymiana IRC: C = klient, S = serwer
S: :irc.example BATCH +lot1 netsplit irc-a.example irc-b.example
S: @batch=lot1 :Bob!u@cloak.example QUIT :Connexion interrompue
S: @batch=lot1 :Chloe!u@cloak.example QUIT :Connexion interrompue
S: :irc.example BATCH -lot1

Serwer otwiera pakiet znakiem +, po którym podaje nieinterpretowany identyfikator i typ. Powiązane wiadomości mają odpowiedni znacznik batch. Pakiet zamyka znak - z tym samym identyfikatorem. Wielkość liter w identyfikatorze ma znaczenie; nie przypisuj mu znaczenia aplikacyjnego.

Negocjowanie i typ pakietu #

Klient prosi o możliwość batch i czeka na ACK. Musi rozumieć format znaczników. Typy pakietów nie są jednak listą negocjowaną przez CAP: każde rozszerzenie opisuje znaczenie swojego typu. Nieznany typ nie uprawnia do odrzucenia zawartości.

Pakiet może być pusty. Kilka pakietów może się przeplatać, a pakiety mogą być zagnieżdżone. Jeden globalny bufor lub założenie „wszystkie kolejne wiadomości należą do pakietu” błędnie odczytywałoby poprawną wymianę.

Historia a stan bieżący #

Typ chathistory grupuje wcześniejsze zdarzenia. Nie usuwaj obecnego użytkownika z bieżącego stanu tylko dlatego, że pakiet historyczny zawiera stare QUIT: odtwarzanie widoku i zmiany aktualnego stanu mają inne zadania.

W dniu weryfikacji możliwość żądania historii pozostaje draft/chathistory, choć typ pakietu chathistory jest już finalny. Rozszerzenie draft/multiline opisuje jeszcze inne zastosowanie. Sama obsługa batch nie gwarantuje tych funkcji.

Ograniczenia i kończenie przetwarzania #

  • Przechowuj tabelę pakietów według identyfikatorów zamiast jednej zmiennej.
  • Zachowuj powiązanie z ewentualnym pakietem nadrzędnym.
  • Ogranicz rozmiar i liczbę pakietów oraz obsłuż przerwanie transportu.
  • Nie przedstawiaj odtworzonej historii jako nowej czynności użytkownika i nie odpowiadaj automatycznie na zdarzenia historyczne.

Źródła i weryfikacja

Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.