/Prototipo/Servlet/lib/xstream-distribution-1.4.1-bin/xstream-1.4.1/docs/converters.html

http://prototipomemoria.googlecode.com/ · HTML · 819 lines · 758 code · 34 blank · 27 comment · 0 complexity · 15d8a6c523fac6d0a8f1553133cee893 MD5 · raw file

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <!--
  4. Copyright (C) 2005, 2006 Joe Walnes.
  5. Copyright (C) 2006, 2007, 2008 XStream committers.
  6. All rights reserved.
  7. The software in this package is published under the terms of the BSD
  8. style license a copy of which has been included with this distribution in
  9. the LICENSE.txt file.
  10. Created on 29. January 2005 by Joe Walnes
  11. -->
  12. <head>
  13. <title>XStream - Converters</title>
  14. <link rel="stylesheet" type="text/css" href="style.css"/>
  15. <style type="text/css">
  16. .example { font-family: courier; font-size: 8pt; }
  17. #content td { border-top: thin solid #5c5 ;}
  18. #content .headerRow { background-color: white; }
  19. </style>
  20. <!-- Google analytics -->
  21. <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
  22. </script>
  23. <script type="text/javascript">
  24. _uacct = "UA-110973-2";
  25. urchinTracker();
  26. </script>
  27. </head>
  28. <body>
  29. <div id="banner">
  30. <a href="index.html"><img id="logo" src="logo.gif" alt="XStream"/></a>
  31. </div>
  32. <div id="center" class="Content2Column"> <!-- Content3Column for index -->
  33. <div id="content">
  34. <h1 class="FirstChild">Converters</h1>
  35. <p>The core of XStream consists of a registry of
  36. <a href="javadoc/com/thoughtworks/xstream/converters/Converter.html"><b>Converters</b></a>. The responsibility of a Converter is to
  37. provide a strategy for converting particular types of objects found in the object graph, to and from XML.</p>
  38. <p>XStream is provided with Converters for common types such as primitives, String, File, Collections, arrays,
  39. and Dates.</p>
  40. <table class="examplesTable" summary="Overview over all Converters delivered with XStream">
  41. <!-- .................................................................................................. -->
  42. <tr>
  43. <td colspan="4" class="headerRow"><h1 id="java.lang">java.lang (and core special types)</h1></td>
  44. </tr>
  45. <tr>
  46. <th>Converter</th>
  47. <th>Supported types</th>
  48. <th>Example</th>
  49. <th>Notes</th>
  50. </tr>
  51. <tr>
  52. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/NullConverter.html">NullConverter</a></td>
  53. <td>null values</td>
  54. <td class="example">&lt;null/&gt;</td>
  55. <td>Usually, null fields are left out of the XML, however when used in arrays or the root object they
  56. have to be explicitly marked.</td>
  57. </tr>
  58. <tr>
  59. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/ArrayConverter.html">ArrayConverter</a></td>
  60. <td>Any kind of array</td>
  61. <td class="example">
  62. &lt;string-array&gt;<br/>
  63. &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
  64. &nbsp;&nbsp;&lt;string&gt;banana&lt;/string&gt;<br/>
  65. &nbsp;&nbsp;&lt;string&gt;cabbage&lt;/string&gt;<br/>
  66. &lt;/string-array&gt;
  67. </td>
  68. <td>This supports arrays of primitives as well as objects. It also supports multi-dimensional arrays, even if
  69. they are non-rectangular.</td>
  70. </tr>
  71. <tr>
  72. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/BooleanConverter.html">BooleanConverter</a></td>
  73. <td>boolean<br/>java.lang.Boolean</td>
  74. <td class="example">&lt;boolean&gt;true&lt;/boolean&gt;</td>
  75. <td>&nbsp;</td>
  76. </tr>
  77. <tr>
  78. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/ByteConverter.html">ByteConverter</a></td>
  79. <td>byte<br/>java.lang.Byte</td>
  80. <td class="example">&lt;byte&gt;22&lt;/byte&gt;</td>
  81. <td>The byte is represented as an integer.</td>
  82. </tr>
  83. <tr>
  84. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/EncodedByteArrayConverter.html">EncodedByteArrayConverter</a></td>
  85. <td>byte[]</td>
  86. <td class="example">&lt;byte-array&gt;AHiEFiEABQ==&lt;/byte-array&gt;</td>
  87. <td>Uses Base64 encoding to store binary data in XML. Converter is not automatically registered.</td>
  88. </tr>
  89. <tr>
  90. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/CharConverter.html">CharConverter</a></td>
  91. <td>char<br/>java.lang.Character</td>
  92. <td class="example">&lt;char&gt;X&lt;/char&gt;</td>
  93. <td>&nbsp;</td>
  94. </tr>
  95. <tr>
  96. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/CharArrayConverter.html">CharArrayConverter</a></td>
  97. <td>char[]</td>
  98. <td class="example">
  99. &lt;char-array&gt;hello&lt;char-array&gt;
  100. </td>
  101. <td>Joins all characters into a single String.</td>
  102. </tr>
  103. <tr>
  104. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/DoubleConverter.html">DoubleConverter</a></td>
  105. <td>double<br/>java.lang.Double</td>
  106. <td class="example">&lt;double&gt;456774543443.4553435&lt;/double&gt;</td>
  107. <td>&nbsp;</td>
  108. </tr>
  109. <tr>
  110. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/FloatConverter.html">FloatConverter</a></td>
  111. <td>float<br/>java.lang.Float</td>
  112. <td class="example">&lt;float&gt;4563443.435&lt;/float&gt;</td>
  113. <td>&nbsp;</td>
  114. </tr>
  115. <tr>
  116. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/IntConverter.html">IntConverter</a></td>
  117. <td>int<br/>java.lang.Integer</td>
  118. <td class="example">&lt;int&gt;12345678&lt;/int&gt;</td>
  119. <td>&nbsp;</td>
  120. </tr>
  121. <tr>
  122. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/LongConverter.html">LongConverter</a></td>
  123. <td>long<br/>java.lang.Long</td>
  124. <td class="example">&lt;long&gt;2344556678888786&lt;/long&gt;</td>
  125. <td>&nbsp;</td>
  126. </tr>
  127. <tr>
  128. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/ShortConverter.html">ShortConverter</a></td>
  129. <td>short<br/>java.lang.Short</td>
  130. <td class="example">&lt;short&gt;1445&lt;/short&gt;</td>
  131. <td>&nbsp;</td>
  132. </tr>
  133. <tr>
  134. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/StringConverter.html">StringConverter</a></td>
  135. <td>java.lang.String</td>
  136. <td class="example">&lt;string&gt;hello world&lt;/string&gt;</td>
  137. <td>&nbsp;</td>
  138. </tr>
  139. <tr>
  140. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/StringBufferConverter.html">StringBufferConverter</a></td>
  141. <td>java.lang.StringBuffer</td>
  142. <td class="example">&lt;string-buffer&gt;hello world&lt;/string-buffer&gt;</td>
  143. <td>&nbsp;</td>
  144. </tr>
  145. <tr>
  146. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/StringBuildererConverter.html">StringBuilderConverter</a></td>
  147. <td>java.lang.StringBuilder</td>
  148. <td class="example">&lt;string-builder&gt;hello world&lt;/string-builder&gt;</td>
  149. <td>Available under Java 1.5 or greater.</td>
  150. </tr>
  151. <tr>
  152. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ThrowableConverter.html">ThrowableConverter</a></td>
  153. <td>java.lang.Throwable<br/>java.lang.Exception<br/>java.lang.RuntimeException<br/>java.lang.Error<br/>...and all subclasses
  154. of these.</td>
  155. <td class="example">
  156. &lt;java.io.IOException&gt;<br/>
  157. &nbsp;&nbsp;&lt;detailMessage&gt;No file&lt;/detailMessage&gt;<br/>
  158. &nbsp;&nbsp;&lt;stack-trace&gt;<br/>
  159. &nbsp;&nbsp;&nbsp;&nbsp;&lt;trace&gt;com.x.Foo.stuff(Foo.java:22)&lt;/trace&gt;<br/>
  160. &nbsp;&nbsp;&nbsp;&nbsp;&lt;trace&gt;com.x.Foo.blah(Foo.java:31)&lt;/trace&gt;<br/>
  161. &nbsp;&nbsp;&nbsp;&nbsp;&lt;trace&gt;com.x.Foo.main(Foo.java:43)&lt;/trace&gt;<br/>
  162. &nbsp;&nbsp;&lt;/stack-trace&gt;<br/>
  163. &lt;/java.io.IOException&gt;
  164. </td>
  165. <td>This is only available under Java 1.4 or greater. It retains the full stack trace, including that of any
  166. nested exceptions. The stack trace elements are handled by the
  167. <a href="javadoc/com/thoughtworks/xstream/converters/extended/StackTraceElementConverter.html">StackTraceElementConverter</a>.</td>
  168. </tr>
  169. <tr>
  170. <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumConverter.html">EnumConverter</a></td>
  171. <td>java.lang.Enum</td>
  172. <td class="example">&lt;java.lang.annotation.RetentionPolicy&gt;<br/>CLASS<br/>&lt;/java.lang.annotation.RetentionPolicy&gt;</td>
  173. <td>Available under Java 1.5 or greater.</td>
  174. </tr>
  175. <!-- .................................................................................................. -->
  176. <tr>
  177. <td colspan="4" class="headerRow"><h1 id="java.util">java.util</h1></td>
  178. </tr>
  179. <tr>
  180. <th>Converter</th>
  181. <th>Supported types</th>
  182. <th>Example</th>
  183. <th>Notes</th>
  184. </tr>
  185. <tr>
  186. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/CollectionConverter.html">CollectionConverter</a></td>
  187. <td>java.util.ArrayList<br/>java.util.LinkedList<br/>java.util.HashSet<br/>java.util.Vector<br/>java.util.LinkedHashSet</td>
  188. <td class="example">
  189. &lt;linked-list&gt;<br/>
  190. &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
  191. &nbsp;&nbsp;&lt;string&gt;banana&lt;/string&gt;<br/>
  192. &nbsp;&nbsp;&lt;big-decimal&gt;12345.4555&lt;/big-decimal&gt;<br/>
  193. &lt;/linked-list&gt;
  194. </td>
  195. <td>The objects inside the collection can be any type of objects, including nested collections.</td>
  196. </tr>
  197. <tr>
  198. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/MapConverter.html">MapConverter</a></td>
  199. <td>java.util.HashMap<br/>java.util.Hashtable<br/>java.util.LinkedHashMap</td>
  200. <td class="example">
  201. &lt;map&gt;<br/>
  202. &nbsp;&nbsp;&lt;entry&gt;<br/>
  203. &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
  204. &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;123.553&lt;/float&gt;<br/>
  205. &nbsp;&nbsp;&lt;/entry&gt;<br/>
  206. &nbsp;&nbsp;&lt;entry&gt;<br/>
  207. &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;orange&lt;/string&gt;<br/>
  208. &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;55.4&lt;/float&gt;<br/>
  209. &nbsp;&nbsp;&lt;/entry&gt;<br/>
  210. &lt;/map&gt;
  211. </td>
  212. <td>Both key and values can be any type of objects.</td>
  213. </tr>
  214. <tr>
  215. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/PropertiesConverter.html">PropertiesConverter</a></td>
  216. <td>java.util.Properties</td>
  217. <td class="example">
  218. &lt;properties&gt;<br/>
  219. &nbsp;&nbsp;&lt;property name=&quot;host&quot; value=&quot;localhost&quot;/&gt;<br/>
  220. &nbsp;&nbsp;&lt;property name=&quot;port&quot; value=&quot;888&quot;/&gt;<br/>
  221. &lt;/properties&gt;
  222. </td>
  223. <td>Because the Properties class only accepts Strings for keys and values, the XML can be more concise.
  224. If the Properties instance includes a set of default Properties, these are serialized in a nested <code>&lt;defaults&gt;</code> element.</td>
  225. </tr>
  226. <tr>
  227. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/TreeMapConverter.html">TreeMapConverter</a></td>
  228. <td>java.util.TreeMap</td>
  229. <td class="example">
  230. &lt;tree-map&gt;<br/>
  231. &nbsp;&nbsp;&lt;comparator class=&quot;com.blah.MyComparator&quot;/&gt;<br/>
  232. &nbsp;&nbsp;&lt;entry&gt;<br/>
  233. &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
  234. &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;123.553&lt;/float&gt;<br/>
  235. &nbsp;&nbsp;&lt;/entry&gt;<br/>
  236. &nbsp;&nbsp;&lt;entry&gt;<br/>
  237. &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;orange&lt;/string&gt;<br/>
  238. &nbsp;&nbsp;&nbsp;&nbsp;&lt;float&gt;55.4&lt;/float&gt;<br/>
  239. &nbsp;&nbsp;&lt;/entry&gt;<br/>
  240. &lt;/tree-map&gt;
  241. </td>
  242. <td>This is similar to MapConverter with an additional field for storing the java.util.Comparator associated with the TreeMap.</td>
  243. </tr>
  244. <tr>
  245. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/TreeSetConverter.html">TreeSetConverter</a></td>
  246. <td>java.util.TreeSet</td>
  247. <td class="example">
  248. &lt;tree-set&gt;<br/>
  249. &nbsp;&nbsp;&lt;comparator class=&quot;com.blah.MyComparator&quot;/&gt;<br/>
  250. &nbsp;&nbsp;&lt;string&gt;apple&lt;/string&gt;<br/>
  251. &nbsp;&nbsp;&lt;string&gt;banana&lt;/string&gt;<br/>
  252. &nbsp;&nbsp;&lt;string&gt;cabbage&lt;/string&gt;<br/>
  253. &lt;/tree-set&gt;
  254. </td>
  255. <td>This is similar to CollectionConverter with an additional field for storing the java.util.Comparator associated with the TreeSet.</td>
  256. </tr>
  257. <tr>
  258. <td><a href="javadoc/com/thoughtworks/xstream/converters/collections/BitSetConverter.html">BitSetConverter</a></td>
  259. <td>java.util.BitSet</td>
  260. <td class="example">
  261. &lt;bit-set&gt;0,1,3,5,6,8,10&lt;/bit-set&gt;
  262. </td>
  263. <td>Stores a comma separated list of which bits are set. Designed to be readable without taking up too much space.</td>
  264. </tr>
  265. <tr>
  266. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/DateConverter.html">DateConverter</a></td>
  267. <td>java.util.Date</td>
  268. <td class="example">&lt;date&gt;2004-02-22 15:16:04.0 EST&lt;/date&gt;</td>
  269. <td></td>
  270. </tr>
  271. <tr>
  272. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/GregorianCalendarConverter.html">GregorianCalendarConverter</a></td>
  273. <td>java.util.Calendar<br/>java.util.GregorianCalendar</td>
  274. <td class="example">
  275. &lt;gregorian-calendar&gt;<br/>
  276. &nbsp;&nbsp;&lt;time&gt;555454646&lt;/time&gt;<br/>
  277. &lt;/gregorian-calendar&gt;
  278. </td>
  279. <td>&nbsp;</td>
  280. </tr>
  281. <tr>
  282. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ISO8601DateConverter.html">ISO8601DateConverter</a></td>
  283. <td>java.util.Date</td>
  284. <td class="example">&lt;date&gt;2006-07-28T12:06:17.654-03:00&lt;/date&gt;</td>
  285. <td>Not automatically registered, needs joda-time</td>
  286. </tr>
  287. <tr>
  288. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ISO8601GregorianCalendarConverter.html">ISO8601GregorianCalendarConverter</a></td>
  289. <td>java.util.GregorianCalendar</td>
  290. <td class="example">
  291. &lt;gregorian-calendar&gt;<br/>
  292. 2006-07-28T12:07:02.788-03:00<br/>
  293. &lt;/gregorian-calendar&gt;
  294. </td>
  295. <td>Not automatically registered, needs joda-time</td>
  296. </tr>
  297. <tr>
  298. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/LocaleConverter.html">LocaleConverter</a></td>
  299. <td>java.util.Locale</td>
  300. <td class="example">&lt;locale&gt;en_GB&lt;/locale&gt;</td>
  301. <td>&nbsp;</td>
  302. </tr>
  303. <tr>
  304. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/CurrencyConverter.html">CurrencyConverter</a></td>
  305. <td>java.util.Currency</td>
  306. <td class="example">&lt;currency&gt;USD&lt;/currency&gt;</td>
  307. <td>Available under Java 1.4 or greater.</td>
  308. </tr>
  309. <tr>
  310. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/UUIDConverter.html">UUIDConverter</a></td>
  311. <td>java.util.UUID</td>
  312. <td class="example">&lt;uuid&gt;ca05f023-e07f-4956-a6ef-14ddd23df47b&lt;/uuid&gt;</td>
  313. <td>Available under Java 1.5 or greater.</td>
  314. </tr>
  315. <tr>
  316. <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumMapConverter.html">EnumMapConverter</a></td>
  317. <td>java.util.EnumMap</td>
  318. <td class="example">
  319. &lt;enum-map enum-type="simple"&gt;<br/>
  320. &nbsp;&nbsp;&lt;entry&gt;<br/>
  321. &nbsp;&nbsp;&nbsp;&nbsp;&lt;simple&gt;GREEN&lt;/simple&gt;<br/>
  322. &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;grass&lt;/string&gt;<br/>
  323. &nbsp;&nbsp;&lt;/entry&gt;<br/>
  324. &nbsp;&nbsp;&lt;entry&gt;<br/>
  325. &nbsp;&nbsp;&nbsp;&nbsp;&lt;simple&gt;BLUE&lt;/simple&gt;<br/>
  326. &nbsp;&nbsp;&nbsp;&nbsp;&lt;string&gt;sky&lt;/string&gt;<br/>
  327. &nbsp;&nbsp;&lt;/entry&gt;<br/>
  328. &lt;/enum-map&gt;</td>
  329. <td>Available under Java 1.5 or greater.</td>
  330. </tr>
  331. <tr>
  332. <td><a href="javadoc/com/thoughtworks/xstream/converters/enums/EnumSetConverter.html">EnumSetConverter</a></td>
  333. <td>java.util.EnumSet</td>
  334. <td class="example">
  335. &lt;enum-set enum-type=&quot;simple&quot;&gt;<br/>
  336. &nbsp;&nbsp;GREEN,BLUE<br/>
  337. &lt;/enum-set&gt;</td>
  338. <td>Available under Java 1.5 or greater.</td>
  339. </tr>
  340. <tr>
  341. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/RegexPatternConverter.html">RegexPatternConverter</a></td>
  342. <td>java.util.regex.Pattern</td>
  343. <td class="example">
  344. &lt;java.util.regex.Pattern&gt;<br/>
  345. &nbsp;&nbsp;&lt;pattern&gt;.*&lt;/pattern&gt;<br/>
  346. &nbsp;&nbsp;&lt;flags&gt;0&lt;/flags&gt;<br/>
  347. &lt;/java.util.regex.Pattern&gt;
  348. </td>
  349. <td>Available under Java 1.4 or greater.</td>
  350. </tr>
  351. <!-- .................................................................................................. -->
  352. <tr>
  353. <td colspan="4" class="headerRow"><h1 id="java.sql">java.sql</h1></td>
  354. </tr>
  355. <tr>
  356. <th>Converter</th>
  357. <th>Supported types</th>
  358. <th>Example</th>
  359. <th>Notes</th>
  360. </tr>
  361. <tr>
  362. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SqlDateConverter.html">SqlDateConverter</a></td>
  363. <td>java.sql.Date</td>
  364. <td class="example">&lt;sql-date&gt;1978-08-25&lt;/sql-date&gt;</td>
  365. <td>&nbsp;</td>
  366. </tr>
  367. <tr>
  368. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SqlTimeConverter.html">SqlTimeConverter</a></td>
  369. <td>java.sql.Time</td>
  370. <td class="example">&lt;sql-time&gt;14:07:33&lt;/sql-time&gt;</td>
  371. <td>&nbsp;</td>
  372. </tr>
  373. <tr>
  374. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SqlTimestampConverter.html">SqlTimestampConverter</a></td>
  375. <td>java.sql.Timestamp</td>
  376. <td class="example">&lt;sql-timestamp&gt;1970-01-01 00:00:01.234&lt;/sql-timestamp&gt;</td>
  377. <td>&nbsp;</td>
  378. </tr>
  379. <tr>
  380. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ISO8601SqlTimestampConverter.html">ISO8601SqlTimestampConverter</a></td>
  381. <td>java.sql.Timestamp</td>
  382. <td class="example">&lt;sql-timestamp&gt;2006-07-28T12:06:17.654000000-03:00&lt;/sql-timestamp&gt;</td>
  383. <td>Not automatically registered, needs joda-time</td>
  384. </tr>
  385. <!-- .................................................................................................. -->
  386. <tr>
  387. <td colspan="4" class="headerRow"><h1 id="java.math">java.math</h1></td>
  388. </tr>
  389. <tr>
  390. <th>Converter</th>
  391. <th>Supported types</th>
  392. <th>Example</th>
  393. <th>Notes</th>
  394. </tr>
  395. <tr>
  396. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/BigDecimalConverter.html">BigDecimalConverter</a></td>
  397. <td>java.math.BigDecimal</td>
  398. <td class="example">&lt;big-decimal&gt;342346.445332&lt;/big-decimal&gt;</td>
  399. <td>&nbsp;</td>
  400. </tr>
  401. <tr>
  402. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/BigIntegerConverter.html">BigIntegerConverter</a></td>
  403. <td>java.math.BigInteger</td>
  404. <td class="example">&lt;big-int&gt;23434224556&lt;/big-int&gt;</td>
  405. <td>&nbsp;</td>
  406. </tr>
  407. <!-- .................................................................................................. -->
  408. <tr>
  409. <td colspan="4" class="headerRow"><h1 id="java.net">java.net</h1></td>
  410. </tr>
  411. <tr>
  412. <th>Converter</th>
  413. <th>Supported types</th>
  414. <th>Example</th>
  415. <th>Notes</th>
  416. </tr>
  417. <tr>
  418. <td><a href="javadoc/com/thoughtworks/xstream/converters/basic/URLConverter.html">URLConverter</a></td>
  419. <td>java.net.Url</td>
  420. <td class="example">&lt;url&gt;http://codehaus.org/blah&lt;/url&gt;</td>
  421. <td>&nbsp;</td>
  422. </tr>
  423. <!-- .................................................................................................. -->
  424. <tr>
  425. <td colspan="4" class="headerRow"><h1 id="java.io">java.io</h1></td>
  426. </tr>
  427. <tr>
  428. <th>Converter</th>
  429. <th>Supported types</th>
  430. <th>Example</th>
  431. <th>Notes</th>
  432. </tr>
  433. <tr>
  434. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/FileConverter.html">FileConverter</a></td>
  435. <td>java.io.File</td>
  436. <td class="example">&lt;file&gt;/stuff/hello.txt&lt;/file&gt;</td>
  437. <td>&nbsp;</td>
  438. </tr>
  439. <tr>
  440. <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/SerializableConverter.html">SerializableConverter</a></td>
  441. <td>java.io.Serializable</td>
  442. <td>&nbsp;</td>
  443. <td>See description at Generalized Converters</td>
  444. </tr>
  445. <tr>
  446. <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/ExternalizableConverter.html">ExternalizableConverter</a></td>
  447. <td>java.io.Externalizable</td>
  448. <td>&nbsp;</td>
  449. <td>See description at Generalized Converters</td>
  450. </tr>
  451. <!-- .................................................................................................. -->
  452. <tr>
  453. <td colspan="4" class="headerRow"><h1 id="java.lang.reflect">java.lang.reflect</h1></td>
  454. </tr>
  455. <tr>
  456. <th>Converter</th>
  457. <th>Supported types</th>
  458. <th>Example</th>
  459. <th>Notes</th>
  460. </tr>
  461. <tr>
  462. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/JavaClassConverter.html">JavaClassConverter</a></td>
  463. <td>java.lang.Class</td>
  464. <td class="example">&lt;class&gt;com.foo.MyThing&lt;/class&gt;</td>
  465. <td>This converter will look for the class in the ClassLoader of the current XStream instance. It is possible
  466. to use another ClassLoader by re-registering a new instance of this converter that is wrapped around another
  467. ClassLoader.</td>
  468. </tr>
  469. <tr>
  470. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/JavaFieldConverter.html">JavaFieldConverter</a></td>
  471. <td>java.lang.reflect.Field</td>
  472. <td class="example">
  473. &lt;field&gt;<br/>
  474. &nbsp;&nbsp;&lt;name&gt;myField&lt;/name&gt;<br/>
  475. &nbsp;&nbsp;&lt;class&gt;com.foo.MyThing&lt;/class&gt;<br/>
  476. &lt;/field&gt;
  477. </td>
  478. <td>As with the JavaClassConverter, the converter will use the ClassLoader of the XStream instance to resolve classes
  479. by default. This can be changed by specifying another ClassLoader when constructing this Converter.</td>
  480. </tr>
  481. <tr>
  482. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/JavaMethodConverter.html">JavaMethodConverter</a></td>
  483. <td>java.lang.reflect.Method<br/>java.lang.reflect.Constructor</td>
  484. <td class="example">
  485. &lt;method&gt;<br/>
  486. &nbsp;&nbsp;&lt;class&gt;com.foo.MyThing&lt;/class&gt;<br/>
  487. &nbsp;&nbsp;&lt;name&gt;doStuff&lt;/name&gt;<br/>
  488. &nbsp;&nbsp;&lt;parameter-types&gt;<br/>
  489. &nbsp;&nbsp;&nbsp;&nbsp;&lt;class&gt;java.lang.String&lt;/class&gt;<br/>
  490. &nbsp;&nbsp;&nbsp;&nbsp;&lt;class&gt;java.util.Iterator&lt;/class&gt;<br/>
  491. &nbsp;&nbsp;&lt;/parameter-types&gt;<br/>
  492. &lt;/method&gt;
  493. </td>
  494. <td>The enclosing element for this tag will either by &lt;method&gt; or &lt;constructor&gt;. As with the JavaClassConverter, the converter
  495. will use the ClassLoader of the XStream instance to resolve classes by default. This can be changed by specifying another ClassLoader when
  496. constructing this Converter.</td>
  497. </tr>
  498. <tr>
  499. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/DynamicProxyConverter.html">DynamicProxyConverter</a></td>
  500. <td>Any dynamic proxy generated by java.lang.reflect.Proxy</td>
  501. <td class="example">
  502. &lt;dynamic-proxy&gt;<br/>
  503. &nbsp;&nbsp;&lt;interface&gt;com.foo.Blah&lt;/interface&gt;<br/>
  504. &nbsp;&nbsp;&lt;interface&gt;com.foo.Woo&lt;/interface&gt;<br/>
  505. &nbsp;&nbsp;&lt;handler class=&quot;com.foo.MyHandler&quot;&gt;<br/>
  506. &nbsp;&nbsp;&nbsp;&nbsp;&lt;something&gt;blah&lt;/something&gt;<br/>
  507. &nbsp;&nbsp;&lt;/handler&gt;<br/>
  508. &lt;/dynamic-proxy&gt;
  509. </td>
  510. <td>The dynamic proxy itself is not serialized, however the interfaces it implements and the actual InvocationHandler
  511. instance are serialized. This allows the proxy to be reconstructed after deserialization.</td>
  512. </tr>
  513. <!-- .................................................................................................. -->
  514. <tr>
  515. <td colspan="4" class="headerRow"><h1 id="java.awt">java.awt</h1></td>
  516. </tr>
  517. <tr>
  518. <th>Converter</th>
  519. <th>Supported types</th>
  520. <th>Example</th>
  521. <th>Notes</th>
  522. </tr>
  523. <tr>
  524. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ColorConverter.html">ColorConverter</a></td>
  525. <td>java.awt.Color</td>
  526. <td class="example">
  527. &lt;awt-color&gt;<br/>
  528. &nbsp;&nbsp;&lt;red&gt;255&lt;/red&gt;<br/>
  529. &nbsp;&nbsp;&lt;green&gt;255&lt;/green&gt;<br/>
  530. &nbsp;&nbsp;&lt;blue&gt;255&lt;/blue&gt;<br/>
  531. &nbsp;&nbsp;&lt;alpha&gt;255&lt;/alpha&gt;<br/>
  532. &lt;/awt-color&gt;
  533. </td>
  534. <td><b>Warning:</b> The AWT toolkit is initialized when a Color is deserialized due to the internals of the Color class.
  535. This should only be an issue if deserializing a Color on a headless server process.</td>
  536. </tr>
  537. <tr>
  538. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/FontConverter.html">FontConverter</a></td>
  539. <td>java.awt.Font</td>
  540. <td class="example">&nbsp;</td>
  541. <td><b>Warning:</b> The AWT toolkit is initialized when a Font is deserialized due to the internals of the Font class.
  542. This should only be an issue if deserializing a Font on a headless server process.</td>
  543. </tr>
  544. <!-- .................................................................................................. -->
  545. <tr>
  546. <td colspan="4" class="headerRow"><h1 id="java.awt.font">java.awt.font</h1></td>
  547. </tr>
  548. <tr>
  549. <th>Converter</th>
  550. <th>Supported types</th>
  551. <th>Example</th>
  552. <th>Notes</th>
  553. </tr>
  554. <tr>
  555. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/TextAttributeConverter.html">TextAttributeConverter</a></td>
  556. <td>java.awt.font.TextAttribute</td>
  557. <td class="example">
  558. &lt;awt-text-attribute&gt;family&lt;/awt-text-attribute&gt;
  559. </td>
  560. <td><b>Warning:</b> The AWT toolkit is initialized when a TextAttribute is deserialized due to the internals of the TextAttribute class.
  561. This should only be an issue if deserializing a TextAttribute on a headless server process.</td>
  562. </tr>
  563. <!-- .................................................................................................. -->
  564. <tr>
  565. <td colspan="4" class="headerRow"><h1 id="javax.swing">javax.swing</h1></td>
  566. </tr>
  567. <tr>
  568. <th>Converter</th>
  569. <th>Supported types</th>
  570. <th>Example</th>
  571. <th>Notes</th>
  572. </tr>
  573. <tr>
  574. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/LookAndFeelConverter.html">LookAndFeelConverter</a></td>
  575. <td>javax.swing.LookAndFeel implementations</td>
  576. <td class="example">&nbsp;</td>
  577. <td>Explicit mapping to the ReflectionConverter. Although the implementations of the LookAndFeel classes are serializable, they will
  578. throw an exception executing writeObject(), therefore the SerializableConverter is not used.</td>
  579. </tr>
  580. <!-- .................................................................................................. -->
  581. <tr>
  582. <td colspan="4" class="headerRow"><h1 id="javax.security.auth">javax.security.auth</h1></td>
  583. </tr>
  584. <tr>
  585. <th>Converter</th>
  586. <th>Supported types</th>
  587. <th>Example</th>
  588. <th>Notes</th>
  589. </tr>
  590. <tr>
  591. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/SubjectConverter.html">SubjectConverter</a></td>
  592. <td>javax.security.auth.Subject</td>
  593. <td class="example">
  594. &lt;auth-subject&gt;<br/>
  595. &nbsp;&nbsp;&lt;principals&gt;<br/>
  596. &nbsp;&nbsp;&nbsp;&nbsp;&lt;com.thoughtworks.xstream.Admin/&gt;<br/>
  597. &nbsp;&nbsp;&lt;/principals&gt;<br/>
  598. &nbsp;&nbsp;&lt;readOnly&gt;false&lt;/readOnly&gt;<br/>
  599. &lt;/auth-subject&gt;<br/>
  600. </td>
  601. <td>Available under Java 1.4 or greater. This converter does not serialize any credentials but only the principals.</td>
  602. </tr>
  603. <!-- .................................................................................................. -->
  604. <tr>
  605. <td colspan="4" class="headerRow"><h1 id="java.nio">java.nio</h1></td>
  606. </tr>
  607. <tr>
  608. <th>Converter</th>
  609. <th>Supported types</th>
  610. <th>Example</th>
  611. <th>Notes</th>
  612. </tr>
  613. <tr>
  614. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/CharsetConverter.html">CharsetConverter</a></td>
  615. <td>java.nio.charset.Charset</td>
  616. <td class="example">&lt;charset&gt;US-ASCII&lt;/charset&gt;</td>
  617. <td>Available under Java 1.4 or greater.</td>
  618. </tr>
  619. <!-- .................................................................................................. -->
  620. <tr>
  621. <td colspan="4" class="headerRow"><h1 id="javax.xml.datatype">javax.xml.datatype</h1></td>
  622. </tr>
  623. <tr>
  624. <th>Converter</th>
  625. <th>Supported types</th>
  626. <th>Example</th>
  627. <th>Notes</th>
  628. </tr>
  629. <tr>
  630. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/DurationConverter.html">DurationConverter</a></td>
  631. <td>javax.xml.datatype.Duration</td>
  632. <td class="example">&lt;duration&gt;PT1H2M&lt;/duration&gt;</td>
  633. <td>Available under Java 1.5 or greater.</td>
  634. </tr>
  635. <!-- .................................................................................................. -->
  636. <tr>
  637. <td colspan="4" class="headerRow"><h1 id="generic">Generalized Converters</h1></td>
  638. </tr>
  639. <tr>
  640. <th>Converter</th>
  641. <th>Supported types</th>
  642. <th>Explanation</th>
  643. <th>Notes</th>
  644. </tr>
  645. <tr>
  646. <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/ReflectionConverter.html">ReflectionConverter</a></td>
  647. <td>Any type</td>
  648. <td>The Converter is used as fallback. It uses reflection to examine the class and will serialize its fields.</td>
  649. <td>&nbsp;</td>
  650. </tr>
  651. <tr>
  652. <td><a href="javadoc/com/thoughtworks/xstream/annotations/AnnotationReflectionConverter.html">AnnotationReflectionConverter</a></td>
  653. <td>Any type</td>
  654. <td>The Converter is used as fallback. It uses reflection to examine the class and will serialize its fields and supports annotations for
  655. local converters.</td>
  656. <td>Needs JDK 1.5, default for JDK 1.5. Deprecated since XStream 1.3 and must be registered now explicitly.</td>
  657. </tr>
  658. <tr>
  659. <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/SerializableConverter.html">SerializableConverter</a></td>
  660. <td>java.io.Serializable or types with one of the serializable methods readObject or writeObject</td>
  661. <td>The Converter is used for any JDK-serializable types, if not handled by a specialized Converter.</td>
  662. <td>&nbsp;</td>
  663. </tr>
  664. <tr>
  665. <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/ExternalizableConverter.html">ExternalizableConverter</a></td>
  666. <td>java.io.Externalizable</td>
  667. <td>The Converter is used for any JDK-externalizable types, if not handled by a specialized Converter.</td>
  668. <td>&nbsp;</td>
  669. </tr>
  670. <tr>
  671. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ToAttributesValueConverter.html">ToAttributesValueConverter</a></td>
  672. <td>Any type with all but one fields to be represented by a single string</td>
  673. <td>The Converter is used to write all but one fields of the type as attributes. The left over field is then used as current value.</td>
  674. <td>Must be registered explicitly for the appropriate type</td>
  675. </tr>
  676. <tr>
  677. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/ToStringConverter.html">ToStringConverter</a></td>
  678. <td>Any type with natural String representation</td>
  679. <td>The Converter must be initialized with a type, that provides a complete String representation with its toString() method
  680. and is able to be recreated by a constructor taking a single String argument.</td>
  681. <td>Must be registered explicitly for the appropriate type</td>
  682. </tr>
  683. <tr>
  684. <td><a href="javadoc/com/thoughtworks/xstream/converters/javabean/JavaBeanConverter.html">JavaBeanConverter</a></td>
  685. <td>Java beans</td>
  686. <td>The Converter handles any type as Java bean. It expects the type to convert to have a public default constructor and
  687. appropriate getter and setters.</td>
  688. <td>Must be registered explicitly. Should be used as fallback.</td>
  689. </tr>
  690. <tr>
  691. <td><a href="javadoc/com/thoughtworks/xstream/converters/extended/PropertyEditorCapableConverter.html">PropertyEditorCapableConverter</a></td>
  692. <td>Any type with a PropertyEditor implementation</td>
  693. <td>The Converter can handles any type that provides a PropertyEditor implementation. The PropertyEditor's methods getAsText() and
  694. setAsText() are used to convert between object and string representation.</td>
  695. <td>Must be registered explicitly for the appropriate type.</td>
  696. </tr>
  697. <!-- .................................................................................................. -->
  698. <tr>
  699. <td colspan="4" class="headerRow"><h1 id="3rdParty">Converters for 3rd party classes</h1></td>
  700. </tr>
  701. <tr>
  702. <th>Converter</th>
  703. <th>Supported types</th>
  704. <th>Explanation</th>
  705. <th>Notes</th>
  706. </tr>
  707. <tr>
  708. <td><a href="javadoc/com/thoughtworks/xstream/converters/reflection/CGLIBEnhancedConverter.html">CGLIBEnhancedConverter</a></td>
  709. <td>Proxies generated by the CGLIB Enhancer</td>
  710. <td>The Converter handles proxies generated by the CGLIB Enhancer, if there were not multiple callbacks registered.
  711. A proxy with multiple callbacks can currently not be handled at all.</td>
  712. <td>Must be registered explicitly in combination with the CGLIBMapper. See <a href="faq.html#Serialization_CGLIB">FAQ</a>.</td>
  713. </tr>
  714. </table>
  715. <br/>
  716. </div>
  717. </div>
  718. <div class="SidePanel" id="left">
  719. <div class="MenuGroup">
  720. <h1>Software</h1>
  721. <ul>
  722. <li><a href="index.html">About XStream</a></li>
  723. <li><a href="news.html">News</a></li>
  724. <li><a href="changes.html">Change History</a></li>
  725. <li><a href="versioning.html">About Versioning</a></li>
  726. </ul>
  727. </div>
  728. <div class="MenuGroup">
  729. <h1>Evaluating XStream</h1>
  730. <ul>
  731. <li><a href="tutorial.html">Two Minute Tutorial</a></li>
  732. <li><a href="graphs.html">Object references</a></li>
  733. <li><a href="manual-tweaking-output.html">Tweaking the Output</a></li>
  734. <li><a href="license.html">License</a></li>
  735. <li><a href="download.html">Download</a></li>
  736. <li><a href="references.html">References</a></li>
  737. <li><a href="parser-benchmarks.html">Parser Benchmarks</a></li>
  738. <li><a href="http://www.ohloh.net/projects/3459">Code Statistics</a></li>
  739. </ul>
  740. </div>
  741. <div class="MenuGroup">
  742. <h1>Using XStream</h1>
  743. <ul>
  744. <li><a href="architecture.html">Architecture Overview</a></li>
  745. <li class="currentLink">Converters</li>
  746. <li><a href="faq.html">Frequently Asked Questions</a></li>
  747. <li><a href="list-user.html">Users' Mailing List</a></li>
  748. <li><a href="issues.html">Reporting Issues</a></li>
  749. </ul>
  750. </div>
  751. <div class="MenuGroup">
  752. <h1>Javadoc</h1>
  753. <ul>
  754. <li><a href="javadoc/index.html">XStream Core</a></li>
  755. <li><a href="hibernate-javadoc/index.html">Hibernate Extensions</a></li>
  756. <li><a href="benchmark-javadoc/index.html">Benchmark Module</a></li>
  757. </ul>
  758. </div>
  759. <div class="MenuGroup">
  760. <h1>Tutorials</h1>
  761. <ul>
  762. <li><a href="tutorial.html">Two Minute Tutorial</a></li>
  763. <li><a href="alias-tutorial.html">Alias Tutorial</a></li>
  764. <li><a href="annotations-tutorial.html">Annotations Tutorial</a></li>
  765. <li><a href="converter-tutorial.html">Converter Tutorial</a></li>
  766. <li><a href="objectstream.html">Object Streams Tutorial</a></li>
  767. <li><a href="persistence-tutorial.html">Persistence API Tutorial</a></li>
  768. <li><a href="json-tutorial.html">JSON Tutorial</a></li>
  769. </ul>
  770. </div>
  771. <div class="MenuGroup">
  772. <h1>Developing XStream</h1>
  773. <ul>
  774. <li><a href="how-to-contribute.html">How to Contribute</a></li>
  775. <li><a href="list-dev.html">Developers' Mailing List</a></li>
  776. <li><a href="team.html">Development Team</a></li>
  777. <li><a href="repository.html">Source Repository</a></li>
  778. <li><a href="http://bamboo.ci.codehaus.org/browse/XSTREAM">Continuous Integration</a></li>
  779. </ul>
  780. </div>
  781. </div>
  782. </body>
  783. </html>