c# - 是什么导致 Web 服务 URL 和 namespace 之间存在差异？

Question

我有一个包含 Web 服务的 ASP.NET Web 项目。当我运行该服务时，它会将我带到一个显示所有公开方法的页面，使用类似于 http://api.example.com/game/service.asmx 的 URL。

在 Web 服务的代码中，有具有以下属性的方法:

    [WebService(Namespace = "http://webservices.example.com/GameServices/Game1")]
    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
    public class Game1 : System.Web.Services.WebService
    {
        // code 
    }

我对为什么具有 webService 属性的类的 namespace 与 Web 服务的路径不同感到有点困惑。该命名空间来自哪里？是编出来的吗？

Answer 1

是的，它是编造的。

这听起来很傻，但这是真的。在您的代码中指定的命名空间将用于作为特定 Web 服务的请求和响应进行交换的 XML 文档。如果将网络跟踪程序放在线路上，您会看到消息中来回使用的命名空间字符串。在网络服务中，您的应用程序通常不需要关心 namespace 。 Web 服务库通常会为您处理。

虽然人们经常使用 HTTP URL，但命名空间不需要是 HTTP URL。这可能是您大部分困惑的根源。 The IETF Recommendation for XML namespaces建议应该是a URI ，但该 URI 不必是 HTTP URI，事实上它不需要附加任何“网络协议(protocol)”。

命名空间是……一个字符串。它用作限定 XML 模式中信息的简单方法。把它想象成一个人的姓氏。你可能认识几个叫“克里斯”的人。您可以通过他们的姓氏来区分他们。

同样，元素名称“id”可以用在许多不同的 XML 文档和模式中。应用程序(以及人)可以通过它们的 xml 命名空间区分使用 qname“id”的许多不同元素。

通常，“信息架构师”会将文档或网络服务的 XML 命名空间指定为分层的 URI，对拥有组织而言是唯一的，并且与 XML 文档中信息的含义相关。 (在小型组织中，“信息架构师”只是开发人员。)例如 http://mycompany.com/services/2013/customer可能是 MyCompany 的命名空间，创建于 2013 年，与服务有关，特别是客户服务。

在我看来，没有真正的理由在 XML namespace 的 URI 中使用 http:// 方案，除非您计划在该 HTTP URI 上提供文档。您也可以使用 urn:mycompany.com/services/2013/customer 作为 XML 命名空间。事实上它可能更好，因为它表明它只是一个名称，而不是定位器。 (不是网址)。

我通常使用以 urn: 为前缀的 URN 作为方案，以指示命名空间只是一个名称，一个唯一标识符。

---

编辑URNs的结构是有规则的.基本格式为:

urn:<NID>:<NSS>

...其中 NID 是命名空间 ID，a set of special, approved strings 之一NSS 是特定于 namespace 的字符串。已批准的 NID 列表包括 isbn、uuid、ietf 和其他大约 20 个 - 每个都有不同的 IETF RFC 定义的特定含义。

尽管有关于 NID 的规则，但许多人根本懒得遵守，而是使用他们的域名代替 NID 来创造他们自己的 URN。例如“mycompany.com”。 (这就是我经常做的事情)。

然后您可以选择如何进一步限定名称。您可以指定“服务”，以指示 Web 服务。有些人使用服务在命名空间中启动的年份和月份。这允许您更新服务，并使用不同的日期来区分不同的元素。遵循此命名约定的示例 XML namespace 可能是:

 urn:mycompany.com:services:2011:04:Game

这就是RFC 2141称为“无效 URN”，因为我没有使用已注册的 NID。但它符合我的目的。通过应用由 RFC 4198 定义的 fdc NID，将其转换为“有效 URN”是一个简单的步骤。 .

 urn:fdc:mycompany.com:services:2011:04:Game

看看这有多好？

最后，对于 XML 数据的内部和合作伙伴消费者，大多数人只是建立了自己的命名约定，这对他们的使用有意义。