luffy项目后端轮播图接口

后台主页功能

需求

根据原型图，分析出首页需要配合俩接口

1. 轮播图接口（要写）
   • 查询所有轮播图
2. 推荐课程接口(暂时先不写)

设计表

• 轮播图表：Banner

写轮播图接口

• 查询所有轮播图

轮播图表

写一个公共表模型且只用于继承

from django.db import models

class BaseModel(models.Model):
    # 是否显示，记录插入时间，最后修改时间，是否删除（软删除），排序
    # 课程表，也需要这些字段
    created_time = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
    updated_time = models.DateTimeField(auto_now=True, verbose_name='最后更新时间')
    is_delete = models.BooleanField(default=False, verbose_name='是否删除')
    is_show = models.BooleanField(default=True, verbose_name='是否上架')
    orders = models.IntegerField(verbose_name='优先级')

    class Meta:
        abstract = True  # 这个表，只用来继承，不会再数据库生成表

轮播图表

from utils.common_model import BaseModel
class Banner(BaseModel):
    title = models.CharField(max_length=16, unique=True, verbose_name='名称')
    image = models.ImageField(upload_to='banner', verbose_name='图片')  # 地址，存放轮播图的地址
    link = models.CharField(max_length=64, verbose_name='跳转链接')
    info = models.TextField(verbose_name='详情')  # 也可以用详情表，宽高出处

    class Meta:
        db_table = 'luffy_banner'
        verbose_name_plural = '轮播图表'

    def __str__(self):
        return self.title

轮播图接口

视图类

from rest_framework.mixins import ListModelMixin
from rest_framework.viewsets import GenericViewSet
from .models import Banner
from .serializer import BannerSerializer
from django.conf import settings

class BannerView(GenericViewSet, ListModelMixin):
    # 按orders排序,且只显示多少张
    queryset = Banner.objects.filter(is_delete=False, is_show=True).order_by('orders')[:settings.BANNER_COUNT]
    serializer_class = BannerSerializer

序列化类

from .models import Banner
from rest_framework import serializers

class BannerSerializer(serializers.ModelSerializer):
    class Meta:
        model = Banner
        fields = ['id', 'image', 'link']

路由

from .views import BannerView
from rest_framework.routers import SimpleRouter

router = SimpleRouter()
router.register('banner', BannerView, 'banner')

urlpatterns = []
urlpatterns += router.urls

路由分发

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/v1/home/', include('luffy01.apps.home.urls'))
]

设置

# 写一个user专用设置文件
BANNER_COUNT=3

# 在设置文件中导入user设置
from .user_settings import *

轮播图显示接口

显示轮播图需要一个图片地址接口，和图片点击的跳转

1. 需要将上传的图片全保存在media文件夹中
   • 在项目中创建一个media文件夹
2. 开放media文件夹，和图片的url地址
   • 在配置文件中

   MEDIA_ROOT = os.path.join(BASE_DIR,'media')
   MEDIA_URL = 'media/'
   # 取出的文件地址，拼接上media这个目录
   # http://127.0.0.1:8000/media/banner/banner1.png
   

3. 写图片路由
   就可以通过图片地址访问图片

   from django.views.static import serve
   from django.conf import settings
   
   urlpatterns = [
       path('media/<path:path>', serve, {'document_root': settings.MEDIA_ROOT})
   ]
   

4. 添加轮播图图片
   • 安装admin美化模块: pip install django-simpleui，并在apps中注册
   • 创建一个超级用户，后台登录：python manage.py createsuperuser
   • 在admin中注册轮播图表，在admin文件夹中

     from django.contrib import admin
     from .models import Banner
     admin.site.register(Banner)
     

   • 在admin后台管理中，轮播图表中添加图片就会自动保存在media文件夹中