root/net/cronet/android/java/src/org/chromium/net/UrlRequestContext.java

DEFINITIONS

1. JNINamespace
2. getVersion
3. initNetworkThread
4. finalize
5. getUrlRequestContextPeer
6. nativeGetVersion
7. nativeCreateRequestContextPeer
8. nativeReleaseRequestContextPeer

// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

package org.chromium.net;

import android.content.Context;
import android.os.ConditionVariable;
import android.os.Process;

import org.chromium.base.CalledByNative;
import org.chromium.base.JNINamespace;

/**
 * Provides context for the native HTTP operations.
 */
@JNINamespace("net")
public class UrlRequestContext {
    protected static final int LOG_NONE = 0;
    protected static final int LOG_DEBUG = 1;
    protected static final int LOG_VERBOSE = 2;

    /**
     * Native peer object, owned by UrlRequestContext.
     */
    private long mUrlRequestContextPeer;

    private final ConditionVariable mStarted = new ConditionVariable();

    /**
     * Constructor.
     *
     * @param loggingLevel see {@link #LOG_NONE}, {@link #LOG_DEBUG} and
     *            {@link #LOG_VERBOSE}.
     */
    protected UrlRequestContext(Context context, String userAgent,
            int loggingLevel) {
        mUrlRequestContextPeer = nativeCreateRequestContextPeer(context,
                userAgent, loggingLevel);
        // TODO(mef): Revisit the need of block here.
        mStarted.block(2000);
    }

    /**
     * Returns the version of this network stack formatted as N.N.N.N/X where
     * N.N.N.N is the version of Chromium and X is the version of the JNI layer.
     */
    public static String getVersion() {
        return nativeGetVersion();
    }

    @CalledByNative
    private void initNetworkThread() {
        Thread.currentThread().setName("ChromiumNet");
        Process.setThreadPriority(Process.THREAD_PRIORITY_BACKGROUND);
        mStarted.open();
    }

    @Override
    protected void finalize() throws Throwable {
        nativeReleaseRequestContextPeer(mUrlRequestContextPeer);
        super.finalize();
    }

    protected long getUrlRequestContextPeer() {
        return mUrlRequestContextPeer;
    }

    private static native String nativeGetVersion();

    // Returns an instance URLRequestContextPeer to be stored in
    // mUrlRequestContextPeer.
    private native long nativeCreateRequestContextPeer(Context context,
            String userAgent, int loggingLevel);

    private native void nativeReleaseRequestContextPeer(
            long urlRequestContextPeer);
}