跳到主要內容

[Django教學7]善用Django ModelForm快速開發CRUD應用程式教學

Photo by Daniel Fazio on Unsplash
在現今許多網站中,多數都會有使用到表單的時候,舉例來說,在註冊會員時,就是使用表單的方式來填寫基本資料,進而儲存會員資料至資料庫中。

Django網站框架,提供了許多表單的開發方式,其中最常使用的為ModelForm(資料模型表單),顧名思義,就是利用規劃資料庫時,所建立的資料模型類別(Model),來開發表單,能夠快速建置基本的CRUD(Create-Read-Update-Delete)表單應用程式。

本文將實際開發基本的記帳網站,來說明Django ModelForm的開發方式,其中的重點包含:
  • Django ModelForm建置
  • Django ModelForm初始化
  • Django ModelForm新增資料操作
  • Django Url Reference網址參考
  • Django ModelForm修改資料操作
  • Django ModelForm刪除資料操作

一、Django ModelForm建置

在開發Django網站的ModelForm(資料模型表單)前,需事先建立網站的資料模型(Model),其中的建立方式可以參考Django Migration(資料遷移)的重要觀念文章。

而本文所要建置的記帳網站資料模型(models.py),如下範例:
from django.db import models

class Expense(models.Model):
    name = models.CharField(max_length=255)  #花費項目
    price = models.IntegerField() #金額
Django ModelForm(資料模型表單)就是依據models.py中的資料模型類別,來建立網站表單。首先,在Django的應用程式(APP)下新增一個forms.py檔案,如下圖:
接著,在forms.py檔案中自定類別,繼承自ModelForm類別,並且在其中設定表單所要綁定的資料模型名稱,如下範例:
from django import forms
from .models import Expense


class ExpenseModelForm(forms.ModelForm):

    class Meta:
        model = Expense
而要指定在網站上所要顯示的表單欄位,可以透過fields屬性來進行設定,如下範例:
from django import forms
from .models import Expense


class ExpenseModelForm(forms.ModelForm):

    class Meta:
        model = Expense
        fields = ('name', 'price')
如果要顯示資料模型(Model)中的所有欄位,fields屬性的設定可以簡寫為__all__,如下範例:
from django import forms
from .models import Expense


class ExpenseModelForm(forms.ModelForm):

    class Meta:
        model = Expense
        fields = '__all__'
另外,Django ModelForm也提供了widgets屬性,用來客製化表單的顯示外觀,這邊套用Bootstrap的表單CSS類別為例:
from django import forms
from .models import Expense


class ExpenseModelForm(forms.ModelForm):

    class Meta:
        model = Expense
        fields = '__all__'
        widgets = {
            'name': forms.TextInput(attrs={'class': 'form-control'}),
            'price': forms.NumberInput(attrs={'class': 'form-control'})
        }
由於在資料模型(Model)中,都是定義英文的屬性(Attribute),所以表單欄位的標題也會顯示英文名稱,如果想要進行修改,可以透過labels屬性來設定,如下範例:
from django import forms
from .models import Expense


class ExpenseModelForm(forms.ModelForm):

    class Meta:
        model = Expense
        fields = '__all__'
        widgets = {
            'name': forms.TextInput(attrs={'class': 'form-control'}),
            'price': forms.NumberInput(attrs={'class': 'form-control'})
        }
        labels = {
            'name': '花費項目',
            'price': '金額'
        }

二、Django ModelForm初始化

一般情況下,瀏覽器請求網址的方法(method)有兩種,分別為GETPOST,當沒有特別指定請求的方法為POST時,預設皆為GET方法。所以想要在瀏覽器請求Django應用程式(APP)時,能夠顯示一個空白的表單讓使用者填寫,就可以在views.py中,透過以下的程式碼來達成:
from django.shortcuts import render
from .forms import ExpenseModelForm


def index(request):

    form = ExpenseModelForm()

    context = {
        'form': form
    }

    return render(request, 'expenses/index.html', context)
由於瀏覽器預設使用GET方法請求網址,所以在檢視函式(View Function)中,會執行初始化Django ModelForm表單,並且傳送至Django Template(樣板)中。

接下來在對應的index.html Django Template(樣板)中,即可透過以下的語法,顯示在forms.py中所設定的表單樣式:

{% extends 'base.html' %}

{% block content %}
<form action="" method="POST">
    {% csrf_token %}
    <div class="form-group">
        <div class="form-group col-md-6">
            
            {{ form }}

            <input class="btn btn-success" type="submit" value="儲存" />
        </div>
    </div>
</form>
{% endblock  %}

執行結果
範例程式碼中,在<form>標籤的地方,action為表單要送往的目標網址,預設為目前的網址。另一個method屬性就是表單資料送出時,所使用的請求方法。而其中的csrf_tokenDjango的表單安全驗證機制,防止有心人士透過表單,傳送破壞性的資料到網站來進行攻擊,是Django表單的安全防護機制。

除此之外,如果想要彈性的放置欄位標題及輸入框,來修改排版的方式,則可以在Template(樣板)中,透過form物件單獨存取label欄位標題及輸入框,如下範例:
{% extends 'base.html' %}

{% block content %}

    <form action="" method="POST">
        {% csrf_token %}
        <div class="form-row">
            <div class="form-group col-md-6">
                <label>{{ form.name.label }}</label>
                {{ form.name }}
            </div>
            <div class="form-group col-md-4">
                <label>{{ form.price.label }}</label>
                {{ form.price }}
            </div>
            <div class="form-group col-md-2">
                <input class="btn btn-success" style="margin-top: 30px;" type="submit" value="儲存" />
            </div>
        </div>
    </form>
{% endblock  %}
執行結果

三、Django ModelForm新增資料操作

在儲存送出表單資料時,Django會使用POST方法,將表單資料傳送至目前的網址,這時候在views.py中,就可以透過以下的程式碼,儲存表單資料至資料庫中:
from django.shortcuts import render, redirect
from .models import Expense
from .forms import ExpenseModelForm


def index(request):

    expenses = Expense.objects.all()  # 查詢所有資料

    form = ExpenseModelForm()

    if request.method == "POST":
        form = ExpenseModelForm(request.POST)
        if form.is_valid():
            form.save()
        return redirect("/expenses")

    context = {
        'expenses': expenses,
        'form': form
    }

    return render(request, 'expenses/index.html', context)
由於為了在畫面展示儲存資料後,能將資料顯示在表單的下方,所以在檢視函式(View Function)中增加所有資料的查詢。

在剛剛的index.html Template(樣板)中,指定了表單資料送出的請求方法(method)POST,所以在檢視函式(View Function)中,就會進入if區塊,利用請求方法所帶過來的表單資料,建立ModelForm物件(form),這時候form物件擁有了使用者在表單所填寫的資料,接著利用is_valid()方法進行驗證,如果通過,就可以直接儲存,最後,重新導向到目前的網址。

回到index.html Template(樣板),在表單下方增加顯示所有資料的查詢結果,以及修改和刪除按鈕,如下範例:
{% extends 'base.html' %}

{% block content %}

    <form action="" method="POST">
        {% csrf_token %}
        <div class="form-row">
            <div class="form-group col-md-6">
                <label>{{ form.name.label }}</label>
                {{ form.name }}
            </div>
            <div class="form-group col-md-4">
                <label>{{ form.price.label }}</label>
                {{ form.price }}
            </div>
            <div class="form-group col-md-2">
                <input type="submit" class="btn btn-success" style="margin-top:30px;" value="儲存">
            </div>
        </div>
    </form>

    <table class="table table-bordered table-striped">
        <thead class="thead-dark">
            <tr>
                <th>花費項目</th>
                <th>金額</th>
                <th></th>
            </tr>
        </thead>
        <tbody>
            {% for expense in expenses %}
                <tr>
                    <td>{{ expense.name }}</td>
                    <td>{{ expense.price }}</td>
                    <td>
                        <a href="#" class="btn btn-info">修改</a>
                        <a href="#" class="btn btn-danger">刪除</a>
                    </td>
                </tr>
            {% endfor %}
        </tbody>
    </table>
{% endblock  %}
執行結果

四、Django Url Reference網址參考

要修改資料時,一定要知道該筆資料的主鍵(PK),並且透過網址傳送至Django的檢視函式(View Function)中,這時候就需要在應用程式(APP)下的urls.py中增加網址設定,如下範例:
from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='Index'),
    path('update/<str:pk>', views.update, name='Update')
]
在修改的網址的參數,首先需定義它的資料型態,接著在冒號後面,進行參數的命名。

網址設定完成後,回到index.html Template(樣板),在表單下方的顯示資料表格中,將修改按鈕的網址進行修改,如下範例:
<table class="table table-bordered table-striped">
    <thead class="thead-dark">
	<tr>
	    <th>花費項目</th>
	    <th>金額</th>
	    <th></th>
	</tr>
    </thead>
    <tbody>
        {% for expense in expenses %}
            <tr>
	        <td>{{ expense.name }}</td>
	        <td>{{ expense.price }}</td>
	        <td>
		    <a href="{% url 'Update' expense.id %}" class="btn btn-info">修改</a>
		    <a href="#" class="btn btn-danger">刪除</a>
	        </td>
	    </tr>
        {% endfor %}
    </tbody>
</table>
在修改按鈕的網址中,利用Djangourl樣板語法,指定網址的名稱及該筆資料的主鍵,這樣Django就會依據此名稱,在應用程式(APP)urls.py中,產生相對應的連結,並且由對應的檢視函式(View Function)來進行請求的處理。

五、Django ModelForm修改資料操作

修改按鈕的網址參考設定完成後,在views.py中,新增一個update檢視函式(View Function),並且利用剛剛在urls.py中所命名的參數名稱,取得表單資料的主鍵(id),這時候就能夠透過get()方法取得該筆表單資料。

接著指定Django ModelForminstance關鍵字參數(Keyword Argument)為取得的表單資料物件,來初始化表單,傳送至Template(樣板)中,如下範例:
def update(request, pk):

    expense = Expense.objects.get(id=pk)

    form = ExpenseModelForm(instance=expense)

    context = {
        'form': form
    }

    return render(request, 'expenses/update.html', context)
最後,建立修改畫面的Django Template(樣板),如下圖:
同樣利用剛剛所介紹的表單語法來建立Django ModelForm表單,如下範例:

{% extends 'base.html' %}

{% block content %}

    <form action="" method="POST">
        {% csrf_token %}
        <div class="form-group">
            <div class="form-group col-md-6">

            {{ form }}

            <input class="btn btn-success" type="submit" value="更新" />
            </div>
        </div>
    </form>
{% endblock  %}

假設這時候點選index.html Template(樣板)中,雞腿飯的修改按鈕,就可以看到Django所產生的網址及執行結果:
可以看到成功的透過網址傳遞該筆資料的主鍵至檢視函式(View Function),並且在表單顯示資料庫中的資料。

接下來,在點擊更新按鈕時,同樣利用POST請求方法,將修改的資料傳送至目前的網址,所以在相對的 update檢視函式(View Function)中,判斷如果為POST方法,就把取得的修改資料及資料庫中的該筆資料傳入Django ModelForm中,來建立form物件,如果修改的表單資料驗證通過,則進行修改的動作,如下範例:
def update(request, pk):

    expense = Expense.objects.get(id=pk)

    form = ExpenseModelForm(instance=expense)

    if request.method == 'POST':
        form = ExpenseModelForm(request.POST, instance=expense)
        if form.is_valid():
            form.save()
        return redirect('/expenses')

    context = {
        'form': form
    }

    return render(request, 'expenses/update.html', context)

六、Django ModelForm刪除資料操作

首先,開啟urls.py檔案,新增刪除按鈕的網址,如下範例:
from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='Index'),
    path('update/<str:pk>', views.update, name='Update'),
    path('delete/<str:pk>', views.delete, name='Delete')
]
接著,開啟index.html Template(樣板),設定刪除按鈕的網址,如下範例:
<table class="table table-bordered table-striped">
    <thead class="thead-dark">
	<tr>
	    <th>花費項目</th>
	    <th>金額</th>
	    <th></th>
	</tr>
    </thead>
    <tbody>
        {% for expense in expenses %}
            <tr>
	        <td>{{ expense.name }}</td>
	        <td>{{ expense.price }}</td>
	        <td>
		    <a href="{% url 'Update' expense.id %}" class="btn btn-info">修改</a>
		    <a href="{% url 'Delete' expense.id %}" class="btn btn-danger">刪除</a>
	        </td>
	    </tr>
        {% endfor %}
    </tbody>
</table>
2020/03/28補充說明
完成設定後,在views.py中,建立刪除的檢視函式(View Function),同樣先利用get()方法取得該筆資料後,傳遞至刪除的Template(樣板),讓使用者確認是否要進行刪除的動作,如下範例:
def delete(request, pk):

    expense = Expense.objects.get(id=pk)

    context = {
        'expense': expense
    }

    return render(request, 'expenses/delete.html', context)
Django應用程式(APP)下,新增刪除的Template(樣板),如下圖:
delete.html Template(樣板)中,首先,利用檢視函式(View Function)所傳過來的expense物件,顯示花費項目的名稱。接著,將確定及取消按鈕放置在表單中,讓「確定按鈕能夠使用POST方法進行請求,如下範例:

{% extends 'base.html' %}

{% block content %}

<h3>是否確定刪除{{ expense.name }}?</h3>

<form action="" method="POST">
    {% csrf_token %}
    <input class="btn btn-success" type="submit" value="確定" />
    <a class="btn btn-warning" href="{% url 'Index' %}">取消</a>
</form>

{% endblock  %}
範例中的「取消」按鈕,由於它的型態(type)不是送出(submit),所以會使用GET請求方法回到首頁。

假設想要刪除雞腿飯這筆花費項目,點擊「刪除」按鈕後,則可以看到如下圖的執行結果:
最後,回到刪除的檢視函式(View Function),如果請求的方法是POST,也就是按下了「確定」按鈕,則呼叫delete()方法進行刪除的動作,完成後回到首頁,如下範例:
def delete(request, pk):

    expense = Expense.objects.get(id=pk)

    if request.method == "POST":
        expense.delete()
        return redirect('/expenses')

    context = {
        'expense': expense
    }

    return render(request, 'expenses/delete.html', context)

七、小結

以上就是利用Django ModelForm來快速的建立一個CRUD的應用程式,希望透過本文的實作,可以瞭解Django ModelForm的使用方式。如果在實作的過程中有碰到任何問題,歡迎留言提問,我將盡力為各位解答。

如果您喜歡我的文章,請幫我按五下Like(使用GoogleFacebook帳號免費註冊),支持我創作教學文章,回饋由LikeCoin基金會出資,完全不會花到錢,感謝大家。


GitHub網址:https://github.com/mikeku1116/django-urexpenses

有想要看的教學內容嗎?歡迎利用以下的Google表單讓我知道,將有機會成為教學文章,分享給大家😊

你可能有興趣的文章

留言

  1. 回覆
    1. 已補充在文章最後,GitHub網址為https://github.com/mikeku1116/django-urexpenses

      刪除
  2. if form.is_valid: 少了( )

    :)

    回覆刪除
    回覆
    1. pika您好:
      已完成修改,感謝您的提醒 :)

      刪除
  3. 您好

    在第一次執行解果的地方 按鈕沒有顯示 儲存 index.html 的value那邊可能要補一下

    Thank you~

    回覆刪除

張貼留言

這個網誌中的熱門文章

[Python爬蟲教學]7個Python使用BeautifulSoup開發網頁爬蟲的實用技巧

Photo by Stanley Dai on Unsplash 在實務上開發專案時,很多時候會利用其他網站的資料來進行分析或運用,而取得的方式除了透過網站所提供的API(Application Programming Interface)外,也可以利用Python來開發爬蟲程式,將網頁的HTML內容下載下來,接著利用BeautifulSoup套件(Package),擷取所需的資訊。

本文將開發一個簡單的爬蟲程式,爬取「ETtoday旅遊雲」網頁,擷取桃園旅遊景點的標題資訊,如下圖: 取自ETtoday的旅遊雲 而在開發的過程中,常會需要搜尋HTML的節點,本文將分享幾個常用的方法,包含: BeautifulSoup安裝以HTML標籤及屬性搜尋節點以CSS屬性搜尋節點搜尋父節點搜尋前、後節點取得屬性值取得連結文字一、BeautifulSoup安裝BeautifulSoup是一個用來解析HTML結構的Python套件(Package),將取回的網頁HTML結構,透過其提供的方法(Method),能夠輕鬆的搜尋及擷取網頁上所需的資料,因此廣泛的應用在網頁爬蟲的開發上。

Beautifulsoup套件(Package)可以透過pip指令來進行安裝,如下範例: pip install beautifulsoup4而要解析網頁的HTML程式碼前,還需要安裝Python的requests套件(Package),將要爬取的網頁HTML程式碼取回來,安裝方式如下: pip install requests安裝完成後,首先引用requests套件(Package),並且透過get()方法(Method)存取ETtoday旅遊雲的桃園景點網址,如下範例: import requests response = requests.get( "https://travel.ettoday.net/category/%E6%A1%83%E5%9C%92/")將網頁的HTML程式碼取回來後,接著引用BeautifulSoup類別(Class),傳入取回的HTML結構字串,並且指定HTML的解析型態來建立其物件,如下範例: import requests from bs4 import BeautifulSoup response = requests.get( "…

Python學習資源整理

Photo by Pablo Heimplatz on Unsplash 本文將分享在學習Python的過程中,所參考的學習資源,由於喜歡做中學,所以分享的教學資源大部分都會有應用實作,除了能夠瞭解基本的Python語法外,透過實際的專案開發,可以增加熟悉度,並且從中培養解決問題的能力。而今天分享的Python學習資源,分別有: 網站書籍YouTube頻道線上課程一、網站以下是除了Python官方之外,推薦的教學網站,除了附有範例程式碼說明之外,觀念講解清楚且易於理解,包含: 1.Real Python: Python Tutorials
2.Python Programming Language - GeeksforGeeks
3.ccClub(Coding&Co-working Club)

二、書籍 1.Python初學特訓班(第四版):從快速入門到主流應用全面實戰(附250分鐘影音教學/範例程式)這本書從Python的基本語法教學開始,最後進行幾個應用程式的開發,包含了YouTube、LINE Bot聊天機器人、網頁爬蟲及資訊圖表繪製等Python專案的開發,這也是我非常喜歡的原因,學習任何的程式語言,在學習完基礎語法後,就是要透過實際的專案開發來練習及增加熟悉度,其中的實戰專案也是我目前正在學習的,並且還有附影音教學,非常適合初學者入門或是想要增加自己實戰經驗的開發人員。

2.Python自動化的樂趣:搞定重複瑣碎&單調無聊的工作(第二版)這本書同樣是先介紹Python的基本重要語法,簡潔易懂,不過這裡的專案實作比較是針對Python自動化的處理,包含Web擷取資訊、工作排程、影像圖片處理及Email發送等,是我在開發自動化專案時的參考書籍,實作範例都很實用,適合初學者及對Python自動化處理有興趣的開發人員。

3.Python設計模式實務上在開發專案時,大家都知道需求會隨著業務一直改變,這時候就會有機會修改程式碼,而有好的架構會讓程式碼好維護,相信這是開發人員所追求的,這本書就是介紹Python常用的設計模式(Design Pattern)及設計原則(Design Principle),藉此設計出好維護及簡潔的程式碼,適合進階且已有實務經驗的開發人員,未來在部落格中,會參考本書來分享學習心得。
三、YouTube頻道 1.Programming with …

[Python爬蟲教學]Python網頁爬蟲結合LINE Notify打造自動化訊息通知服務

Photo by William Hook on Unsplash 日常生活中,每個人都有關注的事情,像是演唱會門票的開賣、喜歡的商品降價或新電影上檔等,而為了要及時自動取得這些資訊,Python網頁爬蟲就被廣泛的使用,除了將爬取的資訊透過 [Python實戰應用]Python寄送Gmail電子郵件實作教學文章介紹的電子郵件進行通知外,另一個備受歡迎的接收通知管道就是LINE。
而LINE官方提供了LINE Notify的服務,只要完成和LINE網站的連動設定,就可以透過LINE Notify推播或傳送訊息至目標使用者的LINE中。
本文即以Udemy線上課程網站為例,利用Python網頁爬蟲關注想購買的線上課程,只要低於指定的價格,就透過LINE Notify服務傳送訊息給使用者。本文的重點包含: 登錄LINE Notify服務 發行LINE Notify權杖(Token) 整合Python網頁爬蟲及LINE Notify服務 一、登錄LINE Notify服務首先,前往LINE Notify官網,來進行Python網頁爬蟲與LINE Notify的連動設定,如下圖: 點選右上角的登入,輸入LINE帳號及密碼,如下圖: 成功登入後,就可以看到「管理登錄服務」頁面,如下圖: 接著,點擊「登錄服務」,輸入LINE Notify服務的基本資料,由於本文的Python爬蟲是跑在本機上,所以「服務網址」及「Callback URL」皆為http://127.0.0.1,如下範例: 填寫完成後,點擊「同意並前往下一步」,就可以看到剛剛所輸入的基本資料,確認沒問題點選「登錄」按鈕即可,如下範例: 這時後LINE Notify會發送認證郵件到登錄服務時,所填寫的電子郵件帳號中,如下圖: 完成電子郵件認證後,點擊「前往服務一覽」,可以看到LINE Notify配發了一個Client ID(帳號)給我們,如下圖: 而密碼則需點擊服務,才可以看到,如下圖:
以上就完成了LINE Notify服務的基本資料登錄了。 二、發行LINE Notify權杖(Token)有了的服務帳號及密碼後,接下來,就可以向LINE Notify取得權杖(token),各位可以把它想像是一張活動的門票,只要參加者有這張門票,就可以進入會場,並且主辦單位會為參加者提供多樣的服務。
同樣的道理,只要程式碼中帶有LINE Notify所給的權杖(t…

解析Python模組(Module)和套件(Package)的概念

Photo by Helloquence on Unsplash 當我們在開發大型應用程式時,如果沒有適當的組織程式碼,除了會降低開發的效率外,也不易於維護,所以模組(Module)化就顯得相當的重要,讓程式碼能夠透過引用的方式來重複使用,提升重用性(Reusable)。
但是隨著專案模組(Module)的增加,將難以管理及問題的追蹤,這時候就能將模組(Module)打包成套件(Package),利用其階層式的結構來彈性規劃模組(Module)。
本篇文章就帶大家瞭解Python模組(Module)及套件(Package)的重要觀念,包含: 什麼是模組(Module)模組引用方式(Import)什麼是套件(Package)dir()函式(dir function)將模組當作腳本來執行(Executing a Module as a Script)一、什麼是模組(Module)模組(Module)就是一個檔案,包含了相關性較高的程式碼。隨著應用程式的開發規模越來越大,我們不可能把所有的程式碼都寫在同一份Python檔案中,一定會將關聯性較高的程式碼抽出來放在不同的檔案中來形成模組(Module),主程式再透過引用的方式來使用。所以模組(Module)可以提高程式碼的重用性(Reusable)且易於維護。
假設我們現在要開發一個部落格,主程式為 app.py ,在還沒有模組化時,程式碼可能長得像這樣: #取得作者 def get_author(): return "Mike" #取得電子郵件 def get_email(): return "learncodewithmike@gmail.com" #新增文章 def add_post(title): pass #刪除文章 def delete_post(title): pass add_post() author = get_author() email = get_email()各位應該可以想像,隨著部落格功能的增加,將所有程式碼都寫在 app.py 主程式中會變得怎麼樣。所以這時候就可以將相關性較高的功能進行模組化的動作。
以此範例來說,取得作者及電子郵件可以獨立出來建立一個關於模組(about.py),而新增及刪除文章則可以獨立出來為文章模…

[Python+LINE Bot教學]6步驟快速上手LINE Bot機器人

Photo by Yura Fresh on Unsplash 每當朋友或家人要聚餐時,是不是總要花很長的時間尋找評價不錯的餐廳?不但要確認營業時間、消費價格及地點,還要觀看許多的美食文章才有辦法決定,這時候如果有人能夠明確提供幾間符合條件且有人氣的餐廳作為選擇,想必會省事許多。
所以筆者開發了一個美食的LINE Bot小作品,透過對談的方式瞭解使用者所要尋找的餐廳條件後,利用Python網頁爬蟲取得目前正在營業的五間最高人氣餐廳資料,回覆給使用者作為參考。
為了要讓想學習的您能夠由淺入深,瞭解其中的實作過程,所以將會分成三篇文章來進行教學。
2020/06/30補充說明 而在進行實作前,先來看一下LINE Bot主要的執行架構,如下圖: 使用者透過LINE發送訊息時,LINE Platform將會進行接收,並且傳遞至我們所開發的LINE Bot執行邏輯運算後,透過LINE所提供的Messaging API回應訊息給LINE Platform,最後再將訊息傳遞給使用者。
其中Messaging API(Application Programming Interface),就是LINE官方定義的回應訊息標準介面,包含Text(文字)、Sticker(貼圖)、Video(影片)、Audio(聲音)及Template(樣板)訊息等,完整的說明可以參考LINE的官方文件
所以在我們的LINE Bot回應訊息時,就要依據Messaging API定義的規範,傳入相應的參數後,Messaging API就會回應使用者相對的訊息類型。簡單來說,就是LINE Platform與LINE Bot的溝通橋樑。
而本文就先以最基本的使用者發送什麼訊息,LINE Bot就回應什麼訊息為例,讓讀者體會其中的運作方式,整體架構如下圖: 在LINE Bot的部分,使用Django框架來進行建置,並且透過Messaging API回應Text(文字)訊息。在下一篇文章中,將會加入Python網頁爬蟲,取得美食網站的資訊回應給使用者。
本文的實作步驟包含: 建立Provider建立Messaging API channel設定LINE Bot憑證開發LINE Bot應用程式安裝Ngrok設定LINE Webhook URL一、建立Provider要開發LINE Bot前,首先需建立一個Provider,也就是服務提供者…

[Python實戰應用]瞭解Python存取API的重要觀念-以KKBOX Open API為例

Photo by Nirmal Rajendharkumar on Unsplash 在現今很多網站,都會透過API(Application Programming Interface)的方式來提供服務,讓用呼端能夠藉由這個介面存取其資料,進行多樣化的應用開發。本文就以KKBOX Open API為例,實作一個簡單的專案,示範Python如何存取音樂排行榜API,並且可以讓使用者選擇想聽的排行榜類別,試聽其中的歌曲。

經過本文的教學,將會瞭解API的基本觀念,以及學會如何解析Python存取API後的回傳結果,並且篩選所需的欄位,重點包含了: 什麼是API專案前置準備KKBOX Open API用戶端憑證(Client Credentials)KKBOX Open API - Charts 一、什麼是API 各位可以將API(Application Programming Interface)想像是一個大門,要進入存取必須提供合法的帳號及密碼,才能拿到存取憑證(Access Token),之後要存取門後的API資源,只要帶著這個憑證,就可以進行存取。

而實際上API就是一組網址,透過HTTP協定來和用戶端進行溝通。舉例來說,各位可以開啟Chrome瀏覽器,按下F12進入開發者視窗,點擊Network頁籤,接著輸入google.com.tw網址,可以看到類似下圖的結果: 點選任一個網址,可以看到以下的資訊: 其中的Headers(標頭)就是瀏覽器發送至Google的資訊,如果換成是存取KKBOX Open API,Request URL就是API網址,Request Method有幾個常用的類型,分別有: GET(查詢資料)POST(新增資料)PUT(修改資料)DELETE(刪除資料) 以上四個是在存取API時,常用的HTTP動詞。而Response頁籤中的內容即是Google回傳給瀏覽器的結果。 二、專案前置準備有了基本的API觀念後,

[Python物件導向]淺談Python類別(Class)

Photo by Bram Naus on Unsplash 在學習程式語言時,或多或少都有聽過物件導向程式設計(Object-oriented programming,簡稱OOP),它是一個具有物件(Object)概念的開發方式,能夠提高軟體的重用性、擴充性及維護性,在開發大型的應用程式時更是被廣為使用,所以在現今多數的程式語言都有此種開發方式,Python當然也不例外。而要使用物件導向程式設計就必須對類別(Class)及物件(Object)等有一些基本的了解,包含了: 類別(Class)物件(Object)屬性(Attribute)建構式(Constructor)方法(Method)我們先來看一下今天要來建立的類別: # 汽車類別 class Cars: # 建構式 def __init__(self, color, seat): self.color = color # 顏色屬性 self.seat = seat # 座位屬性 # 方法(Method) def drive(self): print(f"My car is {self.color} and {self.seat} seats.") 接下來就針對類別(Class)各個部分來進行介紹。 一、類別(Class) 簡單來說,就是物件(Object)的藍圖(blueprint)。就像要生產一部汽車時,都會有設計圖,藉此可以知道此類汽車會有哪些特性及功能,類別(Class)就類似設計圖,會定義未來產生物件(Object)時所擁有的屬性(Attribute)及方法(Method)。而定義類別的語法如下: class classname:   statement 首先會有class關鍵字,接著自定類別名稱,最後加上冒號。類別名稱的命名原則習慣上使用Pascal命名法,也就是每個單字字首大寫,不得使用空白或底線分隔單字,如下範例: #範例一 class Cars: #範例二 class MyCars:二、物件(Object) 就是透過類別(Class)實際建立的實體,就像實際生產出來的汽車(例如:Mazda)。類別(Class)與物件(Object)的關係就像汽車設計圖與汽車實體。而建立物件(Object)的語法如…

[Python爬蟲教學]整合Python Selenium及BeautifulSoup實現動態網頁爬蟲

Photo by LAUREN GRAY on Unsplash 相信大家都知道,取得資料後能夠進行許多的應用,像是未來的趨勢預測、機器學習或資料分析等,而有效率的取得資料則是這些應用的首要議題,網頁爬蟲則是其中的一個方法。
網頁爬蟲就是能夠取得網頁原始碼中的元素資料技術,但是,有一些網頁較為特別,像是社群平台,需先登入後才能進行資料的爬取,或是電商網站,無需登入,但是要透過滾動捲軸,才會動態載入更多的資料,而要爬取這樣類型的網頁爬蟲,就稱為動態網頁爬蟲。
該如何實作呢?本文將使用Python Selenium及BeautifulSoup套件來示範動態網頁爬蟲的開發過程,重點包含: BeautifualSoup vs Selenium安裝Selenium及Webdriver安裝BeautifulSoupSelenium get()方法Selenium元素定位Selenium send_keys()方法Selenium execute_script方法BeautifulSoup find_all()方法BeautifulSoup getText()方法 一、BeautifualSoup vs SeleniumBeautifulSoup套件相信對於開發網頁爬蟲的人員來說,應該都有聽過,能夠解析及取得HTML原始碼各個標籤的元素資料,擁有非常容易上手的方法(Method),但是,對於想要爬取動態網頁資料來說,則無法達成,因為BeautifulSoup套件並沒有模擬使用者操作網頁的方法(Method),像是輸入帳號密碼進行登入或滾動捲軸等,來讓網頁動態載入資料,進行爬取的動作。
所以,這時候,就可以使用被設計於自動化測試的Selenium套件,來模擬使用者的動作,進行登入後爬取資料或滾動卷軸,並且能夠執行JavaScript程式碼,這些就是Selenium與BeautifulSoup套件最大不同的地方。對於開發Python動態爬蟲來說,就可以結合Selenium套件以上的特點,讓網頁動態載入資料後,再利用BeautifulSoup套件簡潔的方法(Method),將所需的資料爬取下來。
本文就是利用這樣的概念,利用Selenium套件登入Facebook後,前往粉絲專頁,執行滾動卷軸的JavaScript程式碼,讓網頁動態載入資料後,再使用BeautifulSoup套件爬取貼文標題。 二、…

有效管理Python套件(Package)的工具及概念

Photo by Kevin Bhagat on Unsplash 在實務上發展應用程式時,除了可以自行開發模組(Module)與套件(Package)外,很多時候會安裝使用第三方套件(Package),來提升專案的開發效率。
所以本文將介紹如何在PyPI中搜尋所需的Python套件(Package),並且以Windows作業系統及Visual Studio Code開發工具為例,瞭解Python強大的套件管理工具,讓您有效管理專案中的Python套件(Package)。
由於是在Visual Studio Code的Terminal視窗中下指令的方式來操作,所以使用命令提示字元視窗,也可以達到相同的效果。本文重點包含: PyPI(Python Package Index)pip套件管理工具pipenv套件管理工具Pipfile及Pipfile.lock檔案一、PyPI(Python Package Index)PyPI是一個套件庫,位於https://pypi.org,其中包含了各式各樣的Python套件(Package),在開發應用程式的過程中,可以到這邊來搜尋是否有所需的功能套件(Package),安裝後透過引用的方式來進行使用,藉此提升開發效率。

現在就來介紹幾個在使用PyPI時,需要瞭解的基本功能。首先,PyPI的首頁如下圖: 各位可以在搜尋的地方查詢所需的套件,例如搜尋常應用在網路爬蟲的beautifulsoup4套件(Package),從查詢結果可以看到許多相關的套件(Package),如下圖: 以beautifulsoup4 4.8.2為例,點進此套件(Package)後,可以看到安裝的指令及最新版的發佈日期,如下圖: 一個套件(Package)要如何使用,一定會有文件可以參考,往下即可看到Documentation的連結,如下圖: 而套件(Package)的版本演進歷史則可以透過左邊的Release history來查看,如下圖: 以上是在使用PyPI上查找套件(Package)時,較常使用的部分,接下來,就來教大家如何透過指令來安裝套件(Package)吧。 二、pip套件管理工具pip是一個全域環境的套件管理工具,用來安裝及管理PyPI上的Python套件(Package),也就是說利用pip指令所安裝的Python套件(Package),所有專案皆可使用。其中包…

[Django教學1]3步驟快速安裝Django網站框架

Photo by Danielle MacInnes on Unsplash 在現今網路發達的時代,許多人都會透過網站來經營個人的品牌或生意,在上面能夠展示各種的產品、課程或部落格等,甚至是社群平台,皆是利用網站的方式來連接全世界的使用者,是傳達訊息非常重要的媒介。

而想要利用Python簡潔的語法及特性來開發網站,則可以使用最受歡迎的網站框架Django,能夠快速的建置出具有安全性且模組化的網站應用程式,知名的網站像Instagram、YouTube及Spotify等,皆使用Django網站框架來進行開發。
為什麼這些國際性的網站會選擇使用Django來進行開發呢?接下來,將會撰寫一系列的Django教學文章,從安裝到開發出一個簡單的網站,最後發佈到雲端,帶大家來體會一下強大的Django網站框架吧。本文的重點包含: Django的架構Django的優點Django安裝步驟一、Django的架構 Django是一個由Python建構而成的網站框架(Web Framework),其中能夠包含許多的應用程式(APP),其架構就是將網站的各個功能,模組化為多個應用程式(APP),而每一個應用程式(APP),其實就是Python的套件(Package),如下圖: 就像是如果要開發一個旅遊社群網站,可以把整個網站的功能切分為多個不同的應用程式(APP),例如登入(Login)、貼文(Post)、旅遊規劃(Plan)及搜尋景點(Search)等,每一個應用程式(APP)皆專注在特定的功能邏輯,這就是Django框架的基本架構。 二、Django的優點擴展性由於Django的架構是將網站中關聯性高的功能模組化為多個套件(Package),所以未來要擴展新功能時非常的容易,並且不會影響到既有的專案架構。 移值性Django模組化的架構,讓專案中的應用程式(APP),可以移植至其它的Django專案中使用,擁有非常高的程式碼重用性(Reusable)。 快速開發Django框架定義了專案的基本架構及程式碼撰寫規範,開發人員在參與多個專案時,無需重新適應,可以快速的進入狀況,也因為遵循了Django的規範,提高了Django專案的維護性。 強大的後台在建立Django專案後,預設即提供了一個功能完整的後台,包含使用者的管理、群組管理及資料庫等,並且能夠依需求客製化,無須從頭開發,這也是Django能夠…