19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.net.http; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callbacks in this interface are made as an HTTP request is 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * processed. The normal order of callbacks is status(), headers(), 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then multiple data() then endData(). handleSslErrorRequest(), if 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there is an SSL certificate error. error() can occur anywhere 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the transaction. 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface EventHandler { 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Error codes used in the error() callback. Positive error codes 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are reserved for codes sent by http servers. Negative error 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * codes are connection/parsing failures, etc. 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Success */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int OK = 0; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Generic error */ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR = -1; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Server or proxy hostname lookup failed */ 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_LOOKUP = -2; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Unsupported authentication scheme (ie, not basic or digest) */ 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_UNSUPPORTED_AUTH_SCHEME = -3; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** User authentication failed on server */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTH = -4; 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** User authentication failed on proxy */ 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_PROXYAUTH = -5; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Could not connect to server */ 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_CONNECT = -6; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Failed to write to or read from server */ 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_IO = -7; 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Connection timed out */ 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_TIMEOUT = -8; 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Too many redirects */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_REDIRECT_LOOP = -9; 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Unsupported URI scheme (ie, not http, https, etc) */ 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_UNSUPPORTED_SCHEME = -10; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Failed to perform SSL handshake */ 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_FAILED_SSL_HANDSHAKE = -11; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Bad URL */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_BAD_URL = -12; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Generic file error for file:/// loads */ 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FILE_ERROR = -13; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** File not found error for file:/// loads */ 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FILE_NOT_FOUND_ERROR = -14; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Too many requests queued */ 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int TOO_MANY_REQUESTS_ERROR = -15; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after status line has been sucessfully processed. 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param major_version HTTP version advertised by server. major 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the part before the "." 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param minor_version HTTP version advertised by server. minor 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the part after the "." 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code HTTP Status code. See RFC 2616. 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param reason_phrase Textual explanation sent by server 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void status(int major_version, 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int minor_version, 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int code, 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String reason_phrase); 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after all headers are successfully processed. 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void headers(Headers headers); 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An array containing all or part of the http body as read from 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the server. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param data A byte array containing the content 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param len The length of valid content in data 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: chunked and compressed encodings are handled within 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.net.http. Decoded data is passed through this 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interface. 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void data(byte[] data, int len); 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the document is completely read. No more data() 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callbacks will be made after this call 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void endData(); 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 109dba8cb76371960457e91b31fa396478f809a5a34Brian Carlstrom * SSL certificate callback called before resource request is 110dba8cb76371960457e91b31fa396478f809a5a34Brian Carlstrom * made, which will be null for insecure connection. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void certificate(SslCertificate certificate); 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * There was trouble. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id One of the error codes defined below 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param description of error 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void error(int id, String description); 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * SSL certificate error callback. Handles SSL error(s) on the way 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * up to the user. The callback has to make sure that restartConnection() is called, 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise the connection will be suspended indefinitely. 1254c8db8a4feb2afbd9d5f94ff09c7167ca34076c4Grace Kloba * @return True if the callback can handle the error, which means it will 1264c8db8a4feb2afbd9d5f94ff09c7167ca34076c4Grace Kloba * call restartConnection() to unblock the thread later, 1274c8db8a4feb2afbd9d5f94ff09c7167ca34076c4Grace Kloba * otherwise return false. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1294c8db8a4feb2afbd9d5f94ff09c7167ca34076c4Grace Kloba public boolean handleSslErrorRequest(SslError error); 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 132