TarArchiveOutputStream.html 52 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!-- NewPage -->
  3. <html lang="de">
  4. <head>
  5. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  6. <title>TarArchiveOutputStream (Apache Commons Compress 1.13 API)</title>
  7. <link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
  8. </head>
  9. <body>
  10. <script type="text/javascript"><!--
  11. try {
  12. if (location.href.indexOf('is-external=true') == -1) {
  13. parent.document.title="TarArchiveOutputStream (Apache Commons Compress 1.13 API)";
  14. }
  15. }
  16. catch(err) {
  17. }
  18. //-->
  19. </script>
  20. <noscript>
  21. <div>JavaScript is disabled on your browser.</div>
  22. </noscript>
  23. <!-- ========= START OF TOP NAVBAR ======= -->
  24. <div class="topNav"><a name="navbar_top">
  25. <!-- -->
  26. </a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
  27. <!-- -->
  28. </a>
  29. <ul class="navList" title="Navigation">
  30. <li><a href="../../../../../../overview-summary.html">Overview</a></li>
  31. <li><a href="package-summary.html">Package</a></li>
  32. <li class="navBarCell1Rev">Class</li>
  33. <li><a href="class-use/TarArchiveOutputStream.html">Use</a></li>
  34. <li><a href="package-tree.html">Tree</a></li>
  35. <li><a href="../../../../../../deprecated-list.html">Deprecated</a></li>
  36. <li><a href="../../../../../../index-all.html">Index</a></li>
  37. <li><a href="../../../../../../help-doc.html">Help</a></li>
  38. </ul>
  39. </div>
  40. <div class="subNav">
  41. <ul class="navList">
  42. <li><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveInputStream.html" title="class in org.apache.commons.compress.archivers.tar"><span class="strong">Prev Class</span></a></li>
  43. <li><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveSparseEntry.html" title="class in org.apache.commons.compress.archivers.tar"><span class="strong">Next Class</span></a></li>
  44. </ul>
  45. <ul class="navList">
  46. <li><a href="../../../../../../index.html?org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html" target="_top">Frames</a></li>
  47. <li><a href="TarArchiveOutputStream.html" target="_top">No Frames</a></li>
  48. </ul>
  49. <ul class="navList" id="allclasses_navbar_top">
  50. <li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li>
  51. </ul>
  52. <div>
  53. <script type="text/javascript"><!--
  54. allClassesLink = document.getElementById("allclasses_navbar_top");
  55. if(window==top) {
  56. allClassesLink.style.display = "block";
  57. }
  58. else {
  59. allClassesLink.style.display = "none";
  60. }
  61. //-->
  62. </script>
  63. </div>
  64. <div>
  65. <ul class="subNavList">
  66. <li>Summary:&nbsp;</li>
  67. <li>Nested&nbsp;|&nbsp;</li>
  68. <li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
  69. <li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
  70. <li><a href="#method_summary">Method</a></li>
  71. </ul>
  72. <ul class="subNavList">
  73. <li>Detail:&nbsp;</li>
  74. <li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
  75. <li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
  76. <li><a href="#method_detail">Method</a></li>
  77. </ul>
  78. </div>
  79. <a name="skip-navbar_top">
  80. <!-- -->
  81. </a></div>
  82. <!-- ========= END OF TOP NAVBAR ========= -->
  83. <!-- ======== START OF CLASS DATA ======== -->
  84. <div class="header">
  85. <div class="subTitle">org.apache.commons.compress.archivers.tar</div>
  86. <h2 title="Class TarArchiveOutputStream" class="title">Class TarArchiveOutputStream</h2>
  87. </div>
  88. <div class="contentContainer">
  89. <ul class="inheritance">
  90. <li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
  91. <li>
  92. <ul class="inheritance">
  93. <li><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">java.io.OutputStream</a></li>
  94. <li>
  95. <ul class="inheritance">
  96. <li><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">org.apache.commons.compress.archivers.ArchiveOutputStream</a></li>
  97. <li>
  98. <ul class="inheritance">
  99. <li>org.apache.commons.compress.archivers.tar.TarArchiveOutputStream</li>
  100. </ul>
  101. </li>
  102. </ul>
  103. </li>
  104. </ul>
  105. </li>
  106. </ul>
  107. <div class="description">
  108. <ul class="blockList">
  109. <li class="blockList">
  110. <dl>
  111. <dt>All Implemented Interfaces:</dt>
  112. <dd><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true" title="class or interface in java.io">Closeable</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Flushable.html?is-external=true" title="class or interface in java.io">Flushable</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/AutoCloseable.html?is-external=true" title="class or interface in java.lang">AutoCloseable</a></dd>
  113. </dl>
  114. <hr>
  115. <br>
  116. <pre>public class <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.43">TarArchiveOutputStream</a>
  117. extends <a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></pre>
  118. <div class="block">The TarOutputStream writes a UNIX tar archive as an OutputStream.
  119. Methods are provided to put entries, and then write their contents
  120. by writing to this stream using write().</div>
  121. <dl><dt><span class="strong">This class is not thread-safe</span></dt>
  122. <dd></dd></dl>
  123. </li>
  124. </ul>
  125. </div>
  126. <div class="summary">
  127. <ul class="blockList">
  128. <li class="blockList">
  129. <!-- =========== FIELD SUMMARY =========== -->
  130. <ul class="blockList">
  131. <li class="blockList"><a name="field_summary">
  132. <!-- -->
  133. </a>
  134. <h3>Field Summary</h3>
  135. <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
  136. <caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
  137. <tr>
  138. <th class="colFirst" scope="col">Modifier and Type</th>
  139. <th class="colLast" scope="col">Field and Description</th>
  140. </tr>
  141. <tr class="altColor">
  142. <td class="colFirst"><code>static int</code></td>
  143. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#BIGNUMBER_ERROR">BIGNUMBER_ERROR</a></strong></code>
  144. <div class="block">Fail if a big number (e.g. size &gt; 8GiB) is required in the archive.</div>
  145. </td>
  146. </tr>
  147. <tr class="rowColor">
  148. <td class="colFirst"><code>static int</code></td>
  149. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#BIGNUMBER_POSIX">BIGNUMBER_POSIX</a></strong></code>
  150. <div class="block">POSIX/PAX extensions are used to store big numbers in the archive.</div>
  151. </td>
  152. </tr>
  153. <tr class="altColor">
  154. <td class="colFirst"><code>static int</code></td>
  155. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#BIGNUMBER_STAR">BIGNUMBER_STAR</a></strong></code>
  156. <div class="block">star/GNU tar/BSD tar extensions are used to store big number in the archive.</div>
  157. </td>
  158. </tr>
  159. <tr class="rowColor">
  160. <td class="colFirst"><code>static int</code></td>
  161. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#LONGFILE_ERROR">LONGFILE_ERROR</a></strong></code>
  162. <div class="block">Fail if a long file name is required in the archive.</div>
  163. </td>
  164. </tr>
  165. <tr class="altColor">
  166. <td class="colFirst"><code>static int</code></td>
  167. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#LONGFILE_GNU">LONGFILE_GNU</a></strong></code>
  168. <div class="block">GNU tar extensions are used to store long file names in the archive.</div>
  169. </td>
  170. </tr>
  171. <tr class="rowColor">
  172. <td class="colFirst"><code>static int</code></td>
  173. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#LONGFILE_POSIX">LONGFILE_POSIX</a></strong></code>
  174. <div class="block">POSIX/PAX extensions are used to store long file names in the archive.</div>
  175. </td>
  176. </tr>
  177. <tr class="altColor">
  178. <td class="colFirst"><code>static int</code></td>
  179. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#LONGFILE_TRUNCATE">LONGFILE_TRUNCATE</a></strong></code>
  180. <div class="block">Long paths will be truncated in the archive.</div>
  181. </td>
  182. </tr>
  183. </table>
  184. </li>
  185. </ul>
  186. <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  187. <ul class="blockList">
  188. <li class="blockList"><a name="constructor_summary">
  189. <!-- -->
  190. </a>
  191. <h3>Constructor Summary</h3>
  192. <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
  193. <caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
  194. <tr>
  195. <th class="colOne" scope="col">Constructor and Description</th>
  196. </tr>
  197. <tr class="altColor">
  198. <td class="colOne"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#TarArchiveOutputStream(java.io.OutputStream)">TarArchiveOutputStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os)</code>
  199. <div class="block">Constructor for TarInputStream.</div>
  200. </td>
  201. </tr>
  202. <tr class="rowColor">
  203. <td class="colOne"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#TarArchiveOutputStream(java.io.OutputStream,%20int)">TarArchiveOutputStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  204. int&nbsp;blockSize)</code>
  205. <div class="block">Constructor for TarInputStream.</div>
  206. </td>
  207. </tr>
  208. <tr class="altColor">
  209. <td class="colOne"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#TarArchiveOutputStream(java.io.OutputStream,%20int,%20int)">TarArchiveOutputStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  210. int&nbsp;blockSize,
  211. int&nbsp;recordSize)</code>
  212. <div class="block">Constructor for TarInputStream.</div>
  213. </td>
  214. </tr>
  215. <tr class="rowColor">
  216. <td class="colOne"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#TarArchiveOutputStream(java.io.OutputStream,%20int,%20int,%20java.lang.String)">TarArchiveOutputStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  217. int&nbsp;blockSize,
  218. int&nbsp;recordSize,
  219. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;encoding)</code>
  220. <div class="block">Constructor for TarInputStream.</div>
  221. </td>
  222. </tr>
  223. <tr class="altColor">
  224. <td class="colOne"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#TarArchiveOutputStream(java.io.OutputStream,%20int,%20java.lang.String)">TarArchiveOutputStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  225. int&nbsp;blockSize,
  226. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;encoding)</code>
  227. <div class="block">Constructor for TarInputStream.</div>
  228. </td>
  229. </tr>
  230. <tr class="rowColor">
  231. <td class="colOne"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#TarArchiveOutputStream(java.io.OutputStream,%20java.lang.String)">TarArchiveOutputStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  232. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;encoding)</code>
  233. <div class="block">Constructor for TarInputStream.</div>
  234. </td>
  235. </tr>
  236. </table>
  237. </li>
  238. </ul>
  239. <!-- ========== METHOD SUMMARY =========== -->
  240. <ul class="blockList">
  241. <li class="blockList"><a name="method_summary">
  242. <!-- -->
  243. </a>
  244. <h3>Method Summary</h3>
  245. <table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
  246. <caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
  247. <tr>
  248. <th class="colFirst" scope="col">Modifier and Type</th>
  249. <th class="colLast" scope="col">Method and Description</th>
  250. </tr>
  251. <tr class="altColor">
  252. <td class="colFirst"><code>void</code></td>
  253. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#close()">close</a></strong>()</code>
  254. <div class="block">Closes the underlying OutputStream.</div>
  255. </td>
  256. </tr>
  257. <tr class="rowColor">
  258. <td class="colFirst"><code>void</code></td>
  259. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#closeArchiveEntry()">closeArchiveEntry</a></strong>()</code>
  260. <div class="block">Close an entry.</div>
  261. </td>
  262. </tr>
  263. <tr class="altColor">
  264. <td class="colFirst"><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveEntry.html" title="interface in org.apache.commons.compress.archivers">ArchiveEntry</a></code></td>
  265. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#createArchiveEntry(java.io.File,%20java.lang.String)">createArchiveEntry</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</a>&nbsp;inputFile,
  266. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;entryName)</code>
  267. <div class="block">Create an archive entry using the inputFile and entryName provided.</div>
  268. </td>
  269. </tr>
  270. <tr class="rowColor">
  271. <td class="colFirst"><code>void</code></td>
  272. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#finish()">finish</a></strong>()</code>
  273. <div class="block">Ends the TAR archive without closing the underlying OutputStream.</div>
  274. </td>
  275. </tr>
  276. <tr class="altColor">
  277. <td class="colFirst"><code>void</code></td>
  278. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#flush()">flush</a></strong>()</code>&nbsp;</td>
  279. </tr>
  280. <tr class="rowColor">
  281. <td class="colFirst"><code>long</code></td>
  282. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#getBytesWritten()">getBytesWritten</a></strong>()</code>
  283. <div class="block">Returns the current number of bytes written to this stream.</div>
  284. </td>
  285. </tr>
  286. <tr class="altColor">
  287. <td class="colFirst"><code>int</code></td>
  288. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#getCount()">getCount</a></strong>()</code>
  289. <div class="block"><strong>Deprecated.</strong>&nbsp;</div>
  290. </td>
  291. </tr>
  292. <tr class="rowColor">
  293. <td class="colFirst"><code>int</code></td>
  294. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#getRecordSize()">getRecordSize</a></strong>()</code>
  295. <div class="block">Get the record size being used by this stream's TarBuffer.</div>
  296. </td>
  297. </tr>
  298. <tr class="altColor">
  299. <td class="colFirst"><code>void</code></td>
  300. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#putArchiveEntry(org.apache.commons.compress.archivers.ArchiveEntry)">putArchiveEntry</a></strong>(<a href="../../../../../../org/apache/commons/compress/archivers/ArchiveEntry.html" title="interface in org.apache.commons.compress.archivers">ArchiveEntry</a>&nbsp;archiveEntry)</code>
  301. <div class="block">Put an entry on the output stream.</div>
  302. </td>
  303. </tr>
  304. <tr class="rowColor">
  305. <td class="colFirst"><code>void</code></td>
  306. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#setAddPaxHeadersForNonAsciiNames(boolean)">setAddPaxHeadersForNonAsciiNames</a></strong>(boolean&nbsp;b)</code>
  307. <div class="block">Whether to add a PAX extension header for non-ASCII file names.</div>
  308. </td>
  309. </tr>
  310. <tr class="altColor">
  311. <td class="colFirst"><code>void</code></td>
  312. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#setBigNumberMode(int)">setBigNumberMode</a></strong>(int&nbsp;bigNumberMode)</code>
  313. <div class="block">Set the big number mode.</div>
  314. </td>
  315. </tr>
  316. <tr class="rowColor">
  317. <td class="colFirst"><code>void</code></td>
  318. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#setLongFileMode(int)">setLongFileMode</a></strong>(int&nbsp;longFileMode)</code>
  319. <div class="block">Set the long file mode.</div>
  320. </td>
  321. </tr>
  322. <tr class="altColor">
  323. <td class="colFirst"><code>void</code></td>
  324. <td class="colLast"><code><strong><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#write(byte[],%20int,%20int)">write</a></strong>(byte[]&nbsp;wBuf,
  325. int&nbsp;wOffset,
  326. int&nbsp;numToWrite)</code>
  327. <div class="block">Writes bytes to the current tar archive entry.</div>
  328. </td>
  329. </tr>
  330. </table>
  331. <ul class="blockList">
  332. <li class="blockList"><a name="methods_inherited_from_class_org.apache.commons.compress.archivers.ArchiveOutputStream">
  333. <!-- -->
  334. </a>
  335. <h3>Methods inherited from class&nbsp;org.apache.commons.compress.archivers.<a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></h3>
  336. <code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#canWriteEntryData(org.apache.commons.compress.archivers.ArchiveEntry)">canWriteEntryData</a>, <a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#count(int)">count</a>, <a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#count(long)">count</a>, <a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#write(int)">write</a></code></li>
  337. </ul>
  338. <ul class="blockList">
  339. <li class="blockList"><a name="methods_inherited_from_class_java.io.OutputStream">
  340. <!-- -->
  341. </a>
  342. <h3>Methods inherited from class&nbsp;java.io.<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a></h3>
  343. <code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true#write(byte[])" title="class or interface in java.io">write</a></code></li>
  344. </ul>
  345. <ul class="blockList">
  346. <li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
  347. <!-- -->
  348. </a>
  349. <h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
  350. <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long,%20int)" title="class or interface in java.lang">wait</a></code></li>
  351. </ul>
  352. </li>
  353. </ul>
  354. </li>
  355. </ul>
  356. </div>
  357. <div class="details">
  358. <ul class="blockList">
  359. <li class="blockList">
  360. <!-- ============ FIELD DETAIL =========== -->
  361. <ul class="blockList">
  362. <li class="blockList"><a name="field_detail">
  363. <!-- -->
  364. </a>
  365. <h3>Field Detail</h3>
  366. <a name="LONGFILE_ERROR">
  367. <!-- -->
  368. </a>
  369. <ul class="blockList">
  370. <li class="blockList">
  371. <h4>LONGFILE_ERROR</h4>
  372. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.45">LONGFILE_ERROR</a></pre>
  373. <div class="block">Fail if a long file name is required in the archive.</div>
  374. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.LONGFILE_ERROR">Constant Field Values</a></dd></dl>
  375. </li>
  376. </ul>
  377. <a name="LONGFILE_TRUNCATE">
  378. <!-- -->
  379. </a>
  380. <ul class="blockList">
  381. <li class="blockList">
  382. <h4>LONGFILE_TRUNCATE</h4>
  383. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.48">LONGFILE_TRUNCATE</a></pre>
  384. <div class="block">Long paths will be truncated in the archive.</div>
  385. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.LONGFILE_TRUNCATE">Constant Field Values</a></dd></dl>
  386. </li>
  387. </ul>
  388. <a name="LONGFILE_GNU">
  389. <!-- -->
  390. </a>
  391. <ul class="blockList">
  392. <li class="blockList">
  393. <h4>LONGFILE_GNU</h4>
  394. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.51">LONGFILE_GNU</a></pre>
  395. <div class="block">GNU tar extensions are used to store long file names in the archive.</div>
  396. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.LONGFILE_GNU">Constant Field Values</a></dd></dl>
  397. </li>
  398. </ul>
  399. <a name="LONGFILE_POSIX">
  400. <!-- -->
  401. </a>
  402. <ul class="blockList">
  403. <li class="blockList">
  404. <h4>LONGFILE_POSIX</h4>
  405. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.54">LONGFILE_POSIX</a></pre>
  406. <div class="block">POSIX/PAX extensions are used to store long file names in the archive.</div>
  407. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.LONGFILE_POSIX">Constant Field Values</a></dd></dl>
  408. </li>
  409. </ul>
  410. <a name="BIGNUMBER_ERROR">
  411. <!-- -->
  412. </a>
  413. <ul class="blockList">
  414. <li class="blockList">
  415. <h4>BIGNUMBER_ERROR</h4>
  416. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.57">BIGNUMBER_ERROR</a></pre>
  417. <div class="block">Fail if a big number (e.g. size &gt; 8GiB) is required in the archive.</div>
  418. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.BIGNUMBER_ERROR">Constant Field Values</a></dd></dl>
  419. </li>
  420. </ul>
  421. <a name="BIGNUMBER_STAR">
  422. <!-- -->
  423. </a>
  424. <ul class="blockList">
  425. <li class="blockList">
  426. <h4>BIGNUMBER_STAR</h4>
  427. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.60">BIGNUMBER_STAR</a></pre>
  428. <div class="block">star/GNU tar/BSD tar extensions are used to store big number in the archive.</div>
  429. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.BIGNUMBER_STAR">Constant Field Values</a></dd></dl>
  430. </li>
  431. </ul>
  432. <a name="BIGNUMBER_POSIX">
  433. <!-- -->
  434. </a>
  435. <ul class="blockListLast">
  436. <li class="blockList">
  437. <h4>BIGNUMBER_POSIX</h4>
  438. <pre>public static final&nbsp;int <a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.63">BIGNUMBER_POSIX</a></pre>
  439. <div class="block">POSIX/PAX extensions are used to store big numbers in the archive.</div>
  440. <dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.commons.compress.archivers.tar.TarArchiveOutputStream.BIGNUMBER_POSIX">Constant Field Values</a></dd></dl>
  441. </li>
  442. </ul>
  443. </li>
  444. </ul>
  445. <!-- ========= CONSTRUCTOR DETAIL ======== -->
  446. <ul class="blockList">
  447. <li class="blockList"><a name="constructor_detail">
  448. <!-- -->
  449. </a>
  450. <h3>Constructor Detail</h3>
  451. <a name="TarArchiveOutputStream(java.io.OutputStream)">
  452. <!-- -->
  453. </a>
  454. <ul class="blockList">
  455. <li class="blockList">
  456. <h4>TarArchiveOutputStream</h4>
  457. <pre>public&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.100">TarArchiveOutputStream</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os)</pre>
  458. <div class="block">Constructor for TarInputStream.</div>
  459. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>os</code> - the output stream to use</dd></dl>
  460. </li>
  461. </ul>
  462. <a name="TarArchiveOutputStream(java.io.OutputStream, java.lang.String)">
  463. <!-- -->
  464. </a>
  465. <ul class="blockList">
  466. <li class="blockList">
  467. <h4>TarArchiveOutputStream</h4>
  468. <pre>public&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.110">TarArchiveOutputStream</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  469. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;encoding)</pre>
  470. <div class="block">Constructor for TarInputStream.</div>
  471. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>os</code> - the output stream to use</dd><dd><code>encoding</code> - name of the encoding to use for file names</dd><dt><span class="strong">Since:</span></dt>
  472. <dd>1.4</dd></dl>
  473. </li>
  474. </ul>
  475. <a name="TarArchiveOutputStream(java.io.OutputStream, int)">
  476. <!-- -->
  477. </a>
  478. <ul class="blockList">
  479. <li class="blockList">
  480. <h4>TarArchiveOutputStream</h4>
  481. <pre>public&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.119">TarArchiveOutputStream</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  482. int&nbsp;blockSize)</pre>
  483. <div class="block">Constructor for TarInputStream.</div>
  484. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>os</code> - the output stream to use</dd><dd><code>blockSize</code> - the block size to use</dd></dl>
  485. </li>
  486. </ul>
  487. <a name="TarArchiveOutputStream(java.io.OutputStream, int, java.lang.String)">
  488. <!-- -->
  489. </a>
  490. <ul class="blockList">
  491. <li class="blockList">
  492. <h4>TarArchiveOutputStream</h4>
  493. <pre>public&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.130">TarArchiveOutputStream</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  494. int&nbsp;blockSize,
  495. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;encoding)</pre>
  496. <div class="block">Constructor for TarInputStream.</div>
  497. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>os</code> - the output stream to use</dd><dd><code>blockSize</code> - the block size to use</dd><dd><code>encoding</code> - name of the encoding to use for file names</dd><dt><span class="strong">Since:</span></dt>
  498. <dd>1.4</dd></dl>
  499. </li>
  500. </ul>
  501. <a name="TarArchiveOutputStream(java.io.OutputStream, int, int)">
  502. <!-- -->
  503. </a>
  504. <ul class="blockList">
  505. <li class="blockList">
  506. <h4>TarArchiveOutputStream</h4>
  507. <pre>public&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.141">TarArchiveOutputStream</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  508. int&nbsp;blockSize,
  509. int&nbsp;recordSize)</pre>
  510. <div class="block">Constructor for TarInputStream.</div>
  511. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>os</code> - the output stream to use</dd><dd><code>blockSize</code> - the block size to use</dd><dd><code>recordSize</code> - the record size to use</dd></dl>
  512. </li>
  513. </ul>
  514. <a name="TarArchiveOutputStream(java.io.OutputStream, int, int, java.lang.String)">
  515. <!-- -->
  516. </a>
  517. <ul class="blockListLast">
  518. <li class="blockList">
  519. <h4>TarArchiveOutputStream</h4>
  520. <pre>public&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.153">TarArchiveOutputStream</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a>&nbsp;os,
  521. int&nbsp;blockSize,
  522. int&nbsp;recordSize,
  523. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;encoding)</pre>
  524. <div class="block">Constructor for TarInputStream.</div>
  525. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>os</code> - the output stream to use</dd><dd><code>blockSize</code> - the block size to use</dd><dd><code>recordSize</code> - the record size to use</dd><dd><code>encoding</code> - name of the encoding to use for file names</dd><dt><span class="strong">Since:</span></dt>
  526. <dd>1.4</dd></dl>
  527. </li>
  528. </ul>
  529. </li>
  530. </ul>
  531. <!-- ============ METHOD DETAIL ========== -->
  532. <ul class="blockList">
  533. <li class="blockList"><a name="method_detail">
  534. <!-- -->
  535. </a>
  536. <h3>Method Detail</h3>
  537. <a name="setLongFileMode(int)">
  538. <!-- -->
  539. </a>
  540. <ul class="blockList">
  541. <li class="blockList">
  542. <h4>setLongFileMode</h4>
  543. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.173">setLongFileMode</a>(int&nbsp;longFileMode)</pre>
  544. <div class="block">Set the long file mode.
  545. This can be LONGFILE_ERROR(0), LONGFILE_TRUNCATE(1) or LONGFILE_GNU(2).
  546. This specifies the treatment of long file names (names &gt;= TarConstants.NAMELEN).
  547. Default is LONGFILE_ERROR.</div>
  548. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>longFileMode</code> - the mode to use</dd></dl>
  549. </li>
  550. </ul>
  551. <a name="setBigNumberMode(int)">
  552. <!-- -->
  553. </a>
  554. <ul class="blockList">
  555. <li class="blockList">
  556. <h4>setBigNumberMode</h4>
  557. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.185">setBigNumberMode</a>(int&nbsp;bigNumberMode)</pre>
  558. <div class="block">Set the big number mode.
  559. This can be BIGNUMBER_ERROR(0), BIGNUMBER_POSIX(1) or BIGNUMBER_STAR(2).
  560. This specifies the treatment of big files (sizes &gt; TarConstants.MAXSIZE) and other numeric values to big to fit into a traditional tar header.
  561. Default is BIGNUMBER_ERROR.</div>
  562. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigNumberMode</code> - the mode to use</dd><dt><span class="strong">Since:</span></dt>
  563. <dd>1.4</dd></dl>
  564. </li>
  565. </ul>
  566. <a name="setAddPaxHeadersForNonAsciiNames(boolean)">
  567. <!-- -->
  568. </a>
  569. <ul class="blockList">
  570. <li class="blockList">
  571. <h4>setAddPaxHeadersForNonAsciiNames</h4>
  572. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.194">setAddPaxHeadersForNonAsciiNames</a>(boolean&nbsp;b)</pre>
  573. <div class="block">Whether to add a PAX extension header for non-ASCII file names.</div>
  574. <dl><dt><span class="strong">Parameters:</span></dt><dd><code>b</code> - whether to add a PAX extension header for non-ASCII file names.</dd><dt><span class="strong">Since:</span></dt>
  575. <dd>1.4</dd></dl>
  576. </li>
  577. </ul>
  578. <a name="getCount()">
  579. <!-- -->
  580. </a>
  581. <ul class="blockList">
  582. <li class="blockList">
  583. <h4>getCount</h4>
  584. <pre><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Deprecated.html?is-external=true" title="class or interface in java.lang">@Deprecated</a>
  585. public&nbsp;int&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.200">getCount</a>()</pre>
  586. <div class="block"><span class="strong">Deprecated.</span>&nbsp;</div>
  587. <div class="block"><strong>Description copied from class:&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#getCount()">ArchiveOutputStream</a></code></strong></div>
  588. <div class="block">Returns the current number of bytes written to this stream.</div>
  589. <dl>
  590. <dt><strong>Overrides:</strong></dt>
  591. <dd><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#getCount()">getCount</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></code></dd>
  592. <dt><span class="strong">Returns:</span></dt><dd>the number of written bytes</dd></dl>
  593. </li>
  594. </ul>
  595. <a name="getBytesWritten()">
  596. <!-- -->
  597. </a>
  598. <ul class="blockList">
  599. <li class="blockList">
  600. <h4>getBytesWritten</h4>
  601. <pre>public&nbsp;long&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.205">getBytesWritten</a>()</pre>
  602. <div class="block"><strong>Description copied from class:&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#getBytesWritten()">ArchiveOutputStream</a></code></strong></div>
  603. <div class="block">Returns the current number of bytes written to this stream.</div>
  604. <dl>
  605. <dt><strong>Overrides:</strong></dt>
  606. <dd><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#getBytesWritten()">getBytesWritten</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></code></dd>
  607. <dt><span class="strong">Returns:</span></dt><dd>the number of written bytes</dd></dl>
  608. </li>
  609. </ul>
  610. <a name="finish()">
  611. <!-- -->
  612. </a>
  613. <ul class="blockList">
  614. <li class="blockList">
  615. <h4>finish</h4>
  616. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.219">finish</a>()
  617. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  618. <div class="block">Ends the TAR archive without closing the underlying OutputStream.
  619. An archive consists of a series of file entries terminated by an
  620. end-of-archive entry, which consists of two 512 blocks of zero bytes.
  621. POSIX.1 requires two EOF records, like some other implementations.</div>
  622. <dl>
  623. <dt><strong>Specified by:</strong></dt>
  624. <dd><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#finish()">finish</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></code></dd>
  625. <dt><span class="strong">Throws:</span></dt>
  626. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - on error</dd></dl>
  627. </li>
  628. </ul>
  629. <a name="close()">
  630. <!-- -->
  631. </a>
  632. <ul class="blockList">
  633. <li class="blockList">
  634. <h4>close</h4>
  635. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.239">close</a>()
  636. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  637. <div class="block">Closes the underlying OutputStream.</div>
  638. <dl>
  639. <dt><strong>Specified by:</strong></dt>
  640. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true#close()" title="class or interface in java.io">close</a></code>&nbsp;in interface&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true" title="class or interface in java.io">Closeable</a></code></dd>
  641. <dt><strong>Specified by:</strong></dt>
  642. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/AutoCloseable.html?is-external=true#close()" title="class or interface in java.lang">close</a></code>&nbsp;in interface&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/AutoCloseable.html?is-external=true" title="class or interface in java.lang">AutoCloseable</a></code></dd>
  643. <dt><strong>Overrides:</strong></dt>
  644. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true#close()" title="class or interface in java.io">close</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a></code></dd>
  645. <dt><span class="strong">Throws:</span></dt>
  646. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - on error</dd></dl>
  647. </li>
  648. </ul>
  649. <a name="getRecordSize()">
  650. <!-- -->
  651. </a>
  652. <ul class="blockList">
  653. <li class="blockList">
  654. <h4>getRecordSize</h4>
  655. <pre>public&nbsp;int&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.255">getRecordSize</a>()</pre>
  656. <div class="block">Get the record size being used by this stream's TarBuffer.</div>
  657. <dl><dt><span class="strong">Returns:</span></dt><dd>The TarBuffer record size.</dd></dl>
  658. </li>
  659. </ul>
  660. <a name="putArchiveEntry(org.apache.commons.compress.archivers.ArchiveEntry)">
  661. <!-- -->
  662. </a>
  663. <ul class="blockList">
  664. <li class="blockList">
  665. <h4>putArchiveEntry</h4>
  666. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.273">putArchiveEntry</a>(<a href="../../../../../../org/apache/commons/compress/archivers/ArchiveEntry.html" title="interface in org.apache.commons.compress.archivers">ArchiveEntry</a>&nbsp;archiveEntry)
  667. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  668. <div class="block">Put an entry on the output stream. This writes the entry's
  669. header record and positions the output stream for writing
  670. the contents of the entry. Once this method is called, the
  671. stream is ready for calls to write() to write the entry's
  672. contents. Once the contents are written, closeArchiveEntry()
  673. <B>MUST</B> be called to ensure that all buffered data
  674. is completely written to the output stream.</div>
  675. <dl>
  676. <dt><strong>Specified by:</strong></dt>
  677. <dd><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#putArchiveEntry(org.apache.commons.compress.archivers.ArchiveEntry)">putArchiveEntry</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></code></dd>
  678. <dt><span class="strong">Parameters:</span></dt><dd><code>archiveEntry</code> - The TarEntry to be written to the archive.</dd>
  679. <dt><span class="strong">Throws:</span></dt>
  680. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - on error</dd>
  681. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ClassCastException.html?is-external=true" title="class or interface in java.lang">ClassCastException</a></code> - if archiveEntry is not an instance of TarArchiveEntry</dd></dl>
  682. </li>
  683. </ul>
  684. <a name="closeArchiveEntry()">
  685. <!-- -->
  686. </a>
  687. <ul class="blockList">
  688. <li class="blockList">
  689. <h4>closeArchiveEntry</h4>
  690. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.335">closeArchiveEntry</a>()
  691. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  692. <div class="block">Close an entry. This method MUST be called for all file
  693. entries that contain data. The reason is that we must
  694. buffer data written to the stream in order to satisfy
  695. the buffer's record based writes. Thus, there may be
  696. data fragments still being assembled that must be written
  697. to the output stream before this entry is closed and the
  698. next entry written.</div>
  699. <dl>
  700. <dt><strong>Specified by:</strong></dt>
  701. <dd><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#closeArchiveEntry()">closeArchiveEntry</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></code></dd>
  702. <dt><span class="strong">Throws:</span></dt>
  703. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - on error</dd></dl>
  704. </li>
  705. </ul>
  706. <a name="write(byte[], int, int)">
  707. <!-- -->
  708. </a>
  709. <ul class="blockList">
  710. <li class="blockList">
  711. <h4>write</h4>
  712. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.377">write</a>(byte[]&nbsp;wBuf,
  713. int&nbsp;wOffset,
  714. int&nbsp;numToWrite)
  715. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  716. <div class="block">Writes bytes to the current tar archive entry. This method
  717. is aware of the current entry and will throw an exception if
  718. you attempt to write bytes past the length specified for the
  719. current entry. The method is also (painfully) aware of the
  720. record buffering required by TarBuffer, and manages buffers
  721. that are not a multiple of recordsize in length, including
  722. assembling records from small buffers.</div>
  723. <dl>
  724. <dt><strong>Overrides:</strong></dt>
  725. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true#write(byte[],%20int,%20int)" title="class or interface in java.io">write</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a></code></dd>
  726. <dt><span class="strong">Parameters:</span></dt><dd><code>wBuf</code> - The buffer to write to the archive.</dd><dd><code>wOffset</code> - The offset in the buffer from which to get bytes.</dd><dd><code>numToWrite</code> - The number of bytes to write.</dd>
  727. <dt><span class="strong">Throws:</span></dt>
  728. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - on error</dd></dl>
  729. </li>
  730. </ul>
  731. <a name="flush()">
  732. <!-- -->
  733. </a>
  734. <ul class="blockList">
  735. <li class="blockList">
  736. <h4>flush</h4>
  737. <pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.522">flush</a>()
  738. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  739. <dl>
  740. <dt><strong>Specified by:</strong></dt>
  741. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Flushable.html?is-external=true#flush()" title="class or interface in java.io">flush</a></code>&nbsp;in interface&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/Flushable.html?is-external=true" title="class or interface in java.io">Flushable</a></code></dd>
  742. <dt><strong>Overrides:</strong></dt>
  743. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true#flush()" title="class or interface in java.io">flush</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</a></code></dd>
  744. <dt><span class="strong">Throws:</span></dt>
  745. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code></dd></dl>
  746. </li>
  747. </ul>
  748. <a name="createArchiveEntry(java.io.File, java.lang.String)">
  749. <!-- -->
  750. </a>
  751. <ul class="blockListLast">
  752. <li class="blockList">
  753. <h4>createArchiveEntry</h4>
  754. <pre>public&nbsp;<a href="../../../../../../org/apache/commons/compress/archivers/ArchiveEntry.html" title="interface in org.apache.commons.compress.archivers">ArchiveEntry</a>&nbsp;<a href="../../../../../../src-html/org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html#line.527">createArchiveEntry</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</a>&nbsp;inputFile,
  755. <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;entryName)
  756. throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
  757. <div class="block"><strong>Description copied from class:&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#createArchiveEntry(java.io.File,%20java.lang.String)">ArchiveOutputStream</a></code></strong></div>
  758. <div class="block">Create an archive entry using the inputFile and entryName provided.</div>
  759. <dl>
  760. <dt><strong>Specified by:</strong></dt>
  761. <dd><code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html#createArchiveEntry(java.io.File,%20java.lang.String)">createArchiveEntry</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/commons/compress/archivers/ArchiveOutputStream.html" title="class in org.apache.commons.compress.archivers">ArchiveOutputStream</a></code></dd>
  762. <dt><span class="strong">Parameters:</span></dt><dd><code>inputFile</code> - the file to create the entry from</dd><dd><code>entryName</code> - name to use for the entry</dd>
  763. <dt><span class="strong">Returns:</span></dt><dd>the ArchiveEntry set up with details from the file</dd>
  764. <dt><span class="strong">Throws:</span></dt>
  765. <dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - if an I/O error occurs</dd></dl>
  766. </li>
  767. </ul>
  768. </li>
  769. </ul>
  770. </li>
  771. </ul>
  772. </div>
  773. </div>
  774. <!-- ========= END OF CLASS DATA ========= -->
  775. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  776. <div class="bottomNav"><a name="navbar_bottom">
  777. <!-- -->
  778. </a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
  779. <!-- -->
  780. </a>
  781. <ul class="navList" title="Navigation">
  782. <li><a href="../../../../../../overview-summary.html">Overview</a></li>
  783. <li><a href="package-summary.html">Package</a></li>
  784. <li class="navBarCell1Rev">Class</li>
  785. <li><a href="class-use/TarArchiveOutputStream.html">Use</a></li>
  786. <li><a href="package-tree.html">Tree</a></li>
  787. <li><a href="../../../../../../deprecated-list.html">Deprecated</a></li>
  788. <li><a href="../../../../../../index-all.html">Index</a></li>
  789. <li><a href="../../../../../../help-doc.html">Help</a></li>
  790. </ul>
  791. </div>
  792. <div class="subNav">
  793. <ul class="navList">
  794. <li><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveInputStream.html" title="class in org.apache.commons.compress.archivers.tar"><span class="strong">Prev Class</span></a></li>
  795. <li><a href="../../../../../../org/apache/commons/compress/archivers/tar/TarArchiveSparseEntry.html" title="class in org.apache.commons.compress.archivers.tar"><span class="strong">Next Class</span></a></li>
  796. </ul>
  797. <ul class="navList">
  798. <li><a href="../../../../../../index.html?org/apache/commons/compress/archivers/tar/TarArchiveOutputStream.html" target="_top">Frames</a></li>
  799. <li><a href="TarArchiveOutputStream.html" target="_top">No Frames</a></li>
  800. </ul>
  801. <ul class="navList" id="allclasses_navbar_bottom">
  802. <li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li>
  803. </ul>
  804. <div>
  805. <script type="text/javascript"><!--
  806. allClassesLink = document.getElementById("allclasses_navbar_bottom");
  807. if(window==top) {
  808. allClassesLink.style.display = "block";
  809. }
  810. else {
  811. allClassesLink.style.display = "none";
  812. }
  813. //-->
  814. </script>
  815. </div>
  816. <div>
  817. <ul class="subNavList">
  818. <li>Summary:&nbsp;</li>
  819. <li>Nested&nbsp;|&nbsp;</li>
  820. <li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
  821. <li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
  822. <li><a href="#method_summary">Method</a></li>
  823. </ul>
  824. <ul class="subNavList">
  825. <li>Detail:&nbsp;</li>
  826. <li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
  827. <li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
  828. <li><a href="#method_detail">Method</a></li>
  829. </ul>
  830. </div>
  831. <a name="skip-navbar_bottom">
  832. <!-- -->
  833. </a></div>
  834. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  835. <p class="legalCopy"><small>Copyright &#169; 2016 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
  836. </body>
  837. </html>