Constants.java revision cfaffa85e4a5388f3591bb17f88fc7768676eae2 
1/*
2 * Copyright (c) 2008-2009, Motorola, Inc.
3 *
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions are met:
8 *
9 * - Redistributions of source code must retain the above copyright notice,
10 * this list of conditions and the following disclaimer.
11 *
12 * - Redistributions in binary form must reproduce the above copyright notice,
13 * this list of conditions and the following disclaimer in the documentation
14 * and/or other materials provided with the distribution.
15 *
16 * - Neither the name of the Motorola, Inc. nor the names of its contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
24 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
31 */
32
33package com.android.bluetooth.opp;
34
35import java.io.IOException;
36import java.util.regex.Pattern;
37
38import javax.obex.HeaderSet;
39
40import android.content.ContentValues;
41import android.content.Context;
42import android.content.Intent;
43import android.net.Uri;
44import android.util.Log;
45
46/**
47 * Bluetooth OPP internal constants definition
48 */
49public class Constants {
50    /** Tag used for debugging/logging */
51    public static final String TAG = "BluetoothOpp";
52
53    /**
54     * The intent that gets sent when the service must wake up for a retry Note:
55     * only retry Outbound transfer
56     */
57    public static final String ACTION_RETRY = "android.btopp.intent.action.RETRY";
58
59    /** the intent that gets sent when clicking a successful transfer */
60    public static final String ACTION_OPEN = "android.btopp.intent.action.OPEN";
61
62    /** the intent that gets sent when clicking outbound transfer notification */
63    public static final String ACTION_OPEN_OUTBOUND_TRANSFER = "android.btopp.intent.action.OPEN_OUTBOUND";
64
65    /** the intent that gets sent when clicking a inbound transfer notification */
66    public static final String ACTION_OPEN_INBOUND_TRANSFER = "android.btopp.intent.action.OPEN_INBOUND";
67
68    /** the intent that gets sent from the Settings app to show the received files */
69    public static final String ACTION_OPEN_RECEIVED_FILES = "android.btopp.intent.action.OPEN_RECEIVED_FILES";
70
71    /** the intent that whitelists a remote bluetooth device for auto-receive confirmation (NFC) */
72    public static final String ACTION_WHITELIST_DEVICE = "android.btopp.intent.action.WHITELIST_DEVICE";
73
74    /** the intent that can be sent by handover requesters to stop a BTOPP transfer */
75    public static final String ACTION_STOP_HANDOVER = "android.btopp.intent.action.STOP_HANDOVER_TRANSFER";
76
77    /** the intent extra to show all received files in the transfer history */
78    public static final String EXTRA_SHOW_ALL_FILES = "android.btopp.intent.extra.SHOW_ALL";
79
80    /** the intent that gets sent when clicking an incomplete/failed transfer */
81    public static final String ACTION_LIST = "android.btopp.intent.action.LIST";
82
83    /** the intent that is used for initiating a handover transfer */
84    public static final String ACTION_HANDOVER_SEND =
85            "android.nfc.handover.intent.action.HANDOVER_SEND";
86
87    /** the intent that is used for initiating a multi-uri handover transfer */
88    public static final String ACTION_HANDOVER_SEND_MULTIPLE =
89            "android.nfc.handover.intent.action.HANDOVER_SEND_MULTIPLE";
90
91    /** the intent that is used for indicating an incoming transfer*/
92    public static final String ACTION_HANDOVER_STARTED =
93            "android.nfc.handover.intent.action.HANDOVER_STARTED";
94
95    /** intent action used to indicate the progress of a handover transfer */
96    public static final String ACTION_BT_OPP_TRANSFER_PROGRESS =
97            "android.nfc.handover.intent.action.TRANSFER_PROGRESS";
98
99    /** intent action used to indicate the completion of a handover transfer */
100    public static final String ACTION_BT_OPP_TRANSFER_DONE =
101            "android.nfc.handover.intent.action.TRANSFER_DONE";
102
103    /** intent extra used to indicate the success of a handover transfer */
104    public static final String EXTRA_BT_OPP_TRANSFER_STATUS =
105            "android.nfc.handover.intent.extra.TRANSFER_STATUS";
106
107    /** intent extra used to indicate the address associated with the transfer */
108    public static final String EXTRA_BT_OPP_ADDRESS =
109            "android.nfc.handover.intent.extra.ADDRESS";
110
111    public static final String EXTRA_BT_OPP_OBJECT_COUNT =
112            "android.nfc.handover.intent.extra.OBJECT_COUNT";
113
114    public static final int COUNT_HEADER_UNAVAILABLE = -1;
115    public static final int HANDOVER_TRANSFER_STATUS_SUCCESS = 0;
116
117    public static final int HANDOVER_TRANSFER_STATUS_FAILURE = 1;
118
119    /** intent extra used to indicate the direction of a handover transfer */
120    public static final String EXTRA_BT_OPP_TRANSFER_DIRECTION =
121            "android.nfc.handover.intent.extra.TRANSFER_DIRECTION";
122
123    public static final int DIRECTION_BLUETOOTH_INCOMING = 0;
124
125    public static final int DIRECTION_BLUETOOTH_OUTGOING = 1;
126
127    /** intent extra used to provide a unique ID for the transfer */
128    public static final String EXTRA_BT_OPP_TRANSFER_ID =
129            "android.nfc.handover.intent.extra.TRANSFER_ID";
130
131    /** intent extra used to provide progress of the transfer */
132    public static final String EXTRA_BT_OPP_TRANSFER_PROGRESS =
133            "android.nfc.handover.intent.extra.TRANSFER_PROGRESS";
134
135    /** intent extra used to provide the Uri where the data was stored
136     * by the handover transfer */
137    public static final String EXTRA_BT_OPP_TRANSFER_URI =
138            "android.nfc.handover.intent.extra.TRANSFER_URI";
139
140    /** intent extra used to provide the mime-type of the data in
141     *  the handover transfer */
142    public static final String EXTRA_BT_OPP_TRANSFER_MIMETYPE =
143            "android.nfc.handover.intent.extra.TRANSFER_MIME_TYPE";
144
145    /** permission needed to be able to receive handover status requests */
146    public static final String HANDOVER_STATUS_PERMISSION =
147            "android.permission.NFC_HANDOVER_STATUS";
148
149    /** intent extra that indicates this transfer is a handover from another
150      * transport (NFC, WIFI)
151      */
152    public static final String EXTRA_CONNECTION_HANDOVER =
153            "com.android.intent.extra.CONNECTION_HANDOVER";
154
155    /**
156     * the intent that gets sent when deleting the incoming file confirmation
157     * notification
158     */
159    public static final String ACTION_HIDE = "android.btopp.intent.action.HIDE";
160
161    /**
162     * the intent that gets sent when deleting the notifications of outbound and
163     * inbound completed transfer
164     */
165    public static final String ACTION_COMPLETE_HIDE = "android.btopp.intent.action.HIDE_COMPLETE";
166
167    /**
168     * the intent that gets sent when clicking a incoming file confirm
169     * notification
170     */
171    public static final String ACTION_INCOMING_FILE_CONFIRM = "android.btopp.intent.action.CONFIRM";
172
173    public static final String THIS_PACKAGE_NAME = "com.android.bluetooth";
174
175    /**
176     * The column that is used to remember whether the media scanner was invoked
177     */
178    public static final String MEDIA_SCANNED = "scanned";
179
180    public static final int MEDIA_SCANNED_NOT_SCANNED = 0;
181
182    public static final int MEDIA_SCANNED_SCANNED_OK = 1;
183
184    public static final int MEDIA_SCANNED_SCANNED_FAILED = 2;
185
186    /**
187     * The MIME type(s) of we could share to other device.
188     */
189    /*
190     * TODO: define correct type list
191     */
192    public static final String[] ACCEPTABLE_SHARE_OUTBOUND_TYPES = new String[] {
193        "image/*", "text/x-vcard",
194    };
195
196    /**
197     * The MIME type(s) of we could not share to other device. TODO: define
198     * correct type list
199     */
200    public static final String[] UNACCEPTABLE_SHARE_OUTBOUND_TYPES = new String[] {
201        "virus/*",
202    };
203
204    /**
205     * The MIME type(s) of we could accept from other device.
206     * This is in essence a "white list" of acceptable types.
207     * Today, restricted to images, audio, video and certain text types.
208     */
209    public static final String[] ACCEPTABLE_SHARE_INBOUND_TYPES = new String[] {
210        "image/*",
211        "video/*",
212        "audio/*",
213        "text/x-vcard",
214        "text/plain",
215        "text/html",
216        "text/xml",
217        "application/zip",
218        "application/vnd.ms-excel",
219        "application/msword",
220        "application/vnd.ms-powerpoint",
221        "application/pdf",
222        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
223        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
224        "application/vnd.openxmlformats-officedocument.presentationml.presentation",
225    };
226
227    /**
228     * The MIME type(s) of we could not accept from other device. TODO: define
229     * correct type list
230     */
231    public static final String[] UNACCEPTABLE_SHARE_INBOUND_TYPES = new String[] {
232        "text/x-vcalendar",
233    };
234
235    /** Where we store Bluetooth received files on the external storage */
236    public static final String DEFAULT_STORE_SUBDIR = "/bluetooth";
237
238    /**
239     * Debug level logging
240     */
241    public static final boolean DEBUG = true;
242
243    /**
244     * Verbose level logging
245     */
246    public static final boolean VERBOSE = false;
247
248    /** use TCP socket instead of Rfcomm Socket to develop */
249    public static final boolean USE_TCP_DEBUG = false;
250
251    /** use simple TCP server started from TestActivity */
252    public static final boolean USE_TCP_SIMPLE_SERVER = false;
253
254    /** Test TCP socket port */
255    public static final int TCP_DEBUG_PORT = 6500;
256
257    /** use emulator to debug */
258    public static final boolean USE_EMULATOR_DEBUG = false;
259
260    public static final int MAX_RECORDS_IN_DATABASE = 1000;
261
262    public static final int BATCH_STATUS_PENDING = 0;
263
264    public static final int BATCH_STATUS_RUNNING = 1;
265
266    public static final int BATCH_STATUS_FINISHED = 2;
267
268    public static final int BATCH_STATUS_FAILED = 3;
269
270    public static final String BLUETOOTHOPP_NAME_PREFERENCE = "btopp_names";
271
272    public static final String BLUETOOTHOPP_CHANNEL_PREFERENCE = "btopp_channels";
273
274    public static String filename_SEQUENCE_SEPARATOR = "-";
275
276    public static void updateShareStatus(Context context, int id, int status) {
277        Uri contentUri = Uri.parse(BluetoothShare.CONTENT_URI + "/" + id);
278        ContentValues updateValues = new ContentValues();
279        updateValues.put(BluetoothShare.STATUS, status);
280        context.getContentResolver().update(contentUri, updateValues, null, null);
281        Constants.sendIntentIfCompleted(context, contentUri, status);
282    }
283
284    /*
285     * This function should be called whenever transfer status change to
286     * completed.
287     */
288    public static void sendIntentIfCompleted(Context context, Uri contentUri, int status) {
289        if (BluetoothShare.isStatusCompleted(status)) {
290            Intent intent = new Intent(BluetoothShare.TRANSFER_COMPLETED_ACTION);
291            intent.setClassName(THIS_PACKAGE_NAME, BluetoothOppReceiver.class.getName());
292            intent.setDataAndNormalize(contentUri);
293            context.sendBroadcast(intent);
294        }
295    }
296
297    public static boolean mimeTypeMatches(String mimeType, String[] matchAgainst) {
298        for (String matchType : matchAgainst) {
299            if (mimeTypeMatches(mimeType, matchType)) {
300                return true;
301            }
302        }
303        return false;
304    }
305
306    public static boolean mimeTypeMatches(String mimeType, String matchAgainst) {
307        Pattern p = Pattern.compile(matchAgainst.replaceAll("\\*", "\\.\\*"),
308                Pattern.CASE_INSENSITIVE);
309        return p.matcher(mimeType).matches();
310    }
311
312    public static void logHeader(HeaderSet hs) {
313        Log.v(TAG, "Dumping HeaderSet " + hs.toString());
314        try {
315
316            Log.v(TAG, "COUNT : " + hs.getHeader(HeaderSet.COUNT));
317            Log.v(TAG, "NAME : " + hs.getHeader(HeaderSet.NAME));
318            Log.v(TAG, "TYPE : " + hs.getHeader(HeaderSet.TYPE));
319            Log.v(TAG, "LENGTH : " + hs.getHeader(HeaderSet.LENGTH));
320            Log.v(TAG, "TIME_ISO_8601 : " + hs.getHeader(HeaderSet.TIME_ISO_8601));
321            Log.v(TAG, "TIME_4_BYTE : " + hs.getHeader(HeaderSet.TIME_4_BYTE));
322            Log.v(TAG, "DESCRIPTION : " + hs.getHeader(HeaderSet.DESCRIPTION));
323            Log.v(TAG, "TARGET : " + hs.getHeader(HeaderSet.TARGET));
324            Log.v(TAG, "HTTP : " + hs.getHeader(HeaderSet.HTTP));
325            Log.v(TAG, "WHO : " + hs.getHeader(HeaderSet.WHO));
326            Log.v(TAG, "OBJECT_CLASS : " + hs.getHeader(HeaderSet.OBJECT_CLASS));
327            Log.v(TAG, "APPLICATION_PARAMETER : " + hs.getHeader(HeaderSet.APPLICATION_PARAMETER));
328        } catch (IOException e) {
329            Log.e(TAG, "dump HeaderSet error " + e);
330        }
331    }
332}
333