Home | History | Annotate | Download | only in bluetooth 
      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 
     32     /*package*/ BluetoothInputStream(BluetoothSocket s) {
     33         mSocket = s;
     34     }
     35 
     36     /**
     37      * Return number of bytes available before this stream will block.
     38      */
     39     public int available() throws IOException {
     40         return mSocket.available();
     41     }
     42 
     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      */
     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      */
     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