You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by bo...@apache.org on 2013/03/14 18:11:35 UTC
svn commit: r854484 [40/43] - in
/websites/production/commons/content/proper/commons-compress: ./ apidocs/
apidocs/org/apache/commons/compress/archivers/
apidocs/org/apache/commons/compress/archivers/ar/
apidocs/org/apache/commons/compress/archivers/ar...
Modified: websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/ZipUtil.html
==============================================================================
--- websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/ZipUtil.html (original)
+++ websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/ZipUtil.html Thu Mar 14 17:10:39 2013
@@ -102,238 +102,241 @@
<a class="jxr_linenumber" name="92" href="#92">92</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="93" href="#93">93</a> <em class="jxr_javadoccomment"> * @return the reversed array (mutated in-place, but also returned for</em>
<a class="jxr_linenumber" name="94" href="#94">94</a> <em class="jxr_javadoccomment"> * convenience).</em>
-<a class="jxr_linenumber" name="95" href="#95">95</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="96" href="#96">96</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] reverse(<strong class="jxr_keyword">final</strong> byte[] array) {
-<a class="jxr_linenumber" name="97" href="#97">97</a> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> z = array.length - 1; <em class="jxr_comment">// position of last element</em>
-<a class="jxr_linenumber" name="98" href="#98">98</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0; i < array.length / 2; i++) {
-<a class="jxr_linenumber" name="99" href="#99">99</a> byte x = array[i];
-<a class="jxr_linenumber" name="100" href="#100">100</a> array[i] = array[z - i];
-<a class="jxr_linenumber" name="101" href="#101">101</a> array[z - i] = x;
-<a class="jxr_linenumber" name="102" href="#102">102</a> }
-<a class="jxr_linenumber" name="103" href="#103">103</a> <strong class="jxr_keyword">return</strong> array;
-<a class="jxr_linenumber" name="104" href="#104">104</a> }
-<a class="jxr_linenumber" name="105" href="#105">105</a>
-<a class="jxr_linenumber" name="106" href="#106">106</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="107" href="#107">107</a> <em class="jxr_javadoccomment"> * Converts a BigInteger into a long, and blows up</em>
-<a class="jxr_linenumber" name="108" href="#108">108</a> <em class="jxr_javadoccomment"> * (NumberFormatException) if the BigInteger is too big.</em>
-<a class="jxr_linenumber" name="109" href="#109">109</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="110" href="#110">110</a> <em class="jxr_javadoccomment"> * @param big BigInteger to convert.</em>
-<a class="jxr_linenumber" name="111" href="#111">111</a> <em class="jxr_javadoccomment"> * @return long representation of the BigInteger.</em>
-<a class="jxr_linenumber" name="112" href="#112">112</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="113" href="#113">113</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> bigToLong(BigInteger big) {
-<a class="jxr_linenumber" name="114" href="#114">114</a> <strong class="jxr_keyword">if</strong> (big.bitLength() <= 63) { <em class="jxr_comment">// bitLength() doesn't count the sign bit.</em>
-<a class="jxr_linenumber" name="115" href="#115">115</a> <strong class="jxr_keyword">return</strong> big.longValue();
-<a class="jxr_linenumber" name="116" href="#116">116</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="117" href="#117">117</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"The BigInteger cannot fit inside a 64 bit java long: ["</span> + big + <span class="jxr_string">"]"</span>);
-<a class="jxr_linenumber" name="118" href="#118">118</a> }
-<a class="jxr_linenumber" name="119" href="#119">119</a> }
-<a class="jxr_linenumber" name="120" href="#120">120</a>
-<a class="jxr_linenumber" name="121" href="#121">121</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="122" href="#122">122</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="123" href="#123">123</a> <em class="jxr_javadoccomment"> * Converts a long into a BigInteger. Negative numbers between -1 and</em>
-<a class="jxr_linenumber" name="124" href="#124">124</a> <em class="jxr_javadoccomment"> * -2^31 are treated as unsigned 32 bit (e.g., positive) integers.</em>
-<a class="jxr_linenumber" name="125" href="#125">125</a> <em class="jxr_javadoccomment"> * Negative numbers below -2^31 cause an IllegalArgumentException</em>
-<a class="jxr_linenumber" name="126" href="#126">126</a> <em class="jxr_javadoccomment"> * to be thrown.</em>
-<a class="jxr_linenumber" name="127" href="#127">127</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="128" href="#128">128</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="129" href="#129">129</a> <em class="jxr_javadoccomment"> * @param l long to convert to BigInteger.</em>
-<a class="jxr_linenumber" name="130" href="#130">130</a> <em class="jxr_javadoccomment"> * @return BigInteger representation of the provided long.</em>
-<a class="jxr_linenumber" name="131" href="#131">131</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="132" href="#132">132</a> <strong class="jxr_keyword">static</strong> BigInteger longToBig(<strong class="jxr_keyword">long</strong> l) {
-<a class="jxr_linenumber" name="133" href="#133">133</a> <strong class="jxr_keyword">if</strong> (l < Integer.MIN_VALUE) {
-<a class="jxr_linenumber" name="134" href="#134">134</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"Negative longs < -2^31 not permitted: ["</span> + l + <span class="jxr_string">"]"</span>);
-<a class="jxr_linenumber" name="135" href="#135">135</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (l < 0 && l >= Integer.MIN_VALUE) {
-<a class="jxr_linenumber" name="136" href="#136">136</a> <em class="jxr_comment">// If someone passes in a -2, they probably mean 4294967294</em>
-<a class="jxr_linenumber" name="137" href="#137">137</a> <em class="jxr_comment">// (For example, Unix UID/GID's are 32 bit unsigned.)</em>
-<a class="jxr_linenumber" name="138" href="#138">138</a> l = ZipUtil.adjustToLong((<strong class="jxr_keyword">int</strong>) l);
-<a class="jxr_linenumber" name="139" href="#139">139</a> }
-<a class="jxr_linenumber" name="140" href="#140">140</a> <strong class="jxr_keyword">return</strong> BigInteger.valueOf(l);
-<a class="jxr_linenumber" name="141" href="#141">141</a> }
-<a class="jxr_linenumber" name="142" href="#142">142</a>
-<a class="jxr_linenumber" name="143" href="#143">143</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="144" href="#144">144</a> <em class="jxr_javadoccomment"> * Converts a signed byte into an unsigned integer representation</em>
-<a class="jxr_linenumber" name="145" href="#145">145</a> <em class="jxr_javadoccomment"> * (e.g., -1 becomes 255).</em>
-<a class="jxr_linenumber" name="146" href="#146">146</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="147" href="#147">147</a> <em class="jxr_javadoccomment"> * @param b byte to convert to int</em>
-<a class="jxr_linenumber" name="148" href="#148">148</a> <em class="jxr_javadoccomment"> * @return int representation of the provided byte</em>
-<a class="jxr_linenumber" name="149" href="#149">149</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="150" href="#150">150</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> signedByteToUnsignedInt(byte b) {
-<a class="jxr_linenumber" name="151" href="#151">151</a> <strong class="jxr_keyword">if</strong> (b >= 0) {
-<a class="jxr_linenumber" name="152" href="#152">152</a> <strong class="jxr_keyword">return</strong> b;
-<a class="jxr_linenumber" name="153" href="#153">153</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="154" href="#154">154</a> <strong class="jxr_keyword">return</strong> 256 + b;
-<a class="jxr_linenumber" name="155" href="#155">155</a> }
-<a class="jxr_linenumber" name="156" href="#156">156</a> }
-<a class="jxr_linenumber" name="157" href="#157">157</a>
-<a class="jxr_linenumber" name="158" href="#158">158</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="159" href="#159">159</a> <em class="jxr_javadoccomment"> * Converts an unsigned integer to a signed byte (e.g., 255 becomes -1).</em>
-<a class="jxr_linenumber" name="160" href="#160">160</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="161" href="#161">161</a> <em class="jxr_javadoccomment"> * @param i integer to convert to byte</em>
-<a class="jxr_linenumber" name="162" href="#162">162</a> <em class="jxr_javadoccomment"> * @return byte representation of the provided int</em>
-<a class="jxr_linenumber" name="163" href="#163">163</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException if the provided integer is not inside the range [0,255].</em>
-<a class="jxr_linenumber" name="164" href="#164">164</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="165" href="#165">165</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte unsignedIntToSignedByte(<strong class="jxr_keyword">int</strong> i) {
-<a class="jxr_linenumber" name="166" href="#166">166</a> <strong class="jxr_keyword">if</strong> (i > 255 || i < 0) {
-<a class="jxr_linenumber" name="167" href="#167">167</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"Can only convert non-negative integers between [0,255] to byte: ["</span> + i + <span class="jxr_string">"]"</span>);
-<a class="jxr_linenumber" name="168" href="#168">168</a> }
-<a class="jxr_linenumber" name="169" href="#169">169</a> <strong class="jxr_keyword">if</strong> (i < 128) {
-<a class="jxr_linenumber" name="170" href="#170">170</a> <strong class="jxr_keyword">return</strong> (byte) i;
-<a class="jxr_linenumber" name="171" href="#171">171</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="172" href="#172">172</a> <strong class="jxr_keyword">return</strong> (byte) (i - 256);
-<a class="jxr_linenumber" name="173" href="#173">173</a> }
-<a class="jxr_linenumber" name="174" href="#174">174</a> }
-<a class="jxr_linenumber" name="175" href="#175">175</a>
-<a class="jxr_linenumber" name="176" href="#176">176</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="177" href="#177">177</a> <em class="jxr_javadoccomment"> * Convert a DOS date/time field to a Date object.</em>
-<a class="jxr_linenumber" name="178" href="#178">178</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="179" href="#179">179</a> <em class="jxr_javadoccomment"> * @param zipDosTime contains the stored DOS time.</em>
-<a class="jxr_linenumber" name="180" href="#180">180</a> <em class="jxr_javadoccomment"> * @return a Date instance corresponding to the given time.</em>
-<a class="jxr_linenumber" name="181" href="#181">181</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="182" href="#182">182</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Date fromDosTime(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipLong.html">ZipLong</a> zipDosTime) {
-<a class="jxr_linenumber" name="183" href="#183">183</a> <strong class="jxr_keyword">long</strong> dosTime = zipDosTime.getValue();
-<a class="jxr_linenumber" name="184" href="#184">184</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> Date(dosToJavaTime(dosTime));
-<a class="jxr_linenumber" name="185" href="#185">185</a> }
-<a class="jxr_linenumber" name="186" href="#186">186</a>
-<a class="jxr_linenumber" name="187" href="#187">187</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="188" href="#188">188</a> <em class="jxr_javadoccomment"> * Converts DOS time to Java time (number of milliseconds since</em>
-<a class="jxr_linenumber" name="189" href="#189">189</a> <em class="jxr_javadoccomment"> * epoch).</em>
-<a class="jxr_linenumber" name="190" href="#190">190</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="191" href="#191">191</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> dosToJavaTime(<strong class="jxr_keyword">long</strong> dosTime) {
-<a class="jxr_linenumber" name="192" href="#192">192</a> Calendar cal = Calendar.getInstance();
-<a class="jxr_linenumber" name="193" href="#193">193</a> <em class="jxr_comment">// CheckStyle:MagicNumberCheck OFF - no point</em>
-<a class="jxr_linenumber" name="194" href="#194">194</a> cal.set(Calendar.YEAR, (<strong class="jxr_keyword">int</strong>) ((dosTime >> 25) & 0x7f) + 1980);
-<a class="jxr_linenumber" name="195" href="#195">195</a> cal.set(Calendar.MONTH, (<strong class="jxr_keyword">int</strong>) ((dosTime >> 21) & 0x0f) - 1);
-<a class="jxr_linenumber" name="196" href="#196">196</a> cal.set(Calendar.DATE, (<strong class="jxr_keyword">int</strong>) (dosTime >> 16) & 0x1f);
-<a class="jxr_linenumber" name="197" href="#197">197</a> cal.set(Calendar.HOUR_OF_DAY, (<strong class="jxr_keyword">int</strong>) (dosTime >> 11) & 0x1f);
-<a class="jxr_linenumber" name="198" href="#198">198</a> cal.set(Calendar.MINUTE, (<strong class="jxr_keyword">int</strong>) (dosTime >> 5) & 0x3f);
-<a class="jxr_linenumber" name="199" href="#199">199</a> cal.set(Calendar.SECOND, (<strong class="jxr_keyword">int</strong>) (dosTime << 1) & 0x3e);
-<a class="jxr_linenumber" name="200" href="#200">200</a> <em class="jxr_comment">// CheckStyle:MagicNumberCheck ON</em>
-<a class="jxr_linenumber" name="201" href="#201">201</a> <strong class="jxr_keyword">return</strong> cal.getTime().getTime();
-<a class="jxr_linenumber" name="202" href="#202">202</a> }
-<a class="jxr_linenumber" name="203" href="#203">203</a>
-<a class="jxr_linenumber" name="204" href="#204">204</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="205" href="#205">205</a> <em class="jxr_javadoccomment"> * If the entry has Unicode*ExtraFields and the CRCs of the</em>
-<a class="jxr_linenumber" name="206" href="#206">206</a> <em class="jxr_javadoccomment"> * names/comments match those of the extra fields, transfer the</em>
-<a class="jxr_linenumber" name="207" href="#207">207</a> <em class="jxr_javadoccomment"> * known Unicode values from the extra field.</em>
-<a class="jxr_linenumber" name="208" href="#208">208</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="209" href="#209">209</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> setNameAndCommentFromExtraFields(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> ze,
-<a class="jxr_linenumber" name="210" href="#210">210</a> byte[] originalNameBytes,
-<a class="jxr_linenumber" name="211" href="#211">211</a> byte[] commentBytes) {
-<a class="jxr_linenumber" name="212" href="#212">212</a> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnicodePathExtraField.html">UnicodePathExtraField</a> name = (UnicodePathExtraField)
-<a class="jxr_linenumber" name="213" href="#213">213</a> ze.getExtraField(UnicodePathExtraField.UPATH_ID);
-<a class="jxr_linenumber" name="214" href="#214">214</a> String originalName = ze.getName();
-<a class="jxr_linenumber" name="215" href="#215">215</a> String newName = getUnicodeStringIfOriginalMatches(name,
-<a class="jxr_linenumber" name="216" href="#216">216</a> originalNameBytes);
-<a class="jxr_linenumber" name="217" href="#217">217</a> <strong class="jxr_keyword">if</strong> (newName != <strong class="jxr_keyword">null</strong> && !originalName.equals(newName)) {
-<a class="jxr_linenumber" name="218" href="#218">218</a> ze.setName(newName);
-<a class="jxr_linenumber" name="219" href="#219">219</a> }
-<a class="jxr_linenumber" name="220" href="#220">220</a>
-<a class="jxr_linenumber" name="221" href="#221">221</a> <strong class="jxr_keyword">if</strong> (commentBytes != <strong class="jxr_keyword">null</strong> && commentBytes.length > 0) {
-<a class="jxr_linenumber" name="222" href="#222">222</a> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnicodeCommentExtraField.html">UnicodeCommentExtraField</a> cmt = (UnicodeCommentExtraField)
-<a class="jxr_linenumber" name="223" href="#223">223</a> ze.getExtraField(UnicodeCommentExtraField.UCOM_ID);
-<a class="jxr_linenumber" name="224" href="#224">224</a> String newComment =
-<a class="jxr_linenumber" name="225" href="#225">225</a> getUnicodeStringIfOriginalMatches(cmt, commentBytes);
-<a class="jxr_linenumber" name="226" href="#226">226</a> <strong class="jxr_keyword">if</strong> (newComment != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="227" href="#227">227</a> ze.setComment(newComment);
-<a class="jxr_linenumber" name="228" href="#228">228</a> }
-<a class="jxr_linenumber" name="229" href="#229">229</a> }
-<a class="jxr_linenumber" name="230" href="#230">230</a> }
-<a class="jxr_linenumber" name="231" href="#231">231</a>
-<a class="jxr_linenumber" name="232" href="#232">232</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="233" href="#233">233</a> <em class="jxr_javadoccomment"> * If the stored CRC matches the one of the given name, return the</em>
-<a class="jxr_linenumber" name="234" href="#234">234</a> <em class="jxr_javadoccomment"> * Unicode name of the given field.</em>
-<a class="jxr_linenumber" name="235" href="#235">235</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="236" href="#236">236</a> <em class="jxr_javadoccomment"> * <p>If the field is null or the CRCs don't match, return null</em>
-<a class="jxr_linenumber" name="237" href="#237">237</a> <em class="jxr_javadoccomment"> * instead.</p></em>
-<a class="jxr_linenumber" name="238" href="#238">238</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="239" href="#239">239</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong>
-<a class="jxr_linenumber" name="240" href="#240">240</a> String getUnicodeStringIfOriginalMatches(<a href="../../../../../../org/apache/commons/compress/archivers/zip/AbstractUnicodeExtraField.html">AbstractUnicodeExtraField</a> f,
-<a class="jxr_linenumber" name="241" href="#241">241</a> byte[] orig) {
-<a class="jxr_linenumber" name="242" href="#242">242</a> <strong class="jxr_keyword">if</strong> (f != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="243" href="#243">243</a> CRC32 crc32 = <strong class="jxr_keyword">new</strong> CRC32();
-<a class="jxr_linenumber" name="244" href="#244">244</a> crc32.update(orig);
-<a class="jxr_linenumber" name="245" href="#245">245</a> <strong class="jxr_keyword">long</strong> origCRC32 = crc32.getValue();
-<a class="jxr_linenumber" name="246" href="#246">246</a>
-<a class="jxr_linenumber" name="247" href="#247">247</a> <strong class="jxr_keyword">if</strong> (origCRC32 == f.getNameCRC32()) {
-<a class="jxr_linenumber" name="248" href="#248">248</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="249" href="#249">249</a> <strong class="jxr_keyword">return</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipEncodingHelper.html">ZipEncodingHelper</a>
-<a class="jxr_linenumber" name="250" href="#250">250</a> .UTF8_ZIP_ENCODING.decode(f.getUnicodeName());
-<a class="jxr_linenumber" name="251" href="#251">251</a> } <strong class="jxr_keyword">catch</strong> (IOException ex) {
-<a class="jxr_linenumber" name="252" href="#252">252</a> <em class="jxr_comment">// UTF-8 unsupported? should be impossible the</em>
-<a class="jxr_linenumber" name="253" href="#253">253</a> <em class="jxr_comment">// Unicode*ExtraField must contain some bad bytes</em>
-<a class="jxr_linenumber" name="254" href="#254">254</a>
-<a class="jxr_linenumber" name="255" href="#255">255</a> <em class="jxr_comment">// TODO log this anywhere?</em>
-<a class="jxr_linenumber" name="256" href="#256">256</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="257" href="#257">257</a> }
-<a class="jxr_linenumber" name="258" href="#258">258</a> }
-<a class="jxr_linenumber" name="259" href="#259">259</a> }
-<a class="jxr_linenumber" name="260" href="#260">260</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="261" href="#261">261</a> }
-<a class="jxr_linenumber" name="262" href="#262">262</a>
-<a class="jxr_linenumber" name="263" href="#263">263</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="264" href="#264">264</a> <em class="jxr_javadoccomment"> * Create a copy of the given array - or return null if the</em>
-<a class="jxr_linenumber" name="265" href="#265">265</a> <em class="jxr_javadoccomment"> * argument is null.</em>
-<a class="jxr_linenumber" name="266" href="#266">266</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="267" href="#267">267</a> <strong class="jxr_keyword">static</strong> byte[] copy(byte[] from) {
-<a class="jxr_linenumber" name="268" href="#268">268</a> <strong class="jxr_keyword">if</strong> (from != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="269" href="#269">269</a> byte[] to = <strong class="jxr_keyword">new</strong> byte[from.length];
-<a class="jxr_linenumber" name="270" href="#270">270</a> System.arraycopy(from, 0, to, 0, to.length);
-<a class="jxr_linenumber" name="271" href="#271">271</a> <strong class="jxr_keyword">return</strong> to;
-<a class="jxr_linenumber" name="272" href="#272">272</a> }
-<a class="jxr_linenumber" name="273" href="#273">273</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="274" href="#274">274</a> }
-<a class="jxr_linenumber" name="275" href="#275">275</a>
-<a class="jxr_linenumber" name="276" href="#276">276</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="277" href="#277">277</a> <em class="jxr_javadoccomment"> * Whether this library is able to read or write the given entry.</em>
-<a class="jxr_linenumber" name="278" href="#278">278</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="279" href="#279">279</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> canHandleEntryData(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> entry) {
-<a class="jxr_linenumber" name="280" href="#280">280</a> <strong class="jxr_keyword">return</strong> supportsEncryptionOf(entry) && supportsMethodOf(entry);
-<a class="jxr_linenumber" name="281" href="#281">281</a> }
-<a class="jxr_linenumber" name="282" href="#282">282</a>
-<a class="jxr_linenumber" name="283" href="#283">283</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="284" href="#284">284</a> <em class="jxr_javadoccomment"> * Whether this library supports the encryption used by the given</em>
-<a class="jxr_linenumber" name="285" href="#285">285</a> <em class="jxr_javadoccomment"> * entry.</em>
-<a class="jxr_linenumber" name="286" href="#286">286</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="287" href="#287">287</a> <em class="jxr_javadoccomment"> * @return true if the entry isn't encrypted at all</em>
-<a class="jxr_linenumber" name="288" href="#288">288</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="289" href="#289">289</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> supportsEncryptionOf(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> entry) {
-<a class="jxr_linenumber" name="290" href="#290">290</a> <strong class="jxr_keyword">return</strong> !entry.getGeneralPurposeBit().usesEncryption();
-<a class="jxr_linenumber" name="291" href="#291">291</a> }
-<a class="jxr_linenumber" name="292" href="#292">292</a>
-<a class="jxr_linenumber" name="293" href="#293">293</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="294" href="#294">294</a> <em class="jxr_javadoccomment"> * Whether this library supports the compression method used by</em>
-<a class="jxr_linenumber" name="295" href="#295">295</a> <em class="jxr_javadoccomment"> * the given entry.</em>
-<a class="jxr_linenumber" name="296" href="#296">296</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="297" href="#297">297</a> <em class="jxr_javadoccomment"> * @return true if the compression method is STORED or DEFLATED</em>
-<a class="jxr_linenumber" name="298" href="#298">298</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="299" href="#299">299</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> supportsMethodOf(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> entry) {
-<a class="jxr_linenumber" name="300" href="#300">300</a> <strong class="jxr_keyword">return</strong> entry.getMethod() == ZipEntry.STORED
-<a class="jxr_linenumber" name="301" href="#301">301</a> || entry.getMethod() == ZipEntry.DEFLATED;
-<a class="jxr_linenumber" name="302" href="#302">302</a> }
-<a class="jxr_linenumber" name="303" href="#303">303</a>
-<a class="jxr_linenumber" name="304" href="#304">304</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="305" href="#305">305</a> <em class="jxr_javadoccomment"> * Checks whether the entry requires features not (yet) supported</em>
-<a class="jxr_linenumber" name="306" href="#306">306</a> <em class="jxr_javadoccomment"> * by the library and throws an exception if it does.</em>
-<a class="jxr_linenumber" name="307" href="#307">307</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="308" href="#308">308</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> checkRequestedFeatures(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> ze)
-<a class="jxr_linenumber" name="309" href="#309">309</a> <strong class="jxr_keyword">throws</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a> {
-<a class="jxr_linenumber" name="310" href="#310">310</a> <strong class="jxr_keyword">if</strong> (!supportsEncryptionOf(ze)) {
-<a class="jxr_linenumber" name="311" href="#311">311</a> <strong class="jxr_keyword">throw</strong>
-<a class="jxr_linenumber" name="312" href="#312">312</a> <strong class="jxr_keyword">new</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>(<a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>
-<a class="jxr_linenumber" name="313" href="#313">313</a> .Feature.ENCRYPTION, ze);
-<a class="jxr_linenumber" name="314" href="#314">314</a> }
-<a class="jxr_linenumber" name="315" href="#315">315</a> <strong class="jxr_keyword">if</strong> (!supportsMethodOf(ze)) {
-<a class="jxr_linenumber" name="316" href="#316">316</a> <a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipMethod.html">ZipMethod</a> m = ZipMethod.getMethodByCode(ze.getMethod());
-<a class="jxr_linenumber" name="317" href="#317">317</a> <strong class="jxr_keyword">if</strong> (m == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="318" href="#318">318</a> <strong class="jxr_keyword">throw</strong>
-<a class="jxr_linenumber" name="319" href="#319">319</a> <strong class="jxr_keyword">new</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>(<a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>
-<a class="jxr_linenumber" name="320" href="#320">320</a> .Feature.METHOD, ze);
-<a class="jxr_linenumber" name="321" href="#321">321</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="322" href="#322">322</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>(m, ze);
-<a class="jxr_linenumber" name="323" href="#323">323</a> }
-<a class="jxr_linenumber" name="324" href="#324">324</a> }
-<a class="jxr_linenumber" name="325" href="#325">325</a> }
-<a class="jxr_linenumber" name="326" href="#326">326</a> }
+<a class="jxr_linenumber" name="95" href="#95">95</a> <em class="jxr_javadoccomment"> * @since 1.5</em>
+<a class="jxr_linenumber" name="96" href="#96">96</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="97" href="#97">97</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] reverse(<strong class="jxr_keyword">final</strong> byte[] array) {
+<a class="jxr_linenumber" name="98" href="#98">98</a> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> z = array.length - 1; <em class="jxr_comment">// position of last element</em>
+<a class="jxr_linenumber" name="99" href="#99">99</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0; i < array.length / 2; i++) {
+<a class="jxr_linenumber" name="100" href="#100">100</a> byte x = array[i];
+<a class="jxr_linenumber" name="101" href="#101">101</a> array[i] = array[z - i];
+<a class="jxr_linenumber" name="102" href="#102">102</a> array[z - i] = x;
+<a class="jxr_linenumber" name="103" href="#103">103</a> }
+<a class="jxr_linenumber" name="104" href="#104">104</a> <strong class="jxr_keyword">return</strong> array;
+<a class="jxr_linenumber" name="105" href="#105">105</a> }
+<a class="jxr_linenumber" name="106" href="#106">106</a>
+<a class="jxr_linenumber" name="107" href="#107">107</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="108" href="#108">108</a> <em class="jxr_javadoccomment"> * Converts a BigInteger into a long, and blows up</em>
+<a class="jxr_linenumber" name="109" href="#109">109</a> <em class="jxr_javadoccomment"> * (NumberFormatException) if the BigInteger is too big.</em>
+<a class="jxr_linenumber" name="110" href="#110">110</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="111" href="#111">111</a> <em class="jxr_javadoccomment"> * @param big BigInteger to convert.</em>
+<a class="jxr_linenumber" name="112" href="#112">112</a> <em class="jxr_javadoccomment"> * @return long representation of the BigInteger.</em>
+<a class="jxr_linenumber" name="113" href="#113">113</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="114" href="#114">114</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> bigToLong(BigInteger big) {
+<a class="jxr_linenumber" name="115" href="#115">115</a> <strong class="jxr_keyword">if</strong> (big.bitLength() <= 63) { <em class="jxr_comment">// bitLength() doesn't count the sign bit.</em>
+<a class="jxr_linenumber" name="116" href="#116">116</a> <strong class="jxr_keyword">return</strong> big.longValue();
+<a class="jxr_linenumber" name="117" href="#117">117</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="118" href="#118">118</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"The BigInteger cannot fit inside a 64 bit java long: ["</span> + big + <span class="jxr_string">"]"</span>);
+<a class="jxr_linenumber" name="119" href="#119">119</a> }
+<a class="jxr_linenumber" name="120" href="#120">120</a> }
+<a class="jxr_linenumber" name="121" href="#121">121</a>
+<a class="jxr_linenumber" name="122" href="#122">122</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="123" href="#123">123</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="124" href="#124">124</a> <em class="jxr_javadoccomment"> * Converts a long into a BigInteger. Negative numbers between -1 and</em>
+<a class="jxr_linenumber" name="125" href="#125">125</a> <em class="jxr_javadoccomment"> * -2^31 are treated as unsigned 32 bit (e.g., positive) integers.</em>
+<a class="jxr_linenumber" name="126" href="#126">126</a> <em class="jxr_javadoccomment"> * Negative numbers below -2^31 cause an IllegalArgumentException</em>
+<a class="jxr_linenumber" name="127" href="#127">127</a> <em class="jxr_javadoccomment"> * to be thrown.</em>
+<a class="jxr_linenumber" name="128" href="#128">128</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="129" href="#129">129</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="130" href="#130">130</a> <em class="jxr_javadoccomment"> * @param l long to convert to BigInteger.</em>
+<a class="jxr_linenumber" name="131" href="#131">131</a> <em class="jxr_javadoccomment"> * @return BigInteger representation of the provided long.</em>
+<a class="jxr_linenumber" name="132" href="#132">132</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="133" href="#133">133</a> <strong class="jxr_keyword">static</strong> BigInteger longToBig(<strong class="jxr_keyword">long</strong> l) {
+<a class="jxr_linenumber" name="134" href="#134">134</a> <strong class="jxr_keyword">if</strong> (l < Integer.MIN_VALUE) {
+<a class="jxr_linenumber" name="135" href="#135">135</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"Negative longs < -2^31 not permitted: ["</span> + l + <span class="jxr_string">"]"</span>);
+<a class="jxr_linenumber" name="136" href="#136">136</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (l < 0 && l >= Integer.MIN_VALUE) {
+<a class="jxr_linenumber" name="137" href="#137">137</a> <em class="jxr_comment">// If someone passes in a -2, they probably mean 4294967294</em>
+<a class="jxr_linenumber" name="138" href="#138">138</a> <em class="jxr_comment">// (For example, Unix UID/GID's are 32 bit unsigned.)</em>
+<a class="jxr_linenumber" name="139" href="#139">139</a> l = ZipUtil.adjustToLong((<strong class="jxr_keyword">int</strong>) l);
+<a class="jxr_linenumber" name="140" href="#140">140</a> }
+<a class="jxr_linenumber" name="141" href="#141">141</a> <strong class="jxr_keyword">return</strong> BigInteger.valueOf(l);
+<a class="jxr_linenumber" name="142" href="#142">142</a> }
+<a class="jxr_linenumber" name="143" href="#143">143</a>
+<a class="jxr_linenumber" name="144" href="#144">144</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="145" href="#145">145</a> <em class="jxr_javadoccomment"> * Converts a signed byte into an unsigned integer representation</em>
+<a class="jxr_linenumber" name="146" href="#146">146</a> <em class="jxr_javadoccomment"> * (e.g., -1 becomes 255).</em>
+<a class="jxr_linenumber" name="147" href="#147">147</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="148" href="#148">148</a> <em class="jxr_javadoccomment"> * @param b byte to convert to int</em>
+<a class="jxr_linenumber" name="149" href="#149">149</a> <em class="jxr_javadoccomment"> * @return int representation of the provided byte</em>
+<a class="jxr_linenumber" name="150" href="#150">150</a> <em class="jxr_javadoccomment"> * @since 1.5</em>
+<a class="jxr_linenumber" name="151" href="#151">151</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="152" href="#152">152</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> signedByteToUnsignedInt(byte b) {
+<a class="jxr_linenumber" name="153" href="#153">153</a> <strong class="jxr_keyword">if</strong> (b >= 0) {
+<a class="jxr_linenumber" name="154" href="#154">154</a> <strong class="jxr_keyword">return</strong> b;
+<a class="jxr_linenumber" name="155" href="#155">155</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="156" href="#156">156</a> <strong class="jxr_keyword">return</strong> 256 + b;
+<a class="jxr_linenumber" name="157" href="#157">157</a> }
+<a class="jxr_linenumber" name="158" href="#158">158</a> }
+<a class="jxr_linenumber" name="159" href="#159">159</a>
+<a class="jxr_linenumber" name="160" href="#160">160</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="161" href="#161">161</a> <em class="jxr_javadoccomment"> * Converts an unsigned integer to a signed byte (e.g., 255 becomes -1).</em>
+<a class="jxr_linenumber" name="162" href="#162">162</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="163" href="#163">163</a> <em class="jxr_javadoccomment"> * @param i integer to convert to byte</em>
+<a class="jxr_linenumber" name="164" href="#164">164</a> <em class="jxr_javadoccomment"> * @return byte representation of the provided int</em>
+<a class="jxr_linenumber" name="165" href="#165">165</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException if the provided integer is not inside the range [0,255].</em>
+<a class="jxr_linenumber" name="166" href="#166">166</a> <em class="jxr_javadoccomment"> * @since 1.5</em>
+<a class="jxr_linenumber" name="167" href="#167">167</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="168" href="#168">168</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte unsignedIntToSignedByte(<strong class="jxr_keyword">int</strong> i) {
+<a class="jxr_linenumber" name="169" href="#169">169</a> <strong class="jxr_keyword">if</strong> (i > 255 || i < 0) {
+<a class="jxr_linenumber" name="170" href="#170">170</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"Can only convert non-negative integers between [0,255] to byte: ["</span> + i + <span class="jxr_string">"]"</span>);
+<a class="jxr_linenumber" name="171" href="#171">171</a> }
+<a class="jxr_linenumber" name="172" href="#172">172</a> <strong class="jxr_keyword">if</strong> (i < 128) {
+<a class="jxr_linenumber" name="173" href="#173">173</a> <strong class="jxr_keyword">return</strong> (byte) i;
+<a class="jxr_linenumber" name="174" href="#174">174</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="175" href="#175">175</a> <strong class="jxr_keyword">return</strong> (byte) (i - 256);
+<a class="jxr_linenumber" name="176" href="#176">176</a> }
+<a class="jxr_linenumber" name="177" href="#177">177</a> }
+<a class="jxr_linenumber" name="178" href="#178">178</a>
+<a class="jxr_linenumber" name="179" href="#179">179</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="180" href="#180">180</a> <em class="jxr_javadoccomment"> * Convert a DOS date/time field to a Date object.</em>
+<a class="jxr_linenumber" name="181" href="#181">181</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="182" href="#182">182</a> <em class="jxr_javadoccomment"> * @param zipDosTime contains the stored DOS time.</em>
+<a class="jxr_linenumber" name="183" href="#183">183</a> <em class="jxr_javadoccomment"> * @return a Date instance corresponding to the given time.</em>
+<a class="jxr_linenumber" name="184" href="#184">184</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="185" href="#185">185</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Date fromDosTime(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipLong.html">ZipLong</a> zipDosTime) {
+<a class="jxr_linenumber" name="186" href="#186">186</a> <strong class="jxr_keyword">long</strong> dosTime = zipDosTime.getValue();
+<a class="jxr_linenumber" name="187" href="#187">187</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> Date(dosToJavaTime(dosTime));
+<a class="jxr_linenumber" name="188" href="#188">188</a> }
+<a class="jxr_linenumber" name="189" href="#189">189</a>
+<a class="jxr_linenumber" name="190" href="#190">190</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="191" href="#191">191</a> <em class="jxr_javadoccomment"> * Converts DOS time to Java time (number of milliseconds since</em>
+<a class="jxr_linenumber" name="192" href="#192">192</a> <em class="jxr_javadoccomment"> * epoch).</em>
+<a class="jxr_linenumber" name="193" href="#193">193</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="194" href="#194">194</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> dosToJavaTime(<strong class="jxr_keyword">long</strong> dosTime) {
+<a class="jxr_linenumber" name="195" href="#195">195</a> Calendar cal = Calendar.getInstance();
+<a class="jxr_linenumber" name="196" href="#196">196</a> <em class="jxr_comment">// CheckStyle:MagicNumberCheck OFF - no point</em>
+<a class="jxr_linenumber" name="197" href="#197">197</a> cal.set(Calendar.YEAR, (<strong class="jxr_keyword">int</strong>) ((dosTime >> 25) & 0x7f) + 1980);
+<a class="jxr_linenumber" name="198" href="#198">198</a> cal.set(Calendar.MONTH, (<strong class="jxr_keyword">int</strong>) ((dosTime >> 21) & 0x0f) - 1);
+<a class="jxr_linenumber" name="199" href="#199">199</a> cal.set(Calendar.DATE, (<strong class="jxr_keyword">int</strong>) (dosTime >> 16) & 0x1f);
+<a class="jxr_linenumber" name="200" href="#200">200</a> cal.set(Calendar.HOUR_OF_DAY, (<strong class="jxr_keyword">int</strong>) (dosTime >> 11) & 0x1f);
+<a class="jxr_linenumber" name="201" href="#201">201</a> cal.set(Calendar.MINUTE, (<strong class="jxr_keyword">int</strong>) (dosTime >> 5) & 0x3f);
+<a class="jxr_linenumber" name="202" href="#202">202</a> cal.set(Calendar.SECOND, (<strong class="jxr_keyword">int</strong>) (dosTime << 1) & 0x3e);
+<a class="jxr_linenumber" name="203" href="#203">203</a> <em class="jxr_comment">// CheckStyle:MagicNumberCheck ON</em>
+<a class="jxr_linenumber" name="204" href="#204">204</a> <strong class="jxr_keyword">return</strong> cal.getTime().getTime();
+<a class="jxr_linenumber" name="205" href="#205">205</a> }
+<a class="jxr_linenumber" name="206" href="#206">206</a>
+<a class="jxr_linenumber" name="207" href="#207">207</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="208" href="#208">208</a> <em class="jxr_javadoccomment"> * If the entry has Unicode*ExtraFields and the CRCs of the</em>
+<a class="jxr_linenumber" name="209" href="#209">209</a> <em class="jxr_javadoccomment"> * names/comments match those of the extra fields, transfer the</em>
+<a class="jxr_linenumber" name="210" href="#210">210</a> <em class="jxr_javadoccomment"> * known Unicode values from the extra field.</em>
+<a class="jxr_linenumber" name="211" href="#211">211</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="212" href="#212">212</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> setNameAndCommentFromExtraFields(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> ze,
+<a class="jxr_linenumber" name="213" href="#213">213</a> byte[] originalNameBytes,
+<a class="jxr_linenumber" name="214" href="#214">214</a> byte[] commentBytes) {
+<a class="jxr_linenumber" name="215" href="#215">215</a> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnicodePathExtraField.html">UnicodePathExtraField</a> name = (UnicodePathExtraField)
+<a class="jxr_linenumber" name="216" href="#216">216</a> ze.getExtraField(UnicodePathExtraField.UPATH_ID);
+<a class="jxr_linenumber" name="217" href="#217">217</a> String originalName = ze.getName();
+<a class="jxr_linenumber" name="218" href="#218">218</a> String newName = getUnicodeStringIfOriginalMatches(name,
+<a class="jxr_linenumber" name="219" href="#219">219</a> originalNameBytes);
+<a class="jxr_linenumber" name="220" href="#220">220</a> <strong class="jxr_keyword">if</strong> (newName != <strong class="jxr_keyword">null</strong> && !originalName.equals(newName)) {
+<a class="jxr_linenumber" name="221" href="#221">221</a> ze.setName(newName);
+<a class="jxr_linenumber" name="222" href="#222">222</a> }
+<a class="jxr_linenumber" name="223" href="#223">223</a>
+<a class="jxr_linenumber" name="224" href="#224">224</a> <strong class="jxr_keyword">if</strong> (commentBytes != <strong class="jxr_keyword">null</strong> && commentBytes.length > 0) {
+<a class="jxr_linenumber" name="225" href="#225">225</a> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnicodeCommentExtraField.html">UnicodeCommentExtraField</a> cmt = (UnicodeCommentExtraField)
+<a class="jxr_linenumber" name="226" href="#226">226</a> ze.getExtraField(UnicodeCommentExtraField.UCOM_ID);
+<a class="jxr_linenumber" name="227" href="#227">227</a> String newComment =
+<a class="jxr_linenumber" name="228" href="#228">228</a> getUnicodeStringIfOriginalMatches(cmt, commentBytes);
+<a class="jxr_linenumber" name="229" href="#229">229</a> <strong class="jxr_keyword">if</strong> (newComment != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="230" href="#230">230</a> ze.setComment(newComment);
+<a class="jxr_linenumber" name="231" href="#231">231</a> }
+<a class="jxr_linenumber" name="232" href="#232">232</a> }
+<a class="jxr_linenumber" name="233" href="#233">233</a> }
+<a class="jxr_linenumber" name="234" href="#234">234</a>
+<a class="jxr_linenumber" name="235" href="#235">235</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="236" href="#236">236</a> <em class="jxr_javadoccomment"> * If the stored CRC matches the one of the given name, return the</em>
+<a class="jxr_linenumber" name="237" href="#237">237</a> <em class="jxr_javadoccomment"> * Unicode name of the given field.</em>
+<a class="jxr_linenumber" name="238" href="#238">238</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="239" href="#239">239</a> <em class="jxr_javadoccomment"> * <p>If the field is null or the CRCs don't match, return null</em>
+<a class="jxr_linenumber" name="240" href="#240">240</a> <em class="jxr_javadoccomment"> * instead.</p></em>
+<a class="jxr_linenumber" name="241" href="#241">241</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="242" href="#242">242</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong>
+<a class="jxr_linenumber" name="243" href="#243">243</a> String getUnicodeStringIfOriginalMatches(<a href="../../../../../../org/apache/commons/compress/archivers/zip/AbstractUnicodeExtraField.html">AbstractUnicodeExtraField</a> f,
+<a class="jxr_linenumber" name="244" href="#244">244</a> byte[] orig) {
+<a class="jxr_linenumber" name="245" href="#245">245</a> <strong class="jxr_keyword">if</strong> (f != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="246" href="#246">246</a> CRC32 crc32 = <strong class="jxr_keyword">new</strong> CRC32();
+<a class="jxr_linenumber" name="247" href="#247">247</a> crc32.update(orig);
+<a class="jxr_linenumber" name="248" href="#248">248</a> <strong class="jxr_keyword">long</strong> origCRC32 = crc32.getValue();
+<a class="jxr_linenumber" name="249" href="#249">249</a>
+<a class="jxr_linenumber" name="250" href="#250">250</a> <strong class="jxr_keyword">if</strong> (origCRC32 == f.getNameCRC32()) {
+<a class="jxr_linenumber" name="251" href="#251">251</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="252" href="#252">252</a> <strong class="jxr_keyword">return</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipEncodingHelper.html">ZipEncodingHelper</a>
+<a class="jxr_linenumber" name="253" href="#253">253</a> .UTF8_ZIP_ENCODING.decode(f.getUnicodeName());
+<a class="jxr_linenumber" name="254" href="#254">254</a> } <strong class="jxr_keyword">catch</strong> (IOException ex) {
+<a class="jxr_linenumber" name="255" href="#255">255</a> <em class="jxr_comment">// UTF-8 unsupported? should be impossible the</em>
+<a class="jxr_linenumber" name="256" href="#256">256</a> <em class="jxr_comment">// Unicode*ExtraField must contain some bad bytes</em>
+<a class="jxr_linenumber" name="257" href="#257">257</a>
+<a class="jxr_linenumber" name="258" href="#258">258</a> <em class="jxr_comment">// TODO log this anywhere?</em>
+<a class="jxr_linenumber" name="259" href="#259">259</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="260" href="#260">260</a> }
+<a class="jxr_linenumber" name="261" href="#261">261</a> }
+<a class="jxr_linenumber" name="262" href="#262">262</a> }
+<a class="jxr_linenumber" name="263" href="#263">263</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="264" href="#264">264</a> }
+<a class="jxr_linenumber" name="265" href="#265">265</a>
+<a class="jxr_linenumber" name="266" href="#266">266</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="267" href="#267">267</a> <em class="jxr_javadoccomment"> * Create a copy of the given array - or return null if the</em>
+<a class="jxr_linenumber" name="268" href="#268">268</a> <em class="jxr_javadoccomment"> * argument is null.</em>
+<a class="jxr_linenumber" name="269" href="#269">269</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="270" href="#270">270</a> <strong class="jxr_keyword">static</strong> byte[] copy(byte[] from) {
+<a class="jxr_linenumber" name="271" href="#271">271</a> <strong class="jxr_keyword">if</strong> (from != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="272" href="#272">272</a> byte[] to = <strong class="jxr_keyword">new</strong> byte[from.length];
+<a class="jxr_linenumber" name="273" href="#273">273</a> System.arraycopy(from, 0, to, 0, to.length);
+<a class="jxr_linenumber" name="274" href="#274">274</a> <strong class="jxr_keyword">return</strong> to;
+<a class="jxr_linenumber" name="275" href="#275">275</a> }
+<a class="jxr_linenumber" name="276" href="#276">276</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="277" href="#277">277</a> }
+<a class="jxr_linenumber" name="278" href="#278">278</a>
+<a class="jxr_linenumber" name="279" href="#279">279</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="280" href="#280">280</a> <em class="jxr_javadoccomment"> * Whether this library is able to read or write the given entry.</em>
+<a class="jxr_linenumber" name="281" href="#281">281</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="282" href="#282">282</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> canHandleEntryData(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> entry) {
+<a class="jxr_linenumber" name="283" href="#283">283</a> <strong class="jxr_keyword">return</strong> supportsEncryptionOf(entry) && supportsMethodOf(entry);
+<a class="jxr_linenumber" name="284" href="#284">284</a> }
+<a class="jxr_linenumber" name="285" href="#285">285</a>
+<a class="jxr_linenumber" name="286" href="#286">286</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="287" href="#287">287</a> <em class="jxr_javadoccomment"> * Whether this library supports the encryption used by the given</em>
+<a class="jxr_linenumber" name="288" href="#288">288</a> <em class="jxr_javadoccomment"> * entry.</em>
+<a class="jxr_linenumber" name="289" href="#289">289</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="290" href="#290">290</a> <em class="jxr_javadoccomment"> * @return true if the entry isn't encrypted at all</em>
+<a class="jxr_linenumber" name="291" href="#291">291</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="292" href="#292">292</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> supportsEncryptionOf(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> entry) {
+<a class="jxr_linenumber" name="293" href="#293">293</a> <strong class="jxr_keyword">return</strong> !entry.getGeneralPurposeBit().usesEncryption();
+<a class="jxr_linenumber" name="294" href="#294">294</a> }
+<a class="jxr_linenumber" name="295" href="#295">295</a>
+<a class="jxr_linenumber" name="296" href="#296">296</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="297" href="#297">297</a> <em class="jxr_javadoccomment"> * Whether this library supports the compression method used by</em>
+<a class="jxr_linenumber" name="298" href="#298">298</a> <em class="jxr_javadoccomment"> * the given entry.</em>
+<a class="jxr_linenumber" name="299" href="#299">299</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="300" href="#300">300</a> <em class="jxr_javadoccomment"> * @return true if the compression method is STORED or DEFLATED</em>
+<a class="jxr_linenumber" name="301" href="#301">301</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="302" href="#302">302</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> supportsMethodOf(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> entry) {
+<a class="jxr_linenumber" name="303" href="#303">303</a> <strong class="jxr_keyword">return</strong> entry.getMethod() == ZipEntry.STORED
+<a class="jxr_linenumber" name="304" href="#304">304</a> || entry.getMethod() == ZipEntry.DEFLATED;
+<a class="jxr_linenumber" name="305" href="#305">305</a> }
+<a class="jxr_linenumber" name="306" href="#306">306</a>
+<a class="jxr_linenumber" name="307" href="#307">307</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="308" href="#308">308</a> <em class="jxr_javadoccomment"> * Checks whether the entry requires features not (yet) supported</em>
+<a class="jxr_linenumber" name="309" href="#309">309</a> <em class="jxr_javadoccomment"> * by the library and throws an exception if it does.</em>
+<a class="jxr_linenumber" name="310" href="#310">310</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="311" href="#311">311</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> checkRequestedFeatures(<a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipArchiveEntry.html">ZipArchiveEntry</a> ze)
+<a class="jxr_linenumber" name="312" href="#312">312</a> <strong class="jxr_keyword">throws</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a> {
+<a class="jxr_linenumber" name="313" href="#313">313</a> <strong class="jxr_keyword">if</strong> (!supportsEncryptionOf(ze)) {
+<a class="jxr_linenumber" name="314" href="#314">314</a> <strong class="jxr_keyword">throw</strong>
+<a class="jxr_linenumber" name="315" href="#315">315</a> <strong class="jxr_keyword">new</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>(<a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>
+<a class="jxr_linenumber" name="316" href="#316">316</a> .Feature.ENCRYPTION, ze);
+<a class="jxr_linenumber" name="317" href="#317">317</a> }
+<a class="jxr_linenumber" name="318" href="#318">318</a> <strong class="jxr_keyword">if</strong> (!supportsMethodOf(ze)) {
+<a class="jxr_linenumber" name="319" href="#319">319</a> <a href="../../../../../../org/apache/commons/compress/archivers/zip/ZipMethod.html">ZipMethod</a> m = ZipMethod.getMethodByCode(ze.getMethod());
+<a class="jxr_linenumber" name="320" href="#320">320</a> <strong class="jxr_keyword">if</strong> (m == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="321" href="#321">321</a> <strong class="jxr_keyword">throw</strong>
+<a class="jxr_linenumber" name="322" href="#322">322</a> <strong class="jxr_keyword">new</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>(<a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>
+<a class="jxr_linenumber" name="323" href="#323">323</a> .Feature.METHOD, ze);
+<a class="jxr_linenumber" name="324" href="#324">324</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="325" href="#325">325</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a href="../../../../../../org/apache/commons/compress/archivers/zip/UnsupportedZipFeatureException.html">UnsupportedZipFeatureException</a>(m, ze);
+<a class="jxr_linenumber" name="326" href="#326">326</a> }
+<a class="jxr_linenumber" name="327" href="#327">327</a> }
+<a class="jxr_linenumber" name="328" href="#328">328</a> }
+<a class="jxr_linenumber" name="329" href="#329">329</a> }
</pre>
<hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
</html>
Modified: websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/package-frame.html
==============================================================================
--- websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/package-frame.html (original)
+++ websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/package-frame.html Thu Mar 14 17:10:39 2013
@@ -3,7 +3,7 @@
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
- <title>Commons Compress 1.5-SNAPSHOT Reference Package org.apache.commons.compress.archivers.zip</title>
+ <title>Commons Compress 1.6-SNAPSHOT Reference Package org.apache.commons.compress.archivers.zip</title>
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="style" />
</head>
<body>
Modified: websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/package-summary.html
==============================================================================
--- websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/package-summary.html (original)
+++ websites/production/commons/content/proper/commons-compress/xref/org/apache/commons/compress/archivers/zip/package-summary.html Thu Mar 14 17:10:39 2013
@@ -3,7 +3,7 @@
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
- <title>Commons Compress 1.5-SNAPSHOT Reference Package org.apache.commons.compress.archivers.zip</title>
+ <title>Commons Compress 1.6-SNAPSHOT Reference Package org.apache.commons.compress.archivers.zip</title>
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="style" />
</head>
<body>