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 
19 import java.io.IOException;
20 import java.io.InputStream;
21 
22 /**
23  * BluetoothInputStream.
24  *
25  * Used to write to a Bluetooth socket.
26  *
27  * @hide
28  */
29 /*package*/ final class BluetoothInputStream extends InputStream {
30     private BluetoothSocket mSocket;
31 
BluetoothInputStream(BluetoothSocket s)32     /*package*/ BluetoothInputStream(BluetoothSocket s) {
33         mSocket = s;
34     }
35 
36     /**
37      * Return number of bytes available before this stream will block.
38      */
available()39     public int available() throws IOException {
40         return mSocket.available();
41     }
42 
close()43     public void close() throws IOException {
44         mSocket.close();
45     }
46 
47     /**
48      * Reads a single byte from this stream and returns it as an integer in the
49      * range from 0 to 255. Returns -1 if the end of the stream has been
50      * reached. Blocks until one byte has been read, the end of the source
51      * stream is detected or an exception is thrown.
52      *
53      * @return the byte read or -1 if the end of stream has been reached.
54      * @throws IOException
55      *             if the stream is closed or another IOException occurs.
56      * @since Android 1.5
57      */
read()58     public int read() throws IOException {
59         byte b[] = new byte[1];
60         int ret = mSocket.read(b, 0, 1);
61         if (ret == 1) {
62             return (int)b[0] & 0xff;
63         } else {
64             return -1;
65         }
66     }
67 
68     /**
69      * Reads at most {@code length} bytes from this stream and stores them in
70      * the byte array {@code b} starting at {@code offset}.
71      *
72      * @param b
73      *            the byte array in which to store the bytes read.
74      * @param offset
75      *            the initial position in {@code buffer} to store the bytes
76      *            read from this stream.
77      * @param length
78      *            the maximum number of bytes to store in {@code b}.
79      * @return the number of bytes actually read or -1 if the end of the stream
80      *         has been reached.
81      * @throws IndexOutOfBoundsException
82      *             if {@code offset < 0} or {@code length < 0}, or if
83      *             {@code offset + length} is greater than the length of
84      *             {@code b}.
85      * @throws IOException
86      *             if the stream is closed or another IOException occurs.
87      * @since Android 1.5
88      */
read(byte[] b, int offset, int length)89     public int read(byte[] b, int offset, int length) throws IOException {
90         if (b == null) {
91             throw new NullPointerException("byte array is null");
92         }
93         if ((offset | length) < 0 || length > b.length - offset) {
94             throw new ArrayIndexOutOfBoundsException("invalid offset or length");
95         }
96         return mSocket.read(b, offset, length);
97     }
98 }
99