001/*
002 * ====================================================================
003 * Licensed to the Apache Software Foundation (ASF) under one
004 * or more contributor license agreements.  See the NOTICE file
005 * distributed with this work for additional information
006 * regarding copyright ownership.  The ASF licenses this file
007 * to you under the Apache License, Version 2.0 (the
008 * "License"); you may not use this file except in compliance
009 * with the License.  You may obtain a copy of the License at
010 *
011 *   http://www.apache.org/licenses/LICENSE-2.0
012 *
013 * Unless required by applicable law or agreed to in writing,
014 * software distributed under the License is distributed on an
015 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
016 * KIND, either express or implied.  See the License for the
017 * specific language governing permissions and limitations
018 * under the License.
019 * ====================================================================
020 *
021 * This software consists of voluntary contributions made by many
022 * individuals on behalf of the Apache Software Foundation.  For more
023 * information on the Apache Software Foundation, please see
024 * <http://www.apache.org/>.
025 *
026 */
027
028package org.apache.http.impl.client;
029
030import org.apache.http.conn.HttpClientConnectionManager;
031import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
032
033/**
034 * Factory methods for {@link CloseableHttpClient} instances.
035 * @since 4.3
036 */
037public class HttpClients {
038
039    private HttpClients() {
040        super();
041    }
042
043    /**
044     * Creates builder object for construction of custom
045     * {@link CloseableHttpClient} instances.
046     */
047    public static HttpClientBuilder custom() {
048        return HttpClientBuilder.create();
049    }
050
051    /**
052     * Creates {@link CloseableHttpClient} instance with default
053     * configuration.
054     */
055    public static CloseableHttpClient createDefault() {
056        return HttpClientBuilder.create().build();
057    }
058
059    /**
060     * Creates {@link CloseableHttpClient} instance with default
061     * configuration based on ssytem properties.
062     */
063    public static CloseableHttpClient createSystem() {
064        return HttpClientBuilder.create().useSystemProperties().build();
065    }
066
067    /**
068     * Creates {@link CloseableHttpClient} instance that implements
069     * the most basic HTTP protocol support.
070     */
071    public static CloseableHttpClient createMinimal() {
072        return new MinimalHttpClient(new PoolingHttpClientConnectionManager());
073    }
074
075    /**
076     * Creates {@link CloseableHttpClient} instance that implements
077     * the most basic HTTP protocol support.
078     */
079    public static CloseableHttpClient createMinimal(final HttpClientConnectionManager connManager) {
080        return new MinimalHttpClient(connManager);
081    }
082
083}