shared_render - 브로드캐스트 렌더 공유
모두가 같은 화면을 보는 컴포넌트는, 같은 브로드캐스트를 받은 연결들이 렌더를 한 번만 하고 함께 쓴다.
개요#
문제: 같은 화면을 연결마다 다시 그린다#
브로드캐스트(abroadcast(), 컴포넌트의 self.broadcast(), 모델 알림)는 토픽을 구독한 모든 연결에 닿는다. 연결마다 수신자(notification(),
mutation())가 돌고, 컴포넌트를 다시 렌더하고, 그 연결의 화면과 비교해 diff를 보낸다. 공지판·시세판·현황판처럼
1,000명이 같은 컴포넌트를 같은 상태로 보고 있으면, 서버는 똑같은 템플릿을 1,000번 렌더한다. 브로드캐스트 하나가
연결 1,000개에 닿는 시간의 대부분이 이 렌더와 그 결과의 파싱이다(성능).
해결: 선언한 컴포넌트는 렌더를 함께 쓴다#
from wireview import Component
class Scoreboard(Component):
class Meta:
template_name = "games/scoreboard.html"
subscriptions = {"scores"}
shared_render = True # 이 컴포넌트의 렌더는 보는 사람과 무관하다
game_id: int
@property
def scores(self):
return Score.objects.filter(game_id=self.game_id).order_by("-points")[:20]
async def notification(self, channel: str, **kwargs):
pass # 다시 그리기만 하면 된다
{% component "Scoreboard" id="scoreboard" game_id=game.pk %}
같은 프로세스에서 같은 브로드캐스트 메시지를 처리하는 연결들 가운데, 클래스·컴포넌트 id·필드가 같은 것끼리는 처음 온 연결 하나만 렌더한다. 나머지는 그 렌더를 받아 자기 화면과 비교만 한다. 브라우저가 받는 프레임은 공유하지 않을 때와 바이트까지 같다.
선언은 약속이다. "이 컴포넌트의 렌더는 필드와, 모두에게 같은 데이터만 읽는다. 보는 사람이 누구인지는 읽지 않는다." 약속이 틀리면 처음 렌더한 사람의 화면이 다른 사람에게 간다. 그래서 기본값은 꺼져 있고, 선언한 컴포넌트에만 일어나며, 틀린 선언을 최대한 잡는다.
작동 방식#
함께 쓰는 것과 연결마다 하는 것#
| 함께 쓴다 | 연결마다 | |
|---|---|---|
수신자 (notification(), mutation()) |
✓ 각 연결의 컴포넌트에서 돈다. 필드를 바꿔도 된다 | |
| 템플릿 렌더 (property 읽기 포함) | ✓ 메시지와 키마다 한 번 | |
마커 파싱 (Rendered) |
✓ | |
data-state (서명한 상태) |
✓ 연결의 경계(live_session)와 인증 세대에 묶인 토큰이다 |
|
| diff | ✓ 그 연결의 화면이 보여 주는 것과 비교한다 | |
after_render 훅, LiveComponent 수명주기, 구독 갱신 |
✓ | |
| 이벤트(클릭)에 대한 렌더 | ✓ 공유는 브로드캐스트에서만 일어난다 |
data-state는 공유하지 않는다. 서명 봉투에는 클래스와 상태 말고도 페이지 경계 이름과 그 연결의 인증 세대 지문이
들어간다(docs/design/live-session.md). 그래서 공유 렌더는 그 자리를 비워 두고, 연결마다 자기 토큰을 끼운다.
토큰 재사용(같은 상태면 같은 토큰)도 연결마다 그대로다. 토큰은 이벤트 루프 밖에서 서명한다. 상태의 JSON이 computed
field나 QuerySet 필드 때문에 쿼리할 수 있기 때문이다. 렌더한 연결은 그 렌더 트립 안에서 서명하고, 렌더를 받은 연결들은
그동안 기다린 것끼리 워커 트립 하나에서 각자의 토큰을 서명한다.
같은 렌더의 조건#
아래가 모두 같아야 한 렌더를 함께 쓴다. 하나라도 다르면 따로 렌더한다.
- 브로드캐스트 메시지. 발행할 때 메시지마다 id(
message_id)가 붙는다. 같은 메시지를 처리하는 동안만 함께 쓴다. 다음 브로드캐스트는 다시 렌더한다. 프로세스는 메시지의 렌더를 1초 동안 기억하고, 그 사이에도 모두 합해 HTML 16 MB·렌더 4,096개를 넘으면 오래된 메시지부터 잊는다. 그보다 늦게 메시지에 닿은 연결은 각자 렌더한다(결과는 같고 느릴 뿐이다). - 클래스와 컴포넌트 id. id는 루트 요소(
{% tag_header %})에 찍힌다.id=를 주지 않은 컴포넌트는 페이지마다 id가 달라 공유되지 않는다. 모두가 보는 컴포넌트에는 고정 id를 준다. - 필드.
user·wire·session을 뺀 모든 필드를 인스턴스에서 그대로 읽어 키에 넣는다.Meta.exclude_fields로 서명에서 뺀 필드도, pydantic의Field(exclude=True)로 직렬화에서 뺀 필드도 렌더는 읽으므로 넣는다. field serializer도 거치지 않는다. 값의 타입도 본다(1과True, 리스트와 튜플은 다르다). 수신자가 연결마다 필드를 다르게 바꾸면 그 값마다 따로 렌더한다. - 모델 인스턴스와 QuerySet이 없을 것. 필드 어디에든(목록·dict 안,
AsyncResult의 결과까지) 모델 인스턴스나 QuerySet이 있으면 그 렌더는 공유하지 않는다. 키는 행의 pk까지만 알 수 있는데, 렌더는 인스턴스의 속성을 읽는다. 같은 pk라도 연결마다 저장하지 않은 편집, 사용자별 annotate 값, 다른 시각에 읽은 값을 가질 수 있다. 필드의 타입이 모델이나 QuerySet을 말하면 그 클래스는 처음부터 범위 밖이다. 모두가 보는 행은 property에서 읽는다(위 예시의scores처럼). 필드에는 그 행을 가리키는 값(game_id)만 둔다. - 활성 언어와 시간대.
translation.get_language()와timezone.get_current_timezone_name()이다. 연결마다 언어나 시간대를 켜는 앱은 그 값마다 따로 렌더한다.
키를 만드는 비용은 연결당 수 µs다(필드 JSON 한 번).
처음 렌더한 연결이 실패하면#
처음 온 연결의 렌더가 예외를 던지면 그 연결만 오류 처리를 거친다. 기다리던 연결 가운데 하나가
다시 렌더하고 나머지는 그것을 받는다. join이 실패해 막힌 컴포넌트(repo.refused)는 공유에 끼지 않는다. 렌더하지
않는 것은 지금과 같다.
언제 쓰면 안 되는가#
렌더가 보는 사람에 따라 달라지는 컴포넌트에는 선언하지 않는다. 흔한 경우는 이렇다.
| 경우 | 왜 틀리나 | 대신 |
|---|---|---|
| 모델 인스턴스나 QuerySet을 필드에 둠 | 같은 pk의 다른 속성(저장 안 한 편집, 사용자별 annotate)이 다른 사람에게 갈 수 있다 | 공유하지 않는다(자동). 공유하려면 pk를 필드에 두고 행은 property에서 읽는다 |
권한별 화면: {% if this.user.is_staff %}, property에서 self.user.has_perm() |
처음 렌더한 사람의 권한으로 모두가 본다 | 선언하지 않는다. 또는 권한마다 다른 클래스·토픽으로 나눈다 |
| 사용자별 데이터: "내 알림 3개", "내가 좋아요 누름" | 남의 숫자가 보인다 | 그 부분을 선언하지 않은 다른 컴포넌트로 뺀다 |
| 사용자 프로필의 언어·시간대·통화로 직접 포맷 | 키는 Django의 활성 언어·시간대만 본다. 프로필 필드를 템플릿이 읽으면 키에 없다 | 언어·시간대는 translation.activate()·timezone.activate()로 켠다(그러면 키가 가른다). 아니면 선언하지 않는다 |
쿼리 파라미터를 렌더에서 직접 읽음 (self.wire.params) |
키에 없다 | params_changed()에서 필드에 옮긴다. 필드는 키에 들어간다 |
페이지의 쿼리에서 시작하는 {% querystring %} |
쿼리는 연결마다 다르다 | 범위 밖이다(아래). 공유하려면 params_changed()에서 쿼리를 필드에 옮기고, 그 필드로 QueryDict를 만드는 property를 넘긴다({% querystring this.query page=2 %}) |
연결마다 다른 비공개 속성(_rows)을 수신자가 채움 |
비공개 속성은 키에 없다 | 공개 필드에 둔다 |
| "현재 사용자"를 thread-local·contextvar로 읽는 property (django-crum류) | 처음 렌더한 연결의 사용자로 계산된다 | 선언하지 않는다 |
{% now %}·현재 시각 |
메시지 하나를 처리하는 수백 ms 안에서는 같은 값이 간다. 대개 괜찮다 | 초 단위가 중요하면 필드로 |
업로드(allow_upload), 슬롯, LiveComponent를 그림 |
연결의 저장소와 업로드 상태를 그린다 | 범위 밖이다(아래). 공유되지 않는다 |
공유해도 결과가 같다는 확신이 없으면 선언하지 않는다. 선언하지 않은 컴포넌트에는 아무것도 바뀌지 않는다.
범위#
다음 컴포넌트는 선언해도 공유하지 않는다. 렌더는 연결마다 그대로이고, 첫 렌더에서 서버 로그에 경고가 한 줄 남고,
manage.py check의 wireview.W019가 미리 알린다.
LiveComponent. 그리는 쪽이 렌더와 수명주기를 정한다.Meta.temporary_assigns가 있는 컴포넌트. 연결마다 자기 화면에 남은 값으로 맞춘다(temporary_assigns).Meta.slots가 있는 컴포넌트. 그리는 페이지가 내용을 채운다.Meta.live_sessions가 있는 컴포넌트. 경계는 누가 보는가에 관한 것이다.- 필드의 타입이 모델이나 QuerySet을 말하는 컴포넌트(
doc: Bookmark | None,rows: list[Bookmark]). 타입이 말하지 않는 필드(t.Any)에 들어 있으면 그 렌더에서 알아채고 각자 렌더한다. - 템플릿이 다른 컴포넌트·슬롯·업로드를 그리는 컴포넌트(
{% component %},{% live_component %},{% render_slot %},{% upload_input %}…). - 템플릿이
user·session·this.user·this.session·request·perms·csrf_token·messages를 읽는 컴포넌트.{{ }}와{% if %}·{% for %}·{% with %}뿐 아니라 필터 인자({{ x|default:request.path }})와 변수를 받는 태그 ({% firstof %}·{% cycle %}·{% cache %}의vary_on·{% blocktranslate %}의 본문과with…), wireview의{% cond %}·{% class %}의 식({% class {'staff': user.is_staff} %})도 본다. 체크는 템플릿의 소스를 파서로 한 번 더 읽어 파서가 만든 노드와 표현식을 모두 본다. 그래서 태그가 본문과 인자를 어디에 두든(child_nodelists를 선언하지 않은 블록 태그의 본문, 자기 객체로 감싼 인자도) 빠지지 않는다. 태그가 노드로 만들지 않고 토큰째 가져간{{ }}(본문을 렌더 때 컴파일하거나 자기 파서로 파싱하는 태그)도 그 식으로 읽는다 —{% comment %}안은 읽지 않는다. 토큰째 가져간{{ }}는 그 태그가 무엇으로 쓰든 Django 식으로 읽는다. 별칭도 이름 그대로라{% blocktranslate with user=author %}{{ user }}도, 본문을 Django가 아닌 문법(클라이언트 템플릿)으로 내보내는 서드파티 태그의{{ user }}도user를 읽는다고 본다. Django의{% verbatim %}안은 렉서가 텍스트로 만들므로 읽지 않는다. 식으로 읽을 수 없으면 공유하지 않는다. 다시 파싱한 트리가 렌더가 쓰는 트리와 맞지 않아도(최상위 노드 수) 공유하지 않는다. 같은 이름의 필드나 property를 가진 컴포넌트는 그것을 읽는 것이므로 빼고 본다. - 템플릿에
{% debug %}가 있는 컴포넌트. 보는 사람의 것을 포함한 컨텍스트 전체를 찍는다. - 템플릿에 매핑 인자 없는 Django의
{% querystring %}({% querystring page=2 %})이 있는 컴포넌트. 컨텍스트의request에서 지금 페이지의 쿼리를 읽는다(내비게이션, #210). 자기 매핑을 넘긴{% querystring this.query page=2 %}은 읽지 않는다(Django 5.2는 그 인자로QueryDict만 받는다). 단 Django 5.2는 그 값이None이면 페이지의 쿼리를 읽는다 — 리터럴{% querystring None page=2 %}은 W019가 읽음으로 보고, 렌더 때None으로 풀리는 변수는 아래의 공유 렌더가 막는다.
공유되는 렌더(선언한 클래스의 라이브 렌더와 그것이 그리는 함수 컴포넌트)에는 context.request가 없다. 1.5와 같다 —
getattr(context, "request", None)으로 요청을 찾는 서드파티 태그는 요청이 없는 것으로 알고 넘어가고, context.request.GET을
바로 읽는 것은 AttributeError로 실패한다. 첫 연결의 쿼리가 다른 연결의 화면으로 가지 않는다. 검사가 켜져 있으면
그 자리에 감시 객체가 있다(아래). 첫 HTTP 렌더에는 context.request가 있으므로, 선언한 클래스는 join에서 그것을 잃어
그런 태그의 출력이 한 번 바뀐다(요청의 쿼리를 그리던 자리가 요청이 없는 것으로 그려진다).
위 두 항목의 "템플릿"은 컴포넌트의 템플릿 파일 하나가 아니라 렌더가 닿는 템플릿 전부다. {% include %}한 템플릿,
{% extends %}의 부모(그 부모의 부모까지), 함수 컴포넌트({% func %}·{% func_block %})의 템플릿, inclusion 태그의
템플릿(문자열로 만든 Template을 넘긴 것도), 템플릿 조각({% include "parts.html#row" %} — Django 6의 것과 Django
5.2에서 쓰는 django-template-partials의 것)을 Django의 렌더가 찾는 대로(같은 엔진·로더, 같은 이름을 extends하면 다음
로더) 따라가고, 거기서 또 불러오는 템플릿도 따라간다. 조각은 렌더가 쓰는 그 파일(캐시 로더가 쥔 것)에서 자기
{% partialdef %} 안과, 그 안의 {% partial %}이 그리는 같은 파일의 조각을 읽는다 — 한 파일의 조각들은 저마다 따로,
페이지와 조각을 한 파일에 둬도 페이지 쪽은 조각의 범위가 아니다. 단 조각 안의 태그가 모두 Django·wireview·그 조각
라이브러리의 것이고 그중 어느 것도 조각 밖에서 파싱된 노드를 쥐지 않을 때만이다. 그 밖의 태그가 하나라도 있으면(조각
밖에 정의한 매크로를 조각 안에서 쓰는 태그처럼 파일의 다른 자리를 그릴 수 있다) 파일 전체를 읽는다. 같은 조각 이름을
두 라이브러리가 정의해도 파일 전체다. {% extends %}하는 템플릿은 다른 사슬로 다시 오면 다시 걷는다(같은 이름을
extends할 때 고르는 부모가 지나온 템플릿에 따라 다르다). 함수 컴포넌트와 inclusion 태그의 템플릿은 자기 컨텍스트로
그려지므로, 그 안에서 읽은 user는 같은 이름의 필드가 있어도 보는 사람의 것으로 본다.
- 렌더 전에는 이름을 알 수 없는 템플릿을 불러오는 컴포넌트. 변수로 이름을 정하는
{% include part %}·{% extends base %}·{% func kind %}, 등록되지 않은 함수 컴포넌트, 불러올 수 없는(없거나 문법 오류인) 템플릿 — 컴포넌트 자기 템플릿이 그렇더라도. 무엇을 읽을지 모르므로 공유하지 않는다(걷는 도중의 오류도 같다). 공유하려면 이름을 문자열 리터럴로 쓴다.
정적으로 보이지 않는 것도 있다. 템플릿 태그의 파이썬 코드가 다른 컴포넌트를 그리거나, {% tag_header %}가 두 번
나오면 첫 렌더가 그것을 알아채고 그 클래스는 그 뒤로 공유하지 않는다.
범위는 클래스마다 처음 렌더할 때 한 번 정한다(템플릿마다 소스를 한 번 더 파싱한다 — admin의 change_form.html과
그것이 닿는 템플릿 일곱 개에 4 ms쯤). 개발 서버(runserver)의 자동 리로더가 파일 변경을 알리면 다음 렌더에서 다시
정한다 — 끼워 넣은 템플릿을 고쳐 보는 사람을 읽게 되면 그 뒤로 공유하지 않는다. 운영(자동 리로더가 없다)에서는
프로세스를 다시 띄울 때까지 그대로다. 처음 정할 때 불러올 수 없던 템플릿(DB 템플릿 로더처럼 나중에 생기는 것)은 생긴
뒤에도 재시작 전까지 공유하지 않는다. manage.py check 때 아직 없는 그런 템플릿은 W019가 알린다 — 컴포넌트 자기
템플릿이면 its template could not be loaded, 끼워 넣은 것이면 which this check cannot follow.
틀린 선언 잡기#
시스템 체크#
manage.py check가 위 범위를 wireview.W019로 알린다. 템플릿은 렌더가 닿는 템플릿을 모두 걷고, 보는 사람을
읽은 곳이 컴포넌트의 템플릿 밖이면 그 파일을 함께 적는다(its template reads user (through partials/row.html)). 이름을
렌더만 아는 템플릿은 그 태그를 적는다({% include part %}). property와 템플릿 태그·필터의 파이썬 코드 안은 보지 않는다.
필드는 타입 표기를 본다.
렌더 때의 검사 (VERIFY_SHARED_RENDER)#
설정 VERIFY_SHARED_RENDER가 켜져 있으면 선언한 컴포넌트를 두 가지로 검사한다. 기본값
None은 DEBUG를 따르고, wireview.testing의 render_diff()에서는 언제나 켜진다. False로 끈다.
- 보는 사람의 이름을 읽으면 오류다. 렌더하는 동안 컴포넌트의
user와session, 컨텍스트의request·perms·csrf_token·messages자리에 감시 객체를 둔다({% querystring %}이나 서드파티 태그가 읽는context.request의GET도, 그 렌더가 그리는 함수 컴포넌트의 템플릿에서도). 속성 접근·문자열 변환·진릿값 평가·비교에서SharedRenderError(ImproperlyConfigured의 하위 클래스)를 던진다. property 안의self.user와 다른 이름으로 받은 컴포넌트의{% with viewer=this %}{{ viewer.user }}처럼 시스템 체크가 보지 못하는 읽기도 잡는다. 감시 객체는 던지기 전에 읽혔다는 사실을 그 렌더에 적어 둔다. 그래서 오류를 삼키는 자리 — 연산자가 든{% if request.user.is_staff and x %}(Django는 피연산자의 예외를 거짓으로 바꾼다), 예외를 스스로 잡는 property — 에서 읽어도 렌더가 끝난 뒤 던진다. 렌더 밖(핸들러,joined(),notification())에서는 그대로 읽힌다. - 받은 렌더를 다시 렌더해 비교한다. 다른 연결의 렌더를 받은 연결이 자기도 렌더해서, 둘이 다르면
SharedRenderError를 던진다. 감시 이름을 거치지 않고 연결마다 달라지는 것(비공개 속성,self.wire.params, thread-local의 현재 사용자)을, 두 연결이 실제로 다른 값을 가질 때 잡는다. 개발 중에 브라우저 두 개를 다른 사용자로 열어 브로드캐스트해 보면 드러난다.
오류는 그 컴포넌트의 오류 처리를 탄다. 서버 로그에 무엇이 달랐는지(처음 다른 곳 앞뒤 40자)가 남는다.
{% csrf_token %}을 그리는 템플릿 — {% include %}한 것, 함수 컴포넌트·inclusion 태그의 것 포함 — 을 가진 클래스는
범위 밖이라 공유하지 않고, 연결마다 자기 토큰을 그린다. 시스템 체크가 보지 못하는 길(템플릿 태그의 파이썬
코드)로 공유 렌더에 들어간 토큰은 검사가 꺼져 있으면 비어 있다. 한 연결이 모두를 위해 그리는 렌더에 그 연결의 토큰을
넣지 않는다(dead view).
켜 두면 받은 연결도 렌더하므로 공유로 아끼는 시간이 없다. 운영에서는 끈다(DEBUG = False면 기본으로 꺼진다).
잡지 못하는 것#
감시하는 것은 컴포넌트의 user·session과 컨텍스트의 request·perms·csrf_token·messages 이름뿐이다. 그
이름을 거쳐 읽으면 어디서든(템플릿, {% include %}, property, 오류를 삼키는 자리) 잡는다. 그 밖은 다음과 같다.
- 감시 이름을 거치지 않는 읽기. 비공개 속성(
self._rows),self.wire의 값(params·channel_name·live_session), thread-local·contextvar의 현재 사용자, 미리 꺼내 둔 사용자 객체(self._me = self.user를joined()에서 해 두고 렌더에서 읽음), 사용자 id를 property 안에서 다른 경로로 얻어 하는 쿼리. 이것은 2번 비교로만 잡히고, 그것도 아래 조건에서다. - 그런 읽기를 테스트나 개발에서 연결 하나로만 돌렸을 때. 비교할 다른 렌더가 없다.
- 개발 환경에서 우연히 모두 같은 값이었던 것(사용자가 한 명뿐, 언어가 하나뿐).
- 운영(
DEBUG = False이고VERIFY_SHARED_RENDER를 켜지 않음). 아무것도 검사하지 않는다.
시스템 체크는 렌더가 닿는 템플릿을 모두 걷지만 property, 템플릿 태그·필터의 파이썬 코드, 다른 이름으로 받은
컴포넌트({% with viewer=this %})는 보지 않는다. 태그가 파서를 거치지 않고 스스로 만든 것도 파이썬 코드 몫이다 —
토큰 조각으로 직접 만든 template.Variable(노드의 속성이나 거기 둔 list·tuple·dict에 있으면 본다)을 자기 객체 안에
둔 것, do_include()를 불러 만든 노드를 감싸 둔 것, 변수 이름을 문자열로 들고 렌더 때 컨텍스트에서 읽는 것(Django
admin의 {% get_admin_log 10 as log for_user user %}가 그렇다). 그것은 렌더 때의 검사 몫이다. W019가 없다는 것은 체크가 본 곳에
보는 사람이 없었다는 뜻이지, 그 클래스가 안전하다는 뜻이 아니다.
그래서 테스트에서 사용자 둘을 만들어 보는 것이 가장 확실하다.
from wireview import mount
async def test_the_scoreboard_does_not_read_the_viewer():
board = await mount(Scoreboard, id="scoreboard", game_id=1)
await board.render_diff() # self.user를 읽으면 SharedRenderError
이름#
shared_render는 결과를 이름으로 삼는다. 이 렌더는 보는 사람들 사이에서 공유된다. 선언하는 사람이 받아들여야
하는 것이 바로 그것이다. viewer_independent처럼 약속을 이름으로 삼으면 최적화라는 사실이 가려져, 아무 데나
붙여도 될 것처럼 읽힌다. 렌더 없이 같은 패치를 보내는 브로드캐스트(#178)와도 낱말이 겹치지 않는다. 그쪽은
Broadcast이고 발행하는 쪽이 고르며, 이것은 받는 컴포넌트가 선언한다.
렌더 없는 브로드캐스트와의 관계#
둘은 서로를 대체하지 않는다. shared_render는 필드와 property에 기대어 컴포넌트를 다시 그려야 하는
브로드캐스트를 싸게 한다. 연결마다 수신자가 돌고 diff를 만드는 구조는 그대로다. 스트림 항목 추가처럼 서버가
추적하지 않는 DOM만 바꾸는 경우는 렌더 없이 같은 프레임을 보내는 쪽이 더 싸다(설계: #178).
관련 문서#
- 성능: 측정값
- System Checks:
wireview.W019 - 설정:
VERIFY_SHARED_RENDER - 서버 오류 처리
- temporary_assigns
- 설계와 측정: §4-A가 설계, §7이 결과다