Django ViewClass 2-5) ListView

📌ListView

• 특정 모델을 바로 리스트 형태로 조회할 수 있게 해주는 ViewClass
• template_name으로 템플릿 지정 가능

List 뷰 클래스의 기본 형태

class ListView:
	model: Model
    template_name: str
    queryset: Queryset

---

📌적용

from django.http import HttpRequest, HttpResponse
from django.shortcuts import render, HttpResponseRedirect, redirect
from django.views.generic import TemplateView, CreateView, UpdateView, DeleteView, ListView, DetailView, FormView
from .models import Task, ChecklistItem
from django.utils import timezone
from django.core.paginator import Paginator
from django.urls import reverse_lazy

class TaskPreviousView(ListView):
    model = Task
    template_name = "pages/task_previous_list.html"
    queryset = Task.objects.filter(due__lt=timezone.now())

<div class="row row-cols-1 row-cols-md-2 row-cols-lg-4 g-4 mt-2">
    {% for item in object_list %}
    <div class="col">
        <div class="card text-white bg-secondary mb-3">
            <div class="card-header">{{item.type}}</div>
            <div class="card-body">
                <h5 class="card-title">{{item.title}}</h5>
                <p class="card-text">
                    <span class="badge bg-light text-dark">
                        {{item.due|date:"Y년 m월 d일 H시 i분"}}까지
                    </span>
                </p>
            </div>
        </div>
    </div>
    {% endfor %}
</div>

• queryset 변수에 Task.objects.filter(due__lt=timezone.now()) 코드를 작성
• queryset 인스턴스가 생성된 것일뿐 실제로 데이터베이스를 히트치지 않는다.
• 히트치는 시점은 템플릿에서 for문(이터레이션)으로 순회를 할 때 히트가 된다.

📌QuerySet

• Django ORM에서 데이터를 조회하는 명령어를 정의
• 쿼리셋 단계에서는 실제 데이터베이스에서 데이터를 질의하진 않음

📌QuerySet의 Evaluate 시점(데이터베이스 히트) ★

• 이터레이션(순환)
• 슬라이싱
• 픽클링(pickling), 캐싱(caching)
• len() 호출
• list(), bool()로 변환
• 파이썬 인터프리터에서 출력할 때

📌FieldLookup

• Django ORM의 QuerySet를 정의할 때 {필드명}__{조건}식으로 사용함
• 참고자료 - Django QuerySet API reference

📌QuerySet API

• Django가 제공하는 ORM을 사용해 데이터베이스를 조작하는 방법
• Model을 정의하면 데이터를 만들고, 읽고, 수정하고, 지울 수 있는 API 제공
• QuerySet과 상호작용하기 위해 사용하는 도구

📌Database API 구문

-- objects (Manager)

• Django 모델이 데이터베이스 쿼리 작업을 가능하게 하는 인터페이스
• Django는 기본적으로 모든 Django 모델 클래스에 대해 object라는 Manager 객체를 자동으로 추가함
• 이 Manager를 통해 특정 데이터를 조작할 수 있음
• DB를 Python Class로 조작할 수 있도록 여러 메서드를 제공하는 manager

-- Query

• 데이터베이스에 특정한 데이터를 보여 달라는 요청
• 쿼리문을 작성한다. → 원하는 데이터를 얻기 위해 데이터베이스에 요청을 보낼 코드를 작성한다.
• 이 때, 파이썬으로 작성한 코드가 ORM에 의해 SQL로 변환되어 데이터베이스에 전달되며, 데이터베이스의 응답 데이터를 ORM이 QuerySet이라는 자료 형태로 변환하여 우리에게 전달됨, 파이썬의 자료구조처럼 쓸 수 있게 해줌

-- QuerySet

• 데이터베이스에게서 전달 받은 객체 목록(데이터 모음)
• 순회가 가능(Iterator)한 데이터로써 1개 이상의 데이터를 불러와 사용할 수 있음
• Django ORM을 통해 만들어진 자료형이며, 필터(filter)를 걸거나 정렬(order_by) 등을 수행할 수 있음
• objects manager를 사용하여 복수의 데이터를 가져오는 QuerySet Method를 사용할 때 반환되는 객체
• 단 데이터베이스가 단일한 객체를 반환할 때는 QuerySet이 아닌 모델(Class)의 인스턴스로 반환됨

📌Create

In[1] : from taskapp.models import Task

In[2] : from django.utils import timezone

In[3] : due_time = timezone.now() + timezone.timedelta(days=3)

In[4] : new_task = Task.objects.create(title="운전면허", type=Task.TaskType.SOCIAL, due=due_time)

In[5] : new_task.save()

📌Read

• QuerySet API Method를 사용해 데이터를 다양하게 조회할 수 있다.

• QuerySet API Method는 크게 새로운 Querysets를 반환하는 것과 반환하지 않는 것 2가지로 분류

①. all()

• QuerySet return

• 전체 데이터 조회

②. get()

• 단일 데이터 조회

• 객체를 찾을 수 없다면 DoesnotExist 예외를 발생시키고 둘 이상의 객체를 찾으면 MultipleObjectsReturned 예외를 발생시킴

• 위와 같은 특징을 가지고 있기 때문에 Primary Key와 같이 고유성을 보장하는 조회에서만 사용

③. filter()

• 지정된 조회 매개변수와 일치하는 객체를 포함하는 새 QuerySet을 반환

• 조회된 객체가 없거나 1개여도 QuerySet을 반환

④. FieldLookup

• FieldLookup은 SQL WHERE절의 핵심을 지정하는 방법이다. 이는 filter(), exclude(), get() 등의 QuerySet 메소드로 얻을 수 있는 QuerySet을 조건에 맞게 제한

표현	의미
__exact	정확히 일치 → 대소문자를 구분
__iexact	정확히 일치 → 대소문자를 구분하지않음
__contains	포함하는지 → 대소문자를 구분
__icontains	포함하는지 → 대소문자를 구분하지않음
__gt	큼 → greater than
__gte	크거나 같음 → greater than or equal to
__lt	작음 → less than
__lte	작거나 같음 → less than or equal to
__startwith	시작하는지
__endwith	끝나는지

참고자료 - Django FieldLookup

📌Update

• 수정하고자 하는 인스턴스 객체를 get()을 이용해 조회한 후 반환 값을 저장

• 인스턴스 객체의 인스턴스 변수 값을 새로운 값으로 할당

• save() 인스턴스 메소드 호출하여 저장

📌Delete

• 삭제하고자 하는 인스턴스 객체를 get()을 이용해 조회한 후 반환 값을 저장

• delete() 인스턴스 메소드 호출하여 삭제