6.4 子树过滤示例

6.4.1 没有过滤器

在<get>操作中省略过滤器将返回整个数据模型。

  1.  <rpc message-id="101"
  2.       xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.    <get/>
  4.  </rpc>
  6.  <rpc-reply message-id="101"
  7.       xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  8.    <data>
  9.      <!-- ... entire set of data returned ... -->
  10.    </data>
  11.  </rpc-reply>

6.4.2 空过滤器

空的过滤器将不会选择任何内容，因为没有内容匹配或选择节点存在。 这不是一个错误。 这些例子中使用的<filter>元素的“type”属性将在7.1节进一步讨论。

  1.  <rpc message-id="101"
  2.       xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.    <get>
  4.      <filter type="subtree">
  5.      </filter>
  6.    </get>
  7.  </rpc>
  9. <rpc-reply message-id="101"
  10.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  11.     <data>
  12.     </data>
  13. </rpc-reply>

6.4.3 选择整个<users>子树

这个例子中的过滤器包含一个选择节点（<users>），所以只有该子树被过滤器选中。 这个例子代表了下面大部分过滤器例子中的完全填充的<users>数据模型。 在真实的数据模型中，<company-info>不可能与特定主机或网络的用户列表一起返回。

注：本文档中使用的过滤和配置示例出现在命名空间“http://example.com/schema/1.2/config”中。 这个命名空间的根元素是<top>。 <top>元素及其后代仅表示一个示例配置数据模型。

  1. <rpc message-id="101"
  2.     xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.     <get-config>
  4.         <source>
  5.             <running/>
  6.         </source>
  7.         <filter type="subtree">
  8.             <top xmlns="http://example.com/schema/1.2/config">
  9.                 <users/>
  10.             </top>
  11.         </filter>
  12.     </get-config>
  13. </rpc>
  16. <rpc-reply message-id="101"
  17.     xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  18.     <data>
  19.         <top xmlns="http://example.com/schema/1.2/config">
  20.             <users>
  21.                 <user>
  22.                     <name>root</name>
  23.                     <type>superuser</type>
  24.                     <full-name>Charlie Root</full-name>
  25.                     <company-info>
  26.                         <dept>1</dept>
  27.                         <id>1</id>
  28.                     </company-info>
  29.                 </user>
  30.                 <user>
  31.                     <name>fred</name>
  32.                     <type>admin</type>
  33.                     <full-name>Fred Flintstone</full-name>
  34.                     <company-info>
  35.                         <dept>2</dept>
  36.                         <id>2</id>
  37.                     </company-info>
  38.                 </user>
  39.                 <user>
  40.                     <name>barney</name>
  41.                     <type>admin</type>
  42.                     <full-name>Barney Rubble</full-name>
  43.                     <company-info>
  44.                         <dept>2</dept>
  45.                         <id>3</id>
  46.                     </company-info>
  47.                 </user>
  48.             </users>
  49.         </top>
  50.     </data>
  51. </rpc-reply>

下面的过滤器请求会产生相同的结果，但只是因为容器<users>定义了一个子元素（<user>）。

  1. <rpc message-id="101"
  2.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.     <get-config>
  4.     <source>
  5.         <running/>
  6.     </source>
  7.     <filter type="subtree">
  8.         <top xmlns="http://example.com/schema/1.2/config">
  9.             <users>
  10.                 <user/>
  11.             </users>
  12.         </top>
  13.     </filter>
  14.     </get-config>
  15. </rpc>

6.4.4. 选择<users>子树内的所有<name>元素

该过滤器包含两个容器节点（<users>，<user>）和一个选择节点（<name>）。 在过滤器输出中选择同一兄弟集合中<name>元素的所有实例。 客户端可能需要知道<name>在这个特定的数据结构中被用作实例标识符，但是服务器不需要知道该元数据来处理该请求。

  1. <rpc message-id="101"
  2.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.   <get-config>
  4.     <source>
  5.       <running/>
  6.     </source>
  7.     <filter type="subtree">
  8.       <top xmlns="http://example.com/schema/1.2/config">
  9.         <users>
  10.           <user>
  11.             <name/>
  12.           </user>
  13.         </users>
  14.       </top>
  15.     </filter>
  16.   </get-config>
  17. </rpc>
  19. <rpc-reply message-id="101"
  20.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  21.   <data>
  22.     <top xmlns="http://example.com/schema/1.2/config">
  23.       <users>
  24.         <user>
  25.           <name>root</name>
  26.         </user>
  27.         <user>
  28.           <name>fred</name>
  29.         </user>
  30.         <user>
  31.           <name>barney</name>
  32.         </user>
  33.       </users>
  34.     </top>
  35.   </data>
  36. </rpc-reply>

6.4.5 一个特定的<user>条目

此过滤器包含两个容器节点（<users>，<user>）和一个内容匹配节点（<name>）。 在过滤器输出中选择包含<name>（其名称等于“fred”的值的兄弟集合的所有实例）。

  1. <rpc message-id="101"
  2.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.   <get-config>
  4.     <source>
  5.       <running/>
  6.     </source>
  7.     <filter type="subtree">
  8.       <top xmlns="http://example.com/schema/1.2/config">
  9.         <users>
  10.           <user>
  11.             <name>fred</name>
  12.           </user>
  13.         </users>
  14.       </top>
  15.     </filter>
  16.   </get-config>
  17. </rpc>
  19. <rpc-reply message-id="101"
  20.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  21.   <data>
  22.     <top xmlns="http://example.com/schema/1.2/config">
  23.       <users>
  24.         <user>
  25.           <name>fred</name>
  26.           <type>admin</type>
  27.           <full-name>Fred Flintstone</full-name>
  28.           <company-info>
  29.             <dept>2</dept>
  30.             <id>2</id>
  31.           </company-info>
  32.         </user>
  33.       </users>
  34.     </top>
  35.   </data>
  36. </rpc-reply>

6.4.6 来自特定<user>条目的特定元素

该过滤器包含两个容器节点（<users>，<user>），一个内容匹配节点（<name>）和两个选择节点（<type>，<full-type>）。 在过滤器输出中选择包含<name>的相同同级组中的<type>和<full-name>元素的所有实例，其中<name>的值等于“fred”。 不包含<company-info>元素，因为兄弟集合包含选择节点。

  3. <rpc message-id="101"
  4.     xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  5.     <get-config>
  6.         <source>
  7.         <running/>
  8.         </source>
  9.         <filter type="subtree">
  10.             <top xmlns="http://example.com/schema/1.2/config">
  11.                 <users>
  12.                     <user>
  13.                         <name>fred</name>
  14.                         <type/>
  15.                         <full-name/>
  16.                     </user>
  17.                 </users>
  18.             </top>
  19.         </filter>
  20.     </get-config>
  21. </rpc>
  23. <rpc-reply message-id="101"
  24.     xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  25.     <data>
  26.         <top xmlns="http://example.com/schema/1.2/config">
  27.         <users>
  28.             <user>
  29.                 <name>fred</name>
  30.                 <type>admin</type>
  31.                 <full-name>Fred Flintstone</full-name>
  32.             </user>
  33.         </users>
  34.         </top>
  35.     </data>
  36. </rpc-reply>

6.4.7 多个子树

这个过滤器包含三个子树（name = root，fred，barney）。

“root”子树筛选器包含两个包含节点（<users>，<user>），一个内容匹配节点（<name>）和一个选择节点（<company-info>）。满足子树的选择条件，在过滤器输出中只选择“root”的company-info子树。

“fred”子树筛选器包含三个包含节点（<users>，<user>，<company-info>），一个内容匹配节点（<name>）和一个选择节点（<id>）。满足子树的选择条件，在过滤器输出中只选择“fred”的company-info子树内的<id>元素。

“barney”子树筛选器包含三个包含节点（<users>，<user>，<company-info>），两个内容匹配节点（<name>，<type>）和一个选择节点（<dept>）。由于用户“barney”不是“superuser”，并且“barney”（包括其父<user>条目）的整个子树被从过滤器输出中排除，所以不满足子树选择条件。

  1. <rpc message-id="101"
  2.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.     <get-config>
  4.         <source>
  5.             <running/>
  6.         </source>
  7.         <filter type="subtree">
  8.             <top xmlns="http://example.com/schema/1.2/config">
  9.                 <users>
  10.                     <user>
  11.                         <name>root</name>
  12.                         <company-info/>
  13.                     </user>
  14.                     <user>
  15.                         <name>fred</name>
  16.                         <company-info>
  17.                             <id/>
  18.                         </company-info>
  19.                     </user>
  20.                     <user>
  21.                         <name>barney</name>
  22.                         <type>superuser</type>
  23.                         <company-info>
  24.                             <dept/>
  25.                         </company-info>
  26.                     </user>
  27.                 </users>
  28.             </top>
  29.         </filter>
  30.     </get-config>
  31. </rpc>
  33. <rpc-reply message-id="101"
  34.     xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  35.     <data>
  36.         <top xmlns="http://example.com/schema/1.2/config">
  37.             <users>
  38.                 <user>
  39.                     <name>root</name>
  40.                     <company-info>
  41.                         <dept>1</dept>
  42.                         <id>1</id>
  43.                     </company-info>
  44.                 </user>
  45.                 <user>
  46.                     <name>fred</name>
  47.                     <company-info>
  48.                         <id>2</id>
  49.                     </company-info>
  50.                 </user>
  51.             </users>
  52.         </top>
  53.     </data>
  54. </rpc-reply>

6.4.8 具有属性命名的元素

在此示例中，筛选器包含一个包含节点（<interfaces>），一个属性匹配表达式（“ifName”）和一个选择节点（<interface>）。 在过滤器输出中选择具有“ifName”属性等于“eth0”的<interface>子树的所有实例。 过滤器数据元素和属性是合格的，因为如果命名空间属性不合格，“ifName”属性将不被视为“schema/1.2”命名空间的一部分。

  1. <rpc message-id="101"
  2.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.   <get>
  4.     <filter type="subtree">
  5.       <t:top xmlns:t="http://example.com/schema/1.2/stats">
  6.         <t:interfaces>
  7.           <t:interface t:ifName="eth0"/>
  8.         </t:interfaces>
  9.       </t:top>
  10.     </filter>
  11.   </get>
  12. </rpc>
  14. <rpc-reply message-id="101"
  15.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  16.   <data>
  17.     <t:top xmlns:t="http://example.com/schema/1.2/stats">
  18.       <t:interfaces>
  19.         <t:interface t:ifName="eth0">
  20.           <t:ifInOctets>45621</t:ifInOctets>
  21.           <t:ifOutOctets>774344</t:ifOutOctets>
  22.         </t:interface>
  23.       </t:interfaces>
  24.     </t:top>
  25.   </data>
  26. </rpc-reply>

如果“ifName”是一个子节点而不是一个属性，那么下面的请求会产生类似的结果。

  1. <rpc message-id="101"
  2.      xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  3.   <get>
  4.     <filter type="subtree">
  5.       <top xmlns="http://example.com/schema/1.2/stats">
  6.         <interfaces>
  7.           <interface>
  8.             <ifName>eth0</ifName>
  9.           </interface>
  10.         </interfaces>
  11.       </top>
  12.     </filter>
  13.   </get>
  14. </rpc>