1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<!--NewPage--> 3<HTML> 4<HEAD> 5<!-- Generated by javadoc (build 1.6.0-google-internal) on Mon Jan 04 20:48:00 PST 2010 --> 6<TITLE> 7NamingThreadFactory (Guava Libraries 2010.01.04) 8</TITLE> 9 10<META NAME="date" CONTENT="2010-01-04"> 11 12<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style"> 13 14<SCRIPT type="text/javascript"> 15function windowTitle() 16{ 17 if (location.href.indexOf('is-external=true') == -1) { 18 parent.document.title="NamingThreadFactory (Guava Libraries 2010.01.04)"; 19 } 20} 21</SCRIPT> 22<NOSCRIPT> 23</NOSCRIPT> 24 25</HEAD> 26 27<BODY BGCOLOR="white" onload="windowTitle();"> 28<HR> 29 30 31<!-- ========= START OF TOP NAVBAR ======= --> 32<A NAME="navbar_top"><!-- --></A> 33<A HREF="#skip-navbar_top" title="Skip navigation links"></A> 34<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 35<TR> 36<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 37<A NAME="navbar_top_firstrow"><!-- --></A> 38<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 39 <TR ALIGN="center" VALIGN="top"> 40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 42 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/NamingThreadFactory.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 45 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 46 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 47 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 48 </TR> 49</TABLE> 50</TD> 51<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 52</EM> 53</TD> 54</TR> 55 56<TR> 57<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 58 <A HREF="../../../../../com/google/common/util/concurrent/ListenableFutureTask.html" title="class in com.google.common.util.concurrent"><B>PREV CLASS</B></A> 59 <A HREF="../../../../../com/google/common/util/concurrent/SimpleTimeLimiter.html" title="class in com.google.common.util.concurrent"><B>NEXT CLASS</B></A></FONT></TD> 60<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 61 <A HREF="../../../../../index.html?com/google/common/util/concurrent/NamingThreadFactory.html" target="_top"><B>FRAMES</B></A> 62 <A HREF="NamingThreadFactory.html" target="_top"><B>NO FRAMES</B></A> 63 <SCRIPT type="text/javascript"> 64 <!-- 65 if(window==top) { 66 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>'); 67 } 68 //--> 69</SCRIPT> 70<NOSCRIPT> 71 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A> 72</NOSCRIPT> 73 74 75</FONT></TD> 76</TR> 77<TR> 78<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 79 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 80<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 81DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 82</TR> 83</TABLE> 84<A NAME="skip-navbar_top"></A> 85<!-- ========= END OF TOP NAVBAR ========= --> 86 87<HR> 88<!-- ======== START OF CLASS DATA ======== --> 89<H2> 90<FONT SIZE="-1"> 91com.google.common.util.concurrent</FONT> 92<BR> 93Class NamingThreadFactory</H2> 94<PRE> 95<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A> 96 <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>com.google.common.util.concurrent.NamingThreadFactory</B> 97</PRE> 98<DL> 99<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A></DD> 100</DL> 101<HR> 102<DL> 103<DT><PRE>public class <B>NamingThreadFactory</B><DT>extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A></DL> 104</PRE> 105 106<P> 107A ThreadFactory which decorates another ThreadFactory to set a name on 108 each thread created. 109<P> 110 111<P> 112<DL> 113<DT><B>Since:</B></DT> 114 <DD>2009.09.15 <b>tentative</b></DD> 115<DT><B>Author:</B></DT> 116 <DD>Kevin Bourrillion</DD> 117</DL> 118<HR> 119 120<P> 121<!-- =========== FIELD SUMMARY =========== --> 122 123<A NAME="field_summary"><!-- --></A> 124<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 125<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 126<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 127<B>Field Summary</B></FONT></TH> 128</TR> 129<TR BGCOLOR="white" CLASS="TableRowColor"> 130<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 131<CODE>static <A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A></CODE></FONT></TD> 132<TD><CODE><B><A HREF="../../../../../com/google/common/util/concurrent/NamingThreadFactory.html#DEFAULT_FACTORY">DEFAULT_FACTORY</A></B></CODE> 133 134<BR> 135 </TD> 136</TR> 137</TABLE> 138 139<!-- ======== CONSTRUCTOR SUMMARY ======== --> 140 141<A NAME="constructor_summary"><!-- --></A> 142<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 143<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 144<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 145<B>Constructor Summary</B></FONT></TH> 146</TR> 147<TR BGCOLOR="white" CLASS="TableRowColor"> 148<TD><CODE><B><A HREF="../../../../../com/google/common/util/concurrent/NamingThreadFactory.html#NamingThreadFactory(java.lang.String)">NamingThreadFactory</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> format)</CODE> 149 150<BR> 151 Creates a new factory that delegates to the default thread factory for 152 thread creation, then uses <code>format</code> to construct a name for the new 153 thread.</TD> 154</TR> 155<TR BGCOLOR="white" CLASS="TableRowColor"> 156<TD><CODE><B><A HREF="../../../../../com/google/common/util/concurrent/NamingThreadFactory.html#NamingThreadFactory(java.lang.String, java.util.concurrent.ThreadFactory)">NamingThreadFactory</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> format, 157 <A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A> backingFactory)</CODE> 158 159<BR> 160 Creates a new factory that delegates to <code>backingFactory</code> for thread 161 creation, then uses <code>format</code> to construct a name for the new thread.</TD> 162</TR> 163</TABLE> 164 165<!-- ========== METHOD SUMMARY =========== --> 166 167<A NAME="method_summary"><!-- --></A> 168<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 169<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 170<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> 171<B>Method Summary</B></FONT></TH> 172</TR> 173<TR BGCOLOR="white" CLASS="TableRowColor"> 174<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> 175<CODE> <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Thread.html?is-external=true" title="class or interface in java.lang">Thread</A></CODE></FONT></TD> 176<TD><CODE><B><A HREF="../../../../../com/google/common/util/concurrent/NamingThreadFactory.html#newThread(java.lang.Runnable)">newThread</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</A> r)</CODE> 177 178<BR> 179 </TD> 180</TR> 181</TABLE> 182 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> 183<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 184<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> 185<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH> 186</TR> 187<TR BGCOLOR="white" CLASS="TableRowColor"> 188<TD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> 189</TR> 190</TABLE> 191 192<P> 193 194<!-- ============ FIELD DETAIL =========== --> 195 196<A NAME="field_detail"><!-- --></A> 197<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 198<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 199<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 200<B>Field Detail</B></FONT></TH> 201</TR> 202</TABLE> 203 204<A NAME="DEFAULT_FACTORY"><!-- --></A><H3> 205DEFAULT_FACTORY</H3> 206<PRE> 207public static final <A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A> <B>DEFAULT_FACTORY</B></PRE> 208<DL> 209<DL> 210</DL> 211</DL> 212 213<!-- ========= CONSTRUCTOR DETAIL ======== --> 214 215<A NAME="constructor_detail"><!-- --></A> 216<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 217<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 218<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 219<B>Constructor Detail</B></FONT></TH> 220</TR> 221</TABLE> 222 223<A NAME="NamingThreadFactory(java.lang.String)"><!-- --></A><H3> 224NamingThreadFactory</H3> 225<PRE> 226public <B>NamingThreadFactory</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> format)</PRE> 227<DL> 228<DD>Creates a new factory that delegates to the default thread factory for 229 thread creation, then uses <code>format</code> to construct a name for the new 230 thread. 231<P> 232<DL> 233<DT><B>Parameters:</B><DD><CODE>format</CODE> - a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#format(java.lang.String, java.lang.Object...)" title="class or interface in java.lang"><CODE>String.format(String, Object...)</CODE></A>-compatible format 234 String, to which a unique integer (0, 1, etc.) will be supplied as the 235 single parameter. This integer will be unique to this instance of 236 NamingThreadFactory and will be assigned sequentially.</DL> 237</DL> 238<HR> 239 240<A NAME="NamingThreadFactory(java.lang.String, java.util.concurrent.ThreadFactory)"><!-- --></A><H3> 241NamingThreadFactory</H3> 242<PRE> 243public <B>NamingThreadFactory</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> format, 244 <A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A> backingFactory)</PRE> 245<DL> 246<DD>Creates a new factory that delegates to <code>backingFactory</code> for thread 247 creation, then uses <code>format</code> to construct a name for the new thread. 248<P> 249<DL> 250<DT><B>Parameters:</B><DD><CODE>format</CODE> - a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#format(java.lang.String, java.lang.Object...)" title="class or interface in java.lang"><CODE>String.format(String, Object...)</CODE></A>-compatible format 251 String, to which a unique integer (0, 1, etc.) will be supplied as the 252 single parameter<DD><CODE>backingFactory</CODE> - the factory that will actually create the threads 253<DT><B>Throws:</B> 254<DD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/util/IllegalFormatException.html?is-external=true" title="class or interface in java.util">IllegalFormatException</A></CODE> - if <code>format</code> is invalid</DL> 255</DL> 256 257<!-- ============ METHOD DETAIL ========== --> 258 259<A NAME="method_detail"><!-- --></A> 260<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> 261<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> 262<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> 263<B>Method Detail</B></FONT></TH> 264</TR> 265</TABLE> 266 267<A NAME="newThread(java.lang.Runnable)"><!-- --></A><H3> 268newThread</H3> 269<PRE> 270public <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Thread.html?is-external=true" title="class or interface in java.lang">Thread</A> <B>newThread</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</A> r)</PRE> 271<DL> 272<DD><DL> 273<DT><B>Specified by:</B><DD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true#newThread(java.lang.Runnable)" title="class or interface in java.util.concurrent">newThread</A></CODE> in interface <CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/util/concurrent/ThreadFactory.html?is-external=true" title="class or interface in java.util.concurrent">ThreadFactory</A></CODE></DL> 274</DD> 275<DD><DL> 276</DL> 277</DD> 278</DL> 279<!-- ========= END OF CLASS DATA ========= --> 280<HR> 281 282 283<!-- ======= START OF BOTTOM NAVBAR ====== --> 284<A NAME="navbar_bottom"><!-- --></A> 285<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> 286<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> 287<TR> 288<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> 289<A NAME="navbar_bottom_firstrow"><!-- --></A> 290<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> 291 <TR ALIGN="center" VALIGN="top"> 292 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> 293 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> 294 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> 295 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/NamingThreadFactory.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> 296 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> 297 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> 298 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> 299 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> 300 </TR> 301</TABLE> 302</TD> 303<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> 304</EM> 305</TD> 306</TR> 307 308<TR> 309<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 310 <A HREF="../../../../../com/google/common/util/concurrent/ListenableFutureTask.html" title="class in com.google.common.util.concurrent"><B>PREV CLASS</B></A> 311 <A HREF="../../../../../com/google/common/util/concurrent/SimpleTimeLimiter.html" title="class in com.google.common.util.concurrent"><B>NEXT CLASS</B></A></FONT></TD> 312<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> 313 <A HREF="../../../../../index.html?com/google/common/util/concurrent/NamingThreadFactory.html" target="_top"><B>FRAMES</B></A> 314 <A HREF="NamingThreadFactory.html" target="_top"><B>NO FRAMES</B></A> 315 <SCRIPT type="text/javascript"> 316 <!-- 317 if(window==top) { 318 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>'); 319 } 320 //--> 321</SCRIPT> 322<NOSCRIPT> 323 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A> 324</NOSCRIPT> 325 326 327</FONT></TD> 328</TR> 329<TR> 330<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 331 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> 332<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 333DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> 334</TR> 335</TABLE> 336<A NAME="skip-navbar_bottom"></A> 337<!-- ======== END OF BOTTOM NAVBAR ======= --> 338 339<HR> 340 341</BODY> 342</HTML> 343