SQLAlchemy 分离对象

发表于 2022-04-11 阅读次数： Valine：

i = session.query(Model)
session.expunge(i)

old_id = i.id
i.id = None
session.add(i)
session.flush()
print(i.id) #New ID

修改从 SQLAlchemy 查询出来的模型会提交的缓冲里, 例如上述代码会导致查询出来的模型id被修改为None

如何分离一份模型出来使其修改不影响数据库的提交?

可以使用make_transient()函数

1	from sqlalchemy.orm import make_transient

inst = session.query(Model).first()
session.expunge(inst)

make_transient(inst)
inst.id = None
session.add(inst)
session.flush()
print(inst.id) #New ID

参考链接

https://docs.sqlalchemy.org/en/14/orm/session_api.html?highlight=make_transient#sqlalchemy.orm.make_transient
https://qa.1r1g.com/sf/ask/1024533471/

Javascript中的函数返回多个值

发表于 2022-04-11 阅读次数： Valine：

当使用 Javascript 调用函数的时候只能通过 return 返回一个值

const getAge = () => {
  return 37
}
const getName = () => {
return ‘Flavio’
}

当需要返回多个值的时候可以通过解构的方式获得

通过数组

1
2
3

const getDetails = () => {
  return [37, 'Flavio']
}

通过数组结构, 我们可以这样获得

1	const [age, name] = getDetails()

现在我们有了age和name包含这些值的变量

但是需要注意获取的顺序.

通过对象

也可以返回一个对象然后解构

const getDetails = () => {
  return { 
    age: 37, 
    name: 'Flavio'
  }
}
const { age, name } = getDetails()

1	const { age, name } = getDetails()

此时顺序将不再重要, 因为这些都是命名参数

参考链接

https://tech-wiki.online/tw/javascript-return-multiple-values.html

PowerShell设置全局代理

发表于 2022-04-05 阅读次数： Valine：

在 PowerShell 里输入环境变量

格式

1 2	$env:HTTP_PROXY="http://域名:端口" $env:HTTPS_PROXY="http://域名:端口"

例如

1 2	$env:HTTP_PROXY="http://127.0.0.1:10809" $env:HTTPS_PROXY="http://127.0.0.1:10809"

参考链接

https://blog.csdn.net/weixin_44120025/article/details/110950434

[Vue warn]: Non-function value encountered for default slot

发表于 2022-04-05 阅读次数： Valine：

开发工具警告信息:

1	[Vue warn]: Non-function value encountered for default slot. Prefer function slots for better performance.

原因是组件插槽所插入的是插槽内容，而非函数值。Vue3 推荐使用函数式插槽，以便获得更佳的性能。

不推荐的写法

1	h(AtActionSheetHeader, null, props.title) // 不推荐的写法

推荐的写法

1	h(AtActionSheetHeader, null, { default: () => props.title })

参考链接

https://github.com/b2nil/taro-ui-vue3/issues/3

npm install --save core-js/modules/es.error.cause.js 报错

发表于 2022-04-04 阅读次数： Valine：

在启动项目时，出现 npm install –save core-js/modules/es.error.cause.js 的错误

解决方案

先删除 node_modules 依赖

1	npm rm -rf node_modules

首先安装 报错的插件

1	npm install --save core-js

最后再 npm install 或者 yarn install

1 2	npm install yarn install

最后 npm run dev 运行启动

1	npm run dev

转载

https://blog.csdn.net/Missbelover/article/details/123221351

Javascript 中那些奇怪的符号

发表于 2022-04-04 阅读次数： Valine：

摘自

https://developer.mozilla.org/zh-CN/docs/Web/JavaScript

展开语法(Spread syntax)

展开语法(Spread syntax), 可以在函数调用/数组构造时, 将数组表达式或者string在语法层面展开；还可以在构造字面量对象时, 将对象表达式按key-value的方式展开。(译者注: 字面量一般指 [1, 2, 3] 或者 {name: “mdn”} 这种简洁的构造方式)

function sum(x, y, z) {
  return x + y + z;
}

const numbers = [1, 2, 3];

console.log(sum(...numbers));
// expected output: 6

console.log(sum.apply(null, numbers));
// expected output: 6

数组拷贝

var arr = [1, 2, 3];
var arr2 = [...arr]; // like arr.slice()
arr2.push(4);

// arr2 此时变成 [1, 2, 3, 4]
// arr 不受影响

注意实际上, 展开语法和 Object.assign() 行为一致, 执行的都是浅拷贝(只遍历一层)。如果想对多维数组进行深拷贝, 下面的示例就有些问题了。

var a = [[1], [2], [3]];
var b = [...a];
b.shift().shift(); // 1
// Now array a is affected as well: [[2], [3]]

链接多个数组

Array.concat函数常用于将一个数组连接到另一个数组的后面。如果不使用展开语法, 代码可能是下面这样的

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
// 将 arr2 中所有元素附加到 arr1 后面并返回
var arr3 = arr1.concat(arr2);

使用展开语法:

1
2
3

var arr1 = [0, 1, 2];
var arr2 = [3, 4, 5];
var arr3 = [...arr1, ...arr2];

详情参考

https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Operators/Spread_syntax

可选链操作符(?.)

可选链操作符( ?. )允许读取位于连接对象链深处的属性的值，而不必明确验证链中的每个引用是否有效。?. 操作符的功能类似于 . 链式操作符，不同之处在于，在引用为空(nullish) (null或者undefined) 的情况下不会引起错误，该表达式短路返回值是 undefined。与函数调用一起使用时，如果给定的函数不存在，则返回 undefined。

当尝试访问可能不存在的对象属性时，可选链操作符将会使表达式更短、更简明。在探索一个对象的内容时，如果不能确定哪些属性必定存在，可选链操作符也是很有帮助的。

const adventurer = {
  name: 'Alice',
  cat: {
    name: 'Dinah'
  }
};

const dogName = adventurer.dog?.name;
console.log(dogName);
// expected output: undefined

console.log(adventurer.someNonExistentMethod?.());
// expected output: undefined

语法格式

obj?.prop
obj?.[expr]
arr?.[index]
func?.(args)

详情参考

https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Operators/Optional_chaining

空值合并运算符(??)

空值合并操作符（??）是一个逻辑操作符，当左侧的操作数为 null 或者 undefined 时，返回其右侧操作数，否则返回左侧操作数。

与逻辑或操作符（||）不同，逻辑或操作符会在左侧操作数为假值时返回右侧操作数。也就是说，如果使用 || 来为某些变量设置默认值，可能会遇到意料之外的行为。比如为假值（例如，'' 或 0）时。见下面的例子。

const foo = null ?? 'default string';
console.log(foo);
// expected output: "default string"

const baz = 0 ?? 42;
console.log(baz);
// expected output: 0

语法格式

1	leftExpr ?? rightExpr

详情参考

https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing_operator

electron安装

发表于 2022-04-02 阅读次数： Valine：

错误信息

error C:\Users\wlzaz\Desktop\Gitlab\vben-admin-electron\node_modules\electron: Co
Exit code: 1
Command: node install.js
Arguments: 
Directory: C:\Users\wlzaz\Desktop\Gitlab\vben-admin-electron\node_modules\electro
Output:
RequestError: read ECONNRESET
    at ClientRequest.<anonymous> (C:\Users\wlzaz\Desktop\Gitlab\vben-admin-electr
    at Object.onceWrapper (node:events:646:26)
    at ClientRequest.emit (node:events:538:35)
    at ClientRequest.origin.emit (C:\Users\wlzaz\Desktop\Gitlab\vben-admin-electr
    at TLSSocket.socketErrorListener (node:_http_client:442:9)
    at TLSSocket.emit (node:events:526:28)

运行node install.js失败

分析错误原因 RequestError: read ECONNRESET 连接重置

这个原因大概率是因为被墙了

解决方案, 更换为国内源, 例如淘宝镜像

npm

1	npm config set ELECTRON_MIRROR http://npm.taobao.org/mirrors/electron/

yarn

1	yarn config set electron_mirror https://cdn.npm.taobao.org/dist/electron/

参考链接

https://www.talktocomputer.site/blogs/139/

Restful API设计最佳实践

发表于 2022-03-28 阅读次数： Valine：

Restful API设计最佳实践

Restful API成熟度

在Richardson Maturity Model模型中，将RESTful分为4个等级：

4个等级分别是：

第一级（Level 0）的 Web 服务仅使用 HTTP 作为传输方式，实际上只是远程方法调用（RPC）的一种具体形式。SOAP 和 XML-RPC 都属于此类。

第二级（Level 1）的 Web 服务引入了资源的概念。每个资源有对应的标识符和表达。

第三级（Level 2）的 Web 服务使用不同的 HTTP 方法来进行不同的操作，并且使用HTTP 状态码来表示不同的结果。如 HTTP GET 方法来获取资源，HTTP DELETE 方法来删除资源。

第四级（Level 3）的 Web 服务使用 HATEOAS。在资源的表达中包含了链接信息。客户端可以根据链接来发现可以执行的动作。

实践1：一类资源两个URL

一个URL表示该类型资源集合，另一个URL用来表示特定的资源元素。

# 资源集合：
/epics
# 资源元素：
/epics/5

实践2：使用一致的复数名词

避免混用复数和单数形式，只应该使用统一的复数名词来表达资源。

反例：

1 2	GET /story GET /story/3

正例：

1 2	GET /stories GET /stories/3

实践3：使用名词而不是动词

使用Http方法来表达动作（增、删、改、查）：

增（POST：非幂等性）: 使用POST方法创建新的资源。
删（DELETE：幂等性）: 使用DELETE方法删除存在的资源。
改（PUT：幂等性）: 使用PUT或PATCH方法来更新已存在的资源。
查: 使用GET方法读取资源。（GET：幂等性）

反例：

/getAllEpics
/getAllFinishedEpics
/createEpic
/updateEpic

正例：

GET /epics
GET /epics?state=finished
POST /epics
PUT /epics/5

实践4：将实际数据包装在data字段中

GET /epics在数据字段中返回epic资源列表：

{
  "data": [
    { "id": 1, "name": "epic1" }
    , { "id": 2, "name": "epic2" }
  ]
}

GET /epic/1在数据字段中返回id为1的epic对象：

{
  "data": { 
    "id": 1, 
    "name": "epic1"
  }
}

PUT，POST和PATCH请求的有效负荷还应包含实际对象的数据字段。

优点：

还有空间扩展元数据
一致性
兼容JSON API标准

实践5：对可选及复杂参数使用查询字符串（？）

反例：

GET /employees
GET /externalEmployees
GET /internalEmployees
GET /internalAndSeniorEmployees

保持URL简单短小。坚持使用基本URL，将复杂或可选参数移动到查询字符串。

1 2	GET /employees?state=internal&title=senior GET /employees?id=1,2

另外还可以使用JSON API方式过滤：

1 2	GET /employees?filter[state]=internal&filter[title]=senior GET /employees?filter[id]=1,2

实践6：使用HTTP状态码

RESTful Web服务应使用合适的HTTP状态码来响应客户端的请求。

2xx - 成功 - 一切正常。
4xx - 客户端错误 - 如果客户端的故障（例如：客户端发送无效请求或未经授权）
5xx - 服务器错误 - 服务端的故障（尝试处理请求时的错误，如数据库故障，依赖服务不可用，编码错误或不应发生的状态）

请注意，使用所有过多的HTTP状态码可能会让API用户感到困惑。所以应该保持使用精简的HTTP状态码集。常用状态码如下：

2xx：成功，操作被成功接收并处理
- 200：请求成功。一般用于GET与POST请求
- 201：已创建。成功请求并创建了新的资源
3xx：重定向，需要进一步的操作以完成请求
- 301：永久移动。请求的资源已被永久的移动到新URI，返回信息会包括新的URI，浏览器会自动定向到新URI。今后任何新的请求都应使用新的URI代替
- 304：未修改。所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。客户端通常会缓存访问过的资源，通过提供一个头信息指出客户端希望只返回在指定日期之后修改的资源
4xx：客户端错误，请求包含语法错误或无法完成请求
- 400：客户端请求的语法错误，服务器无法理解
- 401：请求要求用户的身份认证
- 403：服务器理解请求客户端的请求，但是拒绝执行此请求
- 404：服务器无法根据客户端的请求找到资源（网页）。通过此代码，网站设计人员可设置”您所请求的资源无法找到”的个性页面
- 410：客户端请求的资源已经不存在。410不同于404，如果资源以前有现在被永久删除了可使用410代码，网站设计人员可通过301代码指定资源的新位置
5xx：服务器错误，服务器在处理请求的过程中发生了错误
- 500：服务器内部错误，无法完成请求

不要过度使用404。状态码的使用要尽量精确。如果资源可用，但禁止用户访问，则返回403。如果资源曾经存在但现已被删除或停用，请使用410。

实践7：提供有用的错误消息

除了提供恰当的HTTP状态代码外，还应该在HTTP响应正文中提供有用且详细的错误描述。如下所示：

请求：

1	GET /epics?state=unknow

响应：

// 400 Bad Request
{
  "errors": [
    {
      "status": 400,
      "detail": "Invalid state. Valid values are 'biz' or 'tech'",
      "code": 352,
      "links": {
        "about": "http://www.jira.com/rest/errorcode/352"
      }
    }
  ]
}

实践8：使用HATEOAS

HATEOAS 是 Hypermedia As The Engine Of Application State 的缩写，从字面上理解是 “超媒体即是应用状态引擎” 。其原则就是客户端与服务器的交互完全由超媒体动态提供，客户端无需事先了解如何与数据或者服务器交互。相反的，在一些RPC服务或者Redis,Mysql等软件，需要事先了解接口定义或者特定的交互语法。举例如下：

客户想要访问epic的用户故事清单。因此，他必须知道他可以通过将查询参数stories附加到员工URL（例如/epics/21/stories）来访问用户故事清单。这种字符串拼接易错，脆弱且难以维护。如果更改了在REST API中访问salary语句的方式（例如，现在使用“storyStatements”或“userStories”），则所有客户端都将中断。

更好的做法是在响应中提供客户可以跟进的链接。例如，对GET /epic的响应可能如下所示：

{
  "data": [
    {
      "id":1,
      "name":"epic1",
      "links": [
        {
          "story": "http://www.domain.com/epics/21/stories"
        }
      ]
    }
  ]
}

优点：

如果API被更改，客户端依旧会获取有效的URL（只要保证在URL更改时更新链接）。
API变得更具自描述性，客户端不必经常查找文档。

实践9：恰当地设计关系

假设每个story都有一个epic和几个sub task。在API中设计关系基本上有三种常用选项：链接，侧载和嵌入。

它们都是有效的，正确的选择取决于用例。基本上，应根据客户端的访问模式以及可容忍的请求数量和有效负载大小来设计关系。

链接

{
  "data": [
    { 
      "id": 1, 
      "name": "用户故事1",
      "relationships": {
        "epic": "http://www.domain.com/story/1/epic",
        "subTasks": [ 
          "http://www.domain.com/subTasks/12",
          "http://www.domain.com/subTasks/13"
        ]
        //or "subTasks": "http://www.domain.com/story/1/subTasks"
      }
    }
  ]
}

有效负载小。
许多请求。
客户端必须将数据拼接在一起才能获得所有数据。

侧载

{
  "data": [
    { 
      "id": 1, 
      "name": "用户故事1",
      "relationships": {
        "epic":  5 , 
        "subTask": [ 12, 13 ]
      }
    }
  ],
  "included": {
    "epic": {
      "id": 5, 
      "name": "epic5"
    },
    "subTasks": [
      { "id": 12, "name": "子任务12" }
      , { "id": 13, "name": "子任务13" }
    ]
  }
}

客户端还可以通过诸如GET /stories？include=epic，subTasks之类的查询参数来控制侧载实体。

一次请求。
定制的有效载荷大小。没有重复（例如，即使被许多用户故事引用，也只用提供一次epic）
客户端仍然必须将数据拼接在一起以便解决关系，这可能非常麻烦。

嵌入

{
  "data": [
    { 
      "id": 1, 
      "name": "用户故事1",
      "epic": {
        "id": 5, 
        "name": "epic5"
      },
      "subTask": [
        { "id": 12, "name": "子任务12" }
        , { "id": 13, "name": "子任务13" }
      ]
    }
  ]
}

对客户来说最方便。是可以直接通过关系来获取实际数据。
如果客户端不需要关系，白白加载关系。
有效负载大小和重复增加。可能多次嵌入引用的实体。

实践10：使用小驼峰命名法来命名属性

1	{ "epic.dateOfCreated": 2019-05-16 }

// 反例
epic.created_date // 违反JavaScript规范
epic.DateOfCreated // 建议用于构造方法

// 正例
epic.dateOfCreated

实践11：使用动词进行操作

有时对API调用的响应不涉及资源（如计算，转义或变换）。例：

// 读取
GET /translate?from=de_DE&to=en_US&text=Hallo
GET /calculate?para2=23&para2=432

// 触发更改服务器端状态的操作
POST /restartServer
// 无消息体

POST /banUserFromChannel
{ "user": "123", "channel": "serious-chat-channel" }

通过动词来表达RPC风格API，它比尝试RESTful风格来进行操作更简单，更直观（例如PATCH / server with {“restart”：true}）。REST风格非常适合与领域模型交互，RPC适合于操作。更多信息请查看“Understanding RPC Vs REST For HTTP APIs”。

实践12：分页

两种流行的分页方法是：

基于偏移的分页
基于键集的分页，又称继续令牌，也称为光标（推荐）

基于偏移的分页

一般方法是使用参数offset和limit来进行分页：

1 2	# 返回30至45的epics /epics?offset=30&limit=15

如果未填参数，则可使用默认值（offset=0， limit=100 ）：

1 2	# 返回0至100的epics /epics

还可以在响应数据中，提供前一页和后一页的链接：

请求：

1 2	# 返回30至45的epics /epics?offset=30&limit=15

响应：

{
  "pagination": {
    "offset": 20,
    "limit": 10,
    "total": 3465,
  },
  "data": [
    //...
  ],
  "links": {
    "next": "http://www.domain.com/epics?offset=30&limit=10",
    "prev": "http://www.domain.com/epics?offset=10&limit=10"
  }
}

基于偏移量的分页实现很简单，但是有两个缺点：

查询慢。数据量大时SQL偏移子句执行会很慢。
不安全。分页期间的变更。

基于键集的分页，又称继续令牌，也称为光标（推荐）

简单来说就是使用索引列来进行分页。假设epic有一个索引列data_created，我们就可以使用data_created来分页。

GET /epics?pageSize=100                
# 客户端接受最靠前的100条epic信息，使用`data_created`字段排序
# 该分页最老epic的`dataCreated` 字段值为 1504224000000 (= Sep 1, 2017 12:00:00 AM)

GET /epics?pageSize=100&createdSince=1504224000000
# 客户端请求1504224000000之后的100个epics数据。 
# 该分页最前面的epic创建于1506816000000.

该分页方式解决了基于偏移的分页的许多缺点，但对调用方来说不太方便。

更好的方式是通过向日期添加附加信息（如id）来创建所谓的 continuation token，以提高可靠性和效率。
此外，应该向该令牌的有效负载中提供专用字段，以便客户端不用必须通过查看元素才能搞清楚。甚至还可以进一步提供下一页链接。

因此 GET /epics?pageSize=100请求将返回如下：

{
  "pagination": {
    "continuationToken": "1504224000000_10",
  },
  "data": [
    // ...
    // last element:
    { "id": 10, "dateCreated": 1504224000000 }
  ],
  "links": {
    "next": "http://www.domain.com/epics?pageSize=100&continue=1504224000000_10"
  }
}

下一页链接使API真正成为RESTful风格，因为客户端只需通过这些链接（HATEOAS）即可查看集合。无需手动构建URL。此外，服务端可以简单地更改URL结构而不会破坏客户端，保证接口的演进性。

实践13：确保API的可演进性

避免破坏性变更

保持向后兼容。只要客户端能接受就通过添加字段的方式。
复制和弃用。要更改现有字段（重命名或更改结构），可在该字段旁边添加新字段，并在接口手册中弃用该字段。一段时间后，删除旧字段。
利用超媒体和HATEOAS。只要客户端使用响应中的链接来访问（且不会手动创建URL），即可以安全地更改URL而不会破坏客户端。
使用新名称创建新资源。如果新业务需求导致全新的领域模型和工作流，则可以创建新资源。

保持业务逻辑在服务侧

不要让服务成为转储数据访问层，它通过直接公开数据库模型（低级API）来提供CRUD功能。这造成了高耦合。

因此，我们应该构建高层次/基于工作流的API而不是低级API。

实践14：版本化

API实在无法演进，则必须提供不同版本的API。版本控制允许在不破坏客户端的情况下，在新版本中发布不兼容和重大更改的API。

有两种最流行的版本控制方法：

通过URLs版本化
通过Accept HTTP Header进行版本控制（内容协商）

通过URLs版本化

只需将API的版本号放在每个资源的URL中即可。

/v1/epics

优点：

对API开发人员非常简单。
对客户端访问也非常简单。
可以复制和粘贴URL。

缺点：

非RESTful。（该方式会令URL发生变化）
破坏URLs。客户端必须维护和更新URL。

由于其简单性，该方式被各大厂商广泛使用，例如：Facebook, Twitter, Google/YouTube, Bing, Dropbox, Tumblr以及Disqus等。

通过Accept HTTP Header进行版本控制（内容协商）

更RESTFul的方式是利用通过Accept HTTP请求头的内容协商。

1 2	GET /epics Accept: application/vnd.myapi.v2+json

优点：

URLs保持不变
RESTFul方式
HATEOAS友好

缺点：

稍微难以使用。客户必须注意标题。
无法再复制和粘贴网址。

参考案例

转载自: http://kaelzhang81.github.io/2019/05/24/Restful-API%E8%AE%BE%E8%AE%A1%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5/

SQLAlchemy default 不更新

发表于 2022-03-20 阅读次数： Valine：

错误示例

class UserModel(db.Model):


    __tablename__ = "user"

    # 
    id = Column(db.BIGINT, primary_key=True, unique=True, autoincrement=True)

    uid = Column(db.String(36), unique=True, default=generate_uuid())
    username = Column(db.String(32), unique=True)
    password = Column(db.String(60))
    category = Column(db.String(32), default=Constants.DB_UserModel.Category.USER.value)
    mobile = Column(db.String(32), unique=True)
    email = Column(db.String(32), unique=True)
    register_date = Column(db.DATETIME, default=datetime.now())

1 2	def generate_uuid(): return str(uuid.uuid4())

正确示例

class UserModel(db.Model):


    __tablename__ = "user"

    # 
    id = Column(db.BIGINT, primary_key=True, unique=True, autoincrement=True)

    uid = Column(db.String(36), unique=True, default=generate_uuid)
    username = Column(db.String(32), unique=True)
    password = Column(db.String(60))
    category = Column(db.String(32), default=Constants.DB_UserModel.Category.USER.value)
    mobile = Column(db.String(32), unique=True)
    email = Column(db.String(32), unique=True)
    register_date = Column(db.DATETIME, default=datetime.now)

default 这个参数后可以指定一个函数

例如 default=generate_uuid, 如果 default=generate_uuid() 则设定为该函数的一个返回值, 即这样是设置了一个常量