基于python的種子搜尋網站（二）開發過程

本講會對種子搜尋網站的開發過程進行詳細的講解。

網站示範：

https://bt.mypython.me 源碼位址： https://github.com/geeeeeeeek/bt

項目開發過程

項目簡介

該項目是基于python的web類庫django開發的一套web網站，做為本人的畢業設計。

本人的研究方向是一項關于搜尋的研究項目。在該項目中，筆者開發了一個簡單版的搜尋網站，實作了對資料庫資料的檢索和更新。 網站域名為bt.mypython.me

啟動項目

django-admin startproject bt            

建立應用

python3 manage.py startapp app           

model設計

主要是對送出的連結進行設計，在此項目中，我們需要展示連結的名稱、url、聯系人、連結簡介等字段。

設計字段如下：

class Link(models.Model):
    list_display = ("url","desc","contact")
    url = models.CharField(max_length=100,blank=True, null=True)
    title = models.CharField(max_length=100,blank=True, null=True)
    size = models.CharField(max_length=100,blank=True, null=True)
    hot = models.IntegerField(default=0)
    desc = models.CharField(max_length=200,blank=True, null=True)
    contact = models.CharField(max_length=100,blank=True, null=True)
    status = models.BooleanField(default=False)
    timestamp = models.DateTimeField(auto_now_add=True, null=True)
    objects = LinkQuerySet.as_manager()           

業務編寫

本項目一共分為4個頁面，分别是首頁、搜尋清單頁、詳情頁、連結送出頁。

我們一一講解

首頁

首先是首頁，它的模版位于templates/app/index.html 它主要是用來展示首頁内容， 并送出搜尋詞，到搜尋接口，所有的接口都位于app/urls.py裡面，如下

app_name = 'app'
urlpatterns = [
    path('index', views.IndexView.as_view(), name='index'),
    path('search', views.SearchView.as_view(), name='search'),
    path('detail/<int:pk>', views.DetailView.as_view(), name='detail'),
    path('commit', views.CommitView.as_view(), name='commit'),
]           

我們設定首頁的路由為IndexView， 開始編寫IndexView的代碼。它的代碼非常簡單：

class IndexView(generic.TemplateView):
    template_name = 'app/index.html'           

僅僅是展示了首頁頁面，首頁将搜尋詞交給了search來處理，這一點，我們從index.html關于form的代碼中可以看到, 送出給了url 'app:search'

<form id="search-form" action="{% url 'app:search' %}" enctype="multipart/form-data" method="get" role="form">
    <input type="text" id="search" name="q" autocomplete="off" placeholder="搜搜你懂的">
    <input type="submit" id="btnSearch" value="搜 索" class="blue">
 </form>           

清單展示頁

從urls.py中可知，app:search指向了SearchView，這個類是本項目的核心代碼，它實作了搜尋的全過程。

class SearchView(generic.ListView):
    model = Link
    template_name = 'app/search.html'
    context_object_name = 'link_list'
    paginate_by = 10
    q = ''       # 搜尋詞
    duration = 0 # 耗時
    record_count = 0

    def get_context_data(self, *, object_list=None, **kwargs):
        context = super(SearchView, self).get_context_data(**kwargs)
        paginator = context.get('paginator')
        page = context.get('page_obj')
        page_list = get_page_list(paginator, page)
        context['page_list'] = page_list
        context['q'] = self.q
        context['duration'] = round(self.duration,6)
        context['record_count'] = self.record_count
        return context

    def get_queryset(self):
        start = time.time()
        self.q = self.request.GET.get("q", "")
        search_list = Link.objects.get_search_list(self.q)
        # 如搜尋為空，則放假資料
        if len(search_list) <= 0:
            search_list = Link.objects.get_fake_list()
        end = time.time()
        self.duration = end - start
        self.record_count = len(search_list)
        return search_list           

繼承了ListView通用類，通過get_queryset()回調函數來實作搜尋功能，并通過get_context_data來傳遞額外的資料給前端。即是清單展示頁。

詳情頁

我們再來開發詳情頁，從urls.py中看到，詳情頁是由DetailView來實作的，我們來窺探它的全貌：

class DetailView(generic.DetailView):
    model = Link
    template_name = 'app/detail.html'

    def get_object(self, queryset=None):
        obj = super().get_object()
        obj.increase_hot_count()
        return obj

    def get_context_data(self, **kwargs):
        context = super(DetailView, self).get_context_data(**kwargs)
        recommend_list = Link.objects.get_recommend_list()
        context['recommend_list'] = recommend_list
        return context           

它很簡單，繼承了DetailView通用模闆類來顯示詳情。

連結送出頁

最後再來看一下連結送出頁，它是由CommitView來實作的。同樣是觀看代碼：

class CommitView(generic.CreateView):

    model = Link
    form_class = CommitForm
    template_name = 'app/commit.html'

    @ratelimit(key='ip', rate='2/m')
    def post(self, request, *args, **kwargs):
        was_limited = getattr(request, 'limited', False)
        if was_limited:
            messages.warning(self.request, "操作太頻繁了，請1分鐘後再試")
            return render(request, 'app/commit.html', {'form': CommitForm()})
        return super().post(request, *args, **kwargs)

    def get_success_url(self):
        messages.success(self.request, "送出成功! 稽核期3個工作日。")
        return reverse('app:commit')           

它是繼承自CreateView，因為是建立操作嘛，在post中，我們通過ratelimit來限制送出次數。

運作項目

python3 manage.py runserver