blob: 97bddaead964ebbf174be7b6448fd8db88d7a341 [file] [log] [blame]
page.title=Transmitting Network Data Using Volley
<div id="tb-wrapper">
<div id="tb">
<!-- Required platform, tools, add-ons, devices, knowledge, etc. -->
<h2>Dependencies and prerequisites</h2>
<li>Android 1.6 (API Level 4) or higher</li>
<a class="notice-developers-video wide" href="">
<p>Volley: Easy, Fast Networking for Android</p>
<p>Volley is an HTTP library that makes networking for Android apps easier and most importantly,
faster. Volley is available through the open
<a href="">AOSP</a> repository.</p>
<p>Volley offers the following benefits:</p>
<li>Automatic scheduling of network requests.</li>
<li>Multiple concurrent network connections.</li>
<li>Transparent disk and memory response caching with standard HTTP
<a href=">cache coherence</a>.</li>
<li>Support for request prioritization.</li>
<li>Cancellation request API. You can cancel a single request, or you can set blocks or
scopes of requests to cancel.</li>
<li>Ease of customization, for example, for retry and backoff.</li>
<li>Strong ordering that makes it easy to correctly populate your UI with data fetched
asynchronously from the network.</li>
<li>Debugging and tracing tools.</li>
<p>Volley excels at RPC-type operations used to populate a UI, such as fetching a page of
search results as structured data. It integrates easily with any protocol and comes out of
the box with support for raw strings, images, and JSON. By providing built-in support for
the features you need, Volley frees you from writing boilerplate code and allows you to
concentrate on the logic that is specific to your app.</p>
<p>Volley is not suitable for large download or streaming operations, since Volley holds
all responses in memory during parsing. For large download operations, consider using an
alternative like {@link}.</p>
<p>The core Volley library is developed in the open
<a href="">AOSP</a>
repository at {@code frameworks/volley} and contains the main request dispatch pipeline
as well as a set of commonly applicable utilities, available in the Volley "toolbox." The
easiest way to add Volley to your project is to clone the Volley repository and set it as
a library project:</p>
<li>Git clone the repository by typing the following at the command line:
git clone
<li>Import the downloaded source into your app project as an Android library project
(as described in <a href="{@docRoot}tools/projects/projects-eclipse.html">
Managing Projects from Eclipse with ADT</a>, if you're using Eclipse) or make a
<a href="{@docRoot}guide/faq/commontasks.html#addexternallibrary"><code>.jar</code> file</a>.</li>
<strong><a href="simple.html">Sending a Simple Request</a></strong>
Learn how to send a simple request using the default behaviors of Volley, and how
to cancel a request.
<strong><a href="requestqueue.html">Setting Up a RequestQueue</a></strong>
Learn how to set up a {@code RequestQueue}, and how to implement a singleton
pattern to create a {@code RequestQueue} that lasts the lifetime of your app.
<strong><a href="request.html">Making a Standard Request</a></strong>
Learn how to send a request using one of Volley's out-of-the-box request types
(raw strings, images, and JSON).
<strong><a href="request-custom.html">Implementing a Custom Request</a></strong>
Learn how to implement a custom request.