# Broadcast - 렌더 없는 브로드캐스트 > 스트림 항목·훅 이벤트·JS 명령을 발행하는 곳에서 한 번 렌더하고, 구독한 연결마다 그대로 쓴다. --- ## 개요 ### 문제: 모두에게 같은 항목을 연결마다 다시 그린다 피드·채팅·알림 목록에 항목 하나가 들어오면 지금까지는 알림을 보냈다. 받은 연결마다 `notification()`이 돌고, `stream_insert()`가 항목 템플릿을 렌더하고, 그 연산을 채널 레이어로 자기 세션에 다시 보낸다. 모두가 같은 HTML을 받는데도 연결 1,000개면 같은 `
  • `를 1,000번 렌더하고 채널 레이어를 2,000번 오간다. ### 해결: 발행하는 곳에서 한 번 ```python from wireview import Broadcast, Component class Feed(Component): class Meta: template_name = "feed/feed.html" subscriptions = {"feed"} async def joined(self): await self.stream("items", await self._latest()) async def publish(self, text: str): post = await Post.objects.acreate(text=text) await Broadcast(Feed, "feed").stream_insert("items", post, at=0, limit=50).asend() ``` `Broadcast(Feed, "feed")`가 받을 대상이다. `Feed` 클래스의 인스턴스 가운데 `get_subscriptions()`에 `"feed"`가 있는 것이 받는다. 항목은 여기서 한 번 렌더되고, 프레임도 한 번 직렬화된다. 채널 레이어는 그것을 프로세스마다 한 번 나르고, 받는 연결은 아무 코드도 돌리지 않고 그 프레임에 자기 컴포넌트 id만 끼워 쓴다. 브라우저가 받는 바이트는 각 연결이 `self.stream_insert()`를 했을 때와 같다. 알림과 함께 쓸 수 있다. 목록에는 `Broadcast`로 항목을 넣고, 머리의 "새 글 N개" 같은 필드는 알림으로 바꾼다. --- ## API ```text Broadcast(target, topic) .stream_insert(name, item, *, at=-1, limit=0, template=None, dom_id=None) .stream_delete(name, dom_id) .push_event(event, payload=None, *, hook_id=None) .js(js) await broadcast.asend() 바로 렌더하고 보낸다 broadcast.send() 동기 코드에서. 트랜잭션이 커밋된 뒤에 렌더하고 보낸다 ``` | 연산 | 같은 일을 하는 컴포넌트 메서드 | |---|---| | `stream_insert` | `stream_insert()`. 기본 템플릿(`_item.html`)과 DOM id(`"-"`)를 대상 클래스에서 얻는다 | | `stream_delete` | `stream_delete()`. 정수를 주면 `"-<정수>"` | | `push_event` | `push_event()`. `payload`는 JSON이어야 하고, 아니면 연산을 더할 때 `TypeError` | | `js` | `push_js()` | - 연산은 더한 순서대로, 한 메시지로 간다. 그래서 받는 페이지에서도 그 순서로 적용된다. - `target`은 **정확히 그 클래스**다. 하위 클래스는 받지 않는다 — 항목을 다르게 그릴 수 있기 때문이다. - `topic`이 대상 클래스의 `Meta.subscriptions`에 없으면(`get_subscriptions()`를 오버라이드하지 않았을 때) 만들 때 `ValueError`다. 오타 하나로 모든 패치가 조용히 사라지는 일을 막는다. - 토픽은 84자까지, 영숫자·`-`·`_`·`.`만 쓴다. 패치 그룹 `wireview.patch.<토픽>`이 채널 레이어 그룹 이름(100자 미만)이어야 하기 때문이다. ### 동기 코드에서: `send()` 신호 수신자처럼 동기인 곳에서는 `send()`를 쓴다. `broadcast()`처럼 트랜잭션이 커밋된 뒤에 보낸다. 항목 렌더도 커밋 뒤에 하므로 커밋된 행을 읽고, 롤백된 트랜잭션의 항목은 렌더하지 않는다. ```python @receiver(post_save, sender=Post) def post_saved(sender, instance, created, **kwargs): if created: Broadcast(Feed, "feed").stream_insert("items", instance, at=0, limit=50).send() @receiver(post_delete, sender=Post) def post_deleted(sender, instance, **kwargs): Broadcast(Feed, "feed").stream_delete("items", instance.pk).send() ``` 같은 항목을 `mutation()`의 `stream_insert()`로도 넣으면 일을 두 번 한다(결과는 같다). 한쪽만 쓴다. --- ## 무엇을 보낼 수 있나 **서버가 추적하지 않는 것만 렌더 없이 바꿀 수 있다.** 서버는 컴포넌트마다 마지막 렌더를 diff 기준으로 들고 있고, 필드는 `data-state`로 서명해 둔다. 렌더 없이 그것을 바꾸면 다음 diff나 다음 join이 되돌린다. | 보낼 수 있다 | 보낼 수 없다 | |---|---| | 스트림 삽입·삭제 (`wire-stream` 컨테이너는 morph에서 빠진다) | 필드 변경, 컴포넌트 렌더 — 알림과 [shared_render](/wireview/reference/shared-render/)로 | | 훅 이벤트 (`push_event`) | 스트림 초기화(`stream()` reset) — 연결마다 필터가 다른 목록을 덮는다 | | JS 명령 (`js`) — 다음 morph가 서버 HTML로 되돌리는 것은 `push_js()`와 같다 | 플래시·제목·이동 | --- ## 사람마다 다른 내용은 쓸 수 없다 항목은 한 번 렌더되어 **모든 구독자에게 같은 HTML**로 간다. 그래서 항목 템플릿의 컨텍스트에는 `item`뿐이다. `this`·`user`·`request`·`perms`·`csrf_token`을 읽으면 발행한 곳에서 `ImproperlyConfigured`가 난다. 오류는 읽은 변수 이름을 말한다. 운영에서도 언제나 그렇다 — 빈 값으로 조용히 넘어가면 남의 정보가 나가거나 화면이 틀린 채 남는다. ```django {# feed/feed_item.html #}
  • {{ item.text }} {% on "click" "remove" pk=item.pk %} {# 됨: 핸들러는 대상 클래스에서 확인한다 #} {% if user.is_staff %}…{% endif %} {# 오류: user #}
    • ``` - `{% if user.is_staff and item.x %}`처럼 태그가 오류를 삼켜도(그 `{% if %}`은 피연산자의 예외를 거짓으로 친다) 읽은 것은 기록되어, 렌더가 끝난 뒤 같은 오류가 난다. - `{% on %}`은 쓸 수 있다. 핸들러가 있는지는 대상 클래스에서 확인한다. `myself=True`는 인스턴스의 id를 읽으므로 오류다. - 항목은 `LANGUAGE_CODE`와 기본 시간대로 렌더된다. 발행한 요청이 켠 언어나 시간대가 모두에게 새지 않는다. 사용자마다 시각을 달리 보여 주려면 `