AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

【Qt编程】基于Qt的词典开发系列<八>--用户登录及API调用的实现

2015-06-23 1416
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 在上一篇文章《调用网络API》中，我只讲述了如何直观的使用API接口以及调用API后返回的结果，本文则从程序实现的角度来实现API的调用，当然本程序的实现也是借助于扇贝网的API接口文档http://www.shanbay.com/help/developer/api/。

在上一篇文章《调用网络API》中，我只讲述了如何直观的使用API接口以及调用API后返回的结果，本文则从程序实现的角度来实现API的调用，当然本程序的实现也是借助于扇贝网的API接口文档http://www.shanbay.com/help/developer/api/。

由API文档可知，要想调用其API，必须先注册。因此，我就注册了，账户名为nineheadedbird， 密码为123456。显然，我们要查词，首先必须得登录该账户。如果用浏览器，那就很简单，只需单纯的输入用户名和密码就可以了。可实际上，这一操作并不简单，只是浏览器为我们做了这一切。如果我们要通过程序来实现上述功能的话，就需要用到Qt中的get()函数了，而发送请求的内容格式就至关重要了。

查看请求格式

我们可以通过浏览器来查看请求格式：首先用谷歌浏览器(其他浏览器也可以，不过你要百度一下怎么来查看这些格式)打开扇贝网的登录界面http://www.shanbay.com/accounts/login/ ，在谷歌浏览器的设置中单击开发者选项，然后刷新一下页眉，就会出现如下的界面：
这里写图片描述

然后点击右边的第一个文件login，就会出现下面的内容：
这里写图片描述

从上图可以看出，内容分为三类：General、Response Headers、Request Headers
在General中可以看到Request Method为GET(一般还有另一种方式POST，这在Qt中都有对应的函数),Status Code为200表示正常。在Response Headers 中我们关注的是Set-Cookie中的csrftoken的值，因为这在我们登录时需要这个值。我们最关心的是Request Headers的内容，这部分就是我们请求函数中内容格式！参考上述的具体内容如下：
这里写图片描述

我们的程序可以写成如下的方式：

QNetworkRequest request;
        request.setUrl(QUrl("http://www.shanbay.com/accounts/login/"));
        request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
        request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
        request.setRawHeader("Cache-Control","max-age=0");
        request.setRawHeader("Connection","keep-alive");
        request.setRawHeader("Host","www.shanbay.com");
        request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
        http->get(request);

当我们执行上述的请求之后，服务器就会作答，作答的内容就是上面的Response Headers，而我们需要的是Set-Cookie中的csrftoken的值。在Qt中，我们将程序中finished信号与我们定义的槽关联，即每当网络应答结束时，都会发射这个信号，从而触发该槽函数的执行，来处理服务器的应答内容。在程序中，getCookie函数就是来获取csrftoken的值。

用户登录

获得csrftoken的值后，我们就需要实现登录操作了。除了上述的请求格式之外，我们还需要加入csrftoken的值、用户名以及密码。具体格式可见下述代码：

QNetworkRequest request;  request.setUrl(QUrl("http://www.shanbay.com/accounts/login/"));
       request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
       request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
       request.setRawHeader("Cache-Control","max-age=0");
       request.setRawHeader("Connection","keep-alive");
       request.setRawHeader("Host","www.shanbay.com");
       request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
       request.setRawHeader("Origin","http//www.shanbay.com");
       request.setRawHeader("Referer","http://www.shanbay.com/accounts/login/");
       request.setRawHeader("Host","www.shanbay.com");
       request.setRawHeader("Content-Type","application/x-www-form-urlencoded");
       QByteArray postData;
       postData.append(QString("csrfmiddlewaretoken=%1&").arg(sessionid));//csrftoken的值
       postData.append(QString("username=%1&password=%2&").arg(QUrl::toPercentEncoding(username).constData()).arg(password));//用户名及密码
       postData.append("login=登录&continue=home&u=1&next=");
       request.setHeader(QNetworkRequest::ContentLengthHeader,postData.size());
       httpAction=LoginAction;
       http->post(request,postData);

调用API

完成登录之后，就可以进行查词和添词操作了。除了上述提到的请求头格式之外，只需要遵守API规范（《调用网络API》中提到请求格式）即可。查词及添词的程序实现分别如下：

void netWork::queryWord(const QString &word)//查词操作
{
      QNetworkRequest request;
      request.setUrl(QUrl("http://www.shanbay.com/api/word/"+word));
      request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
      request.setRawHeader("Accept-Charset","GBK,utf-8;q=0.7,*;q=0.3");
      request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
      request.setRawHeader("Cache-Control","max-age=0");
      request.setRawHeader("Connection","keep-alive");
      request.setRawHeader("Host","www.shanbay.com");
      request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
      httpAction=QueryWordAction;
      http->get(request);
}

void netWork::addWord(const QString &word)//添词操作
{
    if(word.isEmpty())
        qDebug()<<"你的输入有误";
    else
    {
        QNetworkRequest request;
        request.setUrl(QUrl("http://www.shanbay.com/api/learning/add/"+word));
        request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
        request.setRawHeader("Accept-Charset","GBK,utf-8;q=0.7,*;q=0.3");
        request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
        request.setRawHeader("Cache-Control","max-age=0");
        request.setRawHeader("Connection","keep-alive");
        request.setRawHeader("Host","www.shanbay.com");
        request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
        httpAction=AddWordAction;
        http->get(request);
    }
}

完整流程

至此，API调用的各个功能已经实现，下面给出程序的整体思路：首先获取csrftoken的值（每次都不同）；然后利用用户名、密码及csrftoken的值来登录；接着就可以调用API了。在程序中，每当进行请求，都会在replyfinished函数中用case语句来分别处理这些请求对应的应答。注意，不要连续的进行请求，否则可能发生冲突。在程序中，为了防止冲突，我在connectNet请求后，在其应答处理函数中再进行loginShanbay的登录，然后在其应答函数中进行queryWord查词请求，然后在其对应的应答处理函数中进行addWord添词请求。其结果显示如下：

这里写图片描述

程序实现

下面我们给出具体的程序实现(qt 5版本，使用到网络类，需要加上QT += network)：首先建立一个空的qt子项目，然后添加一个名为netWork的类，继承自QObject，然后再添加一个名为main的源文件，这三个文件的内容分别如下：
1、network.h文件

#ifndef NETWORK_H
#define NETWORK_H


#include <QObject>
#include <QtNetwork/QNetworkAccessManager>
#include<QtNetwork/QNetworkReply>
#include<QtNetwork/QNetworkRequest>
#include<QtNetwork/QNetworkCookie>
#include<QtNetwork/QNetworkCookieJar>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QJsonValue>
#include<QString>
#include<QDebug>
#include<QList>
#include<QUrl>
#include<QByteArray>

class netWork : public QObject //由于程序文件直接摘自整个项目文件，所以程序中有关的定义或函数没有使用，但是这个程序可以单独运行
{
    Q_OBJECT
public:
    explicit netWork(QObject *parent = 0);
 //   ~netWork();


    enum HttpAction{NoAction,NetStudy,GetSessionidAction,LoginAction,QueryWordAction,AddWordAction,AddExampleAction,QueryWordExamplesAction};
    HttpAction httpAction;
    QNetworkAccessManager * http;
    QString sessionid;
    QString queryword;//要查询的单词
    QString nickname;
    QString username;
    QString password;
    bool isBusy;


    QString getCookie(const QString &name);

    void loginShanbay();
    void queryWord(const QString &word);
    void queryExamples(QString learningid);
    void connectNet(QString username="nineheadedbird", QString password="123456");
    void addWord(const QString &word);

signals://这里的信号都没有用到

    void connectSuccess(); 
    void connectFail();
    void verifySuccess();
    void verifyFail();
    void NetState(bool);
public slots:
    void replyfinished(QNetworkReply*);

};

#endif // NETWORK_H

2、network.cpp文件

#include "network.h"
#include<QList>
#include<QDesktopServices>
netWork::netWork(QObject *parent) :
    QObject(parent)
{
        http=new QNetworkAccessManager(this);
        http->setCookieJar(new QNetworkCookieJar(this));
        connect(http,SIGNAL(finished(QNetworkReply*)),this,SLOT(replyfinished(QNetworkReply*)));//将finished信号与我们定义的槽关联，每当网络应答结束时，都会发射这个信号
        isBusy=true;

}

QString netWork::getCookie(const QString &name)//用于获得SessionId
{
    foreach(QNetworkCookie cookie , http->cookieJar()->cookiesForUrl(QUrl("http://www.shanbay.com/")))
    {
            if(cookie.name()==name)
            {
                qDebug()<<"csrftoken:"<<cookie.value();
                return cookie.value();
            }
    }
        return "";
}
void netWork::connectNet(QString username, QString password)//连接网络,使用默认的用户名和密码
{
        this->username=username;
        this->password=password;
        QNetworkRequest request;
        request.setUrl(QUrl("http://www.shanbay.com/accounts/login/"));
        request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
        request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
        request.setRawHeader("Cache-Control","max-age=0");
        request.setRawHeader("Connection","keep-alive");
        request.setRawHeader("Host","www.shanbay.com");
        request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
        httpAction=GetSessionidAction;
        http->get(request);
}

void netWork::replyfinished(QNetworkReply *reply)//每当执行网站应答结束后，就会执行该槽函数
{
    QVariant status_code=reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);
    qDebug()<<"code_state="<<status_code;//网络状态,200代表正常，302代表重定向，404：not found等等
    if(status_code==QVariant::Invalid)//判断是否连接到网站,即当前设备能否上网
        emit NetState(false);
    else
        emit NetState(true);

    switch(httpAction)//根据我们都进行了什么网络请求
    {
    case NoAction:
        break;
    case GetSessionidAction://获取SessionId
        sessionid=getCookie("csrftoken");
        if(!sessionid.isEmpty())
        {
            emit connectSuccess();
            qDebug()<<("已经连接扇贝网，正在验证用户名密码...");
            loginShanbay();
        }else
        {
            emit connectFail();

             qDebug()<<("Cannot connect to the website!");
        }

        break;
    case LoginAction: //进行登录操作
        httpAction=NoAction;
        if(0==reply->readAll().size())
        {
            QString nickname=QUrl::fromPercentEncoding(getCookie("username").toLatin1());
            emit verifySuccess();

            qDebug()<<"Successfully Login"<<nickname;
            queryWord("hello");
        }else
        {
            emit verifyFail();
            qDebug()<<"Failed to login!";
        }
        break;

    case QueryWordAction://查词操作
        qDebug()<<"----query word----";
        qDebug()<<reply->readAll();//读取查词结果

        addWord("hello");//添加单词到单词本
        break;
    case AddWordAction://添词操作
        qDebug()<<"---add word----";
        qDebug()<<reply->readAll();//返回添加词语的learning_id
        break;
    default:break;
    }
}

void netWork::loginShanbay()//账户密码的登录操作
{
       QNetworkRequest request;
       request.setUrl(QUrl("http://www.shanbay.com/accounts/login/"));
       request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
       request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
       request.setRawHeader("Cache-Control","max-age=0");
       request.setRawHeader("Connection","keep-alive");
       request.setRawHeader("Host","www.shanbay.com");
       request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
       request.setRawHeader("Origin","http//www.shanbay.com");
       request.setRawHeader("Referer","http://www.shanbay.com/accounts/login/");
       request.setRawHeader("Host","www.shanbay.com");
       request.setRawHeader("Content-Type","application/x-www-form-urlencoded");
       QByteArray postData;
       postData.append(QString("csrfmiddlewaretoken=%1&").arg(sessionid));
       postData.append(QString("username=%1&password=%2&").arg(QUrl::toPercentEncoding(username).constData()).arg(password));
       postData.append("login=登录&continue=home&u=1&next=");
       request.setHeader(QNetworkRequest::ContentLengthHeader,postData.size());
       httpAction=LoginAction;
       http->post(request,postData);

}

void netWork::queryWord(const QString &word)//查词操作
{
      QNetworkRequest request;
      request.setUrl(QUrl("http://www.shanbay.com/api/word/"+word));
      request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
      request.setRawHeader("Accept-Charset","GBK,utf-8;q=0.7,*;q=0.3");
      request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
      request.setRawHeader("Cache-Control","max-age=0");
      request.setRawHeader("Connection","keep-alive");
      request.setRawHeader("Host","www.shanbay.com");
      request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
      httpAction=QueryWordAction;
      http->get(request);
}



void netWork::addWord(const QString &word)//添词操作
{
    if(word.isEmpty())
        qDebug()<<"你的输入有误";
    else
    {
        QNetworkRequest request;
        request.setUrl(QUrl("http://www.shanbay.com/api/learning/add/"+word));
        request.setRawHeader("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
        request.setRawHeader("Accept-Charset","GBK,utf-8;q=0.7,*;q=0.3");
        request.setRawHeader("Accept-Language","zh-CN,zh;q=0.8");
        request.setRawHeader("Cache-Control","max-age=0");
        request.setRawHeader("Connection","keep-alive");
        request.setRawHeader("Host","www.shanbay.com");
        request.setRawHeader("User-Agent","Mozilla/5.0 (Windows NT 6.1) AppleWebKit/535.7 (KHTML, like Gecko) Chrome/16.0.912.63 Safari/535.7");
        httpAction=AddWordAction;
        http->get(request);
    }
}

3、main.cpp文件

#include <QApplication>
#include "network.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    netWork *nW = new netWork();
   //
    nW->connectNet();
  //  nW->loginShanbay();
  //  nW->queryWord("hello");
    return a.exec();
}

基于Qt的词典开发系列

  1. 词典框架设计及成品展示
  2. 本地词典的设计
  3. 开始菜单的设计
  4. 无边框窗口的缩放与拖动
  5. 无边框窗口的拖动
  6. 界面美化设计
  7. 调用网络API
  8. 用户登录及API调用的实现
  9. JSON数据解析
  10. 国际音标的显示
  11. 系统托盘的显示
  12. 调用讲述人
  13. 音频播放
  14. 自动补全功能
  15. HTML特殊字符及正则表达式
  16. 后序

作品下载地址（发布版）：http://download.csdn.net/detail/tengweitw/8548767
作品下载地址（绿色版）：http://download.csdn.net/detail/tengweitw/8830495
源码下载地址：http://download.csdn.net/detail/tengweitw/8830503

原文：http://blog.csdn.net/tengweitw/article/details/45932429

作者：nineheadedbird

文章标签：
API
Windows
Web App开发
数据格式
数据安全/隐私保护
关键词：
API开发
开发API
API编程
编程API
Qt开发
tengweitw
目录
相关文章
土木林森
|
8天前
|
XML JSON API
ServiceStack：不仅仅是一个高性能Web API和微服务框架，更是一站式解决方案——深入解析其多协议支持及简便开发流程，带您体验前所未有的.NET开发效率革命
【10月更文挑战第9天】ServiceStack 是一个高性能的 Web API 和微服务框架，支持 JSON、XML、CSV 等多种数据格式。它简化了 .NET 应用的开发流程，提供了直观的 RESTful 服务构建方式。ServiceStack 支持高并发请求和复杂业务逻辑，安装简单，通过 NuGet 包管理器即可快速集成。示例代码展示了如何创建一个返回当前日期的简单服务，包括定义请求和响应 DTO、实现服务逻辑、配置路由和宿主。ServiceStack 还支持 WebSocket、SignalR 等实时通信协议，具备自动验证、自动过滤器等丰富功能，适合快速搭建高性能、可扩展的服务端应用。
土木林森
46 3
代码bug生产队
|
11天前
|
设计模式 API 开发者
探索现代后端开发：微服务架构与API设计
【10月更文挑战第6天】探索现代后端开发：微服务架构与API设计
代码bug生产队
28 0
爱的不是纯牛奶-47754
|
6天前
|
缓存 监控 前端开发
利用GraphQL提升API开发效率
【10月更文挑战第10天】本文介绍了GraphQL的核心概念、优势及其实现步骤，探讨了其在现代开发中的应用，包括动态数据需求、单页应用和微服务架构。通过缓存策略、批处理、安全性和监控等实战技巧，提升API开发效率和用户体验。
爱的不是纯牛奶-47754
10 1
爱的不是纯牛奶-47754
|
9天前
|
监控 Cloud Native API
利用声明式API管理提高开发效率
【10月更文挑战第8天】声明式API管理通过声明式配置简化了API的定义和管理，提高了开发效率和可维护性。本文介绍了声明式API管理的核心优势、实施步骤及其在微服务、云原生应用和跨团队协作中的应用，并提供了实战技巧。
爱的不是纯牛奶-47754
33 1
爱的不是纯牛奶-47754
|
16天前
|
安全 API 数据库
掌握GraphQL：现代API开发的新选择
【10月更文挑战第1天】在传统RESTful API显现出局限性后，GraphQL作为新型API查询语言和运行时，提供更灵活的数据获取方式。客户端可精确指定所需数据结构，减少传输量并提升效率。本文探讨GraphQL核心概念、优势及实施方法。尽管存在复杂性和性能优化等挑战，GraphQL仍是构建现代API的强大工具。
爱的不是纯牛奶-47754
44 3
taro_秋刀鱼
|
2月前
|
机器人 API Python
智能对话机器人(通义版)会话接口API使用Quick Start
本文主要演示了如何使用python脚本快速调用智能对话机器人API接口，在参数获取的部分给出了具体的获取位置截图，这部分容易出错，第一次使用务必仔细参考接入参数获取的位置。
taro_秋刀鱼
173 1
游客zbd2htthkjuby
|
2天前
|
编解码 监控 API
直播源怎么调用api接口
调用直播源的API接口涉及开通服务、添加域名、获取API密钥、调用API接口、生成推流和拉流地址、配置直播源、开始直播、监控管理及停止直播等步骤。不同云服务平台的具体操作略有差异，但整体流程简单易懂。
游客zbd2htthkjuby
14 2
深语人工智能DeepNLP
|
15天前
|
人工智能 自然语言处理 PyTorch
Text2Video Huggingface Pipeline 文生视频接口和文生视频论文API
文生视频是AI领域热点，很多文生视频的大模型都是基于 Huggingface的 diffusers的text to video的pipeline来开发。国内外也有非常多的优秀产品如Runway AI、Pika AI 、可灵King AI、通义千问、智谱的文生视频模型等等。为了方便调用，这篇博客也尝试了使用 PyPI的text2video的python库的Wrapper类进行调用，下面会给大家介绍一下Huggingface Text to Video Pipeline的调用方式以及使用通用的text2video的python库调用方式。
深语人工智能DeepNLP
62 4
技术交流18179014480
|
14天前
|
JSON JavaScript API
（API接口系列）商品详情数据封装接口json数据格式分析
在成长的路上，我们都是同行者。这篇关于商品详情API接口的文章，希望能帮助到您。期待与您继续分享更多API接口的知识，请记得关注Anzexi58哦！
技术交流18179014480
42 1
众所周知
|
1月前
|
安全 API 开发者
Web 开发新风尚！Python RESTful API 设计与实现，让你的接口更懂开发者心！
在当前的Web开发中，Python因能构建高效简洁的RESTful API而备受青睐，大大提升了开发效率和用户体验。本文将介绍RESTful API的基本原则及其在Python中的实现方法。以Flask为例，演示了如何通过不同的HTTP方法（如GET、POST、PUT、DELETE）来创建、读取、更新和删除用户信息。此示例还包括了基本的路由设置及操作，为开发者提供了清晰的API交互指南。
众所周知
95 6

热门文章

最新文章

  • 1
    Qt实用技巧：在Qt中获取屏幕的绝对坐标
  • 2
    Windows在线安装QT5.15.2
  • 3
    Qt编写自定义控件35-GIF录屏控件
  • 4
    Qt/E服务器客户端的通信机制
  • 5
    6.QT信号和槽
  • 6
    Qt动态添加控件并设置大小位置等属性
  • 7
    QT软件开发: 基于FFMPGE设计的流媒体播放器(rtmp/rtsp)
  • 8
    Qt编写安防视频监控系统4-删除视频
  • 9
    Qt核心剖析：信息隐藏(2)
  • 10
    PyCharm安装PyQt5及其工具（Qt Designer、PyUIC、PyRcc）详细教程
  • 1
    Vue3有哪些常用的API
    51
  • 2
    Elasticsearch 8.10 同义词管理新篇章：引入同义词 API
    153
  • 3
    记录openai官网关于Setup your API key for a single project(为单个项目设置API 可以)的错误（2023/11/24）
    128
  • 4
    API在电子商务中的应用与优势：深入解析
    64
  • 5
    阿里云大佬叮嘱我务必要科普这个 Elasticsearch API
    65
  • 6
    电商数据分析的利器：电商关键词搜索API接口（标题丨图片丨价格丨链接）
    116
  • 7
    深入理解RESTful API设计原则与实践
    107
  • 8
    📑教你如何编写一份 API 文档
    104
  • 9
    请问下钉钉有能够获取到群聊天和个人聊天历史记录的api嘛？
    76
  • 10
    淘宝商品评论数据获取：从API调用到应用实践
    123

    • 相关电子书

    更多
  • Spring Boot2.0实战Redis分布式缓存
  • CUDA MATH API
  • API PLAYBOOK

    • 相关实验场景

    更多
  • 快速体验智能体API应用
  • 基于Assistant Api的旅游助手
  • 函数计算入门-HelloWorld应用开发

    • 推荐镜像

    更多
  • qt
  • python-release
  • blender
    • 下一篇
    AI助理直击要害，从繁复中提炼精华——使用CDN加速访问OSS存储的图片