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