摘要：使用之前安裝安裝并啟動(dòng)它選擇或者用來(lái)測(cè)試，推薦第一個(gè)創(chuàng)建兩個(gè)文件和放在同一目錄下，第一次用的兩個(gè)坑，一個(gè)是沒(méi)啟動(dòng)，一個(gè)就是這個(gè)了是設(shè)置文件，包含各種配置，必須存在一個(gè)名為的字典，定義了要提供的資源以字典形式表示在寫(xiě)入如下內(nèi)容就不解釋了在中寫(xiě)

安裝 eve
安裝 mongodb, 并啟動(dòng)它
選擇 curl或者postman 用來(lái)測(cè)試，推薦postman

創(chuàng)建兩個(gè)文件main.py 和 settings.py放在同一目錄下，第一次用eve的兩個(gè)坑，一個(gè)是mongodb沒(méi)啟動(dòng)，一個(gè)就是這個(gè)setting.py了

settting.py是設(shè)置文件，包含各種配置，必須存在一個(gè)名為DOMAIN的字典，DOMAIN定義了要提供的資源 以字典形式表示
在settings.py寫(xiě)入如下內(nèi)容

DOMAIN = {"people": {}}

main.py就不解釋了
在main.py中寫(xiě)入如下內(nèi)容

    from eve import Eve
    app = Eve()
    app.run()

Eve是基于Flask的，所以這樣的寫(xiě)法對(duì)于用過(guò)Flask的人應(yīng)該很熟悉
然后運(yùn)行 main.py 用postman做get請(qǐng)求訪問(wèn) http://127.0.0.1:5000 可以得到類(lèi)似下面的結(jié)果

    {
        "_links": {
            "child": [
                {
                    "title": "people",
                    "href": "people"
                }
            ]
        }
    }

Eve的api遵循HATEOAS原則,關(guān)于HATEOAS，可以看維基和這篇文章

之后用postman訪問(wèn) http://127.0.0.1:5000/people 這個(gè)資源，得到如下內(nèi)容

    {
        "_items": [],
        "_links": {
            "self": {
                "title": "people",
                "href": "people"
            },
            "parent": {
                "title": "home",
                "href": "/"
            }
        },
        "_meta": {
            "max_results": 25,
            "total": 0,
            "page": 1
        }
    }

可以得到一個(gè)items列表，links和meta，items是該資源組中所有資源，links中包含self和parent，是指向自己和所在資源組的連接，meta是元信息，這里不討論
默認(rèn)情況下。這些api都是只讀的，PUT,POST或者DELETE操作都會(huì)返回405

如果想要允許讀寫(xiě)，在setting中寫(xiě)入

# 啟用對(duì)資源組的增刪查
# 如果忽略這一行，默認(rèn)只提供查
RESOURCE_METHODS = ["GET", "POST", "DELETE"]

# 啟用對(duì)單個(gè)資源的增刪改查
# 忽略情況下只提供查
ITEM_METHODS = ["GET", "PATCH", "PUT", "DELETE"]

這些設(shè)置是全局的，會(huì)影響到所有資源和資源組的設(shè)定，可以在各個(gè)資源點(diǎn)獨(dú)立設(shè)定允許的方法
可選：

    MONGO_HOST = "localhost"
    MONGO_PORT = 27017
    
    MONGO_USERNAME = ""
    MONGO_PASSWORD = ""
    
    MONGO_DBNAME = "apitest"

我們給第一個(gè)demo補(bǔ)上添加的功能

數(shù)據(jù)驗(yàn)證：
創(chuàng)建一個(gè)字典schema，定義people的結(jié)構(gòu)

    schema = {
        "firstname":{
                "type":"string",
                "minlength": 1,
                "maxlength":10,
            },
        "lastname":{
                "type": "string",
                "minlength": 1,
                "maxlength": 115,
                "required": True
            },
        "role":{
            "type":"list",
            "allowed":["author","contributor","copy"],
        },
        "location":{
            "type":"dict",
            "schema":{
                "address":{"type":"string"},
                "city":{"type":"string"}
            }
        },
        "born":{
            "type":"datetime",
        },
    }

這是基于Cerberus語(yǔ)法的模式定義的，具體語(yǔ)法可以看Cerberus官網(wǎng)
之后我們?cè)O(shè)置people屬性

    people= {
        "item_title": "person",
        # 默認(rèn)情況下查找資源要同過(guò)/people/才能找到
        # 這里添加新的只讀路徑，可以通過(guò)lastname來(lái)獲得資源
        "additional_lookup": {
            "url":"regex("[w]+")",
            "field":"lastname",
        },
        # 控制緩存
        "cache_control":"max-age=10,must-revalidate",
        "cache_expires": 10,
        # 覆蓋全局的讀寫(xiě)方法
        "resource_methods":["GET","POST"],
        # 設(shè)定結(jié)構(gòu)
        "schema":schema,
    }

最后更新資源設(shè)置

    DOMAIN={"people":people}

用postman做post添加數(shù)據(jù)

[{"firstname": "barack", "lastname": "obama"}, {"firstname": "mitt", "lastname": "romney"}]

然后查看數(shù)據(jù) http://127.0.0.1:5000/people

    {
        "_items": [
            {
                "_id": "5a30e8527111c41e885ff38a",
                "firstname": "barack",
                "_etag": "adab38db64dea06ebfe1c0e783a28bde88565c3f",
                "_links": {
                    "self": {
                        "href": "people/5a30e8527111c41e885ff38a",
                        "title": "person"
                    }
                },
                "_created": "Wed, 13 Dec 2017 08:44:02 GMT",
                "lastname": "obama",
                "_updated": "Wed, 13 Dec 2017 08:44:02 GMT"
            },
            {
                "_id": "5a30e8527111c41e885ff38b",
                "firstname": "mitt",
                "_etag": "39426631ce8050ff7ad6982e02281289cff4919b",
                "_links": {
                    "self": {
                        "href": "people/5a30e8527111c41e885ff38b",
                        "title": "person"
                    }
                },
                "_created": "Wed, 13 Dec 2017 08:44:02 GMT",
                "lastname": "romney",
                "_updated": "Wed, 13 Dec 2017 08:44:02 GMT"
            }
        ],
        "_meta": {
            "page": 1,
            "max_results": 25,
            "total": 2
        },
        "_links": {
            "parent": {
                "href": "/",
                "title": "home"
            },
            "self": {
                "href": "people",
                "title": "people"
            }
        }
    

通過(guò)新增加的路徑查看 http://127.0.0.1:5000/people/obama

    {
        "_created": "Wed, 13 Dec 2017 07:24:04 GMT",
        "lastname": "obama",
        "_links": {
            "parent": {
                "title": "home",
                "href": "/"
            },
            "collection": {
                "title": "people",
                "href": "people"
            },
            "self": {
                "title": "person",
                "href": "people/5a30d5947111c40f80df511e"
            }
        },
        "_updated": "Wed, 13 Dec 2017 07:24:04 GMT",
        "_etag": "94237cbea7a9a93d6db2dfb1c78a6ee84c4f8c89",
        "_id": "5a30d5947111c40f80df511e",
        "firstname": "barack"
    }

感覺(jué)還行