• Django에서 Model을 정의하면 ORM을 통해 데이터베이스와 소통할 수 있는 API를 제공

  API란?

  Application Programming Interface

• 어플리케이션에서 시스템의 기능을 제어할 수 있도록 만든 인터페이스

• 어떤 기능을 쉽게 사용할 수 있도록 만든 체계

  Queryset

• Django Model의 데이터가 담겨있는 목록

• 파이썬의 리스트와 비슷한 형태

• Queryset을 얻기 위해서 'objects'를 이용

  • 'Model Manager'

<model>.objects.all() # <model>의 모든 데이터 Queryset 가져오기

Queryset API

Queryset을 반환 하는 API

• all() : 해당 모델 테이블의 모든 데이터 조회
• filter() : 특정 조건에 맞는 모든 데이터 조회
• values() : Queryset에 있는 모든 모델 데이터의 정보를 사전형으로 갖는 리스트 반환

  하나의 데이터 객체를 반환하는 API

• get() : 조건에 맞는 하나의 데이터 조회
• create() : 하나의 데이터를 생성하고 해당 모델 데이터를 반환
• latest() : 주어진 필드 기준으로 가장 최신의 모델 데이터를 반환

  그 외 API

• exists() : 연산된 쿼리셋에 데이터가 있다면 True 반환
• count() : 쿼리셋의 데이터 개수를 정수로 반환
• delete() : 데이터를 삭제할 때 사용

디버그 모드 (Debug Mode)

• 기본적으로 Django 프로젝트를 생성하면 settings.py에 디버그 모드가 켜져 있는 상태로 만들어짐

  # settings.py
  

...

SECURITY WARNING: don't run with debug turned on in production!

DEBUG = True ...

- 보안 이슈로 이어지기 때문에 꼭 디버그 모드를 꺼주어야 함
- 모드를 끄게 되면 실제로 ALLOWED_HOSTS에 있는 호스트(hosts) 외에는 
일체 접속이 차단 되어 더이상 내 컴퓨터에서도 접속이 되지 않음
### 호스트 설정 (Allowed Hosts)
- ALLOWED_HOSTS에 적는 호스트는 Django 프로젝트로 들어오는 요청에 대해 응답을 할 수 있는 호스트 즉, 서버의 주소
- 처음 프로젝트를 생성하면 아래처럼 비어있는 리스트로 생성
```python
# settings.py

...
ALLOWED_HOSTS = []
...

• 비어있는 호스트이면서 디버그 모드가 켜져 있는 경우에는 [ 'localhost', '127.0.0.1', '[::1]' ]과 같은 의미가 되어 로컬 호스트(localhost) 즉 내 컴퓨터에서 접속이 가능한 상태
• 배포할 서버와 내 컴퓨터에 대해 허용해주기 위해 ALLOWED_HOSTS 리스트에 호스트를 추가해주는 것이 필요

  정적 파일 관리 (Static Files)

• 흩어져있는 정적 파일들을 하나의 경로로 모두 모아 주어야 하는데 이때 사용하는 명령어가 바로 collectstatic 명령어
• collectstatic 명령어는 흩어져 있는 정적 파일을 settings.py에 명시되어 있는 STATIC_ROOT 경로로 복사해서 모아줌

  STATIC_URL과 STATIC_ROOT의 차이

• STATIC_URL은 실제 존재하는 경로가 아니라 웹 페이지에서 사용할 정적 파일에 대한 URL
• STATIC_ROOT는 실제 존재하는 경로로 Django 프로젝트에서 사용하는 모든 정적 파일이 이 경로에 존재하며 웹 서버가 정적 파일을 찾기 위해 참조하는 실제 경로

  소스코드 관리

• 버전 관리 시스템을 사용해서 소스코드를 관리하고 원격 서버에 업로드 하는 방법을 권장
• Git, SVN, Mercurial 등의 시스템

• Django는 Model을 정의하면 ORM을 통해서 데이터베이스에 데이터를 추가하고(Create) 조회하고(Read) 수정하고(Update) 삭제(Delete)할 수 있도록 하는 편리한 기능을 제공
• Model의 'objects'를 이용해서 수행

  데이터 추가하기 (Create)

• 데이터를 추가하기 위해서는 import를 이용해서 먼저 사용할 Model을 불러 와야 함

  from {app_name}.models import {model}

  Create

• Create는 데이터 객체를 생성하고 데이터베이스에 반영하는 과정을 한 번에 할 수 있음

  data_model = {model}.objects.create( {field_name}=value, ... )
  # example
  # food = Food.objects.create(price=10000)

  save

• save를 이용하면 데이터 객체를 생성하는 타이밍과 실제로 데이터베이스에 반영하는 과정을 분리할 수 있음

  data_model = {model}( {field_name}=value, ... )
  data_model.save()
  # example 
  # food = Food(price=10000)
  #   food.save()

  데이터 조회하기 (Read)

• 데이터를 데이터베이스로 부터 읽어오는 것은 Django Model Manager인 objects를 통해서 할 수 있음

  모든 데이터 조회

• all()을 사용

  data = {model}.obejcts.all()

  하나의 데이터 조회

• get()을 사용
  • get을 사용했을때 조회 결과가 여러개라면 에러

    data = {model}.objects.get(field=value)

    조건에 맞는 여러 데이터 조회

• filter()를 사용
• 해당 필드 조건에 해당하는 모든 데이터를 가져오거나 아래에서 설명하는 조건 키워드를 함께 사용할 수 있음

  data = {model}.objects.filter(field=value)

  정렬해서 데이터 조회

• order_by()를 사용
• 두 개 이상의 필드를 함께 사용해서 정렬할 수 있으며 '-'를 사용해서 내림차순으로 정렬할 수 있음

  data = {model}.objects.order_by('field_1', '-field_2')
  # field_1을 기준으로 오름차순으로 정렬하고 
  # 그 결과를 다시 field_2를 기준으로 내림차순으로 정렬합니다.

  데이터의 개수 세기

• count()를 사용

  rows = {model}.objects.count()

  특정 조건을 제외한 데이터 조회

• exclude()를 사용

  data = {model}.objects.exclude(field=value)
  # 특정 field가 value인 데이터를 제외한 모든 데이터를 조회합니다.

  체인으로 연결해서 조회

• 여러가지 데이터 조회를 체인처럼 연결해서 사용할 수 있음

  data = {model}.objects.filter(price=10000).order_by('name')
  # 가격(price)이 10,000원인 데이터를 이름(name)으로 정렬해서 조회합니다.

  data = data.order_by('name')
  # 이렇게 적어도 위와 똑같은 명령을 수행합니다. 

  조건 키워드

• {field_name}__{keyword}={condition} 형태로 사용

  __exact, __iexact

• __exact는 대소문자를 구분해서 조건과 정확히 일치 하는지를 체크
• __iexact는 대소문자를 구분 하지 않고 일치하는 지를 체크

  __contains, __icontains

• 지정한 문자열을 포함 하는지를 체크
• __icontains는 대소문자를 구분하지 않고 체크

  __range

• 지정한 범위 내에 포함 되는지 체크
• 파이썬의 range와 비슷

  공식문서

• https://docs.djangoproject.com/en/2.2/ref/models/querysets/#field-lookups

  데이터 수정하기

• 수정할 데이터 객체를 가져온 다음 원하는 필드를 수정하고 save()를 호출하여 데이터베이스에 반영

  데이터 삭제하기

• 데이터를 삭제하기 위해서는 삭제할 데이터 객체를 가져온 다음 delete()를 호출

  공식문서

• https://docs.djangoproject.com/en/2.2/topics/db/queries/

from django.db import models

class <model name>(models.Model):
    <variable name> = models.<model field>

Model Field

• Django Model은 대부분의 데이터를 저장할 수 있는 필드(Field)를 지원

  필드(Field)

• 필드(Field)는 데이터 테이블에서의 열(column), 즉 데이터의 속성을 의미

  CharField

• class CharField(max_length=None)
• 제한된 길이의 문자열을 위한 필드
  • max_length 필수 인수이며 입력할 최대 길이를 설정

    IntegerField

• class IntegerField()
• 정수 값을 위한 필드이며 -2147483648 부터 2147483647 범위를 지원

  BooleanField

• class BooleanField()
• Boolean 값을 위한 필드

  DateField

• class DateField(auto_now=False, auto_now_add=False)
• DateField는 파이썬의 datetime.date 객체 형태로 표시되는 날짜 필드
  • auto_now
    • true로 설정되면 해당 객체가 변경(save) 될 때마다 자동으로 필드 값을 지금으로 수정
  • auto_now_add
    • 모델이 처음 생성될 때 한 번, 자동으로 필드 값을 지금으로 설정
    • '생성된 시간'을 저장하기 위해 많이 사용

      DateTimeField

• class DateTimeField(auto_now=False, auto_now_add=False)
• 파이썬의 datetime.datetime 객체 형태로 표시되는 날짜 필드
• DateField와 인수 옵션은 같음

  EmailField

• class EmailField(max_length=254)
• CharField의 하위 클래스로 문자열이 이용 가능한 이메일 주소인지 EmailValidator를 통해 확인
• https://docs.djangoproject.com/en/3.1/ref/validators/#django.core.validators.EmailValidator

  FileField

• class FileField(upload_to=None, max_length=100)
• 파일 업로드를 위한 필드
  • upload_to 업로드될 경로를 지정하는 필드로 Storage.save() 함수로 값이 전달되어 저장
  • https://docs.djangoproject.com/en/3.1/ref/files/storage/#django.core.files.storage.Storage.save

    ImageField

• class ImageField(upload_to=None, height_field=None, width_field=None, max_length=100)
• FileField를 상속하여 구현되는 파일 업로드를 위한 필드이며 기본적으로 최대 길이가 100인 문자열 형식으로 생성
• FileField에서 업로드된 파일이 정상적인 이미지 파일인지 확인하는 과정이 추가된 필드로 이미지 처리를 위한 Pillow 라이브러리가 필수적으로 필요
  • height_field & width_field 객체가 저장 될 때 이미지의 높이와 너비값이 자동으로 채워짐

옵션(Option)

• 옵션은 모든 필드 타입에 사용할 수 있으며 선택적으로 적용할 수 있음

  null

• Field.null
• 기본 값은 False이며 Null 값 허용 여부를 선택

  blank

• Field.blank
• 기본 값은 False이며 True로 설정한 경우 필드 값을 빈 값으로 설정할 수 있음

  default

• Field.default
• 필드의 기본값을 설정하는 옵션으로 값 또는 함수가 들어갈 수 있음

  db_column

• Field.db_column
• 해당 필드에 사용할 데이터베이스 속성 명을 지정

공식문서

• https://docs.djangoproject.com/en/3.1/ref/models/fields/#django.db.models.Field.default

• Django에서 URL을 처리하기 위해서는 URLconf 모듈 즉 urls.py를 작성

  # urls.py
  from django.urls import path
  from . import views
  

urlpatterns = [ path('URL', views.view) ]

### URL 처리 순서
- 요청이 들어오면 Django는 맨 처음 사용할 URLConf 모듈을 찾음
- 변경하지 않았다면 프로젝트 앱 내 settings.py의 ROOT_URLCONF 설정을 사용
- ROOT_URLconf로 정의된 URLConf 모듈을 보고 urlpatterns 리스트 안쪽의 django.urls.path() 함수를 순서대로 실행
- 요청과 일치하는 URL 패턴이 있다면 django.urls.path() 함수에 따라 view를 호출하거나, 일치하는 URL 패턴 다음의 URL을 하위 URLconf 모듈로 넘김
```python
from django.urls import path
from django.urls import include
from . import views

urlpatterns = [
    path('music/', views.player),
    path('video/', include('videoApp.urls')),
    # URL이 '~/video/lecture/django' 라면
    # videoApp의 URLconf에는 'lecture/django'가 넘어갑니다.
]

path 함수

django.urls.path path(route, view, kwargs=None, name=None)

route

• URL 문자열을 인수로 받으며 경로 변수(Path Converter)를 사용하여 URL의 일부를 view의 인수로 보낼 수 있음

  Path converters

• Django에서 기본으로 제공하는 경로 변환기 이하 경로 변수는 5가지가 있음
  • str : 경로 구분 기호(/)를 제외한 모든 문자열과 매칭
  • int : 0 또는 양의 정수와 매칭
  • slug : 문자, 숫자, 하이픈(-), 밑줄(_)로 구성된 문자열과 매칭
  • uuid : 범용 고유 식별자(UUID)와 매칭
    • https://ko.wikipedia.org/wiki/%EB%B2%94%EC%9A%A9_%EA%B3%A0%EC%9C%A0_%EC%8B%9D%EB%B3%84%EC%9E%90
  • path : 경로 구분 기호(/)를 포함한 모든 문자열과 매칭

    view

• 함수형 view 또는 클래스 기반 view가 들어갈 수 있음
• include를 사용해서 다른 URLconf 모듈로 연결할 수도 있음

  kwargs

• view에 추가 인자를 전달 할 때 사용

  name

• path 함수가 가지는 URL 패턴에 이름을 붙여 주기 위해 사용
• URL을 직접 템플릿에 적지 않게 해주고 URL을 직관적으로 참조할 수 있게 해줌

  공식문서

• https://docs.djangoproject.com/en/2.2/topics/http/urls/

• 템플릿 언어 (Template Language)는 Django의 템플릿에서 사용 할 수 있는 특별한 문법

• 템플릿 변수 / 템플릿 필터 / 템플릿 태그 / 템플릿 코멘트

  템플릿 변수 (Template Variable)

  {{ variable }}

• 템플릿 변수는 템플릿이 렌더될 때 해당 변수가 의미하는 값으로 변환

• 뷰(View)에서 가공한 데이터를 템플릿으로 넘겨주면 템플릿에서는 템플릿 변수를 사용해 넘겨받은 데이터에 접근

템플릿 필터 (Template Filter)

{{ variable|filter }}

• 템플릿 변수에 파이프(|)를 쓰고 템플릿 필터를 사용하면 템플릿 변수를 특정 형식으로 변환

default

{{ variable|default:"example" }}

• 변수가 비어 있거나 False면 example 라는 텍스트로 대체

capfirst

{{ variable|capfirst }}

• 맨 첫글자를 대문자로 변환

random

{{ variable|random }}

• 만약 variable이 참조하는 값이 ["a","b","c","d"] 인 리스트형이면, 템플릿 변수가 리스트 내의 하나의 원소로 대체

upper & lower

{{ variable | upper }} , {{ variable | lower }}

• 템플릿 변수를 대문자(upper) 또는 소문자 (lower)로 변환

ljust & rjust

{{ variable|ljust:"length" }}, {{ variable|rjust:"length" }}

• variable이 "example" 일 때 {{ variable|ljust:"10" }} 이라면 "example "
• variable이 "example" 일 때 {{ variable|rjust:"10" }} 이라면 " example"

공식문서

• https://docs.djangoproject.com/en/2.2/ref/templates/builtins/#ref-templates-builtins-filters

템플릿 태그 (Template Tag)

{% tag %}

• 템플릿을 작성할 때 반복문, 조건문 등의 로직을 사용해서 마치 프로그래밍을 하듯 템플릿을 작성
• 기본적으로 제공하는 태그가 있지만, 개발자가 직접 태그를 정의해서 사용할 수 있음

공식문서

• https://docs.djangoproject.com/en/2.2/ref/templates/builtins/#ref-templates-builtins-tags

사용자 정의

• https://docs.djangoproject.com/en/2.2/howto/custom-template-tags/

render( request, template_name, context=None, content_type=None, status=None, using=None )

• 인자로 주어진 템플릿을 사전형(dict) 인자인 context와 결합해서 렌더링을 거친 다음 HttpResponse 객체로 반환하는 함수
• 인자로 넘겨주는 템플릿과 context 데이터를 합쳐서 HttpResponse 객체로 돌려주는 함수

필수인자

request

• 데이터를 요청한 요청 객체를 넘겨줌
• 요청에 대한 정보에 접근해서 user, session 등 여러 가지 기능을 구현하기 위해

  template_name

• 렌더링에 사용할 대상 템플릿을 명시

선택 인자

context

• 템플릿에 추가할 값들이 들어 있는 사전형 인자
• 기본값은 아무것도 없는 None

  content_type

• 결과로 만들어 내는 문서의 유형
• 기본값은 'text/html' 즉 HTML 웹 페이지

  status

• 상태 코드(Status Code) 값
• 기본값은 200(성공)

  using

• 템플릿을 렌더하는 템플릿 엔진을 지정할 수 있는 인자
• 원하는 경우 다른 템플릿 엔진을 사용하여 템플릿을 렌더링할 수 있음

공식문서

• https://docs.djangoproject.com/en/2.2/topics/http/shortcuts/#django.shortcuts.render

상태코드(Status Code)

• 클라이언트 요청에 대한 처리가 성공했는지 실패했는지에 대해 알려주는 코드

1XX (정보 전달)

• 100 (진행, Continue)
  • 요청의 첫 부분을 받아서 다음 요청을 기다리고 있음
  • 이미 요청을 완료했다면 해당 응답을 무시할 수 있음
• 101 (프로토콜 전환, Switching Protocol)
  • 클라이언트가 서버에게 프로토콜 전환을 요청했고 서버에서 프로토콜을 변경함

    2XX (성공)

• 200 (성공, OK)
  • 클라이언트의 요청이 성공적으로 처리
• 201 (작성됨, Created)
  • 요청이 성공적으로 처리되어 새로운 리소스를 생성
• 202 (허용됨, Accepted)
  • 서버가 성공적으로 요청을 받았지만 아직 처리 전인 상태
• 203 (신뢰할 수 없는 정보, Non-Authoritative Information)
  • 서버가 성공적으로 요청을 처리했지만 요청에 포함된 정보가 다른 곳에서 수정된 정보
• 204 (콘텐츠 없음, No Content)
  • 요청을 성공적으로 처리했지만 콘텐츠를 제공하지 않는다는 것을 의미
• 205 (콘텐츠 재설정, Reset Content)
  • 요청을 성공적으로 처리했고 콘텐츠를 제공하지 않으며 클라이언트가 문서 보기를 재설정할 것을 요구

    3XX (리다이렉션)

• 300 (여러 개의 선택 항목, Multiple Choice)
  • 요청에 대해 서버가 여러 응답이 가능하며 하나를 선택해야 함을 의미
• 301 (영구 이동, Moved Permanently)
  • 요청한 리소스가 새로운 위치로 영구 이동
  • 클라이언트는 자동적으로 새로운 위치로 전달됨
• 302 (임시 이동, Found)
  • 요청한 리소스가 일시적으로 이동했음
  • 향후 다시 해당 리소스를 요청할 때도 동일한 주소로 해야함을 의미
• 304 (수정되지 않음, Not Modified)
  • 마지막 요청 이후 요청한 리소스는 수정되지 않았음
  • 서버가 콘텐츠를 전달하지 않음
  • 클라이언트는 이전에 전달받은 결과를 계속해서 사용할 수 있음

    4XX (실패)

• 400 (잘못된 요청, Bad Request)
  • 클라이언트의 요청을 서버가 이해할 수 없다는 것을 의미
• 401 (권한 없음, Unauthorized)
  • 클라이언트가 해당 요청에 대한 응답을 받기 위해서는 추가적인 인증이 필요하다는 것을 나타냄
• 402 (결제 필요, Payment Required)
  • 이 요청을 결제가 필요하다는 것을 의미
  • 현재는 사용되고 있지 않음
• 403 (금지됨, Forbidden)
  • 클라이언트가 요청한 리소스에 접근할 권한이 없음
  • 401과 다른 점은 서버는 해당 클라이언트에 대한 정보를 가지고 있음
• 404 (찾을 수 없음, Not Found)
  • 클라이언트가 요청한 리소스를 서버가 찾을 수 없다는 것을 의미

    5XX (서버 오류)

• 500 (내부 서버 오류, Internal Server Error)
  • 서버에서 오류가 발생하여 요청한 작업을 수행할 수 없다는 것을 의미
• 501 (구현되지 않음, Not Implemented)
  • 클라이언트가 요청한 방법을 서버에서 수행할 수 있는 기능이 없다는 것을 의미
• 502 (잘못된 게이트웨이, Bad Gateway)
  • 서버가 요청을 처리하는데 필요한 작업 중 게이트웨이로부터 잘못된 응답을 받았다는 것을 의미
• 503 (서비스를 사용할 수 없음, Service Unavailable)
  • 서버가 해당 요청을 처리할 준비가 되지 않았으며 일반적으로는 유지관리를 위해 작동이 중단되거나 과부하가 걸렸을 때를 나타냄
  • 보통 일시

    추가정보

• https://developer.mozilla.org/en-US/docs/Web/HTTP/Status

• Django에서 프로젝트 생성

  django-admin startproject {프로젝트명}

Django 프로젝트 구조

{프로젝트명}/

manage.py {프로젝트명}/

__init__.py settings.py urls.py wsgi.py

manage.py

• 하나의 Django 프로젝트를 생성하면 자동으로 만들어지는 프로젝트 관리를 위한 명령 유틸리티
• Django 앱을 만들거나, 데이터베이스 관련 기능을 수행하거나, 개발 서버를 실행
• 공식문서
  • https://docs.djangoproject.com/en/2.2/ref/django-admin/

ProjectApp

• {프로젝트명} 디렉토리는 Django 프로젝트를 위한 여러 파일이 담겨 있는 디렉토리

__ init __.py

• 파일이 포함된 디렉토리를 Python의 패키지로 인식하게끔 하기 위해서 사용

urls.py

• url을 보고 알맞은 로직(View)으로 연결해주는 역할

wsgi.py

• WSGI는 WebServer Gateway Interface의 약자
• 웹 서버와 Django 어플리케이션을 연결
• 참고문서
  • https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface

앱 생성

• Project와 App의 차이점
  • 웹 서비스 각각의 기능은 앱 단위로 구현
  • 서로 다른 기능을 하는 앱을 여러 개 모아서 하나의 프로젝트 제작
  • 하나의 프로젝트는 여러 개의 앱과 약간의 설정 파일들로 구성
  • 하나의 앱은 여러 개의 프로젝트에서 사용할 수 있음

python manage.py startapp {생성할 App 이름}

Django 앱 구조

{app_name}/

__init__.py admin.py apps.py migrations/ models.py tests.py views.py

admin.py

• 각각의 앱을 Django의 관리자 기능과 연결하거나 관리자 기능에 대해 설정

apps.py

• 각각의 App마다 추가적인 기능 및 설정을 넣어 주기 위한 파일
• 공식문서
  • https://docs.djangoproject.com/en/2.2/ref/applications

migrations 디렉토리

• Django 앱의 데이터 구조에 대한 변경 사항인 migration 파일이 저장되는 디렉토리

models.py

• 앱에서 사용하는 데이터 구조를 정의하고 데이터베이스와의 소통을 담당

tests.py

• 앱에 대한 테스트 코드를 작성하는 파일

views.py

• 앱에서 어떤 기능을 할지에 대한 메인 로직을 담당하는 파일

• 모듈(module)이란?
  • 여러 기능을 모아둔 파이썬 파일
  • 모듈은 파일 이름에서 .py를 빼고 부름

import

• 모듈에 저장된 기능을 가져다 쓰기 위해서는 모듈을 임포트(import)

  import <module>

• 모듈 전체를 임포트
• 모듈 안에 있는 함수나 변수는 .으로 접근

  import example
  print(example.case(n))
  print(example.case)

  from <module> import <member(s)>

• 모듈에서 필요한 것들만 임포트
• 불러온 변수나 함수를 접근할 때 앞에 module.을 붙이지 않음

  from example import case
  print(case(n))
  print(case)

  from <module> import *

• 모듈에서 모든 걸 임포트
• 모든 것을 가져오는만큼 불필요한 요소까지 가져올 수 있기에 권장되지 않음

  키워드 as

• 임포트 문 뒤에 as를 사용하여 이름을 바꿀 수 있음

  # 모듈 이름 변경
  import example as ex
  print(ex.case(n))
  # 함수 이름 변경
  from example import case as ca
  print(ca(n))

  모듈 vs 스크립트

• 스크립트는 실제로 프로그램을 작동시키는 실행 용도의 파일
• 모듈은 프로그램에 필요한 변수들이나 함수들을 정의한 임포트 용도의 파일
• 파일 자체에 특별한 차이가 없음
  • 어떤 파일은 상황에 따라 모듈이 될 수도 있고 스크립트가 될 수 있음

    __name__

• __name__은 모듈의 이름을 저장해 놓은 변수
  • 직접 실행하면 __name__은 __main__
  • 임포트하면 __name__은 모듈 이름