blob: 33a9093716fe0ba1465a22807f283baef3853484 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
/*
* Copyright (C) 2013 Square, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.squareup.picasso;
import android.graphics.Bitmap;
import android.net.Uri;
import java.io.IOException;
import java.io.InputStream;
/** A mechanism to load images from external resources such as a disk cache and/or the internet. */
public interface Downloader {
/**
* Download the specified image {@code url} from the internet.
*
* @param uri Remote image URL.
* @param localCacheOnly If {@code true} the URL should only be loaded if available in a local
* disk cache.
* @return {@link Response} containing either a {@link Bitmap} representation of the request or an
* {@link InputStream} for the image data. {@code null} can be returned to indicate a problem
* loading the bitmap.
* @throws IOException if the requested URL cannot successfully be loaded.
*/
Response load(Uri uri, boolean localCacheOnly) throws IOException;
/** Thrown for non-2XX responses. */
class ResponseException extends IOException {
public ResponseException(String message) {
super(message);
}
}
/** Response stream or bitmap and info. */
class Response {
final InputStream stream;
final Bitmap bitmap;
final boolean cached;
/**
* Response image and info.
*
* @param bitmap Image.
* @param loadedFromCache {@code true} if the source of the image is from a local disk cache.
*/
public Response(Bitmap bitmap, boolean loadedFromCache) {
if (bitmap == null) {
throw new IllegalArgumentException("Bitmap may not be null.");
}
this.stream = null;
this.bitmap = bitmap;
this.cached = loadedFromCache;
}
/**
* Response stream and info.
*
* @param stream Image data stream.
* @param loadedFromCache {@code true} if the source of the stream is from a local disk cache.
*/
public Response(InputStream stream, boolean loadedFromCache) {
if (stream == null) {
throw new IllegalArgumentException("Stream may not be null.");
}
this.stream = stream;
this.bitmap = null;
this.cached = loadedFromCache;
}
/**
* Input stream containing image data.
* <p>
* If this returns {@code null}, image data will be available via {@link #getBitmap()}.
*/
public InputStream getInputStream() {
return stream;
}
/**
* Bitmap representing the image.
* <p>
* If this returns {@code null}, image data will be available via {@link #getInputStream()}.
*/
public Bitmap getBitmap() {
return bitmap;
}
}
}
|
