java - CloudEndpoints : what is autogenerated "patch" API method and how to use it?

Question

在@Api注解类中添加get()和update()两个方法后，Endpoints生成了3个方法:

• *.get 直接为get()方法生成
• *.update 直接为update()方法生成
• *.patch 似乎是间接生成的，在将 get() 和 update() 方法插入注释后类。

我可以通过本地服务器上的 APIs Explorer 查看这三种方法。我用来生成端点的代码发布在这个问题的末尾。

我的问题是:为什么要生成第三种方法patch？是故意的吗？如果是，如何使用此方法？它可以从外部客户端使用还是仅供内部使用？

这是我的端点 api 类:

@Api (name = "sample_endpoint")
public class SampleEndpoint
{
    public Entity get()
    {
        return new Entity();
    }

    public Entity update(Entity entity)
    {
        return entity;
    }

    public class Entity
    {
        public String parameter = "Validated ok.";
        public String getParameter() { return parameter; }
    }
}

Answer 1

当您创建名为“update”的方法时，“patch”方法会自动生成。它用于部分更新，可供外部客户使用。

用法:它以实体的id作为参数，你可以只发送你想改变的数据字段。

参见 patch explanation .