创建REST SOE的schema

方法CreateRestSchema()对于创建REST SOE是很重要的。在这个方法中，你将为你的服务创建schema，表明SOE支持哪些资源与操作。

a.对于每个资源，你将定义一个RestResource。

b.对于每个操作，你将定义一个RestOperation。

一旦你定义了所有的资源与操作，调用资源和操作的 Add()方法以便创建schema。

[C#]

private RestResource CreateRestSchema()
{
    RestResource rootRes = new RestResource(soe_name, false, RootResHandler);
    RestOperation sampleOper = new RestOperation("sampleOperation", new string[]
    {
        "parm1", "parm2"
    }
    , new string[]
    {
        "json"
    }
    , SampleOperHandler);
    rootRes.operations.Add(sampleOper);
    return rootRes;
}

[VB.NET]

Private Function CreateRestSchema() As RestResource
    Dim rootRes As New RestResource("RestSOE1", False, AddressOf RootResHandler)
    Dim sampleOper As New RestOperation("sampleOperation", New String() {"parm1", "parm2"}, New String() {"json"}, AddressOf SampleOperHandler)
    rootRes.operations.Add(sampleOper)
    Return rootRes
End Function

在上面的schema中，你获得了一个资源rootRes。该资源中包含一个操作sampleOper。

当你创建一个RestResource或一个RestOperation的时候，你可以传递一个可选参数capabilities名称。capabilities是一组资源和操作，这样服务器管理员可以方便的统一管理该组资源和操作启用或者不启用。

需要注意的是，当你在ArcCatalog中打开服务编辑对话框或在Manager中编辑服务的时候，capabilities会显示为“允许的操作”字样。

不要将SOE的capabilities和对话框中可进行勾选的"Capabilities"进行混淆。对话框中的“Capabilities”指的是SOEs本身。

模板中的代码没有定义任何的capabilities，但是你可以在REST示例Find Near Features中查看如何使用capabilities。

创建一个schema就像搭积木直到你创建了最终的高楼大厦。首先从schema中最深层次开始，为每一层级添加资源和操作，如此继续，直到根级别，这样你就创建了一个完整的schema。这一过程在模板中没有展现出来，因为模板代码仅仅展示了一个资源和操作被创建的过程。不过你会在SDK的示例中查看更复杂的schema的创建过程。