android volley 패키지 및 소스 코드 분석

1.볼 리 간단하게 사용

Volley.newRequestQueue(this).add(new StringRequest(Request.Method.GET, "http://api.wumeijie.net/list", new Response.Listener() {
    @Override
    public void onResponse(String response) {
        //TODO       
    }
}, new Response.ErrorListener() {
    @Override
    public void onErrorResponse(VolleyError error) {
        //TODO         
    }
}));

2.VolleyManager 패키지
전체 코드:https://github.com/snailycy/volley_manager
volley 의 요청 대기 열 은 하나의 예 를 사용 하 는 것 을 권장 합 니 다.ReqeustQueue 와 start()를 예화 할 때마다 캐 시 스 레 드 1 개 와 네트워크 요청 스 레 드 4 개 를 만 들 고 start()를 여러 번 호출 하면 interrupt 의 스 레 드 를 만 들 고 자원 낭 비 를 초래 하기 때 문 입 니 다.

import com.android.volley.AuthFailureError;
import com.android.volley.DefaultRetryPolicy;
import com.android.volley.Request;
import com.android.volley.RequestQueue;
import com.android.volley.Response;
import com.android.volley.toolbox.JsonObjectRequest;
import com.android.volley.toolbox.StringRequest;
import com.android.volley.toolbox.Volley;

import org.json.JSONObject;

import java.util.HashMap;
import java.util.Map;

public class VolleyManager {
    private static RequestQueue requestQueue;
    //     30s
    private final static int TIME_OUT = 30000;

    private static RequestQueue getRequestQueue() {
        if (requestQueue == null) {
            synchronized (VolleyManager.class) {
                if (requestQueue == null) {
                    //    context  
                    requestQueue = Volley.newRequestQueue(MyApplication.getContext());
                }
            }
        }
        return requestQueue;
    }

    private static  void addRequest(RequestQueue requestQueue, Request request) {
        request.setShouldCache(true);
        request.setRetryPolicy(new DefaultRetryPolicy(TIME_OUT,
                DefaultRetryPolicy.DEFAULT_MAX_RETRIES,
                DefaultRetryPolicy.DEFAULT_BACKOFF_MULT));
        requestQueue.add(request);
    }

    public static void sendJsonObjectRequest(int method, String url,
                                             JSONObject params,
                                             final Response.Listener listener,
                                             final Response.ErrorListener errorListener) {
        try {
            JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(method,
                    url, params, listener, errorListener) {
                @Override
                public Map getHeaders() throws AuthFailureError {
                    Map headers = new HashMap<>();
                    headers.put("accept-encoding", "utf-8");
                    return headers;
                }
            };
            addRequest(getRequestQueue(), jsonObjectRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void sendStringRequest(int method, String url,
                                         final Map params,
                                         final Response.Listener listener,
                                         final Response.ErrorListener errorListener) {
        try {
            StringRequest stringRequest = new StringRequest(method, url, listener, errorListener) {
                @Override
                protected Map getParams() throws AuthFailureError {
                    return params;
                }
            };
            addRequest(getRequestQueue(), stringRequest);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

포장 이 끝나 서 사용 하기 도 매우 간단 하 다.

//  StringRequest
HashMap params = new HashMap<>();
params.put("params1", "xixi");
VolleyManager.sendStringRequest(Request.Method.GET,
        "http://api.wumeijie.net/list", params,
        new Response.Listener() {
            @Override
            public void onResponse(String response) {
                //TODO       
            }
        }, new Response.ErrorListener() {
            @Override
            public void onErrorResponse(VolleyError error) {
                //TODO         
            }
        });

혹은

//  JsonObjectRequest
JSONObject params = new JSONObject();
try {
    params.put("params1", "xixi");
} catch (JSONException e) {
    e.printStackTrace();
}
VolleyManager.sendJsonObjectRequest(Request.Method.GET,
        "http://api.wumeijie.net/list", params,
        new Response.Listener() {
            @Override
            public void onResponse(JSONObject response) {
                //TODO       
            }
        }, new Response.ErrorListener() {
            @Override
            public void onErrorResponse(VolleyError error) {
                //TODO         
            }
        });

3.소스 코드 분석
3.1 Volley 는 RequestQueue 를 만 들 때 먼저 HttpStack 대상 을 만 듭 니 다.이 대상 은 시스템 버 전>=9 시 에 구현 클래스 HurlStack 으로 만 듭 니 다.구체 적 으로 HttpURLConnection 으로 네트워크 요청 을 실현 합 니 다.시스템 버 전<9 시 에 구현 클래스 HttpClient Stack 으로 만 듭 니 다.HttpClient 를 사용 하여 네트워크 요청 원본 을 다음 과 같이 구현 합 니 다.(Volley 클래스 의 new RequestQueue 방법)

    public static RequestQueue newRequestQueue(Context context, HttpStack stack) {
        File cacheDir = new File(context.getCacheDir(), DEFAULT_CACHE_DIR);

        String userAgent = "volley/0";
        try {
            String packageName = context.getPackageName();
            PackageInfo info = context.getPackageManager().getPackageInfo(packageName, 0);
            userAgent = packageName + "/" + info.versionCode;
        } catch (NameNotFoundException e) {
        }

        if (stack == null) {
            if (Build.VERSION.SDK_INT >= 9) {
                stack = new HurlStack();
            } else {
                // Prior to Gingerbread, HttpUrlConnection was unreliable.
                // See: http://android-developers.blogspot.com/2011/09/androids-http-clients.html
                stack = new HttpClientStack(AndroidHttpClient.newInstance(userAgent));
            }
        }

        Network network = new BasicNetwork(stack);

        RequestQueue queue = new RequestQueue(new DiskBasedCache(cacheDir), network);
        queue.start();

        return queue;
    }

3.2 RequestQueue 를 만 듭 니 다.주로 1 개의 캐 시 스 레 드 와 4 개의 네트워크 요청 스 레 드 를 만 들 었 습 니 다.이 5 개의 스 레 드 는 1 개의 요청 대기 열 을 사용 하고 1 개의 캐 시 대상 을 공유 합 니 다.1 개의 ResponseDelivery 소스 코드 는 다음 과 같 습 니 다.(요청 대기 열 RequestQueue 류 에서 start 방법)

public void start() {
    stop();  // Make sure any currently running dispatchers are stopped.
    // Create the cache dispatcher and start it.
    mCacheDispatcher = new CacheDispatcher(mCacheQueue, mNetworkQueue, mCache, mDelivery);
    mCacheDispatcher.start();

    // Create network dispatchers (and corresponding threads) up to the pool size.
    for (int i = 0; i < mDispatchers.length; i++) {
        NetworkDispatcher networkDispatcher = new NetworkDispatcher(mNetworkQueue, mNetwork,
                mCache, mDelivery);
        mDispatchers[i] = networkDispatcher;
        networkDispatcher.start();
    }
}

3.3 캐 시 스 레 드 run 방법 은 주로 죽은 순환 입 니 다.캐 시 대기 열 에서 요청 대상 을 계속 꺼 냅 니 다.이 요청 대상 의 캐 시 를 잃 어 버 리 거나 캐 시 데 이 터 를 새로 고 칠 필요 가 없 으 면 요청 대기 열 에 가입 합 니 다.그렇지 않 으 면...캐 시 를 직접 분석 한 후 ResponseDelivery 대상 의 handler post 를 통 해 메 인 스 레 드 에 응답 리 셋 인터페이스 원본 코드 를 다음 과 같이 실행 합 니 다.(캐 시 스 레 드 CacheDispatcher 클래스 에서 run 방법)

@Override
public void run() {
    if (DEBUG) VolleyLog.v("start new dispatcher");
    Process.setThreadPriority(Process.THREAD_PRIORITY_BACKGROUND);

    // Make a blocking call to initialize the cache.
    mCache.initialize();

    while (true) {
        try {
            // Get a request from the cache triage queue, blocking until
            // at least one is available.
            final Request> request = mCacheQueue.take();
            request.addMarker("cache-queue-take");

            // If the request has been canceled, don't bother dispatching it.
            if (request.isCanceled()) {
                request.finish("cache-discard-canceled");
                continue;
            }

            // Attempt to retrieve this item from cache.
            Cache.Entry entry = mCache.get(request.getCacheKey());
            if (entry == null) {
                request.addMarker("cache-miss");
                // Cache miss; send off to the network dispatcher.
                mNetworkQueue.put(request);
                continue;
            }

            // If it is completely expired, just send it to the network.
            if (entry.isExpired()) {
                request.addMarker("cache-hit-expired");
                request.setCacheEntry(entry);
                mNetworkQueue.put(request);
                continue;
            }

            // We have a cache hit; parse its data for delivery back to the request.
            request.addMarker("cache-hit");
            Response> response = request.parseNetworkResponse(
                    new NetworkResponse(entry.data, entry.responseHeaders));
            request.addMarker("cache-hit-parsed");

            if (!entry.refreshNeeded()) {
                // Completely unexpired cache hit. Just deliver the response.
                mDelivery.postResponse(request, response);
            } else {
                // Soft-expired cache hit. We can deliver the cached response,
                // but we need to also send the request to the network for
                // refreshing.
                request.addMarker("cache-hit-refresh-needed");
                request.setCacheEntry(entry);

                // Mark the response as intermediate.
                response.intermediate = true;

                // Post the intermediate response back to the user and have
                // the delivery then forward the request along to the network.
                mDelivery.postResponse(request, response, new Runnable() {
                    @Override
                    public void run() {
                        try {
                            mNetworkQueue.put(request);
                        } catch (InterruptedException e) {
                            // Not much we can do about this.
                        }
                    }
                });
            }

        } catch (InterruptedException e) {
            // We may have been interrupted because it was time to quit.
            if (mQuit) {
                return;
            }
            continue;
        }
    }
}

3.4 네트워크 스 레 드 run 방법 은 주로 죽은 순환 입 니 다.요청 대기 열 에서 요청 대상 을 계속 꺼 낸 다음 에 시스템 버 전에 따라 HttpStack 대상 을 사용 하여 네트워크 요청(요청 파라미터 설정,요청 헤드,요청 방법 등 정보 포함)을 한 다음 에 HttpResponse 대상 을 되 돌려 줍 니 다.그 다음 에 응답 데 이 터 를 분석 하고 캐 시 상황 을 처리 합 니 다.마지막 으로 ResponseDelivery 대상 의 handler post 를 통 해 메 인 스 레 드 에 응답 리 셋 인터페이스 원본 코드 를 다음 과 같이 실행 합 니 다.(네트워크 요청 스 레 드 NetWorkDispatcher 클래스 에서 run 방법)

@Override
public void run() {
    Process.setThreadPriority(Process.THREAD_PRIORITY_BACKGROUND);
    while (true) {
        long startTimeMs = SystemClock.elapsedRealtime();
        Request> request;
        try {
            // Take a request from the queue.
            request = mQueue.take();
        } catch (InterruptedException e) {
            // We may have been interrupted because it was time to quit.
            if (mQuit) {
                return;
            }
            continue;
        }

        try {
            request.addMarker("network-queue-take");

            // If the request was cancelled already, do not perform the
            // network request.
            if (request.isCanceled()) {
                request.finish("network-discard-cancelled");
                continue;
            }

            addTrafficStatsTag(request);

            // Perform the network request.
            NetworkResponse networkResponse = mNetwork.performRequest(request);
            request.addMarker("network-http-complete");

            // If the server returned 304 AND we delivered a response already,
            // we're done -- don't deliver a second identical response.
            if (networkResponse.notModified && request.hasHadResponseDelivered()) {
                request.finish("not-modified");
                continue;
            }

            // Parse the response here on the worker thread.
            Response> response = request.parseNetworkResponse(networkResponse);
            request.addMarker("network-parse-complete");

            // Write to cache if applicable.
            // TODO: Only update cache metadata instead of entire record for 304s.
            if (request.shouldCache() && response.cacheEntry != null) {
                mCache.put(request.getCacheKey(), response.cacheEntry);
                request.addMarker("network-cache-written");
            }

            // Post the response back.
            request.markDelivered();
            mDelivery.postResponse(request, response);
        } catch (VolleyError volleyError) {
            volleyError.setNetworkTimeMs(SystemClock.elapsedRealtime() - startTimeMs);
            parseAndDeliverNetworkError(request, volleyError);
        } catch (Exception e) {
            VolleyLog.e(e, "Unhandled exception %s", e.toString());
            VolleyError volleyError = new VolleyError(e);
            volleyError.setNetworkTimeMs(SystemClock.elapsedRealtime() - startTimeMs);
            mDelivery.postError(request, volleyError);
        }
    }
}

3.5 해당 절차 3.4 에서 실행

NetworkResponse networkResponse = mNetwork.performRequest(request);

다른 버 전의 네트워크 요청 구현 클래스 에 요청 을 배포 합 니 다.여 기 는 HurlStack 을 예 로 들 어 HurlStack 에 배 포 된 performRequest 방법 을 다음 과 같이 실행 하도록 요청 합 니 다.(HurlStack 클래스 의 performRequest 방법)

@Override
public HttpResponse performRequest(Request> request, Map<String, String> additionalHeaders)
        throws IOException, AuthFailureError {
    String url = request.getUrl();
    HashMap<String, String> map = new HashMap<String, String>();
    map.putAll(request.getHeaders());
    map.putAll(additionalHeaders);
    if (mUrlRewriter != null) {
        String rewritten = mUrlRewriter.rewriteUrl(url);
        if (rewritten == null) {
            throw new IOException("URL blocked by rewriter: " + url);
        }
        url = rewritten;
    }
    URL parsedUrl = new URL(url);
    HttpURLConnection connection = openConnection(parsedUrl, request);
    for (String headerName : map.keySet()) {
        connection.addRequestProperty(headerName, map.get(headerName));
    }
    setConnectionParametersForRequest(connection, request);
    // Initialize HttpResponse with data from the HttpURLConnection.
    ProtocolVersion protocolVersion = new ProtocolVersion("HTTP", 1, 1);
    int responseCode = connection.getResponseCode();
    if (responseCode == -1) {
        // -1 is returned by getResponseCode() if the response code could not be retrieved.
        // Signal to the caller that something was wrong with the connection.
        throw new IOException("Could not retrieve response code from HttpUrlConnection.");
    }
    StatusLine responseStatus = new BasicStatusLine(protocolVersion,
            connection.getResponseCode(), connection.getResponseMessage());
    BasicHttpResponse response = new BasicHttpResponse(responseStatus);
    response.setEntity(entityFromConnection(connection));
    for (Entry<String, List<String>> header : connection.getHeaderFields().entrySet()) {
        if (header.getKey() != null) {
            Header h = new BasicHeader(header.getKey(), header.getValue().get(0));
            response.addHeader(h);
        }
    }
    return response;
}

3.6 절 차 를 3.5 실행 한 후에 응답 대상 HttpResponse 를 받 고 이 어 3.4 단계 에서 응답 대상 을 분석 합 니 다.

Response> response = request.parseNetworkResponse(networkResponse);

,응답 반전 실행:

mDelivery.postResponse(request, response);

이 mDelivery(Executor Delivery 형식)는 RequestQueue 를 만 들 때 만 든 ResponseDelivery 대상 입 니 다.주로 응답 인터페이스 주 를 되 돌려 줍 니 다.Executor Delivery implements ResponseDelivery 원본 코드 는 다음 과 같 습 니 다.(Executor Delivery 클래스 에서 post Response 방법)

@Override
public void postResponse(Request> request, Response> response, Runnable runnable) {
    request.markDelivered();
    request.addMarker("post-response");
    mResponsePoster.execute(new ResponseDeliveryRunnable(request, response, runnable));
}

Executor Delivery 속성 m Response Poster 는 구체 적 으로 두 가지 방식 이 있 습 니 다.여기 서 사용 하 는 것 은 handler 가 소스 코드 를 다음 과 같이 실현 하 는 것 입 니 다.(Executor Delivery 류 의 구조 방법)

public ExecutorDelivery(final Handler handler) {
    // Make an Executor that just wraps the handler.
    mResponsePoster = new Executor() {
        @Override
        public void execute(Runnable command) {
            handler.post(command);
        }
    };
}

주:이 구조 방법 으로 들 어 온 Handler 대상 은 메 인 스 레 드 의 Looper 대상 을 가 져 왔 습 니 다.
volley 소스 코드:https://android.googlesource.com/platform/frameworks/volley