[Django] 장고 Views를 활용한 HTTP 요청 처리 - 1
카테고리: Django
다양한 응답의 함수 기반 뷰 - 1
View
1개의 HTTP 요청에 대해 -> 1개의 뷰가 호출
urls.py/urlpatterns 리스트에 매핑된 호출 가능한 객체
- 함수도
호출 가능한 객체중의 하나
웹 클라이언트로부터의 HTTP 요청을 처리
크게 2가지 형태의 뷰
- 함수 기반 뷰(Function Based View) : 장고 뷰의
기본
–호출 가능한 객체, 그 자체 - 클래스 기반 뷰(Class Based View)
– 클래스.as_view()를 통해호출가능한 객체를 생성/리턴
View 호출 시, 인자
- HttpRequest 객체 및 URL Captured Values
1번째 인자 : HttpRequest 객체
- 현재 요청에 대한 모든 내역을 담고 있다.
2번째~ 인자 : 현재 요청의 URL로부터 Capture된 문자열들
- url/re_path를 통한 처리에서는 -> 모든 인자는 str 타입으로 전달
- path를 통한 처리에서는 -> 매핑된 Converter의 to_python에 맞게 변환된 값이 인자로 전달
View 호출에 대한 리턴값
- HttpResponse 객체
필히 HttpResponse 객체를 리턴해야 한다.
- 장고 Middleware에서는 뷰에서 HttpResponse 객체를 리턴하기를 기대 -> 다른 타입을 리턴하면 Middleware에서 처리 오류
- django.shortcuts.render 함수는 템플릿 응답을 위한 shortcuts 함수
파일like 객체 혹은 str/bytes 타입의 응답 지원
- str 문자열을 직접 utf8로 인코딩할 필요가 없다.
– 장고 디폴트 설정에서 str 문자열을 utf8로 인코딩 - response = HttpResponse(파일 like 객체 또는 str 객체 또는 bytes 객체)
파일 like 객체
- response.write(str 객체 또는 bytes 객체)
HttpRequest와 HttpRespnse 예시
from django.db import HttpRequest, HttpResponse
def index(request: HttpRequest) -> HttpResponse # View 함수
# 주요 request 속성
request.method # 'GET', 'POST', etc.
request.META
request.GET, request.POST, request.FILES, request.body
content = ```
<html>...</html>
``` # 문자열 혹은 이미지, 각종 파일 등
response = HttpResponse(content)
response.write(content) # response -> file-like object
response['Cutom-Header'] = 'Custom Header Value'
return response
FBV의 예
- Item 목록 보기
# myapp/views.py
from django.shortcuts import render
from shop.models import Item
def item_list(request):
qs = Item.objects.all()
return render(request, 'shop/item_list.html', {
'item_list': qs,
})
# myapp/urls.py
from django.urls import path
urlpatterns = [
path('item/', item_list, name='item_list'),
]
CBV의 예
- Item 목록 보기
# 방법 1
from django.view.generic import ListView
from shop.models import Item
item_list = ListView.as_view(model=Item)
from django.urls import path
urlpatterns = [
path('items/', item_list, name='item_list')
]
# 방법 2
from django.views.generic import ListView
from shop.models import Item
class ItemListView(ListView):
model = Item
item_list = ItemListView.as_view()
from django.urls import path
urlpatterns = [
path('item/', item_list, name='item_list'),
]
다양한 응답의 함수 기반 뷰 - 2
Excel 파일 다운로드 응답
from django.http import HttpResponse
from urllib.parse import quote
def response_excel(request):
filepath = '/other/path/excel.xls'
filename = os.path.basename(filepath)
with open(filepath, 'rb') as f:
response = HttpResponse(f, content_type="application/vnd.ms-excel")
# 브라우저에 따라 다른 처리가 필요
encoded_filename = quote(filename)
response['Content-Disposition'] = "attachment; filename+=utf-8''{}".format(encoded_filename)
return response
Pandas를 통한 CSV 응답 생성
import pandas as pd
from io import StringIO
from django.http import HttpResponse
def response_csv(request):
df = pd.DataFrame([
[100, 110, 120],
[200, 210, 220],
[300, 310, 320],
])
io = StringIO()
df.to_csv(io)
io.seek() # 끝에 있는 file cursoe를 처음으로 이동
response = HttpResponse(io, contend_type='text/csv')
response['Content-Disposition'] = "attachment; filename+=utf-8''{}".format(encoded_filename)
return response
Pandas를 통한 엑셀 응답 생성
import pandas as pd
from io import BytesIO
from urllib.parse import quote
from django.http import HttpResponse
def response_excel(request):
df = pd.DataFrame([
[100, 110, 120],
[200, 210, 220],
])
io = BytesIO()
df.to_excel(io)
io.seek(0)
encoded_filename = quote('pandas.xlsx')
response = HttpResponse(io, contend_type='application/vnd.ms-excel')
response['Content-Disposition'] = "attachment; filename+=utf-8''{}".format(encoded_filename)
return response
Pollow를 통한 이미지 응답 생성 - 기본
import requests
from io import BytesIO
from PIL import Image, ImageDraw, ImageFont
ttf_path = 'C:/Windows/Fonts/malgun.ttf' # 윈도우의 맑은고딕 폰트 경로
image_url = 'http://www.flowermeaning.com/flower-pics/Calla-Lily-Meaning.jpg'
res = requests.get(image_url) # 서버로 HTTP GET 요청하여, 응답 획득
io = BytesIO(res.content) # 응답의 Raw Body, 메모리 파일 객체 BytesIO 인스턴스 생성
io.seek(0) # 파일의 처음으로 커서를 이동
canvas = Image.open(io).convert('RGBA') # 이미지 파일을 열고, RGBA모드로 변환
font = ImageFont.Truetype(ttf_path, 40) # 지정 경로의 TrueType 폰트, 폰트크기 40
draw = ImageDraw.Draw(canvas) # canvas에 대한 ImageDraw 객체 획득
text = 'Ask Company'
left, top = 10, 10
margin = 10
width, height = font.getsize(text)
right = left + width + margin
bottom = top + height + margin
draw.rectangle((left, top, right, bottom), (255, 255, 224))
draw.text((15, 15), text, font=font, fill=(20, 20, 20))
canvas.show()
Pillow를 통한 이미지 응답 생성 - View
import requests
from io import BytesIO
from PIL import Image, ImageDraw, ImageFont
def response_pillow_image(request):
ttf_path = 'C:/Windows/Fonts/malgun.ttf' # 윈도우의 맑은고딕 폰트 경로
image_url = 'http://www.flowermeaning.com/flower-pics/Calla-Lily-Meaning.jpg'
res = requests.get(image_url) # 서버로 HTTP GET 요청하여, 응답 획득
io = BytesIO(res.content) # 응답의 Raw Body, 메모리 파일 객체 BytesIO 인스턴스 생성
io.seek(0) # 파일의 처음으로 커서를 이동
canvas = Image.open(io).convert('RGBA') # 이미지 파일을 열고, RGBA모드로 변환
font = ImageFont.Truetype(ttf_path, 40) # 지정 경로의 TrueType 폰트, 폰트크기 40
draw = ImageDraw.Draw(canvas) # canvas에 대한 ImageDraw 객체 획득
text = 'Ask Company'
left, top = 10, 10
margin = 10
width, height = font.getsize(text)
right = left + width + margin
bottom = top + height + margin
draw.rectangle((left, top, right, bottom), (255, 255, 224))
draw.text((15, 15), text, font=font, fill=(20, 20, 20))
response = HttpResponse(content_type='image/png')
canvas.save(response, format='PNG') # HttpResponse의 file-like 특성 활용
return response
URL Dispatcher와 정규 표현식
URL Dispatcher
“특정 URL 패턴” -> View의 List
프로젝트/seetings.py에서 최상위 URLConf 모듈을 지정
- 최초의 urlpatterns로부터 include를 통해, TREE구조로 확장
HTTP 요청이 들어올 때마다, 등록된 urlpatterns 상의 매핑 리스트를 처음부터 순차적으로 훝으며 URL 매칭을 시도
- 매칭이 되는 URL Rule이 다수 존재하더라도, 처음 Rule만을 사용
- 매칭되는 URL Rule이 없을 경우, 404 Page Not Found 응답을 발생
urlpatterns 예시
- shop/urls.py
from django.urls import path, re_path
from shop import views
urlpatterns = [
path('', views.item_list, name='item_list'), # Item 목록
path('new/', views.item_new, name='item_new'), # 새 Item
path('<int:id>/', views.item_detail, name='item_detail'), # Item 보기
re_path(r'^(?P<id>/d+)/$'), views.item_detail, name='item_detail'), # 혹은 re_path 활용
path('<int:id>/edit/', views.item_edit, name='item_edit'), # Item 수정
path('<int:id>/delete/', views.item_delete, name='item_delete'), # Item 삭제
path('<int:id>/reviews/', views.review_list, name='review_list'), # 리뷰 목록
path('<int:item_id>/reviews/<int:id>/edit/$', views.review_edit, name='review_edit'), # 리뷰 수정
path('<int:item_id>/reviews/<int:id>/delete/$', views.review_delete, name='review_delete'), # 리뷰 삭제
]
path()와 re_path() 사용법
- 장고 1.x에서의 Django.conf.urls.url() 사용이 2가지로 분리
django.urls.re_path()
- django.conf.urls.url()과 동일
django.urls.path()
- 기본 지원되는 Path Converter를 통해 정규표현식 기입이 간소화 -> 만능은 아니다.
- 자주 사용되는 패턴을 Converter로 등록하면, 재활용면에서 편리
from django.conf.urls import url # django 1.x 스타일
from django.urls import path, re_path # django 2.x ~ 스타일
urlpatterns = [
# 장고 1.x에서의 다음 코드를
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
# 다음과 같이 간소화 가능
path('articles/<int:year>/', views.year_archive),
# 다음과 같이 동일하게 사용가능
re_path(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
]
기본 제공되는 Path Converter
IntConverter -> r’[0-9]+’
StringConverter -> r’[^/]+’
UUIDConverter -> r’[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}’
SlugConverter (StringConverter 상속) -> r’[-a-zA-Z0-9_]+’
PathConverter (StringConverter 상속) -> r’.+’
정규 표현식
- Regular Expression
거의 모든 프로그래밍 언어에서 지원
문자열의 패턴, 규칙, Rule을 정의하는 방법
문자열 검색이나 치환작업을 간편하게 처리
장고 URL Dispatcher에서는 정규표현식을 통한 URL 매칭
문법
- 1글자에 대한 패턴 + 연속된 출현 횟수 지정
- 대괄호 내에 1글자에 대한 후보 글자들을 나열
다양한 정규 표현식 패턴 예시
1자리 숫자 -> “[0123456789]” 혹은 “[0-9]” 혹은 r”[\d]” 혹은 r”\d”
2자리 숫자 -> “[0123456789][0123456789]” 혹은 “[0-9][0-9]” 혹은 r”\d\d”
3자리 숫자 -> r”\d\d\d” 혹은 r”\d{3}”
2자리 ~ 4자리 숫자 -> r”\d{2,4}”
휴대폰 번호 -> r”010[1-9]\d{7}”
알파벳 소문자 1글자 -> “[abcdefghijklmnopqrstuvwxyz]” 혹은 “[a-z]”
알파벳 대문자 1글자 -> “[ABCDEFGHIJKLMNOPQRSTUVWXYZ]” 혹은 “[A-Z]”
반복횟수 지정 문법
r”\d” : 별도 횟수 지정 없음 -> 1회 반복
r”\d{1}” : 1회 반복
r”\d{2}” : 2회 반복
r”\d{2,4}” : 2회 ~ 4회 반복
r”\d?” : 0회 혹은 1회 반복
r”\d*” : 0회 이상 반복
r”\d+” : 1회 이상 반복
주의 : 정규표현식은 띄어쓰기 하나에도 민감하므로, 가독성 이유로 띄어쓰기를 하지 말 것.
커스텀 Path converter
# 앱이름/converters.py
class FourDigitYearConverter:
regex = '\d{4}'
def to_python(self, value): # url로부터 추출한 문자열을 뷰에 넘겨주기 전에 변환
return int(value)
def to_url(self, value): # url reverse 시에 호출
return "%04d" % value
# 앱이름/urls.py
from django.urls import register_converter
register_converter(FourDigitYearConverter, 'yyyy')
urlpatterns = [
path('articles/<yyyy:year>/', views.year_archive),
]
커스텀 Converter 예시 : Slug Unicode
정규 표현식
- slug_unicode_re = [-\w]+
Converter
from django.urls.converters import StringConverter
class SlugUnicodeConverter(StringConverter):
regex = r"[-\w]+"
새로운 장고 앱을 생성할 때, 추천 작업
- 앱 내 urls.py를 생성하고 등록하기
- 앱 생성
- 앱이름/urls.py 파일 생성
- 프로젝트/urls.py에 include 적용
- 프로젝트/settings.py의 INSTALLED_APPS에 앱 이름 등록
# 앱/urls.py
from django.urls import path
from 앱이름 import views
app_name = '앱이름'
urlpatterns = [
]
# 프로젝트/urls.py
from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path('admin/', admin.site.urls),
path('앱이름/', include('앱이름.urls')),
]
# 프로젝트/settings.py
ISTALLED_APPS = [
# ...
# '앱이름',
]
🐢 현재 공부하고 있는 파이썬/장고 웹서비스 개발 완벽 가이드 with 리액트 - 이진석 강사 의 강의를 학습하며 기록 및 정리를 하기위한 내용들입니다. 🐢
감사합니다.😊
댓글남기기