环境

以下环境仅代表本文测试环境,其它版本应该也可以。
* 虚拟机 Linux: CentOS Linux release 7.4.1708 (Core)
* 物理机 Windows: Windows 10 1709
* 移动端 Android: 7.1.1

CentOS 7 网络配置

虚拟机配置(在物理机 Windows 10 中)

需将网络连接方式改为桥接模式,否则手机端无法连接到虚拟机中的CentOS,Vmware和VirtualBox都有这个功能,不赘述。

查看物理机网络配置(在物理机 Windows 10 中)

右键开始菜单,打开Windows PowerShell(此处为无线连接,有线连接可以去查看有线网卡)

PS C:\Users\smy13> ipconfig
...

无线局域网适配器 WLAN:

   连接特定的 DNS 后缀 . . . . . . . : DHCP HOST
   本地链接 IPv6 地址. . . . . . . . : fe80::b441:8184:1b12:d4fb%4
   IPv4 地址 . . . . . . . . . . . . : 192.168.0.111
   子网掩码  . . . . . . . . . . . . : 255.255.255.0
   默认网关. . . . . . . . . . . . . : 192.168.0.1

...

记住以上的子网掩码默认网关,以下会用到

设置静态IP(在CentOS 中)

打开/etc/sysconfig/network-scripts/ifcfg-ens33,最后的ifcfg-ens33为网卡名,不一定是这个名字,一般都以ifcfg-开头。

vi /etc/sysconfig/network-scripts/ifcfg-ens33

将配置文件改为如下(重点为最后六行,说明见注释)

TYPE=Ethernet
PROXY_METHOD=none
BROWSER_ONLY=no
# BOOTPROTO=dhcp  # 默认IP获取方式为DHCP,需注释掉
DEFROUTE=yes
IPV4_FAILURE_FATAL=no
IPV6INIT=yes
IPV6_AUTOCONF=yes
IPV6_DEFROUTE=yes
IPV6_FAILURE_FATAL=no
IPV6_ADDR_GEN_MODE=stable-privacy
NAME=ens33
UUID=227a8a72-2a97-468c-91c2-d0851ddec08e
DEVICE=ens33
ONBOOT=yes

# 添加以下内容
BOOTPROTO=static  # 设置IP获取方式为静态
IPADDR=192.168.0.200  # 你想设置的静态IP
NETMASK=255.255.255.0  # 刚在物理机中看到的子网掩码
GATEWAY=192.168.0.1  # 刚在物理机中看到的默认网关
DNS1=192.168.0.1  # 设置为默认网关
DNS2=8.8.8.8  # 勿动

重启网络

systemctl restart network

可以通过ping www.baidu.com查看是否配置成功

[root@localhost ~]# ping www.baidu.com
PING www.a.shifen.com (115.239.211.112) 56(84) bytes of data.
64 bytes from www.baidu.com (115.239.211.112): icmp_seq=1 ttl=54 time=12.1 ms
64 bytes from www.baidu.com (115.239.211.112): icmp_seq=2 ttl=54 time=8.19 ms
64 bytes from www.baidu.com (115.239.211.112): icmp_seq=3 ttl=54 time=9.76 ms
64 bytes from www.baidu.com (115.239.211.112): icmp_seq=4 ttl=54 time=12.3 ms

防火墙配置

配置firewalld

firewall-cmd --permanent --zone=public --add-service=samba
firewall-cmd --reload

关闭selinux

setenforce 0

打开selinux配置文件

vi /etc/selinux/config

将配置文件中的SELINUX=enforcing改为SELINUX=disabled以禁止selinux开机自启

samba 配置

安装 samba 包及依赖

安装 samba 包

yum install samba -y

开启samba服务并设置为开机自启

systemctl start smb
systemctl enable smb

配置共享文件夹

建立共享目录,(/samba/haha/为将来要共享的文件夹,可自定义)

mkdir /samba/haha/ -p

修改目录用户组及权限

chown -R nobody:nobody /samba/haha/
chmod -R 755 /samba/haha/

修改 samba 配置文件

修改配置文件

vi /etc/samba/smb.conf

配置文件如下(说明见注释)

[global]  # 公共配置
        workgroup = WORKGROUP  # 工作组,建议和宿主机保持一致
        server string = Samba Server Version %v  # samba服务器名称,就这样设置就行,%v表示版本号
        max connections = 0  # 最大连接数,0表示不限制
        log file = /var/log/samba/log.%m  # 日志文件存放路径,%m表示连接设备名
        security = user  # 设置Samba Server共享目录只能被授权的用户访问
        passdb backend = smbpasswd  # 使用smb自己的工具smbpasswd来给系统用户(真实用户或者虚拟用户)设置一个Samba密码
        encrypt passwords = yes  # 密码加密
        smb passwd file = /etc/samba/smbpasswd  # smbpasswd文件的目录,有些版本的samba可能需要手动创建该文件
        # 以下四行为设置在共享目录创建文件和文件夹的默认权限
        create mask = 0644
        force create mode = 0644
        directory mask = 0755
        force directory mode = 0755

[haha]  # 私有配置,haha这个名字可自定义
        comment = haha  # 共享名,任意字符串
        path = /samba/haha  # 共享目录路径
        writable = yes  # 指定该共享路径为可写

添加账户到 samba 账户中,并配置单独的密码

[root@localhost ~]# smbpasswd -a root
New SMB password:
Retype new SMB password:

重启samba服务

systemctl restart smb

拷贝物理机中的视频

打开文件资源管理器,在地址栏输入\\192.168.0.200(192.168.0.200为 CentOS 中设置的静态IP),就可以看到我们配置的haha共享目录了,将视频文件复制进去即可。

手机端操作

  • 安装ES文件浏览器和MX 播放器,酷安和豌豆荚都有。

  • 安装完之后打开ES文件浏览器,点击左上角的菜单栏中的”我的网络”
    1

  • 点击右上角菜单-新建-局域网,服务器名为在 CentOS 中设置的静态IP,用户名和密码为刚才执行smbpasswd -a root的用户(root)和密码
    2

  • 之后点进去就可以看到我们刚才存在samba服务器中的视频了,选择使用MX播放器播放即可在线播放,加载速度由局域网决定,一般电影都足够了。
    3

博客更新地址

Schemas是一种机器可读的文档,描述了API的端点,它们的URLs和所支持的操作。
Schemas可以用于自动生成文档,也可以用来驱动可以与API交互的动态客户端库。

Core API

为了提供Schemas支持,REST框架使用了Core API。
安装coreapi

pip install coreapi

添加schema

REST框架既支持自定义Schemas视图,也支持自动生成Schemas视图。
由于我们使用的是viewset和route,我们可以简单地自动生成Schemas视图。

现在我们需要通过在URL中配置一个自动生成的Schemas视图,为我们的API添加一个Schemas。
编辑urls.py

from rest_framework.schemas import get_schema_view

schema_view = get_schema_view(title='Pastebin API')

urlpatterns = [
    url(r'^schema/$', schema_view),
    ...
]

我们通过命令行的形式访问该接口,并指定接收格式为corejson

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# http https://127.0.0.1:80/schema/ Accept:application/coreapi+json
HTTP/1.0 200 OK
Allow: GET, HEAD, OPTIONS
Content-Length: 1498
Content-Type: application/coreapi+json
Date: Fri, 01 Dec 2017 12:04:53 GMT
Server: WSGIServer/0.2 CPython/3.6.3
Vary: Accept, Cookie
X-Frame-Options: SAMEORIGIN

{
    "_meta": {
        "title": "Pastebin API",
        "url": "https://127.0.0.1/schema/"
    },
    "_type": "document",
    "snippets": {
        "highlight": {
            "_type": "link",
            "action": "get",
...

使用命令行客户端

既然我们的API提供了一个Schemas url,我们可以使用一个动态的客户端来与API进行交互。
为了演示,我们使用Core API客户端。
安装coreapi-cli

pip install coreapi-cli

使用命令行客户端访问schema接口

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# coreapi get https://127.0.0.1:80/schema/
<Pastebin API "https://127.0.0.1/schema/">
    snippets: {
        list()
        read(id)
        highlight(id)
    }
    users: {
        list()
        read(id)
    }

由于我们没有登录,所以我们现在只能看到只读的接口。

列出现有的所有snippets

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# coreapi action snippets list
[
    {
        "url": "https://127.0.0.1/snippets/1/",
        "id": 1,
        "highlight": "https://127.0.0.1/snippets/1/highlight/",
        "owner": "song",
        "title": "test_1",
        "code": "print('hello world')",
        "linenos": true,
        "language": "python",
        "style": "friendly"
    },
]

有些API需要一些命名参数

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# coreapi action snippets highlight --param id=1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
   "https://www.w3.org/TR/html4/strict.dtd">

<html>
<head>
  <title>test_1</title>
  <meta http-equiv="content-type" content="text/html; charset=None">
  <style type="text/css">
td.linenos { background-color: #f0f0f0; padding-right: 10px; }
span.lineno { background-color: #f0f0f0; padding: 0 5px 0 5px; }
pre { line-height: 125%; }
...

登录

需要写入的接口需要我们登录才能做,通过以下命令进行登录(test:qazxswedc为用户名和密码)

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# coreapi credentials add 127.0.0.1 test:qazxswedc --auth basic
Added credentials
127.0.0.1 "Basic dGVzdDpxYXp4c3dlZGM="

重载

(django_rest_framework) [root@iZuf62kvdczytcyqlvr2pgZ django_rest_framework]# coreapi reload
Pastebin API "https://127.0.0.1:80/schema/">
    snippets: {
        create(code, [title], [linenos], [language], [style])
        delete(id)
        highlight(id)
        list()
        partial_update(id, [title], [code], [linenos], [language], [style])
        read(id)
        update(id, code, [title], [linenos], [language], [style])
    }
    users: {
        list()
        read(id)
    }

我们现在可以对数据进行写操作了

coreapi action snippets delete --param id=1

关于

本人是初学Django REST framework,Django REST framework 学习纪要系列文章是我从官网文档学习后的初步消化成果,如有错误,欢迎指正。

学习用代码Github仓库:shelmingsong/django_rest_framework

本文参考的官网文档:Tutorial 7: Schemas & client libraries

博客更新地址