You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ba...@apache.org on 2013/10/19 19:17:59 UTC

svn commit: r883363 [48/48] - in /websites/production/commons/content/proper/commons-lang: ./ apidocs/ apidocs/org/apache/commons/lang3/ apidocs/org/apache/commons/lang3/builder/ apidocs/org/apache/commons/lang3/builder/class-use/ apidocs/org/apache/co...

Modified: websites/production/commons/content/proper/commons-lang/xref/org/apache/commons/lang3/time/FormatCache.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/xref/org/apache/commons/lang3/time/FormatCache.html (original)
+++ websites/production/commons/content/proper/commons-lang/xref/org/apache/commons/lang3/time/FormatCache.html Sat Oct 19 17:17:55 2013
@@ -135,146 +135,145 @@
 <a class="jxr_linenumber" name="125" href="#125">125</a>         <strong class="jxr_keyword">return</strong> getInstance(pattern, timeZone, locale);
 <a class="jxr_linenumber" name="126" href="#126">126</a>     }
 <a class="jxr_linenumber" name="127" href="#127">127</a> 
-<a class="jxr_linenumber" name="128" href="#128">128</a>     <em class="jxr_comment">/*</em>
-<a class="jxr_linenumber" name="129" href="#129">129</a> <em class="jxr_comment">     * &lt;p&gt;Gets a date/time formatter instance using the specified style,</em>
-<a class="jxr_linenumber" name="130" href="#130">130</a> <em class="jxr_comment">     * time zone and locale.&lt;/p&gt;</em>
-<a class="jxr_linenumber" name="131" href="#131">131</a> <em class="jxr_comment">     * </em>
-<a class="jxr_linenumber" name="132" href="#132">132</a> <em class="jxr_comment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT</em>
-<a class="jxr_linenumber" name="133" href="#133">133</a> <em class="jxr_comment">     * @param timeStyle  time style: FULL, LONG, MEDIUM, or SHORT</em>
-<a class="jxr_linenumber" name="134" href="#134">134</a> <em class="jxr_comment">     * @param timeZone  optional time zone, overrides time zone of</em>
-<a class="jxr_linenumber" name="135" href="#135">135</a> <em class="jxr_comment">     *  formatted date, null means use default Locale</em>
-<a class="jxr_linenumber" name="136" href="#136">136</a> <em class="jxr_comment">     * @param locale  optional locale, overrides system locale</em>
-<a class="jxr_linenumber" name="137" href="#137">137</a> <em class="jxr_comment">     * @return a localized standard date/time formatter</em>
-<a class="jxr_linenumber" name="138" href="#138">138</a> <em class="jxr_comment">     * @throws IllegalArgumentException if the Locale has no date/time</em>
-<a class="jxr_linenumber" name="139" href="#139">139</a> <em class="jxr_comment">     *  pattern defined</em>
-<a class="jxr_linenumber" name="140" href="#140">140</a> <em class="jxr_comment">     */</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">     * &lt;p&gt;Gets a date/time formatter instance using the specified style,</em>
+<a class="jxr_linenumber" name="130" href="#130">130</a> <em class="jxr_javadoccomment">     * time zone and locale.&lt;/p&gt;</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> <em class="jxr_javadoccomment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT</em>
+<a class="jxr_linenumber" name="133" href="#133">133</a> <em class="jxr_javadoccomment">     * @param timeStyle  time style: FULL, LONG, MEDIUM, or SHORT</em>
+<a class="jxr_linenumber" name="134" href="#134">134</a> <em class="jxr_javadoccomment">     * @param timeZone  optional time zone, overrides time zone of</em>
+<a class="jxr_linenumber" name="135" href="#135">135</a> <em class="jxr_javadoccomment">     *  formatted date, null means use default Locale</em>
+<a class="jxr_linenumber" name="136" href="#136">136</a> <em class="jxr_javadoccomment">     * @param locale  optional locale, overrides system locale</em>
+<a class="jxr_linenumber" name="137" href="#137">137</a> <em class="jxr_javadoccomment">     * @return a localized standard date/time formatter</em>
+<a class="jxr_linenumber" name="138" href="#138">138</a> <em class="jxr_javadoccomment">     * @throws IllegalArgumentException if the Locale has no date/time</em>
+<a class="jxr_linenumber" name="139" href="#139">139</a> <em class="jxr_javadoccomment">     *  pattern defined</em>
+<a class="jxr_linenumber" name="140" href="#140">140</a> <em class="jxr_javadoccomment">     */</em>
 <a class="jxr_linenumber" name="141" href="#141">141</a>     <em class="jxr_comment">// package protected, for access from FastDateFormat; do not make public or protected</em>
 <a class="jxr_linenumber" name="142" href="#142">142</a>     F getDateTimeInstance(<strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> dateStyle, <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> timeStyle, <strong class="jxr_keyword">final</strong> TimeZone timeZone, Locale locale) {
 <a class="jxr_linenumber" name="143" href="#143">143</a>         <strong class="jxr_keyword">return</strong> getDateTimeInstance(Integer.valueOf(dateStyle), Integer.valueOf(timeStyle), timeZone, locale);
 <a class="jxr_linenumber" name="144" href="#144">144</a>     }
 <a class="jxr_linenumber" name="145" href="#145">145</a> 
-<a class="jxr_linenumber" name="146" href="#146">146</a>     <em class="jxr_comment">/*</em>
-<a class="jxr_linenumber" name="147" href="#147">147</a> <em class="jxr_comment">     * &lt;p&gt;Gets a date formatter instance using the specified style,</em>
-<a class="jxr_linenumber" name="148" href="#148">148</a> <em class="jxr_comment">     * time zone and locale.&lt;/p&gt;</em>
-<a class="jxr_linenumber" name="149" href="#149">149</a> <em class="jxr_comment">     * </em>
-<a class="jxr_linenumber" name="150" href="#150">150</a> <em class="jxr_comment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT</em>
-<a class="jxr_linenumber" name="151" href="#151">151</a> <em class="jxr_comment">     * @param timeZone  optional time zone, overrides time zone of</em>
-<a class="jxr_linenumber" name="152" href="#152">152</a> <em class="jxr_comment">     *  formatted date, null means use default Locale</em>
-<a class="jxr_linenumber" name="153" href="#153">153</a> <em class="jxr_comment">     * @param locale  optional locale, overrides system locale</em>
-<a class="jxr_linenumber" name="154" href="#154">154</a> <em class="jxr_comment">     * @return a localized standard date/time formatter</em>
-<a class="jxr_linenumber" name="155" href="#155">155</a> <em class="jxr_comment">     * @throws IllegalArgumentException if the Locale has no date/time</em>
-<a class="jxr_linenumber" name="156" href="#156">156</a> <em class="jxr_comment">     *  pattern defined</em>
-<a class="jxr_linenumber" name="157" href="#157">157</a> <em class="jxr_comment">     */</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">     * &lt;p&gt;Gets a date formatter instance using the specified style,</em>
+<a class="jxr_linenumber" name="148" href="#148">148</a> <em class="jxr_javadoccomment">     * time zone and locale.&lt;/p&gt;</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> <em class="jxr_javadoccomment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT</em>
+<a class="jxr_linenumber" name="151" href="#151">151</a> <em class="jxr_javadoccomment">     * @param timeZone  optional time zone, overrides time zone of</em>
+<a class="jxr_linenumber" name="152" href="#152">152</a> <em class="jxr_javadoccomment">     *  formatted date, null means use default Locale</em>
+<a class="jxr_linenumber" name="153" href="#153">153</a> <em class="jxr_javadoccomment">     * @param locale  optional locale, overrides system locale</em>
+<a class="jxr_linenumber" name="154" href="#154">154</a> <em class="jxr_javadoccomment">     * @return a localized standard date/time formatter</em>
+<a class="jxr_linenumber" name="155" href="#155">155</a> <em class="jxr_javadoccomment">     * @throws IllegalArgumentException if the Locale has no date/time</em>
+<a class="jxr_linenumber" name="156" href="#156">156</a> <em class="jxr_javadoccomment">     *  pattern defined</em>
+<a class="jxr_linenumber" name="157" href="#157">157</a> <em class="jxr_javadoccomment">     */</em>
 <a class="jxr_linenumber" name="158" href="#158">158</a>     <em class="jxr_comment">// package protected, for access from FastDateFormat; do not make public or protected</em>
 <a class="jxr_linenumber" name="159" href="#159">159</a>     F getDateInstance(<strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> dateStyle, <strong class="jxr_keyword">final</strong> TimeZone timeZone, Locale locale) {
 <a class="jxr_linenumber" name="160" href="#160">160</a>         <strong class="jxr_keyword">return</strong> getDateTimeInstance(Integer.valueOf(dateStyle), <strong class="jxr_keyword">null</strong>, timeZone, locale);
 <a class="jxr_linenumber" name="161" href="#161">161</a>     }
 <a class="jxr_linenumber" name="162" href="#162">162</a> 
-<a class="jxr_linenumber" name="163" href="#163">163</a>     <em class="jxr_comment">/*</em>
-<a class="jxr_linenumber" name="164" href="#164">164</a> <em class="jxr_comment">     * &lt;p&gt;Gets a time formatter instance using the specified style,</em>
-<a class="jxr_linenumber" name="165" href="#165">165</a> <em class="jxr_comment">     * time zone and locale.&lt;/p&gt;</em>
-<a class="jxr_linenumber" name="166" href="#166">166</a> <em class="jxr_comment">     * </em>
-<a class="jxr_linenumber" name="167" href="#167">167</a> <em class="jxr_comment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT</em>
-<a class="jxr_linenumber" name="168" href="#168">168</a> <em class="jxr_comment">     * @param timeStyle  time style: FULL, LONG, MEDIUM, or SHORT</em>
-<a class="jxr_linenumber" name="169" href="#169">169</a> <em class="jxr_comment">     * @param timeZone  optional time zone, overrides time zone of</em>
-<a class="jxr_linenumber" name="170" href="#170">170</a> <em class="jxr_comment">     *  formatted date, null means use default Locale</em>
-<a class="jxr_linenumber" name="171" href="#171">171</a> <em class="jxr_comment">     * @param locale  optional locale, overrides system locale</em>
-<a class="jxr_linenumber" name="172" href="#172">172</a> <em class="jxr_comment">     * @return a localized standard date/time formatter</em>
-<a class="jxr_linenumber" name="173" href="#173">173</a> <em class="jxr_comment">     * @throws IllegalArgumentException if the Locale has no date/time</em>
-<a class="jxr_linenumber" name="174" href="#174">174</a> <em class="jxr_comment">     *  pattern defined</em>
-<a class="jxr_linenumber" name="175" href="#175">175</a> <em class="jxr_comment">     */</em>
-<a class="jxr_linenumber" name="176" href="#176">176</a>     <em class="jxr_comment">// package protected, for access from FastDateFormat; do not make public or protected</em>
-<a class="jxr_linenumber" name="177" href="#177">177</a>     F getTimeInstance(<strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> timeStyle, <strong class="jxr_keyword">final</strong> TimeZone timeZone, Locale locale) {
-<a class="jxr_linenumber" name="178" href="#178">178</a>         <strong class="jxr_keyword">return</strong> getDateTimeInstance(<strong class="jxr_keyword">null</strong>, Integer.valueOf(timeStyle), timeZone, locale);
-<a class="jxr_linenumber" name="179" href="#179">179</a>     }
-<a class="jxr_linenumber" name="180" href="#180">180</a> 
-<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">     * &lt;p&gt;Gets a date/time format for the specified styles and locale.&lt;/p&gt;</em>
-<a class="jxr_linenumber" name="183" href="#183">183</a> <em class="jxr_javadoccomment">     * </em>
-<a class="jxr_linenumber" name="184" href="#184">184</a> <em class="jxr_javadoccomment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT, null indicates no date in format</em>
-<a class="jxr_linenumber" name="185" href="#185">185</a> <em class="jxr_javadoccomment">     * @param timeStyle  time style: FULL, LONG, MEDIUM, or SHORT, null indicates no time in format</em>
-<a class="jxr_linenumber" name="186" href="#186">186</a> <em class="jxr_javadoccomment">     * @param locale  The non-null locale of the desired format</em>
-<a class="jxr_linenumber" name="187" href="#187">187</a> <em class="jxr_javadoccomment">     * @return a localized standard date/time format</em>
-<a class="jxr_linenumber" name="188" href="#188">188</a> <em class="jxr_javadoccomment">     * @throws IllegalArgumentException if the Locale has no date/time pattern defined</em>
-<a class="jxr_linenumber" name="189" href="#189">189</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="190" href="#190">190</a>     <em class="jxr_comment">// package protected, for access from test code; do not make public or protected</em>
-<a class="jxr_linenumber" name="191" href="#191">191</a>     <strong class="jxr_keyword">static</strong> String getPatternForStyle(<strong class="jxr_keyword">final</strong> Integer dateStyle, <strong class="jxr_keyword">final</strong> Integer timeStyle, <strong class="jxr_keyword">final</strong> Locale locale) {
-<a class="jxr_linenumber" name="192" href="#192">192</a>         <strong class="jxr_keyword">final</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a> key = <strong class="jxr_keyword">new</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a>(dateStyle, timeStyle, locale);
-<a class="jxr_linenumber" name="193" href="#193">193</a> 
-<a class="jxr_linenumber" name="194" href="#194">194</a>         String pattern = cDateTimeInstanceCache.get(key);
-<a class="jxr_linenumber" name="195" href="#195">195</a>         <strong class="jxr_keyword">if</strong> (pattern == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="196" href="#196">196</a>             <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="197" href="#197">197</a>                 DateFormat formatter;
-<a class="jxr_linenumber" name="198" href="#198">198</a>                 <strong class="jxr_keyword">if</strong> (dateStyle == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="199" href="#199">199</a>                     formatter = DateFormat.getTimeInstance(timeStyle.intValue(), locale);                    
-<a class="jxr_linenumber" name="200" href="#200">200</a>                 }
-<a class="jxr_linenumber" name="201" href="#201">201</a>                 <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (timeStyle == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="202" href="#202">202</a>                     formatter = DateFormat.getDateInstance(dateStyle.intValue(), locale);                    
-<a class="jxr_linenumber" name="203" href="#203">203</a>                 }
-<a class="jxr_linenumber" name="204" href="#204">204</a>                 <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="205" href="#205">205</a>                     formatter = DateFormat.getDateTimeInstance(dateStyle.intValue(), timeStyle.intValue(), locale);
-<a class="jxr_linenumber" name="206" href="#206">206</a>                 }
-<a class="jxr_linenumber" name="207" href="#207">207</a>                 pattern = ((SimpleDateFormat)formatter).toPattern();
-<a class="jxr_linenumber" name="208" href="#208">208</a>                 <strong class="jxr_keyword">final</strong> String previous = cDateTimeInstanceCache.putIfAbsent(key, pattern);
-<a class="jxr_linenumber" name="209" href="#209">209</a>                 <strong class="jxr_keyword">if</strong> (previous != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="210" href="#210">210</a>                     <em class="jxr_comment">// even though it doesn't matter if another thread put the pattern</em>
-<a class="jxr_linenumber" name="211" href="#211">211</a>                     <em class="jxr_comment">// it's still good practice to return the String instance that is</em>
-<a class="jxr_linenumber" name="212" href="#212">212</a>                     <em class="jxr_comment">// actually in the ConcurrentMap</em>
-<a class="jxr_linenumber" name="213" href="#213">213</a>                     pattern= previous;
-<a class="jxr_linenumber" name="214" href="#214">214</a>                 }
-<a class="jxr_linenumber" name="215" href="#215">215</a>             } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> ClassCastException ex) {
-<a class="jxr_linenumber" name="216" href="#216">216</a>                 <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"No date time pattern for locale: "</span> + locale);
-<a class="jxr_linenumber" name="217" href="#217">217</a>             }
-<a class="jxr_linenumber" name="218" href="#218">218</a>         }
-<a class="jxr_linenumber" name="219" href="#219">219</a>         <strong class="jxr_keyword">return</strong> pattern;
-<a class="jxr_linenumber" name="220" href="#220">220</a>     }
-<a class="jxr_linenumber" name="221" href="#221">221</a> 
-<a class="jxr_linenumber" name="222" href="#222">222</a>     <em class="jxr_comment">// ----------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="223" href="#223">223</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="224" href="#224">224</a> <em class="jxr_javadoccomment">     * &lt;p&gt;Helper class to hold multi-part Map keys&lt;/p&gt;</em>
-<a class="jxr_linenumber" name="225" href="#225">225</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="226" href="#226">226</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">class</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a> {
-<a class="jxr_linenumber" name="227" href="#227">227</a>         <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">final</strong> Object[] keys;
-<a class="jxr_linenumber" name="228" href="#228">228</a>         <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">int</strong> hashCode;
-<a class="jxr_linenumber" name="229" href="#229">229</a> 
-<a class="jxr_linenumber" name="230" href="#230">230</a>         <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="231" href="#231">231</a> <em class="jxr_javadoccomment">         * Constructs an instance of &lt;code&gt;MultipartKey&lt;/code&gt; to hold the specified objects.</em>
-<a class="jxr_linenumber" name="232" href="#232">232</a> <em class="jxr_javadoccomment">         * @param keys the set of objects that make up the key.  Each key may be null.</em>
-<a class="jxr_linenumber" name="233" href="#233">233</a> <em class="jxr_javadoccomment">         */</em>
-<a class="jxr_linenumber" name="234" href="#234">234</a>         <strong class="jxr_keyword">public</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a>(<strong class="jxr_keyword">final</strong> Object... keys) {
-<a class="jxr_linenumber" name="235" href="#235">235</a>             <strong class="jxr_keyword">this</strong>.keys = keys;
-<a class="jxr_linenumber" name="236" href="#236">236</a>         }
-<a class="jxr_linenumber" name="237" href="#237">237</a> 
-<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">         * {@inheritDoc}</em>
-<a class="jxr_linenumber" name="240" href="#240">240</a> <em class="jxr_javadoccomment">         */</em>
-<a class="jxr_linenumber" name="241" href="#241">241</a>         @Override
-<a class="jxr_linenumber" name="242" href="#242">242</a>         <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> equals(<strong class="jxr_keyword">final</strong> Object obj) {
-<a class="jxr_linenumber" name="243" href="#243">243</a>             <em class="jxr_comment">// Eliminate the usual boilerplate because</em>
-<a class="jxr_linenumber" name="244" href="#244">244</a>             <em class="jxr_comment">// this inner static class is only used in a generic ConcurrentHashMap</em>
-<a class="jxr_linenumber" name="245" href="#245">245</a>             <em class="jxr_comment">// which will not compare against other Object types</em>
-<a class="jxr_linenumber" name="246" href="#246">246</a>             <strong class="jxr_keyword">return</strong> Arrays.equals(keys, ((MultipartKey)obj).keys);
-<a class="jxr_linenumber" name="247" href="#247">247</a>         }
-<a class="jxr_linenumber" name="248" href="#248">248</a> 
-<a class="jxr_linenumber" name="249" href="#249">249</a>         <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="250" href="#250">250</a> <em class="jxr_javadoccomment">         * {@inheritDoc}</em>
-<a class="jxr_linenumber" name="251" href="#251">251</a> <em class="jxr_javadoccomment">         */</em>
-<a class="jxr_linenumber" name="252" href="#252">252</a>         @Override
-<a class="jxr_linenumber" name="253" href="#253">253</a>         <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">int</strong> hashCode() {
-<a class="jxr_linenumber" name="254" href="#254">254</a>             <strong class="jxr_keyword">if</strong>(hashCode==0) {
-<a class="jxr_linenumber" name="255" href="#255">255</a>                 <strong class="jxr_keyword">int</strong> rc= 0;
-<a class="jxr_linenumber" name="256" href="#256">256</a>                 <strong class="jxr_keyword">for</strong>(<strong class="jxr_keyword">final</strong> Object key : keys) {
-<a class="jxr_linenumber" name="257" href="#257">257</a>                     <strong class="jxr_keyword">if</strong>(key!=<strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="258" href="#258">258</a>                         rc= rc*7 + key.hashCode();
-<a class="jxr_linenumber" name="259" href="#259">259</a>                     }
-<a class="jxr_linenumber" name="260" href="#260">260</a>                 }
-<a class="jxr_linenumber" name="261" href="#261">261</a>                 hashCode= rc;
-<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> hashCode;
-<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> 
-<a class="jxr_linenumber" name="267" href="#267">267</a> }
+<a class="jxr_linenumber" name="163" href="#163">163</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="164" href="#164">164</a> <em class="jxr_javadoccomment">     * &lt;p&gt;Gets a time formatter instance using the specified style,</em>
+<a class="jxr_linenumber" name="165" href="#165">165</a> <em class="jxr_javadoccomment">     * time zone and locale.&lt;/p&gt;</em>
+<a class="jxr_linenumber" name="166" href="#166">166</a> <em class="jxr_javadoccomment">     * </em>
+<a class="jxr_linenumber" name="167" href="#167">167</a> <em class="jxr_javadoccomment">     * @param timeStyle  time style: FULL, LONG, MEDIUM, or SHORT</em>
+<a class="jxr_linenumber" name="168" href="#168">168</a> <em class="jxr_javadoccomment">     * @param timeZone  optional time zone, overrides time zone of</em>
+<a class="jxr_linenumber" name="169" href="#169">169</a> <em class="jxr_javadoccomment">     *  formatted date, null means use default Locale</em>
+<a class="jxr_linenumber" name="170" href="#170">170</a> <em class="jxr_javadoccomment">     * @param locale  optional locale, overrides system locale</em>
+<a class="jxr_linenumber" name="171" href="#171">171</a> <em class="jxr_javadoccomment">     * @return a localized standard date/time formatter</em>
+<a class="jxr_linenumber" name="172" href="#172">172</a> <em class="jxr_javadoccomment">     * @throws IllegalArgumentException if the Locale has no date/time</em>
+<a class="jxr_linenumber" name="173" href="#173">173</a> <em class="jxr_javadoccomment">     *  pattern defined</em>
+<a class="jxr_linenumber" name="174" href="#174">174</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="175" href="#175">175</a>     <em class="jxr_comment">// package protected, for access from FastDateFormat; do not make public or protected</em>
+<a class="jxr_linenumber" name="176" href="#176">176</a>     F getTimeInstance(<strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> timeStyle, <strong class="jxr_keyword">final</strong> TimeZone timeZone, Locale locale) {
+<a class="jxr_linenumber" name="177" href="#177">177</a>         <strong class="jxr_keyword">return</strong> getDateTimeInstance(<strong class="jxr_keyword">null</strong>, Integer.valueOf(timeStyle), timeZone, locale);
+<a class="jxr_linenumber" name="178" href="#178">178</a>     }
+<a class="jxr_linenumber" name="179" href="#179">179</a> 
+<a class="jxr_linenumber" name="180" href="#180">180</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="181" href="#181">181</a> <em class="jxr_javadoccomment">     * &lt;p&gt;Gets a date/time format for the specified styles and locale.&lt;/p&gt;</em>
+<a class="jxr_linenumber" name="182" href="#182">182</a> <em class="jxr_javadoccomment">     * </em>
+<a class="jxr_linenumber" name="183" href="#183">183</a> <em class="jxr_javadoccomment">     * @param dateStyle  date style: FULL, LONG, MEDIUM, or SHORT, null indicates no date in format</em>
+<a class="jxr_linenumber" name="184" href="#184">184</a> <em class="jxr_javadoccomment">     * @param timeStyle  time style: FULL, LONG, MEDIUM, or SHORT, null indicates no time in format</em>
+<a class="jxr_linenumber" name="185" href="#185">185</a> <em class="jxr_javadoccomment">     * @param locale  The non-null locale of the desired format</em>
+<a class="jxr_linenumber" name="186" href="#186">186</a> <em class="jxr_javadoccomment">     * @return a localized standard date/time format</em>
+<a class="jxr_linenumber" name="187" href="#187">187</a> <em class="jxr_javadoccomment">     * @throws IllegalArgumentException if the Locale has no date/time pattern defined</em>
+<a class="jxr_linenumber" name="188" href="#188">188</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="189" href="#189">189</a>     <em class="jxr_comment">// package protected, for access from test code; do not make public or protected</em>
+<a class="jxr_linenumber" name="190" href="#190">190</a>     <strong class="jxr_keyword">static</strong> String getPatternForStyle(<strong class="jxr_keyword">final</strong> Integer dateStyle, <strong class="jxr_keyword">final</strong> Integer timeStyle, <strong class="jxr_keyword">final</strong> Locale locale) {
+<a class="jxr_linenumber" name="191" href="#191">191</a>         <strong class="jxr_keyword">final</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a> key = <strong class="jxr_keyword">new</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a>(dateStyle, timeStyle, locale);
+<a class="jxr_linenumber" name="192" href="#192">192</a> 
+<a class="jxr_linenumber" name="193" href="#193">193</a>         String pattern = cDateTimeInstanceCache.get(key);
+<a class="jxr_linenumber" name="194" href="#194">194</a>         <strong class="jxr_keyword">if</strong> (pattern == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="195" href="#195">195</a>             <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="196" href="#196">196</a>                 DateFormat formatter;
+<a class="jxr_linenumber" name="197" href="#197">197</a>                 <strong class="jxr_keyword">if</strong> (dateStyle == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="198" href="#198">198</a>                     formatter = DateFormat.getTimeInstance(timeStyle.intValue(), locale);                    
+<a class="jxr_linenumber" name="199" href="#199">199</a>                 }
+<a class="jxr_linenumber" name="200" href="#200">200</a>                 <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (timeStyle == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="201" href="#201">201</a>                     formatter = DateFormat.getDateInstance(dateStyle.intValue(), locale);                    
+<a class="jxr_linenumber" name="202" href="#202">202</a>                 }
+<a class="jxr_linenumber" name="203" href="#203">203</a>                 <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="204" href="#204">204</a>                     formatter = DateFormat.getDateTimeInstance(dateStyle.intValue(), timeStyle.intValue(), locale);
+<a class="jxr_linenumber" name="205" href="#205">205</a>                 }
+<a class="jxr_linenumber" name="206" href="#206">206</a>                 pattern = ((SimpleDateFormat)formatter).toPattern();
+<a class="jxr_linenumber" name="207" href="#207">207</a>                 <strong class="jxr_keyword">final</strong> String previous = cDateTimeInstanceCache.putIfAbsent(key, pattern);
+<a class="jxr_linenumber" name="208" href="#208">208</a>                 <strong class="jxr_keyword">if</strong> (previous != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="209" href="#209">209</a>                     <em class="jxr_comment">// even though it doesn't matter if another thread put the pattern</em>
+<a class="jxr_linenumber" name="210" href="#210">210</a>                     <em class="jxr_comment">// it's still good practice to return the String instance that is</em>
+<a class="jxr_linenumber" name="211" href="#211">211</a>                     <em class="jxr_comment">// actually in the ConcurrentMap</em>
+<a class="jxr_linenumber" name="212" href="#212">212</a>                     pattern= previous;
+<a class="jxr_linenumber" name="213" href="#213">213</a>                 }
+<a class="jxr_linenumber" name="214" href="#214">214</a>             } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> ClassCastException ex) {
+<a class="jxr_linenumber" name="215" href="#215">215</a>                 <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"No date time pattern for locale: "</span> + locale);
+<a class="jxr_linenumber" name="216" href="#216">216</a>             }
+<a class="jxr_linenumber" name="217" href="#217">217</a>         }
+<a class="jxr_linenumber" name="218" href="#218">218</a>         <strong class="jxr_keyword">return</strong> pattern;
+<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>     <em class="jxr_comment">// ----------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="222" href="#222">222</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="223" href="#223">223</a> <em class="jxr_javadoccomment">     * &lt;p&gt;Helper class to hold multi-part Map keys&lt;/p&gt;</em>
+<a class="jxr_linenumber" name="224" href="#224">224</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="225" href="#225">225</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">class</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a> {
+<a class="jxr_linenumber" name="226" href="#226">226</a>         <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">final</strong> Object[] keys;
+<a class="jxr_linenumber" name="227" href="#227">227</a>         <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">int</strong> hashCode;
+<a class="jxr_linenumber" name="228" href="#228">228</a> 
+<a class="jxr_linenumber" name="229" href="#229">229</a>         <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="230" href="#230">230</a> <em class="jxr_javadoccomment">         * Constructs an instance of &lt;code&gt;MultipartKey&lt;/code&gt; to hold the specified objects.</em>
+<a class="jxr_linenumber" name="231" href="#231">231</a> <em class="jxr_javadoccomment">         * @param keys the set of objects that make up the key.  Each key may be null.</em>
+<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>         <strong class="jxr_keyword">public</strong> <a href="../../../../../org/apache/commons/lang3/time/FormatCache.html">MultipartKey</a>(<strong class="jxr_keyword">final</strong> Object... keys) {
+<a class="jxr_linenumber" name="234" href="#234">234</a>             <strong class="jxr_keyword">this</strong>.keys = keys;
+<a class="jxr_linenumber" name="235" href="#235">235</a>         }
+<a class="jxr_linenumber" name="236" href="#236">236</a> 
+<a class="jxr_linenumber" name="237" href="#237">237</a>         <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="238" href="#238">238</a> <em class="jxr_javadoccomment">         * {@inheritDoc}</em>
+<a class="jxr_linenumber" name="239" href="#239">239</a> <em class="jxr_javadoccomment">         */</em>
+<a class="jxr_linenumber" name="240" href="#240">240</a>         @Override
+<a class="jxr_linenumber" name="241" href="#241">241</a>         <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> equals(<strong class="jxr_keyword">final</strong> Object obj) {
+<a class="jxr_linenumber" name="242" href="#242">242</a>             <em class="jxr_comment">// Eliminate the usual boilerplate because</em>
+<a class="jxr_linenumber" name="243" href="#243">243</a>             <em class="jxr_comment">// this inner static class is only used in a generic ConcurrentHashMap</em>
+<a class="jxr_linenumber" name="244" href="#244">244</a>             <em class="jxr_comment">// which will not compare against other Object types</em>
+<a class="jxr_linenumber" name="245" href="#245">245</a>             <strong class="jxr_keyword">return</strong> Arrays.equals(keys, ((MultipartKey)obj).keys);
+<a class="jxr_linenumber" name="246" href="#246">246</a>         }
+<a class="jxr_linenumber" name="247" href="#247">247</a> 
+<a class="jxr_linenumber" name="248" href="#248">248</a>         <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="249" href="#249">249</a> <em class="jxr_javadoccomment">         * {@inheritDoc}</em>
+<a class="jxr_linenumber" name="250" href="#250">250</a> <em class="jxr_javadoccomment">         */</em>
+<a class="jxr_linenumber" name="251" href="#251">251</a>         @Override
+<a class="jxr_linenumber" name="252" href="#252">252</a>         <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">int</strong> hashCode() {
+<a class="jxr_linenumber" name="253" href="#253">253</a>             <strong class="jxr_keyword">if</strong>(hashCode==0) {
+<a class="jxr_linenumber" name="254" href="#254">254</a>                 <strong class="jxr_keyword">int</strong> rc= 0;
+<a class="jxr_linenumber" name="255" href="#255">255</a>                 <strong class="jxr_keyword">for</strong>(<strong class="jxr_keyword">final</strong> Object key : keys) {
+<a class="jxr_linenumber" name="256" href="#256">256</a>                     <strong class="jxr_keyword">if</strong>(key!=<strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="257" href="#257">257</a>                         rc= rc*7 + key.hashCode();
+<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>                 hashCode= rc;
+<a class="jxr_linenumber" name="261" href="#261">261</a>             }
+<a class="jxr_linenumber" name="262" href="#262">262</a>             <strong class="jxr_keyword">return</strong> hashCode;
+<a class="jxr_linenumber" name="263" href="#263">263</a>         }
+<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> }
 </pre>
 <hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
 </html>