~ubuntu-branches/ubuntu/hardy/commons-httpclient/hardy

« back to all changes in this revision

Viewing changes to docs/xref/org/apache/commons/httpclient/protocol/Protocol.html

  • Committer: Bazaar Package Importer
  • Author(s): Michael Meskes
  • Date: 2006-09-15 20:07:43 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20060915200743-t2md4cgfsb07wgn7
Tags: 3.0.1-0.1
* Non-maintainer upload.
* Bump debhelper Build-Depends to (>= 4.1.0) as required by cdbs' 
  debhelper.mk
* Put the coppyright holders in debian/copyright
* Include the jar file in the package. (Closes: #381354)
* Only include one copy of the docs.
  done by James Westby <jw+debian@jameswestby.net>  Mon, 14 Aug 2006 02:29:47 +0100

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<div id="overview"><a href="../../../../../../apidocs/org/apache/commons/httpclient/protocol/Protocol.html">View Javadoc</a></div><pre>
9
9
 
10
10
<a name="1" href="#1">1</a>   <em class="comment">/*</em>
11
 
<a name="2" href="#2">2</a>   <em class="comment"> * $Header: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/protocol/Protocol.java,v 1.5.2.2 2004/02/22 18:21:16 olegk Exp $</em>
12
 
<a name="3" href="#3">3</a>   <em class="comment"> * $Revision: 1.5.2.2 $</em>
13
 
<a name="4" href="#4">4</a>   <em class="comment"> * $Date: 2004/02/22 18:21:16 $</em>
 
11
<a name="2" href="#2">2</a>   <em class="comment"> * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/protocol/Protocol.java,v 1.10 2004/04/18 23:51:38 jsdever Exp $</em>
 
12
<a name="3" href="#3">3</a>   <em class="comment"> * $Revision: 157457 $</em>
 
13
<a name="4" href="#4">4</a>   <em class="comment"> * $Date: 2005-03-14 15:23:16 -0500 (Mon, 14 Mar 2005) $</em>
14
14
<a name="5" href="#5">5</a>   <em class="comment"> *</em>
15
15
<a name="6" href="#6">6</a>   <em class="comment"> * ====================================================================</em>
16
16
<a name="7" href="#7">7</a>   <em class="comment"> *</em>
34
34
<a name="25" href="#25">25</a>  <em class="comment"> * information on the Apache Software Foundation, please see</em>
35
35
<a name="26" href="#26">26</a>  <em class="comment"> * &lt;<a href="http://www.apache.org/" target="alexandria_uri">http://www.apache.org/</a>>.</em>
36
36
<a name="27" href="#27">27</a>  <em class="comment"> *</em>
37
 
<a name="28" href="#28">28</a>  <em class="comment"> * [Additional notices, if required by prior licensing conditions]</em>
38
 
<a name="29" href="#29">29</a>  <em class="comment"> *</em>
39
 
<a name="30" href="#30">30</a>  <em class="comment"> */</em>
40
 
<a name="31" href="#31">31</a>  <strong>package</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/package-summary.html">org.apache.commons.httpclient.protocol</a>;
41
 
<a name="32" href="#32">32</a>  
42
 
<a name="33" href="#33">33</a>  <strong>import</strong> java.util.Collections;
43
 
<a name="34" href="#34">34</a>  <strong>import</strong> java.util.HashMap;
44
 
<a name="35" href="#35">35</a>  <strong>import</strong> java.util.Map;
 
37
<a name="28" href="#28">28</a>  <em class="comment"> */</em>
 
38
<a name="29" href="#29">29</a>  <strong>package</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/package-summary.html">org.apache.commons.httpclient.protocol</a>;
 
39
<a name="30" href="#30">30</a>  
 
40
<a name="31" href="#31">31</a>  <strong>import</strong> java.util.Collections;
 
41
<a name="32" href="#32">32</a>  <strong>import</strong> java.util.HashMap;
 
42
<a name="33" href="#33">33</a>  <strong>import</strong> java.util.Map;
 
43
<a name="34" href="#34">34</a>  
 
44
<a name="35" href="#35">35</a>  <strong>import</strong> org.apache.commons.httpclient.util.LangUtils;
45
45
<a name="36" href="#36">36</a>  
46
46
<a name="37" href="#37">37</a>  <em>/**<em>*</em></em>
47
47
<a name="38" href="#38">38</a>  <em> * A class to encapsulate the specifics of a protocol.  This class class also</em>
171
171
<a name="162" href="#162">162</a>     <strong>private</strong> <strong>boolean</strong> secure;
172
172
<a name="163" href="#163">163</a>   
173
173
<a name="164" href="#164">164</a>     <em>/**<em>*</em></em>
174
 
<a name="165" href="#165">165</a> <em>     * Constructs a new Protocol.  The created protcol is insecure.</em>
175
 
<a name="166" href="#166">166</a> <em>     * </em>
176
 
<a name="167" href="#167">167</a> <em>     * @param scheme the scheme (e.g. http, https)</em>
177
 
<a name="168" href="#168">168</a> <em>     * @param factory the factory for creating sockets for communication using</em>
178
 
<a name="169" href="#169">169</a> <em>     * this protocol</em>
179
 
<a name="170" href="#170">170</a> <em>     * @param defaultPort the port this protocol defaults to</em>
180
 
<a name="171" href="#171">171</a> <em>     */</em>
181
 
<a name="172" href="#172">172</a>     <strong>public</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/Protocol.html">Protocol</a>(String scheme, <a href="../../../../../org/apache/commons/httpclient/protocol/ProtocolSocketFactory.html">ProtocolSocketFactory</a> factory, <strong>int</strong> defaultPort) {
182
 
<a name="173" href="#173">173</a>         
183
 
<a name="174" href="#174">174</a>         <strong>if</strong> (scheme == <strong>null</strong>) {
184
 
<a name="175" href="#175">175</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"scheme is null"</span>);
185
 
<a name="176" href="#176">176</a>         }
186
 
<a name="177" href="#177">177</a>         <strong>if</strong> (factory == <strong>null</strong>) {
187
 
<a name="178" href="#178">178</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"socketFactory is null"</span>);
188
 
<a name="179" href="#179">179</a>         }
189
 
<a name="180" href="#180">180</a>         <strong>if</strong> (defaultPort &lt;= 0) {
190
 
<a name="181" href="#181">181</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"port is invalid: "</span> + defaultPort);
191
 
<a name="182" href="#182">182</a>         }
192
 
<a name="183" href="#183">183</a>         
193
 
<a name="184" href="#184">184</a>         <strong>this</strong>.scheme = scheme;
194
 
<a name="185" href="#185">185</a>         <strong>this</strong>.socketFactory = factory;
195
 
<a name="186" href="#186">186</a>         <strong>this</strong>.defaultPort = defaultPort;
196
 
<a name="187" href="#187">187</a>         <strong>this</strong>.secure = false;
197
 
<a name="188" href="#188">188</a>     }
198
 
<a name="189" href="#189">189</a>     
199
 
<a name="190" href="#190">190</a>     <em>/**<em>*</em></em>
200
 
<a name="191" href="#191">191</a> <em>     * Constructs a new Protocol.  The created protcol is secure.</em>
201
 
<a name="192" href="#192">192</a> <em>     *</em>
202
 
<a name="193" href="#193">193</a> <em>     * @param scheme the scheme (e.g. http, https)</em>
203
 
<a name="194" href="#194">194</a> <em>     * @param factory the factory for creating sockets for communication using</em>
204
 
<a name="195" href="#195">195</a> <em>     * this protocol</em>
205
 
<a name="196" href="#196">196</a> <em>     * @param defaultPort the port this protocol defaults to</em>
206
 
<a name="197" href="#197">197</a> <em>     */</em>
207
 
<a name="198" href="#198">198</a>     <strong>public</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/Protocol.html">Protocol</a>(String scheme, 
208
 
<a name="199" href="#199">199</a>         <a href="../../../../../org/apache/commons/httpclient/protocol/SecureProtocolSocketFactory.html">SecureProtocolSocketFactory</a> factory, <strong>int</strong> defaultPort) {
209
 
<a name="200" href="#200">200</a>         
210
 
<a name="201" href="#201">201</a>         <strong>if</strong> (scheme == <strong>null</strong>) {
211
 
<a name="202" href="#202">202</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"scheme is null"</span>);
212
 
<a name="203" href="#203">203</a>         }
213
 
<a name="204" href="#204">204</a>         <strong>if</strong> (factory == <strong>null</strong>) {
214
 
<a name="205" href="#205">205</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"socketFactory is null"</span>);
215
 
<a name="206" href="#206">206</a>         }
216
 
<a name="207" href="#207">207</a>         <strong>if</strong> (defaultPort &lt;= 0) {
217
 
<a name="208" href="#208">208</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"port is invalid: "</span> + defaultPort);
218
 
<a name="209" href="#209">209</a>         }
219
 
<a name="210" href="#210">210</a> 
220
 
<a name="211" href="#211">211</a>         <strong>this</strong>.scheme = scheme;
221
 
<a name="212" href="#212">212</a>         <strong>this</strong>.socketFactory = factory;
222
 
<a name="213" href="#213">213</a>         <strong>this</strong>.defaultPort = defaultPort;
223
 
<a name="214" href="#214">214</a>         <strong>this</strong>.secure = <strong>true</strong>;        
224
 
<a name="215" href="#215">215</a>     }
225
 
<a name="216" href="#216">216</a> 
226
 
<a name="217" href="#217">217</a>     <em>/**<em>*</em></em>
227
 
<a name="218" href="#218">218</a> <em>     * Returns the defaultPort.</em>
228
 
<a name="219" href="#219">219</a> <em>     * @return int</em>
229
 
<a name="220" href="#220">220</a> <em>     */</em>
230
 
<a name="221" href="#221">221</a>     <strong>public</strong> <strong>int</strong> getDefaultPort() {
231
 
<a name="222" href="#222">222</a>         <strong>return</strong> defaultPort;
232
 
<a name="223" href="#223">223</a>     }
233
 
<a name="224" href="#224">224</a> 
234
 
<a name="225" href="#225">225</a>     <em>/**<em>*</em></em>
235
 
<a name="226" href="#226">226</a> <em>     * Returns the socketFactory.  If secure the factory is a</em>
236
 
<a name="227" href="#227">227</a> <em>     * SecureProtocolSocketFactory.</em>
237
 
<a name="228" href="#228">228</a> <em>     * @return SocketFactory</em>
238
 
<a name="229" href="#229">229</a> <em>     */</em>
239
 
<a name="230" href="#230">230</a>     <strong>public</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/ProtocolSocketFactory.html">ProtocolSocketFactory</a> getSocketFactory() {
240
 
<a name="231" href="#231">231</a>         <strong>return</strong> socketFactory;
241
 
<a name="232" href="#232">232</a>     }
242
 
<a name="233" href="#233">233</a> 
243
 
<a name="234" href="#234">234</a>     <em>/**<em>*</em></em>
244
 
<a name="235" href="#235">235</a> <em>     * Returns the scheme.</em>
245
 
<a name="236" href="#236">236</a> <em>     * @return The scheme</em>
246
 
<a name="237" href="#237">237</a> <em>     */</em>
247
 
<a name="238" href="#238">238</a>     <strong>public</strong> String getScheme() {
248
 
<a name="239" href="#239">239</a>         <strong>return</strong> scheme;
249
 
<a name="240" href="#240">240</a>     }
250
 
<a name="241" href="#241">241</a> 
251
 
<a name="242" href="#242">242</a>     <em>/**<em>*</em></em>
252
 
<a name="243" href="#243">243</a> <em>     * Returns true if this protocol is secure</em>
253
 
<a name="244" href="#244">244</a> <em>     * @return true if this protocol is secure</em>
254
 
<a name="245" href="#245">245</a> <em>     */</em>
255
 
<a name="246" href="#246">246</a>     <strong>public</strong> <strong>boolean</strong> isSecure() {
256
 
<a name="247" href="#247">247</a>         <strong>return</strong> secure;
257
 
<a name="248" href="#248">248</a>     }
258
 
<a name="249" href="#249">249</a>     
259
 
<a name="250" href="#250">250</a>     <em>/**<em>*</em></em>
260
 
<a name="251" href="#251">251</a> <em>     * Resolves the correct port for this protocol.  Returns the given port if</em>
261
 
<a name="252" href="#252">252</a> <em>     * valid or the default port otherwise.</em>
262
 
<a name="253" href="#253">253</a> <em>     * </em>
263
 
<a name="254" href="#254">254</a> <em>     * @param port the port to be resolved</em>
264
 
<a name="255" href="#255">255</a> <em>     * </em>
265
 
<a name="256" href="#256">256</a> <em>     * @return the given port or the defaultPort</em>
266
 
<a name="257" href="#257">257</a> <em>     */</em>
267
 
<a name="258" href="#258">258</a>     <strong>public</strong> <strong>int</strong> resolvePort(<strong>int</strong> port) {
268
 
<a name="259" href="#259">259</a>         <strong>return</strong> port &lt;= 0 ? getDefaultPort() : port;
269
 
<a name="260" href="#260">260</a>     }
270
 
<a name="261" href="#261">261</a> 
271
 
<a name="262" href="#262">262</a>     <em>/**<em>*</em></em>
272
 
<a name="263" href="#263">263</a> <em>     * Return a string representation of this object.</em>
273
 
<a name="264" href="#264">264</a> <em>     * @return a string representation of this object.</em>
274
 
<a name="265" href="#265">265</a> <em>     */</em>
275
 
<a name="266" href="#266">266</a>     <strong>public</strong> String toString() {
276
 
<a name="267" href="#267">267</a>         <strong>return</strong> scheme + <span class="string">":"</span> + defaultPort;
277
 
<a name="268" href="#268">268</a>     }
278
 
<a name="269" href="#269">269</a>     
279
 
<a name="270" href="#270">270</a>     <em>/**<em>*</em></em>
280
 
<a name="271" href="#271">271</a> <em>     * Return true if the specified object equals this object.</em>
281
 
<a name="272" href="#272">272</a> <em>     * @param obj The object to compare against.</em>
282
 
<a name="273" href="#273">273</a> <em>     * @return true if the objects are equal.</em>
283
 
<a name="274" href="#274">274</a> <em>     */</em>
284
 
<a name="275" href="#275">275</a>     <strong>public</strong> <strong>boolean</strong> equals(Object obj) {
285
 
<a name="276" href="#276">276</a>         
286
 
<a name="277" href="#277">277</a>         <strong>if</strong> (obj instanceof Protocol) {
287
 
<a name="278" href="#278">278</a>             
288
 
<a name="279" href="#279">279</a>             <a href="../../../../../org/apache/commons/httpclient/protocol/Protocol.html">Protocol</a> p = (Protocol) obj;
289
 
<a name="280" href="#280">280</a>             
290
 
<a name="281" href="#281">281</a>             <strong>return</strong> (
291
 
<a name="282" href="#282">282</a>                 defaultPort == p.getDefaultPort()
292
 
<a name="283" href="#283">283</a>                 &amp;&amp; scheme.equalsIgnoreCase(p.getScheme())
293
 
<a name="284" href="#284">284</a>                 &amp;&amp; secure == p.isSecure()
294
 
<a name="285" href="#285">285</a>                 &amp;&amp; socketFactory.equals(p.getSocketFactory()));
295
 
<a name="286" href="#286">286</a>             
296
 
<a name="287" href="#287">287</a>         } <strong>else</strong> {
297
 
<a name="288" href="#288">288</a>             <strong>return</strong> false;
298
 
<a name="289" href="#289">289</a>         }
299
 
<a name="290" href="#290">290</a>         
300
 
<a name="291" href="#291">291</a>     }
301
 
<a name="292" href="#292">292</a> 
302
 
<a name="293" href="#293">293</a>     <em>/**<em>*</em></em>
303
 
<a name="294" href="#294">294</a> <em>     * Return a hash code for this object</em>
304
 
<a name="295" href="#295">295</a> <em>     * @return The hash code.</em>
305
 
<a name="296" href="#296">296</a> <em>     */</em>
306
 
<a name="297" href="#297">297</a>     <strong>public</strong> <strong>int</strong> hashCode() {
307
 
<a name="298" href="#298">298</a>         <strong>return</strong> scheme.hashCode();
308
 
<a name="299" href="#299">299</a>     }
309
 
<a name="300" href="#300">300</a> }
 
174
<a name="165" href="#165">165</a> <em>     * Constructs a new Protocol. Whether the created protocol is secure depends on</em>
 
175
<a name="166" href="#166">166</a> <em>     * the class of &lt;code>factory&lt;/code>.</em>
 
176
<a name="167" href="#167">167</a> <em>     * </em>
 
177
<a name="168" href="#168">168</a> <em>     * @param scheme the scheme (e.g. http, https)</em>
 
178
<a name="169" href="#169">169</a> <em>     * @param factory the factory for creating sockets for communication using</em>
 
179
<a name="170" href="#170">170</a> <em>     * this protocol</em>
 
180
<a name="171" href="#171">171</a> <em>     * @param defaultPort the port this protocol defaults to</em>
 
181
<a name="172" href="#172">172</a> <em>     */</em>
 
182
<a name="173" href="#173">173</a>     <strong>public</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/Protocol.html">Protocol</a>(String scheme, <a href="../../../../../org/apache/commons/httpclient/protocol/ProtocolSocketFactory.html">ProtocolSocketFactory</a> factory, <strong>int</strong> defaultPort) {
 
183
<a name="174" href="#174">174</a>         
 
184
<a name="175" href="#175">175</a>         <strong>if</strong> (scheme == <strong>null</strong>) {
 
185
<a name="176" href="#176">176</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"scheme is null"</span>);
 
186
<a name="177" href="#177">177</a>         }
 
187
<a name="178" href="#178">178</a>         <strong>if</strong> (factory == <strong>null</strong>) {
 
188
<a name="179" href="#179">179</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"socketFactory is null"</span>);
 
189
<a name="180" href="#180">180</a>         }
 
190
<a name="181" href="#181">181</a>         <strong>if</strong> (defaultPort &lt;= 0) {
 
191
<a name="182" href="#182">182</a>             <strong>throw</strong> <strong>new</strong> IllegalArgumentException(<span class="string">"port is invalid: "</span> + defaultPort);
 
192
<a name="183" href="#183">183</a>         }
 
193
<a name="184" href="#184">184</a>         
 
194
<a name="185" href="#185">185</a>         <strong>this</strong>.scheme = scheme;
 
195
<a name="186" href="#186">186</a>         <strong>this</strong>.socketFactory = factory;
 
196
<a name="187" href="#187">187</a>         <strong>this</strong>.defaultPort = defaultPort;
 
197
<a name="188" href="#188">188</a>         <strong>this</strong>.secure = (factory instanceof SecureProtocolSocketFactory);
 
198
<a name="189" href="#189">189</a>     }
 
199
<a name="190" href="#190">190</a>     
 
200
<a name="191" href="#191">191</a>     <em>/**<em>*</em></em>
 
201
<a name="192" href="#192">192</a> <em>     * Constructs a new Protocol. Whether the created protocol is secure depends on</em>
 
202
<a name="193" href="#193">193</a> <em>     * the class of &lt;code>factory&lt;/code>.</em>
 
203
<a name="194" href="#194">194</a> <em>     *</em>
 
204
<a name="195" href="#195">195</a> <em>     * @param scheme the scheme (e.g. http, https)</em>
 
205
<a name="196" href="#196">196</a> <em>     * @param factory the factory for creating sockets for communication using</em>
 
206
<a name="197" href="#197">197</a> <em>     * this protocol</em>
 
207
<a name="198" href="#198">198</a> <em>     * @param defaultPort the port this protocol defaults to</em>
 
208
<a name="199" href="#199">199</a> <em>     * @deprecated Use the constructor that uses ProtocolSocketFactory, this version of</em>
 
209
<a name="200" href="#200">200</a> <em>     * the constructor is only kept for backwards API compatibility.</em>
 
210
<a name="201" href="#201">201</a> <em>     */</em>
 
211
<a name="202" href="#202">202</a>     <strong>public</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/Protocol.html">Protocol</a>(String scheme, 
 
212
<a name="203" href="#203">203</a>         <a href="../../../../../org/apache/commons/httpclient/protocol/SecureProtocolSocketFactory.html">SecureProtocolSocketFactory</a> factory, <strong>int</strong> defaultPort) {
 
213
<a name="204" href="#204">204</a>         <strong>this</strong>(scheme, (ProtocolSocketFactory) factory, defaultPort);   
 
214
<a name="205" href="#205">205</a>     }    
 
215
<a name="206" href="#206">206</a>     
 
216
<a name="207" href="#207">207</a>     <em>/**<em>*</em></em>
 
217
<a name="208" href="#208">208</a> <em>     * Returns the defaultPort.</em>
 
218
<a name="209" href="#209">209</a> <em>     * @return int</em>
 
219
<a name="210" href="#210">210</a> <em>     */</em>
 
220
<a name="211" href="#211">211</a>     <strong>public</strong> <strong>int</strong> getDefaultPort() {
 
221
<a name="212" href="#212">212</a>         <strong>return</strong> defaultPort;
 
222
<a name="213" href="#213">213</a>     }
 
223
<a name="214" href="#214">214</a> 
 
224
<a name="215" href="#215">215</a>     <em>/**<em>*</em></em>
 
225
<a name="216" href="#216">216</a> <em>     * Returns the socketFactory.  If secure the factory is a</em>
 
226
<a name="217" href="#217">217</a> <em>     * SecureProtocolSocketFactory.</em>
 
227
<a name="218" href="#218">218</a> <em>     * @return SocketFactory</em>
 
228
<a name="219" href="#219">219</a> <em>     */</em>
 
229
<a name="220" href="#220">220</a>     <strong>public</strong> <a href="../../../../../org/apache/commons/httpclient/protocol/ProtocolSocketFactory.html">ProtocolSocketFactory</a> getSocketFactory() {
 
230
<a name="221" href="#221">221</a>         <strong>return</strong> socketFactory;
 
231
<a name="222" href="#222">222</a>     }
 
232
<a name="223" href="#223">223</a> 
 
233
<a name="224" href="#224">224</a>     <em>/**<em>*</em></em>
 
234
<a name="225" href="#225">225</a> <em>     * Returns the scheme.</em>
 
235
<a name="226" href="#226">226</a> <em>     * @return The scheme</em>
 
236
<a name="227" href="#227">227</a> <em>     */</em>
 
237
<a name="228" href="#228">228</a>     <strong>public</strong> String getScheme() {
 
238
<a name="229" href="#229">229</a>         <strong>return</strong> scheme;
 
239
<a name="230" href="#230">230</a>     }
 
240
<a name="231" href="#231">231</a> 
 
241
<a name="232" href="#232">232</a>     <em>/**<em>*</em></em>
 
242
<a name="233" href="#233">233</a> <em>     * Returns true if this protocol is secure</em>
 
243
<a name="234" href="#234">234</a> <em>     * @return true if this protocol is secure</em>
 
244
<a name="235" href="#235">235</a> <em>     */</em>
 
245
<a name="236" href="#236">236</a>     <strong>public</strong> <strong>boolean</strong> isSecure() {
 
246
<a name="237" href="#237">237</a>         <strong>return</strong> secure;
 
247
<a name="238" href="#238">238</a>     }
 
248
<a name="239" href="#239">239</a>     
 
249
<a name="240" href="#240">240</a>     <em>/**<em>*</em></em>
 
250
<a name="241" href="#241">241</a> <em>     * Resolves the correct port for this protocol.  Returns the given port if</em>
 
251
<a name="242" href="#242">242</a> <em>     * valid or the default port otherwise.</em>
 
252
<a name="243" href="#243">243</a> <em>     * </em>
 
253
<a name="244" href="#244">244</a> <em>     * @param port the port to be resolved</em>
 
254
<a name="245" href="#245">245</a> <em>     * </em>
 
255
<a name="246" href="#246">246</a> <em>     * @return the given port or the defaultPort</em>
 
256
<a name="247" href="#247">247</a> <em>     */</em>
 
257
<a name="248" href="#248">248</a>     <strong>public</strong> <strong>int</strong> resolvePort(<strong>int</strong> port) {
 
258
<a name="249" href="#249">249</a>         <strong>return</strong> port &lt;= 0 ? getDefaultPort() : port;
 
259
<a name="250" href="#250">250</a>     }
 
260
<a name="251" href="#251">251</a> 
 
261
<a name="252" href="#252">252</a>     <em>/**<em>*</em></em>
 
262
<a name="253" href="#253">253</a> <em>     * Return a string representation of this object.</em>
 
263
<a name="254" href="#254">254</a> <em>     * @return a string representation of this object.</em>
 
264
<a name="255" href="#255">255</a> <em>     */</em>
 
265
<a name="256" href="#256">256</a>     <strong>public</strong> String toString() {
 
266
<a name="257" href="#257">257</a>         <strong>return</strong> scheme + <span class="string">":"</span> + defaultPort;
 
267
<a name="258" href="#258">258</a>     }
 
268
<a name="259" href="#259">259</a>     
 
269
<a name="260" href="#260">260</a>     <em>/**<em>*</em></em>
 
270
<a name="261" href="#261">261</a> <em>     * Return true if the specified object equals this object.</em>
 
271
<a name="262" href="#262">262</a> <em>     * @param obj The object to compare against.</em>
 
272
<a name="263" href="#263">263</a> <em>     * @return true if the objects are equal.</em>
 
273
<a name="264" href="#264">264</a> <em>     */</em>
 
274
<a name="265" href="#265">265</a>     <strong>public</strong> <strong>boolean</strong> equals(Object obj) {
 
275
<a name="266" href="#266">266</a>         
 
276
<a name="267" href="#267">267</a>         <strong>if</strong> (obj instanceof Protocol) {
 
277
<a name="268" href="#268">268</a>             
 
278
<a name="269" href="#269">269</a>             <a href="../../../../../org/apache/commons/httpclient/protocol/Protocol.html">Protocol</a> p = (Protocol) obj;
 
279
<a name="270" href="#270">270</a>             
 
280
<a name="271" href="#271">271</a>             <strong>return</strong> (
 
281
<a name="272" href="#272">272</a>                 defaultPort == p.getDefaultPort()
 
282
<a name="273" href="#273">273</a>                 &amp;&amp; scheme.equalsIgnoreCase(p.getScheme())
 
283
<a name="274" href="#274">274</a>                 &amp;&amp; secure == p.isSecure()
 
284
<a name="275" href="#275">275</a>                 &amp;&amp; socketFactory.equals(p.getSocketFactory()));
 
285
<a name="276" href="#276">276</a>             
 
286
<a name="277" href="#277">277</a>         } <strong>else</strong> {
 
287
<a name="278" href="#278">278</a>             <strong>return</strong> false;
 
288
<a name="279" href="#279">279</a>         }
 
289
<a name="280" href="#280">280</a>         
 
290
<a name="281" href="#281">281</a>     }
 
291
<a name="282" href="#282">282</a> 
 
292
<a name="283" href="#283">283</a>     <em>/**<em>*</em></em>
 
293
<a name="284" href="#284">284</a> <em>     * Return a hash code for this object</em>
 
294
<a name="285" href="#285">285</a> <em>     * @return The hash code.</em>
 
295
<a name="286" href="#286">286</a> <em>     */</em>
 
296
<a name="287" href="#287">287</a>     <strong>public</strong> <strong>int</strong> hashCode() {
 
297
<a name="288" href="#288">288</a>         <strong>int</strong> hash = LangUtils.HASH_SEED;
 
298
<a name="289" href="#289">289</a>         hash = LangUtils.hashCode(hash, <strong>this</strong>.defaultPort);
 
299
<a name="290" href="#290">290</a>         hash = LangUtils.hashCode(hash, <strong>this</strong>.scheme.toLowerCase());
 
300
<a name="291" href="#291">291</a>         hash = LangUtils.hashCode(hash, <strong>this</strong>.secure);
 
301
<a name="292" href="#292">292</a>         hash = LangUtils.hashCode(hash, <strong>this</strong>.socketFactory);
 
302
<a name="293" href="#293">293</a>         <strong>return</strong> hash;
 
303
<a name="294" href="#294">294</a>     }
 
304
<a name="295" href="#295">295</a> }
310
305
</pre>
311
306
<hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
312
307
</html>