1 /*
2  * ====================================================================
3  * Licensed to the Apache Software Foundation (ASF) under one
4  * or more contributor license agreements.  See the NOTICE file
5  * distributed with this work for additional information
6  * regarding copyright ownership.  The ASF licenses this file
7  * to you under the Apache License, Version 2.0 (the
8  * "License"); you may not use this file except in compliance
9  * with the License.  You may obtain a copy of the License at
10  *
11  *   http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing,
14  * software distributed under the License is distributed on an
15  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16  * KIND, either express or implied.  See the License for the
17  * specific language governing permissions and limitations
18  * under the License.
19  * ====================================================================
20  *
21  * This software consists of voluntary contributions made by many
22  * individuals on behalf of the Apache Software Foundation.  For more
23  * information on the Apache Software Foundation, please see
24  * <http://www.apache.org/>.
25  *
26  */
27 
28 package ch.boye.httpclientandroidlib.impl.client;
29 
30 import ch.boye.httpclientandroidlib.annotation.Immutable;
31 import ch.boye.httpclientandroidlib.conn.HttpClientConnectionManager;
32 import ch.boye.httpclientandroidlib.impl.conn.PoolingHttpClientConnectionManager;
33 
34 /**
35  * Factory methods for {@link CloseableHttpClient} instances.
36  * @since 4.3
37  */
38 @Immutable
39 public class HttpClients {
40 
HttpClients()41     private HttpClients() {
42         super();
43     }
44 
45     /**
46      * Creates builder object for construction of custom
47      * {@link CloseableHttpClient} instances.
48      */
custom()49     public static HttpClientBuilder custom() {
50         return HttpClientBuilder.create();
51     }
52 
53     /**
54      * Creates {@link CloseableHttpClient} instance with default
55      * configuration.
56      */
createDefault()57     public static CloseableHttpClient createDefault() {
58         return HttpClientBuilder.create().build();
59     }
60 
61     /**
62      * Creates {@link CloseableHttpClient} instance with default
63      * configuration based on ssytem properties.
64      */
createSystem()65     public static CloseableHttpClient createSystem() {
66         return HttpClientBuilder.create().useSystemProperties().build();
67     }
68 
69     /**
70      * Creates {@link CloseableHttpClient} instance that implements
71      * the most basic HTTP protocol support.
72      */
createMinimal()73     public static CloseableHttpClient createMinimal() {
74         return new MinimalHttpClient(new PoolingHttpClientConnectionManager());
75     }
76 
77     /**
78      * Creates {@link CloseableHttpClient} instance that implements
79      * the most basic HTTP protocol support.
80      */
createMinimal(final HttpClientConnectionManager connManager)81     public static CloseableHttpClient createMinimal(final HttpClientConnectionManager connManager) {
82         return new MinimalHttpClient(connManager);
83     }
84 
85 }
86