UUID 作为主键 - REST API 指南

Question

在 postgres 中我创建了一个 table:

create table examples(id uuid PRIMARY KEY DEFAULT uuid_generate_v4(),
                     name VARCHAR);

为了从 table 示例中获取我的所有值，我在我的框架处理程序中创建了一个端点：

GET "/examples[/]?"

如果我使用 SERIAL 或 INT 类型作为我的主键，我的单个示例值的端点将如下所示：

GET "/examples/([0-9]+)*"

但是我使用 UUID 作为主键并且我创建了这个怪物：P

GET "/examples/([0-9a-f]{8}-[0-9a-f]{4}-[4][0-9a-f]{3}-[0-9a-f][0-9a-f]{3}-[0-9a-f]{12})"

使用示例：

examples/ef935fbc-8c43-4b22-b160-14124a29312e
examples/{uuid}

它适用于我的情况，但也许有更好的方法吗？有什么好的指导方针可以告诉我们如何处理这样的问题吗？

Answer 1

就 REST 而言，使用 UUID 的字符串表示作为路径段的一部分很好。这只是文字。由于 REST 客户端只是遵循服务器提供给它们的链接，因此使用什么拼写并不重要。

某些选择会让您的路由框架更容易管理，但您对路由的选择是一个实现细节，与您的 [=] 的消费者无关20=].

使用粗粒度路由框架，然后自己实现细粒度控制，真的没有什么错

GET /examples/{data}

if (isUUID(data)):
    // cast the data to an id yourself, then do the right thing
if "the-other-thing" == data:
    // do the other thing

UUID 作为主键 - REST API 指南

UUID as primary key - REST API guideline

api

rest

uuid

endpoint