/Prototipo/Servlet/lib/xstream-distribution-1.4.1-bin/xstream-1.4.1/docs/javadoc/com/thoughtworks/xstream/io/HierarchicalStreamReader.html

http://prototipomemoria.googlecode.com/ · HTML · 531 lines · 458 code · 53 blank · 20 comment · 0 complexity · 26903a1b24fc7007f1e3a844cbee16e1 MD5 · raw file

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!--NewPage-->
  3. <HTML>
  4. <HEAD>
  5. <!-- Generated by javadoc (build 1.6.0_26) on Thu Aug 11 04:40:24 CEST 2011 -->
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <TITLE>
  8. HierarchicalStreamReader (XStream Core 1.4.1 API)
  9. </TITLE>
  10. <META NAME="date" CONTENT="2011-08-11">
  11. <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
  12. <SCRIPT type="text/javascript">
  13. function windowTitle()
  14. {
  15. if (location.href.indexOf('is-external=true') == -1) {
  16. parent.document.title="HierarchicalStreamReader (XStream Core 1.4.1 API)";
  17. }
  18. }
  19. </SCRIPT>
  20. <NOSCRIPT>
  21. </NOSCRIPT>
  22. </HEAD>
  23. <BODY BGCOLOR="white" onload="windowTitle();">
  24. <HR>
  25. <!-- ========= START OF TOP NAVBAR ======= -->
  26. <A NAME="navbar_top"><!-- --></A>
  27. <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
  28. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  29. <TR>
  30. <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  31. <A NAME="navbar_top_firstrow"><!-- --></A>
  32. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  33. <TR ALIGN="center" VALIGN="top">
  34. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  35. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  36. <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  37. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/HierarchicalStreamReader.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  38. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  39. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  40. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  41. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  42. </TR>
  43. </TABLE>
  44. </TD>
  45. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  46. </EM>
  47. </TD>
  48. </TR>
  49. <TR>
  50. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  51. &nbsp;<A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamDriver.html" title="interface in com.thoughtworks.xstream.io"><B>PREV CLASS</B></A>&nbsp;
  52. &nbsp;<A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamWriter.html" title="interface in com.thoughtworks.xstream.io"><B>NEXT CLASS</B></A></FONT></TD>
  53. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  54. <A HREF="../../../../index.html?com/thoughtworks/xstream/io/HierarchicalStreamReader.html" target="_top"><B>FRAMES</B></A> &nbsp;
  55. &nbsp;<A HREF="HierarchicalStreamReader.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
  56. &nbsp;<SCRIPT type="text/javascript">
  57. <!--
  58. if(window==top) {
  59. document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  60. }
  61. //-->
  62. </SCRIPT>
  63. <NOSCRIPT>
  64. <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
  65. </NOSCRIPT>
  66. </FONT></TD>
  67. </TR>
  68. <TR>
  69. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  70. SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  71. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  72. DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  73. </TR>
  74. </TABLE>
  75. <A NAME="skip-navbar_top"></A>
  76. <!-- ========= END OF TOP NAVBAR ========= -->
  77. <HR>
  78. <!-- ======== START OF CLASS DATA ======== -->
  79. <H2>
  80. <FONT SIZE="-1">
  81. com.thoughtworks.xstream.io</FONT>
  82. <BR>
  83. Interface HierarchicalStreamReader</H2>
  84. <DL>
  85. <DT><B>All Superinterfaces:</B> <DD><A HREF="../../../../com/thoughtworks/xstream/converters/ErrorReporter.html" title="interface in com.thoughtworks.xstream.converters">ErrorReporter</A></DD>
  86. </DL>
  87. <DL>
  88. <DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../../com/thoughtworks/xstream/io/xml/DocumentReader.html" title="interface in com.thoughtworks.xstream.io.xml">DocumentReader</A></DD>
  89. </DL>
  90. <DL>
  91. <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../com/thoughtworks/xstream/io/xml/AbstractDocumentReader.html" title="class in com.thoughtworks.xstream.io.xml">AbstractDocumentReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/AbstractPullReader.html" title="class in com.thoughtworks.xstream.io.xml">AbstractPullReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/AbstractReader.html" title="class in com.thoughtworks.xstream.io">AbstractReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/AbstractXmlReader.html" title="class in com.thoughtworks.xstream.io.xml">AbstractXmlReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/binary/BinaryStreamReader.html" title="class in com.thoughtworks.xstream.io.binary">BinaryStreamReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/Dom4JReader.html" title="class in com.thoughtworks.xstream.io.xml">Dom4JReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/DomReader.html" title="class in com.thoughtworks.xstream.io.xml">DomReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/JDomReader.html" title="class in com.thoughtworks.xstream.io.xml">JDomReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/path/PathTrackingReader.html" title="class in com.thoughtworks.xstream.io.path">PathTrackingReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/ReaderWrapper.html" title="class in com.thoughtworks.xstream.io">ReaderWrapper</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/StaxReader.html" title="class in com.thoughtworks.xstream.io.xml">StaxReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/XomReader.html" title="class in com.thoughtworks.xstream.io.xml">XomReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/XppDomReader.html" title="class in com.thoughtworks.xstream.io.xml">XppDomReader</A>, <A HREF="../../../../com/thoughtworks/xstream/io/xml/XppReader.html" title="class in com.thoughtworks.xstream.io.xml">XppReader</A></DD>
  92. </DL>
  93. <HR>
  94. <DL>
  95. <DT><PRE>public interface <B>HierarchicalStreamReader</B><DT>extends <A HREF="../../../../com/thoughtworks/xstream/converters/ErrorReporter.html" title="interface in com.thoughtworks.xstream.converters">ErrorReporter</A></DL>
  96. </PRE>
  97. <P>
  98. <DL>
  99. <DT><B>Author:</B></DT>
  100. <DD>Joe Walnes</DD>
  101. </DL>
  102. <HR>
  103. <P>
  104. <!-- ========== METHOD SUMMARY =========== -->
  105. <A NAME="method_summary"><!-- --></A>
  106. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  107. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  108. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  109. <B>Method Summary</B></FONT></TH>
  110. </TR>
  111. <TR BGCOLOR="white" CLASS="TableRowColor">
  112. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  113. <CODE>&nbsp;void</CODE></FONT></TD>
  114. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#appendErrors(com.thoughtworks.xstream.converters.ErrorWriter)">appendErrors</A></B>(<A HREF="../../../../com/thoughtworks/xstream/converters/ErrorWriter.html" title="interface in com.thoughtworks.xstream.converters">ErrorWriter</A>&nbsp;errorWriter)</CODE>
  115. <BR>
  116. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If any errors are detected, allow the reader to add any additional information that can aid debugging
  117. (such as line numbers, XPath expressions, etc).</TD>
  118. </TR>
  119. <TR BGCOLOR="white" CLASS="TableRowColor">
  120. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  121. <CODE>&nbsp;void</CODE></FONT></TD>
  122. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#close()">close</A></B>()</CODE>
  123. <BR>
  124. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Close the reader, if necessary.</TD>
  125. </TR>
  126. <TR BGCOLOR="white" CLASS="TableRowColor">
  127. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  128. <CODE>&nbsp;<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  129. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getAttribute(int)">getAttribute</A></B>(int&nbsp;index)</CODE>
  130. <BR>
  131. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the value of an attribute of the current node, by index.</TD>
  132. </TR>
  133. <TR BGCOLOR="white" CLASS="TableRowColor">
  134. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  135. <CODE>&nbsp;<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  136. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getAttribute(java.lang.String)">getAttribute</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
  137. <BR>
  138. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the value of an attribute of the current node.</TD>
  139. </TR>
  140. <TR BGCOLOR="white" CLASS="TableRowColor">
  141. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  142. <CODE>&nbsp;int</CODE></FONT></TD>
  143. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getAttributeCount()">getAttributeCount</A></B>()</CODE>
  144. <BR>
  145. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Number of attributes in current node.</TD>
  146. </TR>
  147. <TR BGCOLOR="white" CLASS="TableRowColor">
  148. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  149. <CODE>&nbsp;<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  150. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getAttributeName(int)">getAttributeName</A></B>(int&nbsp;index)</CODE>
  151. <BR>
  152. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Name of attribute in current node.</TD>
  153. </TR>
  154. <TR BGCOLOR="white" CLASS="TableRowColor">
  155. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  156. <CODE>&nbsp;<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</A></CODE></FONT></TD>
  157. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getAttributeNames()">getAttributeNames</A></B>()</CODE>
  158. <BR>
  159. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Names of attributes (as Strings).</TD>
  160. </TR>
  161. <TR BGCOLOR="white" CLASS="TableRowColor">
  162. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  163. <CODE>&nbsp;<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  164. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getNodeName()">getNodeName</A></B>()</CODE>
  165. <BR>
  166. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the name of the current node.</TD>
  167. </TR>
  168. <TR BGCOLOR="white" CLASS="TableRowColor">
  169. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  170. <CODE>&nbsp;<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
  171. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#getValue()">getValue</A></B>()</CODE>
  172. <BR>
  173. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the value (text content) of the current node.</TD>
  174. </TR>
  175. <TR BGCOLOR="white" CLASS="TableRowColor">
  176. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  177. <CODE>&nbsp;boolean</CODE></FONT></TD>
  178. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#hasMoreChildren()">hasMoreChildren</A></B>()</CODE>
  179. <BR>
  180. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Does the node have any more children remaining that have not yet been read?</TD>
  181. </TR>
  182. <TR BGCOLOR="white" CLASS="TableRowColor">
  183. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  184. <CODE>&nbsp;void</CODE></FONT></TD>
  185. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#moveDown()">moveDown</A></B>()</CODE>
  186. <BR>
  187. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Select the current child as current node.</TD>
  188. </TR>
  189. <TR BGCOLOR="white" CLASS="TableRowColor">
  190. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  191. <CODE>&nbsp;void</CODE></FONT></TD>
  192. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#moveUp()">moveUp</A></B>()</CODE>
  193. <BR>
  194. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Select the parent node as current node.</TD>
  195. </TR>
  196. <TR BGCOLOR="white" CLASS="TableRowColor">
  197. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  198. <CODE>&nbsp;<A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html" title="interface in com.thoughtworks.xstream.io">HierarchicalStreamReader</A></CODE></FONT></TD>
  199. <TD><CODE><B><A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#underlyingReader()">underlyingReader</A></B>()</CODE>
  200. <BR>
  201. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the underlying HierarchicalStreamReader implementation.</TD>
  202. </TR>
  203. </TABLE>
  204. &nbsp;
  205. <P>
  206. <!-- ============ METHOD DETAIL ========== -->
  207. <A NAME="method_detail"><!-- --></A>
  208. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  209. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  210. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
  211. <B>Method Detail</B></FONT></TH>
  212. </TR>
  213. </TABLE>
  214. <A NAME="hasMoreChildren()"><!-- --></A><H3>
  215. hasMoreChildren</H3>
  216. <PRE>
  217. boolean <B>hasMoreChildren</B>()</PRE>
  218. <DL>
  219. <DD>Does the node have any more children remaining that have not yet been read?
  220. <P>
  221. <DD><DL>
  222. </DL>
  223. </DD>
  224. <DD><DL>
  225. </DL>
  226. </DD>
  227. </DL>
  228. <HR>
  229. <A NAME="moveDown()"><!-- --></A><H3>
  230. moveDown</H3>
  231. <PRE>
  232. void <B>moveDown</B>()</PRE>
  233. <DL>
  234. <DD>Select the current child as current node.
  235. A call to this function must be balanced with a call to <A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html#moveUp()"><CODE>moveUp()</CODE></A>.
  236. <P>
  237. <DD><DL>
  238. </DL>
  239. </DD>
  240. <DD><DL>
  241. </DL>
  242. </DD>
  243. </DL>
  244. <HR>
  245. <A NAME="moveUp()"><!-- --></A><H3>
  246. moveUp</H3>
  247. <PRE>
  248. void <B>moveUp</B>()</PRE>
  249. <DL>
  250. <DD>Select the parent node as current node.
  251. <P>
  252. <DD><DL>
  253. </DL>
  254. </DD>
  255. <DD><DL>
  256. </DL>
  257. </DD>
  258. </DL>
  259. <HR>
  260. <A NAME="getNodeName()"><!-- --></A><H3>
  261. getNodeName</H3>
  262. <PRE>
  263. <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getNodeName</B>()</PRE>
  264. <DL>
  265. <DD>Get the name of the current node.
  266. <P>
  267. <DD><DL>
  268. </DL>
  269. </DD>
  270. <DD><DL>
  271. </DL>
  272. </DD>
  273. </DL>
  274. <HR>
  275. <A NAME="getValue()"><!-- --></A><H3>
  276. getValue</H3>
  277. <PRE>
  278. <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getValue</B>()</PRE>
  279. <DL>
  280. <DD>Get the value (text content) of the current node.
  281. <P>
  282. <DD><DL>
  283. </DL>
  284. </DD>
  285. <DD><DL>
  286. </DL>
  287. </DD>
  288. </DL>
  289. <HR>
  290. <A NAME="getAttribute(java.lang.String)"><!-- --></A><H3>
  291. getAttribute</H3>
  292. <PRE>
  293. <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getAttribute</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</PRE>
  294. <DL>
  295. <DD>Get the value of an attribute of the current node.
  296. <P>
  297. <DD><DL>
  298. </DL>
  299. </DD>
  300. <DD><DL>
  301. </DL>
  302. </DD>
  303. </DL>
  304. <HR>
  305. <A NAME="getAttribute(int)"><!-- --></A><H3>
  306. getAttribute</H3>
  307. <PRE>
  308. <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getAttribute</B>(int&nbsp;index)</PRE>
  309. <DL>
  310. <DD>Get the value of an attribute of the current node, by index.
  311. <P>
  312. <DD><DL>
  313. </DL>
  314. </DD>
  315. <DD><DL>
  316. </DL>
  317. </DD>
  318. </DL>
  319. <HR>
  320. <A NAME="getAttributeCount()"><!-- --></A><H3>
  321. getAttributeCount</H3>
  322. <PRE>
  323. int <B>getAttributeCount</B>()</PRE>
  324. <DL>
  325. <DD>Number of attributes in current node.
  326. <P>
  327. <DD><DL>
  328. </DL>
  329. </DD>
  330. <DD><DL>
  331. </DL>
  332. </DD>
  333. </DL>
  334. <HR>
  335. <A NAME="getAttributeName(int)"><!-- --></A><H3>
  336. getAttributeName</H3>
  337. <PRE>
  338. <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getAttributeName</B>(int&nbsp;index)</PRE>
  339. <DL>
  340. <DD>Name of attribute in current node.
  341. <P>
  342. <DD><DL>
  343. </DL>
  344. </DD>
  345. <DD><DL>
  346. </DL>
  347. </DD>
  348. </DL>
  349. <HR>
  350. <A NAME="getAttributeNames()"><!-- --></A><H3>
  351. getAttributeNames</H3>
  352. <PRE>
  353. <A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</A> <B>getAttributeNames</B>()</PRE>
  354. <DL>
  355. <DD>Names of attributes (as Strings).
  356. <P>
  357. <DD><DL>
  358. </DL>
  359. </DD>
  360. <DD><DL>
  361. </DL>
  362. </DD>
  363. </DL>
  364. <HR>
  365. <A NAME="appendErrors(com.thoughtworks.xstream.converters.ErrorWriter)"><!-- --></A><H3>
  366. appendErrors</H3>
  367. <PRE>
  368. void <B>appendErrors</B>(<A HREF="../../../../com/thoughtworks/xstream/converters/ErrorWriter.html" title="interface in com.thoughtworks.xstream.converters">ErrorWriter</A>&nbsp;errorWriter)</PRE>
  369. <DL>
  370. <DD>If any errors are detected, allow the reader to add any additional information that can aid debugging
  371. (such as line numbers, XPath expressions, etc).
  372. <P>
  373. <DD><DL>
  374. <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/thoughtworks/xstream/converters/ErrorReporter.html#appendErrors(com.thoughtworks.xstream.converters.ErrorWriter)">appendErrors</A></CODE> in interface <CODE><A HREF="../../../../com/thoughtworks/xstream/converters/ErrorReporter.html" title="interface in com.thoughtworks.xstream.converters">ErrorReporter</A></CODE></DL>
  375. </DD>
  376. <DD><DL>
  377. <DT><B>Parameters:</B><DD><CODE>errorWriter</CODE> - the error writer</DL>
  378. </DD>
  379. </DL>
  380. <HR>
  381. <A NAME="close()"><!-- --></A><H3>
  382. close</H3>
  383. <PRE>
  384. void <B>close</B>()</PRE>
  385. <DL>
  386. <DD>Close the reader, if necessary.
  387. <P>
  388. <DD><DL>
  389. </DL>
  390. </DD>
  391. <DD><DL>
  392. </DL>
  393. </DD>
  394. </DL>
  395. <HR>
  396. <A NAME="underlyingReader()"><!-- --></A><H3>
  397. underlyingReader</H3>
  398. <PRE>
  399. <A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamReader.html" title="interface in com.thoughtworks.xstream.io">HierarchicalStreamReader</A> <B>underlyingReader</B>()</PRE>
  400. <DL>
  401. <DD>Return the underlying HierarchicalStreamReader implementation.
  402. <p>If a Converter needs to access methods of a specific HierarchicalStreamReader implementation that are not
  403. defined in the HierarchicalStreamReader interface, it should call this method before casting. This is because
  404. the reader passed to the Converter is often wrapped/decorated by another implementation to provide additional
  405. functionality (such as XPath tracking).</p>
  406. <p>For example:</p>
  407. <pre>MySpecificReader mySpecificReader = (MySpecificReader)reader; <b>// INCORRECT!</b>
  408. mySpecificReader.doSomethingSpecific();</pre>
  409. <pre>MySpecificReader mySpecificReader = (MySpecificReader)reader.underlyingReader(); <b>// CORRECT!</b>
  410. mySpecificReader.doSomethingSpecific();</pre>
  411. <p>Implementations of HierarchicalStreamReader should return 'this', unless they are a decorator, in which case
  412. they should delegate to whatever they are wrapping.</p>
  413. <P>
  414. <DD><DL>
  415. </DL>
  416. </DD>
  417. <DD><DL>
  418. </DL>
  419. </DD>
  420. </DL>
  421. <!-- ========= END OF CLASS DATA ========= -->
  422. <HR>
  423. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  424. <A NAME="navbar_bottom"><!-- --></A>
  425. <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
  426. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  427. <TR>
  428. <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  429. <A NAME="navbar_bottom_firstrow"><!-- --></A>
  430. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  431. <TR ALIGN="center" VALIGN="top">
  432. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  433. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  434. <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  435. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/HierarchicalStreamReader.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  436. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  437. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  438. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  439. <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  440. </TR>
  441. </TABLE>
  442. </TD>
  443. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  444. </EM>
  445. </TD>
  446. </TR>
  447. <TR>
  448. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  449. &nbsp;<A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamDriver.html" title="interface in com.thoughtworks.xstream.io"><B>PREV CLASS</B></A>&nbsp;
  450. &nbsp;<A HREF="../../../../com/thoughtworks/xstream/io/HierarchicalStreamWriter.html" title="interface in com.thoughtworks.xstream.io"><B>NEXT CLASS</B></A></FONT></TD>
  451. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  452. <A HREF="../../../../index.html?com/thoughtworks/xstream/io/HierarchicalStreamReader.html" target="_top"><B>FRAMES</B></A> &nbsp;
  453. &nbsp;<A HREF="HierarchicalStreamReader.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
  454. &nbsp;<SCRIPT type="text/javascript">
  455. <!--
  456. if(window==top) {
  457. document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  458. }
  459. //-->
  460. </SCRIPT>
  461. <NOSCRIPT>
  462. <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
  463. </NOSCRIPT>
  464. </FONT></TD>
  465. </TR>
  466. <TR>
  467. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  468. SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  469. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  470. DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  471. </TR>
  472. </TABLE>
  473. <A NAME="skip-navbar_bottom"></A>
  474. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  475. <HR>
  476. Copyright &#169; 2004-2011 <a href="http://xstream.codehaus.org">XStream</a>. All Rights Reserved.
  477. </BODY>
  478. </HTML>