Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2009 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | package android.bluetooth; |
| 18 | |
Nick Pelly | 24bb9b8 | 2009-10-02 20:34:18 -0700 | [diff] [blame] | 19 | import android.os.Handler; |
zzy | 3b147b7 | 2012-04-03 19:48:32 -0700 | [diff] [blame] | 20 | import android.os.Message; |
| 21 | import android.os.ParcelUuid; |
Nick Pelly | 24bb9b8 | 2009-10-02 20:34:18 -0700 | [diff] [blame] | 22 | |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 23 | import java.io.Closeable; |
| 24 | import java.io.IOException; |
| 25 | |
| 26 | /** |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 27 | * A listening Bluetooth socket. |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 28 | * |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 29 | * <p>The interface for Bluetooth Sockets is similar to that of TCP sockets: |
| 30 | * {@link java.net.Socket} and {@link java.net.ServerSocket}. On the server |
| 31 | * side, use a {@link BluetoothServerSocket} to create a listening server |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 32 | * socket. When a connection is accepted by the {@link BluetoothServerSocket}, |
| 33 | * it will return a new {@link BluetoothSocket} to manage the connection. |
Jake Hamby | f51eada | 2010-09-21 13:39:53 -0700 | [diff] [blame] | 34 | * On the client side, use a single {@link BluetoothSocket} to both initiate |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 35 | * an outgoing connection and to manage the connection. |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 36 | * |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 37 | * <p>The most common type of Bluetooth socket is RFCOMM, which is the type |
| 38 | * supported by the Android APIs. RFCOMM is a connection-oriented, streaming |
| 39 | * transport over Bluetooth. It is also known as the Serial Port Profile (SPP). |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 40 | * |
Jake Hamby | f51eada | 2010-09-21 13:39:53 -0700 | [diff] [blame] | 41 | * <p>To create a listening {@link BluetoothServerSocket} that's ready for |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 42 | * incoming connections, use |
| 43 | * {@link BluetoothAdapter#listenUsingRfcommWithServiceRecord |
| 44 | * BluetoothAdapter.listenUsingRfcommWithServiceRecord()}. Then call |
| 45 | * {@link #accept()} to listen for incoming connection requests. This call |
| 46 | * will block until a connection is established, at which point, it will return |
Scott Main | 6d95fc0 | 2009-11-19 17:00:19 -0800 | [diff] [blame] | 47 | * a {@link BluetoothSocket} to manage the connection. Once the {@link |
| 48 | * BluetoothSocket} is acquired, it's a good idea to call {@link #close()} on |
| 49 | * the {@link BluetoothServerSocket} when it's no longer needed for accepting |
| 50 | * connections. Closing the {@link BluetoothServerSocket} will <em>not</em> |
| 51 | * close the returned {@link BluetoothSocket}. |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 52 | * |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 53 | * <p>{@link BluetoothServerSocket} is thread |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 54 | * safe. In particular, {@link #close} will always immediately abort ongoing |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 55 | * operations and close the server socket. |
Nick Pelly | cf44059 | 2009-09-08 10:12:06 -0700 | [diff] [blame] | 56 | * |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 57 | * <p class="note"><strong>Note:</strong> |
| 58 | * Requires the {@link android.Manifest.permission#BLUETOOTH} permission. |
| 59 | * |
Joe Fernandez | 3aef8e1d | 2011-12-20 10:38:34 -0800 | [diff] [blame] | 60 | * <div class="special reference"> |
| 61 | * <h3>Developer Guides</h3> |
| 62 | * <p>For more information about using Bluetooth, read the |
| 63 | * <a href="{@docRoot}guide/topics/wireless/bluetooth.html">Bluetooth</a> developer guide.</p> |
| 64 | * </div> |
| 65 | * |
Scott Main | 9fab0ae | 2009-11-03 18:17:59 -0800 | [diff] [blame] | 66 | * {@see BluetoothSocket} |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 67 | */ |
| 68 | public final class BluetoothServerSocket implements Closeable { |
Nick Pelly | 71c3c78 | 2009-09-02 11:51:35 -0700 | [diff] [blame] | 69 | |
Nick Pelly | bd022f4 | 2009-08-14 18:33:38 -0700 | [diff] [blame] | 70 | /*package*/ final BluetoothSocket mSocket; |
Nick Pelly | 24bb9b8 | 2009-10-02 20:34:18 -0700 | [diff] [blame] | 71 | private Handler mHandler; |
| 72 | private int mMessage; |
Ben Dodson | 6d8b80d | 2011-07-08 14:36:42 -0700 | [diff] [blame] | 73 | private final int mChannel; |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 74 | |
| 75 | /** |
| 76 | * Construct a socket for incoming connections. |
Nick Pelly | 6a669fa | 2009-06-02 15:57:18 -0700 | [diff] [blame] | 77 | * @param type type of socket |
| 78 | * @param auth require the remote device to be authenticated |
| 79 | * @param encrypt require the connection to be encrypted |
| 80 | * @param port remote port |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 81 | * @throws IOException On error, for example Bluetooth not available, or |
Jake Hamby | f51eada | 2010-09-21 13:39:53 -0700 | [diff] [blame] | 82 | * insufficient privileges |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 83 | */ |
Nick Pelly | bd022f4 | 2009-08-14 18:33:38 -0700 | [diff] [blame] | 84 | /*package*/ BluetoothServerSocket(int type, boolean auth, boolean encrypt, int port) |
Nick Pelly | 6a669fa | 2009-06-02 15:57:18 -0700 | [diff] [blame] | 85 | throws IOException { |
Ben Dodson | 6d8b80d | 2011-07-08 14:36:42 -0700 | [diff] [blame] | 86 | mChannel = port; |
Nick Pelly | 16fb88a | 2009-10-07 07:44:03 +0200 | [diff] [blame] | 87 | mSocket = new BluetoothSocket(type, -1, auth, encrypt, null, port, null); |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 88 | } |
| 89 | |
| 90 | /** |
zzy | 3b147b7 | 2012-04-03 19:48:32 -0700 | [diff] [blame] | 91 | * Construct a socket for incoming connections. |
| 92 | * @param type type of socket |
| 93 | * @param auth require the remote device to be authenticated |
| 94 | * @param encrypt require the connection to be encrypted |
| 95 | * @param uuid uuid |
| 96 | * @throws IOException On error, for example Bluetooth not available, or |
| 97 | * insufficient privileges |
| 98 | */ |
| 99 | /*package*/ BluetoothServerSocket(int type, boolean auth, boolean encrypt, ParcelUuid uuid) |
| 100 | throws IOException { |
| 101 | mSocket = new BluetoothSocket(type, -1, auth, encrypt, null, -1, uuid); |
| 102 | mChannel = mSocket.getPort(); |
| 103 | } |
| 104 | |
| 105 | |
| 106 | /** |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 107 | * Block until a connection is established. |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 108 | * <p>Returns a connected {@link BluetoothSocket} on successful connection. |
| 109 | * <p>Once this call returns, it can be called again to accept subsequent |
| 110 | * incoming connections. |
| 111 | * <p>{@link #close} can be used to abort this call from another thread. |
| 112 | * @return a connected {@link BluetoothSocket} |
| 113 | * @throws IOException on error, for example this call was aborted, or |
| 114 | * timeout |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 115 | */ |
| 116 | public BluetoothSocket accept() throws IOException { |
| 117 | return accept(-1); |
| 118 | } |
| 119 | |
| 120 | /** |
| 121 | * Block until a connection is established, with timeout. |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 122 | * <p>Returns a connected {@link BluetoothSocket} on successful connection. |
| 123 | * <p>Once this call returns, it can be called again to accept subsequent |
| 124 | * incoming connections. |
| 125 | * <p>{@link #close} can be used to abort this call from another thread. |
| 126 | * @return a connected {@link BluetoothSocket} |
| 127 | * @throws IOException on error, for example this call was aborted, or |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 128 | * timeout |
| 129 | */ |
| 130 | public BluetoothSocket accept(int timeout) throws IOException { |
Nick Pelly | 71c3c78 | 2009-09-02 11:51:35 -0700 | [diff] [blame] | 131 | return mSocket.accept(timeout); |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 132 | } |
| 133 | |
| 134 | /** |
Nick Pelly | 45e2704 | 2009-08-19 11:00:00 -0700 | [diff] [blame] | 135 | * Immediately close this socket, and release all associated resources. |
| 136 | * <p>Causes blocked calls on this socket in other threads to immediately |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 137 | * throw an IOException. |
Scott Main | 6d95fc0 | 2009-11-19 17:00:19 -0800 | [diff] [blame] | 138 | * <p>Closing the {@link BluetoothServerSocket} will <em>not</em> |
| 139 | * close any {@link BluetoothSocket} received from {@link #accept()}. |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 140 | */ |
| 141 | public void close() throws IOException { |
Nick Pelly | 24bb9b8 | 2009-10-02 20:34:18 -0700 | [diff] [blame] | 142 | synchronized (this) { |
| 143 | if (mHandler != null) { |
| 144 | mHandler.obtainMessage(mMessage).sendToTarget(); |
| 145 | } |
| 146 | } |
Nick Pelly | 71c3c78 | 2009-09-02 11:51:35 -0700 | [diff] [blame] | 147 | mSocket.close(); |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 148 | } |
Nick Pelly | 24bb9b8 | 2009-10-02 20:34:18 -0700 | [diff] [blame] | 149 | |
| 150 | /*package*/ synchronized void setCloseHandler(Handler handler, int message) { |
| 151 | mHandler = handler; |
| 152 | mMessage = message; |
| 153 | } |
zzy | 3b147b7 | 2012-04-03 19:48:32 -0700 | [diff] [blame] | 154 | /*package*/ void setServiceName(String ServiceName) { |
| 155 | mSocket.setServiceName(ServiceName); |
| 156 | } |
Ben Dodson | 6d8b80d | 2011-07-08 14:36:42 -0700 | [diff] [blame] | 157 | /** |
| 158 | * Returns the channel on which this socket is bound. |
| 159 | * @hide |
| 160 | */ |
| 161 | public int getChannel() { |
| 162 | return mChannel; |
| 163 | } |
Nick Pelly | 0b6955a | 2009-05-26 19:13:43 -0700 | [diff] [blame] | 164 | } |