文字コード/符号化

2022-05-29 / tau / コメントする

概要

人が読める文字とマシンが処理できる符号を対応させたものが文字コードで、以下の2つの組み合わせ。

符号化文字集合: Coded Character Set: CCS、キャラクターセット。文字ごとに番号を割り当てられた文字の集合。
文字符号化方式: Character Encoding Scheme: CES、エンコーディングルール。符号化文字集合で定義された番号バイト列に返還するルール。

1バイト系

半角系の文字コードは、CCSのコードがそのままバイト列になる。

ASCII～半角英数
EBCDIC/Japanese (katakana) Extended
JIS X 0201～半角英数・カナ

マルチバイト系

JIS X 0208
- エンコーディング：ISO-20220-JP/EUC-JP/Shift-JISなど

参考サイト

ASCII

2022-05-29 / tau / コメントする

概要

ASCII (American Standard Code for Information Interchange) はANSIによって規定されたラテン文字のコード体系。

7ビットの2進数（10進数で0～127、16進数で00～7F）にアルファベットなどのラテン文字や記号、制御コードを割り当てている。

符号化文字集合で割り当てられたコードポイントがそのままバイト列表現であり、文字符号化方式を包含している。

文字コードの構成

16進	10進	対応文字
00～1F	0～31	制御文字
20	32	空白文字
21～7E	33～126	アルファベットなどの図形文字
7F	127	制御文字DEL

文字集合と符合化

制御文字

16進	10進	記号	CS	ESC	機能
00	0	NUL	^@	\0	ヌル文字
01	1	SOH	^A		ヘッディング開始
02	2	STX	^B		テキスト開始
03	3	ETX	^C		テキスト終了
04	4	EOT	^D		伝送終了
05	5	ENQ	^E		送信問合せ
06	6	ACK	-F		送信承認
07	7	BEL	^G	\a	ベル
08	8	BS	^H	\b	後退
09	9	HT	^I	\t	水平タブ
0A	10	LF	^J	\n	ラインフィード(改行)
0B	11	VT	^K	\v	垂直タブ
0C	12	FF	^L	\f	フォームフィード
0D	13	CR	^M	\r	復帰
0E	14	SO	^N		シフトアウト
0F	15	SI	^O		シフトイン
10	16	DLE	^P		伝送制御拡張
11	17	DC1	^Q		装置制御1
12	18	DC2	^R		装置制御2
13	19	DC3	^S		装置制御3
14	20	DC4	^T		装置制御4
15	21	NAK	^U		否定非承認
16	22	SYN	^V		同期符号
17	23	ETB	^W		伝送ブロック終結
18	24	CAN	^X		キャンセル
19	25	EM	^Y		媒体終端
1A	26	SUB	^Z		文字置換
1B	27	ESC	^[	\e	エスケープ
1C	28	FS	^\		ファイル分離
1D	29	GS	^]		グループ分離
1E	30	RS	^^		レコード分離
1F	31	US	^_		ユニット分離
7F	127	DEL	^?		削除

DEL～削除

厳密には制御文字ではなく、誤った文字を削除するための文字。穿孔テープの時代に削除したい文字の位置でこの文字を打つと下位7ビット全てが1となり、この文字が読み飛ばされた。

DLE (Data Link Escape)～伝送制御拡張

RFC原文は以下のとおり。このコードの後に続く連続したコード群の意味を変更する。すなわちデータ伝送ネットワーク上ににおいてASCIIコード以外の意味を持たせる場合にのみ用いられる。

A communication control character which will change the meaning of a limited number of contiguously following characters. It is used exclusively to provide supplementary controls in data communication networks.

SYN (Synchronous Idle)～同期符号

キャラクター同期方式で、送信する文字列の前後に付加する同期用の文字符合。

図形文字

各欄の上段が文字の印字表現、中段がコードの16進表記、下段がコードの10進表記。

	00	01	02	03	04	05	06	07	08	09	0A	0B	0C	0D	0E	0F
20	SP 20 32	! 21 33	” 22 34	# 23 35	$ 24 36	% 25 37	& 26 38	‘ 27 39	( 28 40	) 29 41	* 2A 42	+ 2B 43	, 2C 44	– 2D 45	. 2E 46	/ 2F 47
30	0 30 48	1 31 49	2 32 50	3 33 51	4 34 52	5 35 53	6 36 54	7 37 55	8 38 56	9 39 57	: 3A 58	; 3B 59	< 3C 60	= 3D 61	> 3E 62	? 3F 63
40	@ 40 64	A 41 65	B 42 66	C 43 67	D 44 68	E 45 69	F 46 70	G 47 71	H 48 72	I 49 73	J 4A 74	K 4B 75	L 4C 76	M 4D 77	N 4E 78	O 4F 79
50	P 50 80	Q 51 81	R 52 82	S 53 83	T 54 84	U 55 85	V 56 86	W 57 87	X 58 88	Y 59 89	Z 5A 90	[ 5B 91	\ 5C 92	] 5D 93	^ 5E 94	_ 5F 95
60	` 60 96	a 61 97	b 62 98	c 63 99	d 64 100	e 65 101	f 66 102	g 67 103	h 68 104	i 69 105	j 6A 106	k 6B 107	l 6C 108	m 6D 109	n 6E 110	o 6F 111
70	p 70 112	q 71 113	r 72 114	s 73 115	t 74 116	u 75 117	v 76 118	w 77 119	x 78 120	y 79 121	z 7A 122	( 7B 123	\| 7C 124	) 7D 125	~ 7E 126

括弧の英語表現

()はopening/closing parenthesis、{}はopening/closing brase、[]はopening/closing bracket

その他の記号の英語表現

!はexclamation point、#はnumber sign、*はasterisk、-はhyphen (minus)、.はperiod (decimal point)、/はslant、@はcommercial at、\はreverse slant、^はcircumflex。

コード全体

	00	01	02	03	04	05	06	07	08	09	0A	0B	0C	0D	0E	0F
00	NUL	SOH	STX	ETX	EOT	ENQ	ACK	BEL	BS	HT	LF	VT	FF	CR	SO	SI
10	DLE	DC1	DC2	DC3	DC4	NAK	SYN	ETB	CAN	EM	SUB	ESC	FS	RS	GS	US
20	SP	!	“	#	$	%	&	‘	(	)	*	+	,	–	.	/
30	0	1	2	3	4	5	6	7	8	9	:	;	<	=	>	?
40	@	A	B	C	D	E	F	G	H	I	J	K	L	M	N	O
50	P	Q	R	S	T	U	V	W	X	Y	Z	[	\	]	^	_
60	`	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o
70	p	q	r	s	t	u	v	w	x	y	z	{	\|	}	~	DEL

Django – URLパラメーター

2022-04-20 / tau / コメントする

URLパラメーターの送信

HTTPリクエストで、以下のようにURLにパラメーターを付して送り、これをDjangoで受け取って処理する手順。

http://localhost:8000/paramtest/100

1	http://localhost:8000/paramtest/100

ここではparamtestアプリケーションでパラメーターとして100が送信されるとする。

ルーティングの設定

まずURLに含まれるパラメーターを認識するため、ルーティングを設定する。アプリケーションのurls.pyで、パラメーターを受け取るために以下のように記述する。

from django.urls import path
from paramtest import views

urlpatterns = [
    path('<int:parameter>', views.index),
]

from django.urls import path

from paramtest import views

urlpatterns = [

path('<int:parameter>', views.index),

]

<int:....>によってパラメーターが整数形式であることを明示していて、整数以外の値が渡された場合は404エラーとなる。

ビューの記述

ルーティング先のviews.indexでは、このパラメーターを引数で受け取る。以下の例では、受け取ったパラメーターをそのままテンプレートに渡している。

from django.shortcuts import render

def index(request, parameter):
    context = {'parameter': parameter}
    return render(request, 'paramtest/index.html', context)

from django.shortcuts import render

def index(request, parameter):

context = {'parameter': parameter}

return render(request, 'paramtest/index.html', context)

テンプレートが以下のようになっていれば、URLで与えたパラメーターの値がブラウザーにそのまま表示される。

<p>Parameter: {{ parameter }}</p>

1	<p>Parameter: {{ parameter }}</p>

Django – Tutorial – テンプレート

2022-03-26 / tau / コメントする

概要

DjangoドキュメントのチュートリアルPart3中”Write views that actually do something“の冒頭でビュー関数でのモデル操作を実装した後、テンプレートファイルを使った表示を実装している。

テンプレートの基礎についてはこちらを参照。

テンプレートディレクトリー／ファイルの作成

テンプレートファイルの内容

pollsディレクトリー下にtemplatesディレクトリーを、その下にpollsディレクトリーを作成する。そのディレクトリー下に以下の内容でindex.htmlファイルを作成する。

これから、polls/viewsモジュールからこのテンプレートを参照するよう編集していく。

{% if latest_question_list %}
  <ul>
    {% for question in latest_question_list %}
      <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
    {% endfor %}
  </ul>
{% else %}
  <p>No polls are available.</p>
{% endif %}

{% if latest_question_list %}

<ul>

{% for question in latest_question_list %}

<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>

{% endfor %}

</ul>

{% else %}

<p>No polls are available.</p>

{% endif %}

パスの書き方の注意点

テンプレートファイルのアンカータグは以下のように書かれている。

<a href="/polls/{{ question.id }}/">

1	<a href="/polls/{{ question.id }}/">

当初/polls/{{ ... }}の部分の先頭の'/'を抜かして書いてしまって、polls/{{ ... }}としたところ、URLが以下のようになってしまった。

http://localhost:8000/polls/polls/2/

現在のアプリケーションからの相対パスになってしまったためで、

http://localhost:8000/polls/ + /polls/2/

と解釈されてしまう。先頭のスラッシュを入れるとホスト名をルートとするパスとなる。ただしこの記事の最後の方にあるDTLのurlタグを使うと、このような心配をしなくて済むようになる。

テンプレートの探索

ディレクトリー・ファイル構成は以下の通り。

polls
├── __init__.py
├── admin.py
├── apps.py
├── migrations
│   ├── 0001_initial.py
│   └── __init__.py
├── models.py
├── templates
│   └── polls
│       └── index.html
├── tests.py
├── urls.py
└── views.py

polls

├── __init__.py

├── admin.py

├── apps.py

├── migrations

│ ├── 0001_initial.py

│ └── __init__.py

├── models.py

├── templates

│ └── polls

│ └── index.html

├── tests.py

├── urls.py

└── views.py

config/settings.pyで、以下のように設定している。

INSTALLED_APPSに 'polls.apps.PollsConfig'を登録
→pollsが探索に含まれる
TEMPLATESの'APP_DIRS'がTrueに設定
→polls/templatesが探索に含まれる

ので、polls/templatesとそのサブディレクトリー下がテンプレートファイルの探索場所に含まれる。

ビューにおけるレンダリング

loaderによる標準形

ビューの編集

テンプレートファイルを導入した場合の標準形は以下の構成になる。

django.templateパッケージのloaderオブジェクトをインポート
loader.get_template('テンプレートへのパス')でテンプレートを読み込み
テンプレートのrenderメソッドでレンダリングした結果を、HttpResponseに渡す
→render(context, request)

from django.http import HttpResponse
from django.template import loader

from .models import Question

def index(request):
    latest_question_list = Question.objects.order_by('-pub_date')[:5]
#    output = ', '.join([q.question_text for q in latest_question_list])
    template = loader.get_template('polls/index.html')
    context = {
        'latest_question_list': latest_question_list,
    }
    return HttpResponse(template.render(context, request))

from django.http import HttpResponse

from django.template import loader

from .models import Question

def index(request):

latest_question_list = Question.objects.order_by('-pub_date')[:5]

# output = ', '.join([q.question_text for q in latest_question_list])

template = loader.get_template('polls/index.html')

context = {

'latest_question_list': latest_question_list,

}

return HttpResponse(template.render(context, request))

動作確認

http://localhost:8000/pollsにアクセスすると、2つのリンクが表示される。

このHTMLのソースコードは以下のようになっている。

  <ul>
      <li><a href="/polls/2/">How&#x27;re you doing?</a></li>
      <li><a href="/polls/1/">What&#x27;s up?</a></li>
  </ul>

<ul>

<li><a href="/polls/2/">How're you doing?</a></li>

</ul>

それぞれのリンクをクリックしたときの遷移先URLとブラウザー表示は以下の通り。

href="/polls/2/"
- http://localhost:8000/polls/2/
- You’re looking at question 2.
href="/polls/1/"
- http://localhost:8000/polls/1/
- You’re looking at question 1.

renderショートカット

loaderを用いた標準形では、

テンプレートのローダーによってテンプレートファイルを読み込み、
これをレンダリングした結果をHttpResponseに渡す、

という2段階の処理となっている。Djangoにはこれを1行で済ませるrenderショートカットが準備されている。renderショートカットを使って、indexビューをより簡潔にしてみる。

from django.http import HttpResponse
#from django.template import loader
from django.shortcuts import render

from .models import Question

def index(request):
    latest_question_list = Question.objects.order_by('-pub_date')[:5]
#    template = loader.get_template('polls/index.html')
    context = {
        'latest_question_list': latest_question_list,
    }
#    return HttpResponse(template.render(context, request))
    return render(request, 'polls/index.html', context)

  ....

from django.http import HttpResponse

#from django.template import loader

from django.shortcuts import render

from .models import Question

def index(request):

latest_question_list = Question.objects.order_by('-pub_date')[:5]

# template = loader.get_template('polls/index.html')

context = {

'latest_question_list': latest_question_list,

}

# return HttpResponse(template.render(context, request))

return render(request, 'polls/index.html', context)

....

1行目のHttpResponseのインポートはまだ手を入れていない他のビュー関数のためで、renderによる処理には必要ない。loaderのインポートも不要で、必要なのは3行目のrenderのインポートのみ。

14行目がrenderショートカットを導入した効果で、この1行でリクエスト、テンプレート、contextの指定を済ませてレスポンスを返している。

render(request, 'テンプレートパス', context)

404エラーの実装

存在しないidへの反応

indexテンプレートではQuestionの2つの要素が表示され、それぞれid=1, 2をリクエストパラメーターとして渡している（href="/polls/1/"など）。ところがQuestionに存在しないidを指定したURLでアクセスすると以下のようなエラーがブラウザーに表示される。

DoesNotExist at /polls/3/
Question matching query does not exist.

1 2	DoesNotExist at /polls/3/ Question matching query does not exist.

このエラーの代わりに、404エラーで反応させたい。

例外処理による標準形

ビューの編集

現在のdetailビューは以下のような内容。

from django.http import HttpResponse
from django.shortcuts import render

  ....

def detail(request, question_id):
    return HttpResponse("You're looking at question %s." % question_id)

  ....

from django.http import HttpResponse

from django.shortcuts import render

....

def detail(request, question_id):

return HttpResponse("You're looking at question %s." % question_id)

....

存在しないインスタンスを指定すると例外が投げられるので、それをキャッチして404エラーをレイズするようにする。

from django.http import HttpResponse
from django.http import Http404
from django.shortcuts import render

from .models import Question

  ....

def detail(request, question_id):
    try:
        question = Question.objects.get(pk=question_id)
    except Question.DoesNotExist:
        raise Http404("Qustion does not exist!!")

    return render(request, 'polls/detail.html', {'question': question})

  ....

from django.http import HttpResponse

from django.http import Http404

from django.shortcuts import render

from .models import Question

....

def detail(request, question_id):

try:

question = Question.objects.get(pk=question_id)

except Question.DoesNotExist:

raise Http404("Qustion does not exist!!")

return render(request, 'polls/detail.html', {'question': question})

....

テンプレートの準備

またrenderで指定しているdetailテンプレートを、polls/template/pollsディレクトリーに以下の内容で作成しておく。

Detail: {{ question }}

1	Detail: {{ question }}

実行結果の確認

これで存在しないidの値を指定したときのエラーは以下のように変化する。メッセージがHttp404クラスのコンストラクターに与えたテキストになっている。

get_object_or_404ショートカット

Djangoには、上のような複数行の例外処理を一行で書くget_object_or_404ショートカットが準備されている。

以下のようにget_object_or_404ショートカットをインポートすると、1行でQuestionデータを取得し、存在しなければ404エラーをレイズしてくれる。

from django.http import HttpResponse
#from django.http import Http404
from django.shortcuts import render, get_object_or_404

from .models import Question

  ....

def detail(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    return render(request, 'polls/detail.html', {'question': question})

  ....

from django.http import HttpResponse

#from django.http import Http404

from django.shortcuts import render, get_object_or_404

from .models import Question

....

def detail(request, question_id):

question = get_object_or_404(Question, pk=question_id)

return render(request, 'polls/detail.html', {'question': question})

....

存在しないidを指定したときのエラー表示は以下のようになる。エラーメッセージの内容は固定されていて変更できないようだ。

なおsettings.pyのDEBUGをFalseにすると、ブラウザー表示は以下の2行のより簡素な内容になる

Not Found
The requested resource was not found on this server.

1 2	Not Found The requested resource was not found on this server.

テンプレートシステム

DTLによる記述

先ほどのindexテンプレートの内容は1行で変数を表示するだけの内容だったが、これをテンプレートらしくDTL～テンプレート言語を使って以下のように書き換える。

<h1>{{ question.question_text }}</h1>

<ul>
  {% for choice in question.choice_set.all %}
    <li>{{ choice.choice_text }}</li>
  {% endfor %}
</ul>

<h1>{{ question.question_text }}</h1>

<ul>

{% for choice in question.choice_set.all %}

<li>{{ choice.choice_text }}</li>

{% endfor %}

</ul>

そうすると大きな見出しでQuestionデータのテキストが表示され、そのQuestionデータに関連付けられたChoiceデータのテキストが箇条書きで表示される。

今回のDTLでは、オブジェクトの属性を得るのにドット検索が行われている。通常のPythonの場合リストや辞書型のオブジェクトの要素は[]で参照されるが、DTLではこの記述方法が使えない。代わりにドットを使って以下の順序で探していく

辞書型のキー
オブジェクトの属性
リストのインデックス

今回の例では、辞書型のキーで取得できず、オブジェクトの属性として取得に成功する。

URLのハードコーディング回避

ハードコーディングの問題

現時点でindexテンプレートのアンカー要素のURLは"/polls/{{ question_id }}/"と書かれている。

{% if latest_question_list %}
  <ul>
    {% for question in latest_question_list %}
      <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
    {% endfor %}
  </ul>
{% else %}
  <p>No polls are available.</p>
{% endif %}

{% if latest_question_list %}

<ul>

{% for question in latest_question_list %}

<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>

{% endfor %}

</ul>

{% else %}

<p>No polls are available.</p>

{% endif %}

この場合にリンクが張られるdetailのURLはurlsで定義されていて、たとえば以下の通り。

http://localhost/polls/1

ここでプロジェクト進行中に以下のように変更することとなったとする。

http://localhost/polls/specifics/1

この場合、indexテンプレートのアンカー要素の内容を全て以下のように変更する必要がある。

href="/polls/specifics/{{ question.id }}/"

さらにindexテンプレート以外でもこのルーティングを使っている場合、その分だけ変更が生じてしまう。

ハードコーディングの回避

urls.pyの確認

まずpolls/urls.pyのdetailビューへのルーティングにname='detail'で名前が付けられていることに留意。

from django.urls import path
from polls import views

urlpatterns = [
    path('', views.index, name='index'),
    path('<int:question_id>/', views.detail, name='detail'),
    path('<int:question_id>/results/', views.results, name='results'),
    path('<int:question_id>/vote/', views.vote, name='vote'),
]

from django.urls import path

from polls import views

urlpatterns = [

path('', views.index, name='index'),

path('<int:question_id>/', views.detail, name='detail'),

path('<int:question_id>/results/', views.results, name='results'),

path('<int:question_id>/vote/', views.vote, name='vote'),

]

ビューの変更

index/view.py中、アンカー要素のURL部分を以下のように変更する。

href="..."のURL部分を{% url %}に入れ替え
このタグの引数に、urlsのnameで指定した名前とパラメーターを書く

<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>

1	<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>

一般化した書き方は以下の通り。このとき、先頭や末尾の'/'は不要。

{% url 'urlsのnameで定義した名前' クエリーパラメーター %}

HTMLの確認

生成されるHTMLは以下の通り。

  <ul>
    
      <li><a href="/polls/2/">How&#x27;re you doing?</a></li>
    
      <li><a href="/polls/1/">What&#x27;s up?</a></li>
    
  </ul>

<ul>

<li><a href="/polls/2/">How're you doing?</a></li>

</ul>

URLの変更

URLの変更が必要な場合、1箇所だけ、urlsの内容を変更すればよい。

path('specifics/<int:question_id>/', views.detail, name='detail'),

1	path('specifics/<int:question_id>/', views.detail, name='detail'),

以下のように生成されるHTMLもすべて変更される。

  <ul>
    
      <li><a href="/polls/specifics/2/">How&#x27;re you doing?</a></li>
    
      <li><a href="/polls/specifics/1/">What&#x27;s up?</a></li>
    
  </ul>

<ul>

<li><a href="/polls/specifics/2/">How're you doing?</a></li>

</ul>

そして以下のようにアクセスできるようになる。

http://localhost:8000/polls/specifics/1/

1	http://localhost:8000/polls/specifics/1/

URLの名前空間管理

名前空間管理の必要性

DTLのurlタグで、ルーティングに付けた名前を使って抽象化することができた。ところが、先の例の場合pollsアプリケーションのdetailと同じ名前を他のアプリケーションでも使う場合、見分けがつかない。

そこで、ルート名がどのアプリケーションのものか分かるようにする必要がある。

urls.pyの編集

urls.pyに以下の1行を追加する。

from django.urls import path
from polls import views

app_name = 'polls'

urlpatterns = [
    path('', views.index, name='index'),
    path('<int:question_id>/', views.detail, name='detail'),
    path('<int:question_id>/results/', views.results, name='results'),
    path('<int:question_id>/vote/', views.vote, name='vote'),
]

from django.urls import path

from polls import views

app_name = 'polls'

urlpatterns = [

path('', views.index, name='index'),

path('<int:question_id>/', views.detail, name='detail'),

path('<int:question_id>/results/', views.results, name='results'),

path('<int:question_id>/vote/', views.vote, name='vote'),

]

indexテンプレートの編集

次にindexテンプレートの名前指定部分を、以下のように'アプリケーション名：ルート名'に変更。

{% if latest_question_list %}
  <ul>
    {% for question in latest_question_list %}
      <li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>
    {% endfor %}
  </ul>
{% else %}
  <p>No polls are available.</p>
{% endif %}

{% if latest_question_list %}

<ul>

{% for question in latest_question_list %}

<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>

{% endfor %}

</ul>

{% else %}

<p>No polls are available.</p>

{% endif %}

この場合の実行結果は変わらないが、他のアプリケーションでもdetailという名前のルーティングがある場合でも、pollsアプリケーションの同名のdetailが識別される。

urlsにapp_nameが定義されている状態でurlタグでpolls:を書かないと以下のエラーになる。

NoReverseMatch at /polls/
Reverse for 'detail' not found. 'detail' is not a valid view function or pattern name.

1 2	NoReverseMatch at /polls/ Reverse for 'detail' not found. 'detail' is not a valid view function or pattern name.

Django – Tutorial – ビューでの処理

2022-03-24 / tau / コメントする

概要

DjangoドキュメントのチュートリアルPart3中”Write views that actually do something“では、それまで単に文字列だけを返してブラウザーに表示させていたビュー関数に、ビューでの処理を記述している。そこではデータベースのデータを使った処理を例にしている。

チュートリアルではこれに続いてテンプレートの扱い方を示しているが、ここではモデル操作の実装だけを取り出して整理する。

index関数の編集

チュートリアルで示されているindex関数の編集内容は以下の通り。polls.models.Questionをインポートしていることに注意。

from django.http import HttpResponse

from .models import Question

def index(request):
    latest_question_list = Question.objects.order_by('-pub_date')[:5]
    output = ', '.join([q.question_text for q in latest_question_list])
    return HttpResponse(output)

  ....

from django.http import HttpResponse

from .models import Question

def index(request):

latest_question_list = Question.objects.order_by('-pub_date')[:5]

output = ', '.join([q.question_text for q in latest_question_list])

return HttpResponse(output)

....

http://localhost:8000/polls/にアクセスすると、questionsテーブルに登録されているデータが日時の新しい順に、カンマで区切られて表示される。

チュートリアルではデータが1つしか登録されていなくて分かりづらいので、もう一つデータを登録してみる。

How're you doing?, What's up?

1	How're you doing?, What's up?

コードの内容

モデルインスタンスのソートと抽出

latest_question_list = Question.objects.order_by('-pub_date')[:5]

1	latest_question_list = Question.objects.order_by('-pub_date')[:5]

Questionモデルの全てのインスタンスをpub_dateフィールドの降順に並べ替えて先頭から5個取出し、そのQuerySetインスタンスをlatest_question_listに参照させている。

モデル.objects.order_by()でモデルのデータをソートした結果をQuerySetとして返す
'-pub_date'で降順にソート／昇順の場合は'pub_date'
[:5]はコレクションのスライスで、先頭から5個のデータ(インデックスが5未満のデータ)を取り出す

シェルで実行してみると以下の通り。

>>> latest_question_list = Question.objects.order_by('-pub_date')[:5]
>>> latest_question_list
<QuerySet [<Question: How're you doing?>, <Question: What's up?>]>

>>> latest_question_list = Question.objects.order_by('-pub_date')[:5]

>>> latest_question_list

引数を'pub_date'に変更すると並べ替え順序が昇順になり、古いデータから並べられたセットが得られる。

>>> latest_question_list = Question.objects.order_by('pub_date')[:5]
>>> latest_question_list
<QuerySet [<Question: What's up?>, <Question: How're you doing?>]>

>>> latest_question_list = Question.objects.order_by('pub_date')[:5]

>>> latest_question_list

またスライスを[:1]にすると、インデックスが0の要素だけが得られる。

>>> latest_question_list = Question.objects.order_by('-pub_date')[:1]
>>> latest_question_list
<QuerySet [<Question: How're you doing?>]>

>>> latest_question_list = Question.objects.order_by('-pub_date')[:1]

>>> latest_question_list

出力文字列の構成

output = ', '.join([q.question_text for q in latest_question_list])

1	output = ', '.join([q.question_text for q in latest_question_list])

latest_question_listの各要素を', 'をデリミターとして結合している。各要素はQuestionモデルのインスタンスだが、__str__メソッドが実装されているので、参照するとquestion_textの内容が得られる。

Django – Tutorial – ビューへのルーティング

2022-03-24 / tau / コメントする

概要

DjangoドキュメントのチュートリアルPart3では、ビューへのルーティングやテンプレートの使い方などが詳しく書かれているが、このうちURLconf～ルーティングの部分を整理する。

urls.pyの配置や書き方についてはこちら。

view関数の定義

まず、polls/views.pyファイルに3つのview関数(detail, results, vote)を追加する。

from django.shortcuts import render
from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

def detail(request, question_id):
    return HttpResponse("You're looking at question %s." % question_id)

def results(request, question_id):
    response = "You're looking at the results of question %s."
    return HttpResponse(response % question_id)

def vote(request, question_id):
    return HttpResponse("You're voting on question %s." % question_id)

from django.shortcuts import render

from django.http import HttpResponse

def index(request):

return HttpResponse("Hello, world. You're at the polls index.")

def detail(request, question_id):

return HttpResponse("You're looking at question %s." % question_id)

def results(request, question_id):

response = "You're looking at the results of question %s."

return HttpResponse(response % question_id)

def vote(request, question_id):

return HttpResponse("You're voting on question %s." % question_id)

いずれのビューでも動作の本質は同じ。

リクエストからパラメーターをquestion_idとして受け取る
各ビューで想定している処理の内容に即したテキストをHttpResponseで返す
その際、question_idの値もテキストに含めて返す

なおテキストにquestion_idの内容を文字列として含めるために、Pythonの構文を使っている。

"... %s ..." % 変数

urls.pyの設定

追加したview関数をこれに対応したURLリクエストから呼び出すため、ルーティングを追加する。

いずれのルーティングもpollsアプリケーションのビューに関するものなので、最初に作成したpolls/urls.pyに追記する。

from django.urls import path
from polls import views

urlpatterns = [
    path('', views.index, name='index'),
    path('<int:question_id>/', views.detail, name='detail'),
    path('<int:question_id>/results/', views.results, name='results'),
    path('<int:question_id>/vote/', views.vote, name='vote'),
]

from django.urls import path

from polls import views

urlpatterns = [

path('', views.index, name='index'),

path('<int:question_id>/', views.detail, name='detail'),

path('<int:question_id>/results/', views.results, name='results'),

path('<int:question_id>/vote/', views.vote, name='vote'),

]

確認

サーバー起動状態で各URLを入力したとき、呼ばれるview関数とブラウザー上の文字列は以下のとおり。

http://localhost:8000/polls/34/
→views.detail
→You’re looking at question 34.
http://localhost:8000/polls/34/results/
→views.results
→You’re looking at the results of question 34.
http://localhost:8000/polls/34/vote
→views.vote
→You’re voting on question 34.

URLconf～ルーティングの仕組み

たとえばhttp://ドメイン名/polls/34/というURLでリクエストがあった時、Djangoは以下のように解釈を始める。

settings.pyのROOT_URLCONFの設定に従って、config.urlsモジュールを読み込む（モジュールファイルはconfig/urls.py）
urlsモジュール中のurl_patterns配列から、パターンを1つずつ順に走査していく
URLパターンが'polls/'パターンまでマッチした時、それ以前のパターンを取り除いて、polls.urlsモジュールを読み込む
polls.urlsモジュールでURLパターンの'<int:question_id>/'パターンまでマッチしてその後がないとき、これに対応するviews.detailモジュールを呼び出す
detailモジュールでは<int:queston_id>の内容が引数のquestion_idに渡され、ビュー内での処理に使われる

なおsettings.pyのROOT_URLCONFはデフォルトで以下のように書かれていて、まずconfig.urlsが読み込まれるようになっている。

ROOT_URLCONF = 'config.urls'

1	ROOT_URLCONF = 'config.urls'

またconfig.urlsは、チュートリアルの最初の方で以下のように編集済み。

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('polls/', include('polls.urls'))
]

from django.contrib import admin

from django.urls import path, include

urlpatterns = [

path('admin/', admin.site.urls),

path('polls/', include('polls.urls'))

]

またパラメーターについては<int:question_id>と定義されているので、localhost:8000/polls/abc/のようにパラメーターが整数として解釈されない場合にはパスが見つからず、Page not foundエラーになる。

Django-Tutorial-pollsアプリケーション

2022-03-21 / tau / コメントする

概要

Djangoドキュメントのチュートリアルに従って、mysiteプロジェクトを作成し、その中にpollsアプリケーションを作成する。

プロジェクトの作成

プロジェクトの作成はdjango-adminで実行する。チュートリアルのプロジェクト構成ではmysiteディレクトリーの下にmysiteサブディレクトリーとしているが、ここではmysite/configという構成にした。

$ mkdir mysite && cd mysite
$ django-admin startproject config .

1 2	$ mkdir mysite && cd mysite $ django-admin startproject config .

ディレクトリー構成は以下のようになっている。

$ tree mysite/
mysite/
├── config
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── manage.py

$ tree mysite/

mysite/

├── config

│ ├── __init__.py

│ ├── asgi.py

│ ├── settings.py

│ ├── urls.py

│ └── wsgi.py

└── manage.py

settings.pyを以下のように編集する（初期設定の詳細はこちら）。

ローカルサーバーでの開発のため、ALLOWED_HOSTSに'localhost'を設定
DATABASESはMySQL用に設定
その他、言語コードやタイムゾーンの設定

  ....

ALLOWED_HOSTS = ['localhost']

  ....

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'django_tutorial',
        'USER': 'root',
        'PASSWORD': '********',
    }
}

  ....

LANGUAGE_CODE = 'ja'

TIME_ZONE = 'Asia/Tokyo'

  ....

....

ALLOWED_HOSTS = ['localhost']

....

DATABASES = {

'default': {

'ENGINE': 'django.db.backends.mysql',

'NAME': 'django_tutorial',

'USER': 'root',

'PASSWORD': '********',

}

....

LANGUAGE_CODE = 'ja'

TIME_ZONE = 'Asia/Tokyo'

....

開発用サーバーを起動して、"Congratulations!"の画面を確認。

pollsアプリケーションの作成

startappコマンドでpollsアプリケーションを作成。

$ python3 manage.py startapp polls

1	$ python3 manage.py startapp polls

manage.pyは実行可能ファイルなので、以下でも作成できる。

$ ./manage.py startapp polls

1	$ ./manage.py startapp polls

pollsアプリケーション作成後の構成は以下の通り。

$ tree mysite/
mysite/
├── config
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── manage.py
└── polls
     ├── __init__.py
     ├── admin.py　　→管理者関係の設定ファイル
     ├── apps.py 　　→アプリケーション構成クラス定義(PollsConfig)
     ├── migrations　→マイグレーションファイル保存ディレクトリー
     │   └── __init__.py
     ├── models.py 　→モデルクラス定義
     ├── tests.py　　→テスト用設定ファイル
     ├── urls.py 　　→URL conf：ルーティング
     └── views.py　　→view関数定義ファイル

$ tree mysite/

mysite/

├── config

│ ├── __init__.py

│ ├── asgi.py

│ ├── settings.py

│ ├── urls.py

│ └── wsgi.py

├── manage.py

└── polls

├── __init__.py

├── admin.py　　→管理者関係の設定ファイル

├── apps.py 　　→アプリケーション構成クラス定義(PollsConfig)

├── migrations　→マイグレーションファイル保存ディレクトリー

│ └── __init__.py

├── models.py 　→モデルクラス定義

├── tests.py　　→テスト用設定ファイル

├── urls.py 　　→URL conf：ルーティング

└── views.py　　→view関数定義ファイル

view関数の定義

view関数はMTVの構成要素の一つで、URLからルーティングされ、モデルのデータ操作やブラウザー表示のための様々な処理を実装するもの。MVCモデルのコントローラーに相当する。

一般的にはview関数の戻り値にはブラウザー表示のためのテンプレートを渡すが、ここでは最も単純に、単に文字列だけを返すようにする。

HttpResponseモジュールをインポート
view関数index()を定義
HttpResponseのコンストラクターの引数に文字列を渡し、そのインスタンスを戻り値とする

from django.shortcuts import render
from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

from django.shortcuts import render

from django.http import HttpResponse

def index(request):

return HttpResponse("Hello, world. You're at the polls index.")

URL conf～ルーティング

URLからview関数index()へのルーティングを設定する。pollsアプリケーションのビューなのでpolls/urls.pyで定義する。アプリケーションのurls.pyはデフォルトでは作成されないので、新たに作成して次の内容とする。

from django.urls import path
from polls import views

urlpatterns = [
    path('', views.index, name='index')
]

from django.urls import path

from polls import views

urlpatterns = [

path('', views.index, name='index')

]

pollsアプリケーションのurlsモジュールをプロジェクトに認識させるため、conf/urls.pyに記述を追加する。

django.urlsパッケージのincludeモジュールを追加でインポート
path関数でアプリケーションのurls関数をインポートし、アプリケーションのURLに紐づけ

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('polls/', include('polls.urls'))
]

from django.contrib import admin

from django.urls import path, include

urlpatterns = [

path('admin/', admin.site.urls),

path('polls/', include('polls.urls'))

]

確認

サーバーが起動した状態で、サブディレクトリーpolls/にアクセスする。今の構成ではlocalhost:8000/polls。

ブラウザーの画面には、以下のテキストが表示される。

Hello, world. You're at the polls index.

1	Hello, world. You're at the polls index.

Django – Tutorial – admin

2022-03-21 / tau / コメントする

概要

Djangoのチュートリアル、管理者ページの部分を整理。

管理者ログインページ

Djangoのデフォルトの状態で、既に管理者の環境が準備されている。サーバーを起動してadmin/サブディレクトリーでアクセスすると、以下のような管理者ログイン画面が表示される。

管理者の作成

createsuperuserコマンドで管理者を作成する。

$ ./manage.py createsuperuser

1	$ ./manage.py createsuperuser

管理者のユーザー名、メールアドレス、パスワードを登録し、管理者アカウント作成。プロンプトの一部が日本語になっている。

(django32) mysite:$ ./manage.py createsuperuser
ユーザー名 (leave blank to use 'vagrant'): admin
メールアドレス: admin@mail.com
Password:
Password (again):
このパスワードは ユーザー名 と似すぎています。
Bypass password validation and create user anyway? [y/N]: y
Superuser created successfully.

(django32) mysite:$ ./manage.py createsuperuser

ユーザー名 (leave blank to use 'vagrant'): admin

メールアドレス: admin@mail.com

Password:

Password (again):

このパスワードはユーザー名と似すぎています。

Bypass password validation and create user anyway? [y/N]: y

Superuser created successfully.

パスワードを'admin'という文字列を含むかなり簡単なものにしたため「ユーザー名と似すぎています」という警告が出たが、ここはyesにしておいた。

管理者ログイン・インデックスページ表示

作成した管理者アカウントでログインすると管理者インデックスページへ。この段階では、pollsアプリケーションが管理者で操作できるようにはなっていない。

管理者へのアプリケーションの登録

管理者がpollsアプリケーションを操作できるようにするために、polls/admin.pyに記述を追加する。

Qustionモデルのインポート
adminサイトにQuestionモデルを登録

admin.pyがpollsパッケージ内にあるのでfrom .models ...としているが、from polls.models ...でもよい。

from django.contrib import admin
from .models import Question

admin.site.register(Question)

from django.contrib import admin

from .models import Question

admin.site.register(Question)

インデックスページを再表示させると、今度はQuestionsが見られるようになった。

データの内容表示

インデックスページのQustionsをクリックすると、登録済みデータが表示される。What’s up?と表示されているのは、models.pyのQuestionクラスで__str__メソッドを定義したおかげで、デフォルトの状態だとQuestion object (1)と表示される。

What’s upをクリックすると、フィールド内容の編集画面に移る。

フィールド名のQustion textとDate publishedは、models.pyのQuestionクラスで定義したフィールド名になっている。

Question textは、クラス定義のプロパティーquestion_textのアンダースコアがスペースに、先頭が大文字に変換されたもの
Date publishedはDateTimeFieldの引数に指定した'date published'の先頭が大文字に変換されたもの

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

    ....

class Question(models.Model):

question_text = models.CharField(max_length=200)

pub_date = models.DateTimeField('date published')

....

たとえば上記の3行目をDateTimeField()とすると、画面表示は元のプロパティー名に即してPub dateとなる。

データの編集

Qustion textとDate publishedの内容を変更して「保存して編集を続ける」ボタンを押すと、変更した内容が反映される。

もちろんデータベース上でも変更されている。

mysql> select* from questions;
+----+---------------+----------------------------+
| id | question_text | pub_date                   |
+----+---------------+----------------------------+
|  1 | What's up??   | 2022-03-20 09:36:26.000000 |
+----+---------------+----------------------------+
1 row in set (0.00 sec)

mysql> select* from questions;

+----+---------------+----------------------------+

| id | question_text | pub_date |

+----+---------------+----------------------------+

| 1 | What's up?? | 2022-03-20 09:36:26.000000 |

+----+---------------+----------------------------+

1 row in set (0.00 sec)

変更履歴

画面右上の「履歴」ボタンを押すと変更履歴画面に移り、Question textとDate publishedが変更された履歴が表示される。

Django Tutorial – Pythonシェル

2022-03-20 / tau / コメントする

概要

Pythonシェルの環境下でモデル操作をしてみる。Pythonドキュメントのチュートリアルの流れに沿っている。Laravelのtinkerでの操作と似ている。

シェルの起動・終了

シェルの起動はmanage.pyのshellコマンド。終了はexit()。

$ ./manage.py shell
Python 3.6.8 (default, Nov 16 2020, 16:55:22)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> exit()
$

$ ./manage.py shell

Python 3.6.8 (default, Nov 16 2020, 16:55:22)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux

Type "help", "copyright", "credits" or "license" for more information.

(InteractiveConsole)

>>> exit()

モデルの操作

準備・確認

モデル操作の開始時にモデルのインポートが必要。

from アプリケーション.models import モデルクラス

>>> from polls.models import Choice, Question

1	>>> from polls.models import Choice, Question

タイムゾーン表示のためにtimezoneオブジェクトをインポート。

>>> from django.utils import timezone

1	>>> from django.utils import timezone

timezone.now()で現在時刻を表示してみる。内部的にはUTCで扱われているので、その時点の日本時間とは9時間ずれている。

>>> timezone.now()
datetime.datetime(2022, 3, 18, 8, 52, 16, 897846, tzinfo=<UTC>)

1 2	>>> timezone.now() datetime.datetime(2022, 3, 18, 8, 52, 16, 897846, tzinfo=<UTC>)

モデルの全データの取得。まだデータは登録されていない。

>>> Question.objects.all()
<QuerySet []>

1 2	>>> Question.objects.all() <QuerySet []>

データの作成・保存・編集

作成

Questionモデルのコンストラクターでデータを作成。この段階ではメモリー上に作成されただけで、データベースには保存されていない。

>>> q = Question(question_text="What's new?", pub_date=timezone.now())

1	>>> q = Question(question_text="What's new?", pub_date=timezone.now())

pprintとvarsでデータの内容を確認してみる。

>>> import pprint
>>> pprint.pprint(vars(q))
{'_state': <django.db.models.base.ModelState object at 0x7f423cecf048>,
 'id': None,
 'pub_date': datetime.datetime(2022, 3, 18, 8, 53, 29, 990021, tzinfo=<UTC>),
 'question_text': "What's new?"}

>>> import pprint

>>> pprint.pprint(vars(q))

{'_state': <django.db.models.base.ModelState object at 0x7f423cecf048>,

'id': None,

'pub_date': datetime.datetime(2022, 3, 18, 8, 53, 29, 990021, tzinfo=<UTC>),

'question_text': "What's new?"}

各フィールドを見てみる。まだデータベースに登録されていないので、idは空になっている。

>>> q.id
>>> q.question_text
"What's new?"
>>> q.pub_date
datetime.datetime(2022, 3, 18, 8, 53, 29, 990021, tzinfo=<UTC>)

>>> q.id

>>> q.question_text

"What's new?"

>>> q.pub_date

datetime.datetime(2022, 3, 18, 8, 53, 29, 990021, tzinfo=<UTC>)

保存

save()メソッドでデータベースに保存。

>>> q.save()

1	>>> q.save()

MySQLでテーブルへの保存を確認。

mysql> select * from questions;
+----+---------------+----------------------------+
| id | question_text | pub_date                   |
+----+---------------+----------------------------+
|  1 | What's new?   | 2022-03-18 08:53:29.990021 |
+----+---------------+----------------------------+
1 row in set (0.00 sec)

mysql> select * from questions;

+----+---------------+----------------------------+

| id | question_text | pub_date |

+----+---------------+----------------------------+

| 1 | What's new? | 2022-03-18 08:53:29.990021 |

+----+---------------+----------------------------+

1 row in set (0.00 sec)

データベースに保存されたのでidがセットされた。

>>> q.id
1

1 2	>>> q.id 1

編集

データのquestion_textの内容を書き替えてデータベースに保存。

>>> q.question_text="What's up?"
>>> q.save()

1 2	>>> q.question_text="What's up?" >>> q.save()

データベースを確認して内容が変更されていることを確認。

mysql> select * from questions;
+----+---------------+----------------------------+
| id | question_text | pub_date                   |
+----+---------------+----------------------------+
|  1 | What's up?    | 2022-03-18 08:53:29.990021 |
+----+---------------+----------------------------+
1 row in set (0.00 sec)

mysql> select * from questions;

+----+---------------+----------------------------+

| id | question_text | pub_date |

+----+---------------+----------------------------+

| 1 | What's up? | 2022-03-18 08:53:29.990021 |

+----+---------------+----------------------------+

1 row in set (0.00 sec)

データの取得

Managerオブジェクト

個別のモデルごとにManagerクラスのインスタンスが生成され、モデルのobjectsメンバーとして準備される。データの取得やフィルタリングなど操作は、このインスタンスのメソッドによって行われる。

モデル.objects

all()による全データの読み込み

all()メソッドによってテーブルに登録された全データを読み込める。

モデルクラス.objects.all()

Qustionには1つだけデータが登録されている。

>>> Question.objects.all()
<QuerySet [<Question: Question object (1)>]>

1 2	>>> Question.objects.all() <QuerySet [<Question: Question object (1)>]>

strの定義

データ表示が殺風景なオブジェクトの表示になっているが、これを変更してquestion_textやchoice_textを表示させるようにする。具体的には各モデルに__str__メソッドを定義する。

from django.db import models

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

    def __str__(self):
        return self.question_text
py
    class Meta:
        db_table = 'questions'

class Choice(models.Model):
    question = models.ForeignKey(Question, on_delete=models.CASCADE)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

    def __str_(self):
        return self.choice_text

    class Meta:
        db_table = 'choices'

from django.db import models

class Question(models.Model):

question_text = models.CharField(max_length=200)

pub_date = models.DateTimeField('date published')

def __str__(self):

return self.question_text

class Meta:

db_table = 'questions'

class Choice(models.Model):

question = models.ForeignKey(Question, on_delete=models.CASCADE)

choice_text = models.CharField(max_length=200)

votes = models.IntegerField(default=0)

def __str_(self):

return self.choice_text

class Meta:

db_table = 'choices'

これでデータ内容の表示がわかりやすくなった。

>>> Question.objects.all()
<QuerySet [<Question: What's up?>]>

1 2	>>> Question.objects.all() <QuerySet [<Question: What's up?>]>

get()による1つのデータの抽出

get()メソッドで条件を指定してデータを1つ取り出せる。

モデルクラス.objects.get(条件)

idが1のデータを取り出す。

>>> Question.objects.get(id=1)
<Question: What's up?>

1 2	>>> Question.objects.get(id=1) <Question: What's up?>

該当するデータがない場合はModel.DoesNotExist例外、複数のデータが存在する場合はModelMultipuleObjectsReturned例外。以下はDoesNotExistの例。

>>> Question.objects.get(id=2)
Traceback (most recent call last):
  ....
polls.models.Question.DoesNotExist: Question matching query does not exist.

>>> Question.objects.get(id=2)

Traceback (most recent call last):

....

polls.models.Question.DoesNotExist: Question matching query does not exist.

主キー(primary key)を指定してでも取り出せる。Djangoではprimary keyのショートカットとしてpkが準備されている。

>>> Question.objects.get(pk=1)
<Question: What's up?>

1 2	>>> Question.objects.get(pk=1) <Question: What's up?>

フィルターによる抽出

filter()メソッドでデータを抽出できる

モデルクラス.objects.filter(条件)

以下はid=1の条件で抽出した結果で、今回の例の場合はデータを1つ含むQuerySetが得られる。

>>> Question.objects.filter(id=1)
<QuerySet [<Question: What's up?>]>

1 2	>>> Question.objects.filter(id=1) <QuerySet [<Question: What's up?>]>

存在しないidで抽出すると空のQuerySetが得られる。

>>> Question.objects.filter(id=2)
<QuerySet []>

1 2	>>> Question.objects.filter(id=2) <QuerySet []>

文字列の前方一致の抽出例。引数のフィールドにアンダースコアを2つ(‘__‘)連ねて様々な条件を指定できる。フィルターの条件の書き方はこちらに整理した。

フィールド__条件=値

ここではフィールド__startswith='文字列'として、フィールドが指定した文字列で始まるデータを抽出している。

>>> Question.objects.filter(question_text__startswith='What')
<QuerySet [<Question: What's up?>]>

1 2	>>> Question.objects.filter(question_text__startswith='What') <QuerySet [<Question: What's up?>]>

登録の年が同じデータを抽出する例。まず現在日時の年を取り出して変数current_yearにセットして、pub_dateの年がこれに等しいデータをフィルタリング。datetime型のフィールドの年の条件でフィルタリングするにはフィールド名__year=年とする。__yearのアンダースコアは2つ。

>>> current_year = timezone.now().year
>>> Question.objects.filter(pub_date__year=current_year)
<QuerySet [<Question: What's up?>]>

>>> current_year = timezone.now().year

>>> Question.objects.filter(pub_date__year=current_year)

リレーションがあるモデル

親データに属する子データ群

親データに属する(これを参照している)データのManagerオブジェクトを取り出すには以下のように書く。

親データ.小文字の子モデル名_set

たとえば変数qが Questionモデルのid=1のデータを指している状態で、これに属するChoiceデータ群の全てを取り出すと以下のようになる。まだChoiceデータを1つも登録していないので結果は空。

>>> q.choice_set.all()
<QuerySet []>

1 2	>>> q.choice_set.all() <QuerySet []>

親データに属する子データの作成

親データに関連付けられた子データを新たに作成するときは以下のように書く。

親データ.小文字の子モデル名_set.create(...)

qに関連付けられたChoiceデータを3つ登録。

>>> q.choice_set.create(choice_text='Not much', votes=0)
<Choice: Not much>
>>> q.choice_set.create(choice_text='The sky', votes=0)
<Choice: The sky>
>>> q.choice_set.create(choice_text='Just hacking again')
<Choice: Just hacking again>

>>> q.choice_set.create(choice_text='Not much', votes=0)

<Choice: Not much>

>>> q.choice_set.create(choice_text='The sky', votes=0)

<Choice: The sky>

>>> q.choice_set.create(choice_text='Just hacking again')

<Choice: Just hacking again>

MySQLでテーブルの内容を確認すると、Questionテーブルのid=1のデータを参照する3つのデータが登録されている。

mysql> select * from choices;
+----+--------------------+-------+-------------+
| id | choice_text        | votes | question_id |
+----+--------------------+-------+-------------+
|  1 | Not much           |     0 |           1 |
|  2 | The sky            |     0 |           1 |
|  3 | Just hacking again |     0 |           1 |
+----+--------------------+-------+-------------+
3 rows in set (0.00 sec)

mysql> select * from choices;

+----+--------------------+-------+-------------+

+----+--------------------+-------+-------------+

| 1 | Not much | 0 | 1 |

| 2 | The sky | 0 | 1 |

| 3 | Just hacking again | 0 | 1 |

+----+--------------------+-------+-------------+

3 rows in set (0.00 sec)

＜閑話休題＞
“What’s up?”はくだけた言い方の挨拶で「調子はどう？」、「何か(変わりは)あったかい？」といった感じ。”Not much.”は「普通だよ」とか「特にないね」といった常套句のようだ。”The sky.”はupにひっかけて「(上は)空さ」というジョーク表現（無理やり日本語字幕にするなら「何かあったかい？」「暖かいね」とかなどと考えたが単なる駄洒落か・・・）。”Just hacking again.”はよくわからなかった。

子データのall/count/filter

登録されたデータをallメソッドで取り出してみる。

>>> q.choice_set.all()
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

1 2	>>> q.choice_set.all() <QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

データの個数はcountメソッドで。

>>> q.choice_set.count()
3

1 2	>>> q.choice_set.count() 3

子データ群のフィルタリングは通常と同じように指定。

>>> q.choice_set.filter(choice_text__startswith='Not')
<QuerySet [<Choice: Not much>]>
>>> q.choice_set.filter(votes=0)
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

>>> q.choice_set.filter(choice_text__startswith='Not')

>>> q.choice_set.filter(votes=0)

親データの条件によるフィルタリング

親データの条件でフィルタリングする場合、filter()の中で小文字の親モデル名を使うが、直接以下のように書くとエラーになる。

filter(小文字の親モデル名_フィールド__条件)→エラー

以下の例では、Choiceの親データquestionのquestion_textフィールドの条件でフィルタリング仕様としてエラーになっている。

>>> q.choice_set.filter(question_question_text__startswith='What')
Traceback (most recent call last):
  ....
django.core.exceptions.FieldError: Cannot resolve keyword 'question_question_text' into field.
Choices are: choice_text, id, question, question_id, votes

>>> q.choice_set.filter(question_question_text__startswith='What')

Traceback (most recent call last):

....

django.core.exceptions.FieldError: Cannot resolve keyword 'question_question_text' into field.

Choices are: choice_text, id, question, question_id, votes

親データのフィールドの条件の場合、親データとフィールドの間のアンダーラインを2つにする。

親データ.子データ_set.filter(親データ__フィールド__条件)

たとえばQuestionとChoiceの場合は以下のようになる。

q.choice_set.filter(question__フィールド__条件)

以下はテキストが'What'で始まる親データに属する子データを抽出している。

>>> q.choice_set.filter(question__question_text__startswith='What')
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

1 2	>>> q.choice_set.filter(question__question_text__startswith='What') <QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

以下は登録年が今年の親データに属する子データを抽出している。

>>> q.choice_set.filter(question__pub_date__year=current_year)
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

1 2	>>> q.choice_set.filter(question__pub_date__year=current_year) <QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

データの削除

まずテキストに'huck'(大文字小文字を問わない)を含むchoiceデータをデータベースから得る。

>>> c = q.choice_set.get(choice_text__icontains='hack')
>>> pprint.pprint(vars(c))
{'_state': <django.db.models.base.ModelState object at 0x7efcb4a041d0>,
 'choice_text': 'Just hacking again',
 'id': 3,
 'question_id': 1,
 'votes': 0}

>>> c = q.choice_set.get(choice_text__icontains='hack')

>>> pprint.pprint(vars(c))

{'_state': <django.db.models.base.ModelState object at 0x7efcb4a041d0>,

'choice_text': 'Just hacking again',

'id': 3,

'question_id': 1,

'votes': 0}

そのデータをdeleteメソッドでデータベースから削除。

モデル.delete()

>>> c.delete()
(1, {'polls.Choice': 1})

1 2	>>> c.delete() (1, {'polls.Choice': 1})

MySQLで削除されていることを確認。

mysql> select * from choices;
+----+-------------+-------+-------------+
| id | choice_text | votes | question_id |
+----+-------------+-------+-------------+
|  1 | Not much    |     0 |           1 |
|  2 | The sky     |     0 |           1 |
+----+-------------+-------+-------------+
2 rows in set (0.00 sec)

mysql> select * from choices;

+----+-------------+-------+-------------+

+----+-------------+-------+-------------+

| 1 | Not much | 0 | 1 |

| 2 | The sky | 0 | 1 |

+----+-------------+-------+-------------+

2 rows in set (0.00 sec)

Django – filterの条件

2022-03-19 / tau / コメントする

一致

Case Sensitive

`BINARY field=値` `field=BINARY 値`	`field=値`
	`field__exact=値`

Case Insensitive

field=値 field__iexact=値

大小比較

`field>値`	`field__gt=値`
`field>=値`	`field__gte=値`
`field<値`	`field__lt=値`
`field<=値`	`field__lte=値`

部分一致～LIKE

Case Sensitive

`field LIKE BINARY 'text%'`	`field__startswith='text'`
`field LIKE BINARY '%text'`	`field__endswith='text'`
`field LIKE BINARY '%text%'`	`field__contains='text'`

Case Insensitive

`field LIKE 'text%'`	`field__istartswith='text'`
`field LIKE '%text'`	`field__iendswith='text'`
`field LIKE '%text%'`	`field__icontains='text'`

何れかに一致～IN

field IN (...) field__in=[...]

範囲～BETWEEN

field BETWEEN min AND max field__range=[min, max]

日付の年・月・日の一致

`DATE_FORMAT(date, '%Y') = 'year'`	`date__year=year`
`DATE_FORMAT(date, '%m') = 'month'`	`date__month=month`
`DATE_FORMAT(date, '%d') = 'day'`	`date__day=day`

NULLとの比較

`field IS NULL`	`field__isnull=True`
`field IS NOT NULL`	`field__isnull=False`