DataSource.h revision fc9ba09e3bb368f823d473f5e2bb9aa32dba6289
120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber/*
220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Copyright (C) 2009 The Android Open Source Project
320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber *
420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License");
520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * you may not use this file except in compliance with the License.
620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * You may obtain a copy of the License at
720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber *
820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber *      http://www.apache.org/licenses/LICENSE-2.0
920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber *
1020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Unless required by applicable law or agreed to in writing, software
1120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS,
1220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * See the License for the specific language governing permissions and
1420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * limitations under the License.
1520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber */
1620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
1720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#ifndef DATA_SOURCE_H_
1820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
1920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#define DATA_SOURCE_H_
2020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
2120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <sys/types.h>
2220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
2320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/Errors.h>
2420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/List.h>
25693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber#include <utils/RefBase.h>
2620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/threads.h>
2720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
2820111aa043c5f404472bc63b90bc5aad906b1101Andreas Hubernamespace android {
2920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
3020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass String8;
3120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
32693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huberclass DataSource : public RefBase {
3320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberpublic:
34fc9ba09e3bb368f823d473f5e2bb9aa32dba6289Andreas Huber    static sp<DataSource> CreateFromURI(const char *uri);
35fc9ba09e3bb368f823d473f5e2bb9aa32dba6289Andreas Huber
3620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    DataSource() {}
3720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
3834769bc913e9f6bb138e666d94a9d685bf3da217Andreas Huber    virtual status_t initCheck() const = 0;
3934769bc913e9f6bb138e666d94a9d685bf3da217Andreas Huber
4034769bc913e9f6bb138e666d94a9d685bf3da217Andreas Huber    virtual ssize_t readAt(off_t offset, void *data, size_t size) = 0;
4120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
42693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber    // Convenience methods:
43693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber    bool getUInt16(off_t offset, uint16_t *x);
44693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber
4520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    // May return ERROR_UNSUPPORTED.
4620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    virtual status_t getSize(off_t *size);
4720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
4820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    ////////////////////////////////////////////////////////////////////////////
4920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
5020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    bool sniff(String8 *mimeType, float *confidence);
5120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
5220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    typedef bool (*SnifferFunc)(
53693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber            const sp<DataSource> &source, String8 *mimeType, float *confidence);
5420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
5520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    static void RegisterSniffer(SnifferFunc func);
5620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    static void RegisterDefaultSniffers();
5720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
58693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huberprotected:
59693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber    virtual ~DataSource() {}
60693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber
6120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberprivate:
6220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    static Mutex gSnifferMutex;
6320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    static List<SnifferFunc> gSniffers;
6420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
6520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    DataSource(const DataSource &);
6620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber    DataSource &operator=(const DataSource &);
6720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber};
6820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
6920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber}  // namespace android
7020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber
7120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#endif  // DATA_SOURCE_H_
72