w568w
4 years ago
parent
16a958de8e
commit
a139c78025
@ -0,0 +1,88 @@ |
||||
#阅读API |
||||
## 对于Web的配置 |
||||
您需要先在设置中启用"Web 服务"。 |
||||
## 使用 |
||||
### Web |
||||
待补充 |
||||
### Content Provider |
||||
#### 插入单个书源 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/source/insert |
||||
Method = insert |
||||
``` |
||||
|
||||
创建`Key="json"`的`ContentValues`，内容为`JSON`字符串， |
||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt) |
||||
|
||||
#### 插入多个书源 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/sources/insert |
||||
Method = insert |
||||
``` |
||||
|
||||
创建`Key="json"`的`ContentValues`，内容为`JSON`字符串， |
||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)，**为数组格式**。 |
||||
|
||||
#### 获取书源 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/source/query?url=xxx |
||||
Method = query |
||||
``` |
||||
|
||||
获取指定URL对应的书源信息。 |
||||
用`Cursor.getString(0)`取出返回结果。 |
||||
|
||||
#### 获取所有书源 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/sources/query |
||||
Method = query |
||||
``` |
||||
|
||||
获取APP内的所有书源。 |
||||
用`Cursor.getString(0)`取出返回结果。 |
||||
|
||||
#### 删除多个书源 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/sources/delete |
||||
Method = delete |
||||
``` |
||||
|
||||
创建`Key="json"`的`ContentValues`，内容为`JSON`字符串， |
||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)，**为数组格式**。 |
||||
|
||||
#### 插入书籍 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/book/insert |
||||
Method = insert |
||||
``` |
||||
|
||||
创建`Key="json"`的`ContentValues`，内容为`JSON`字符串， |
||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/Book.kt)。 |
||||
|
||||
#### 获取所有书籍 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/books/query |
||||
Method = query |
||||
``` |
||||
|
||||
获取APP内的所有书籍。 |
||||
用`Cursor.getString(0)`取出返回结果。 |
||||
|
||||
#### 获取书籍章节列表 |
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/book/chapter/query?url=xxx |
||||
Method = query |
||||
``` |
||||
|
||||
获取指定图书的章节列表。 |
||||
用`Cursor.getString(0)`取出返回结果。 |
||||
|
||||
#### 获取书籍内容 |
||||
|
||||
``` |
||||
URL = content://io.legado.app.api.ReaderProvider/book/content/query?url=xxx&index=1 |
||||
Method = query |
||||
``` |
||||
|
||||
获取指定图书的第`index`章节的文本内容。 |
||||
用`Cursor.getString(0)`取出返回结果。 |
||||
@ -0,0 +1,358 @@ |
||||
/* |
||||
* Copyright (C) 2020 w568w |
||||
*/ |
||||
|
||||
package io.legado.app.api; |
||||
|
||||
import android.content.ContentProvider; |
||||
import android.content.ContentResolver; |
||||
import android.content.ContentValues; |
||||
import android.content.UriMatcher; |
||||
import android.database.CharArrayBuffer; |
||||
import android.database.ContentObserver; |
||||
import android.database.Cursor; |
||||
import android.database.DataSetObserver; |
||||
import android.net.Uri; |
||||
import android.os.Bundle; |
||||
|
||||
import com.google.gson.Gson; |
||||
|
||||
import org.jetbrains.annotations.NotNull; |
||||
|
||||
import java.util.ArrayList; |
||||
import java.util.HashMap; |
||||
import java.util.Map; |
||||
|
||||
import io.legado.app.web.controller.BookshelfController; |
||||
import io.legado.app.web.controller.SourceController; |
||||
import io.legado.app.web.utils.ReturnData; |
||||
|
||||
/** |
||||
* Export book data to other app. |
||||
*/ |
||||
public class ReaderProvider extends ContentProvider { |
||||
private enum RequestCode { |
||||
saveSource, saveSources, saveBook, deleteSources, getSource, getSources, getBookshelf, getChapterList, getBookContent |
||||
} |
||||
|
||||
public static final String POST_BODY_KEY = "json"; |
||||
public static final String AUTHORITY = "io.legado.app.api.ReaderProvider"; |
||||
private static UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH); |
||||
private SourceController mSourceController; |
||||
private BookshelfController mBookshelfController; |
||||
|
||||
static { |
||||
sMatcher.addURI(AUTHORITY, "source/insert", RequestCode.saveSource.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "sources/insert", RequestCode.saveSources.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "book/insert", RequestCode.saveBook.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "sources/delete", RequestCode.deleteSources.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "source/query", RequestCode.getSource.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "sources/query", RequestCode.getSources.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "books/query", RequestCode.getBookshelf.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "book/chapter/query", RequestCode.getChapterList.ordinal()); |
||||
sMatcher.addURI(AUTHORITY, "book/content/query", RequestCode.getBookContent.ordinal()); |
||||
} |
||||
|
||||
public ReaderProvider() { |
||||
} |
||||
|
||||
@Override |
||||
public int delete(@NotNull Uri uri, String selection, String[] selectionArgs) { |
||||
if (sMatcher.match(uri) < 0) |
||||
return -1; |
||||
switch (RequestCode.values()[sMatcher.match(uri)]) { |
||||
case deleteSources: |
||||
mSourceController.deleteSources(selection); |
||||
break; |
||||
default: |
||||
throw new IllegalStateException("Unexpected value: " + RequestCode.values()[sMatcher.match(uri)].name()); |
||||
} |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public String getType(@NotNull Uri uri) { |
||||
throw new UnsupportedOperationException("Not yet implemented"); |
||||
} |
||||
|
||||
@Override |
||||
public Uri insert(@NotNull Uri uri, ContentValues values) { |
||||
if (sMatcher.match(uri) < 0) |
||||
return null; |
||||
switch (RequestCode.values()[sMatcher.match(uri)]) { |
||||
case saveSource: |
||||
mSourceController.saveSource(values.getAsString(POST_BODY_KEY)); |
||||
break; |
||||
case saveBook: |
||||
mBookshelfController.saveBook(values.getAsString(POST_BODY_KEY)); |
||||
case saveSources: |
||||
mSourceController.saveSources(values.getAsString(POST_BODY_KEY)); |
||||
default: |
||||
throw new IllegalStateException("Unexpected value: " + RequestCode.values()[sMatcher.match(uri)].name()); |
||||
} |
||||
return null; |
||||
} |
||||
|
||||
@Override |
||||
public boolean onCreate() { |
||||
mSourceController = new SourceController(); |
||||
mBookshelfController = new BookshelfController(); |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public Cursor query(Uri uri, String[] projection, String selection, |
||||
String[] selectionArgs, String sortOrder) { |
||||
|
||||
Map<String, ArrayList<String>> map = new HashMap<>(); |
||||
|
||||
ArrayList<String> list = new ArrayList<>(); |
||||
list.add(uri.getQueryParameter("url")); |
||||
map.put("url", list); |
||||
|
||||
list = new ArrayList<>(); |
||||
list.add(uri.getQueryParameter("index")); |
||||
map.put("index", list); |
||||
|
||||
if (sMatcher.match(uri) < 0) |
||||
return null; |
||||
switch (RequestCode.values()[sMatcher.match(uri)]) { |
||||
case getSource: |
||||
return new SimpleCursor(mSourceController.getSource(map)); |
||||
case getSources: |
||||
return new SimpleCursor(mSourceController.getSources()); |
||||
case getBookshelf: |
||||
return new SimpleCursor(mBookshelfController.getBookshelf()); |
||||
case getBookContent: |
||||
return new SimpleCursor(mBookshelfController.getBookContent(map)); |
||||
case getChapterList: |
||||
return new SimpleCursor(mBookshelfController.getChapterList(map)); |
||||
default: |
||||
throw new IllegalStateException("Unexpected value: " + RequestCode.values()[sMatcher.match(uri)].name()); |
||||
} |
||||
} |
||||
|
||||
@Override |
||||
public int update(@NotNull Uri uri, ContentValues values, String selection, |
||||
String[] selectionArgs) { |
||||
throw new UnsupportedOperationException("Not yet implemented"); |
||||
} |
||||
|
||||
/** |
||||
* Simple inner class to deliver json callback data. |
||||
* |
||||
* Only getString() makes sense. |
||||
*/ |
||||
private static class SimpleCursor implements Cursor { |
||||
private String mData; |
||||
|
||||
public SimpleCursor(ReturnData data) { |
||||
this.mData = new Gson().toJson(data); |
||||
} |
||||
|
||||
@Override |
||||
public int getCount() { |
||||
return 1; |
||||
} |
||||
|
||||
@Override |
||||
public int getPosition() { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public boolean move(int i) { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean moveToPosition(int i) { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean moveToFirst() { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean moveToLast() { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean moveToNext() { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean moveToPrevious() { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean isFirst() { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean isLast() { |
||||
return true; |
||||
} |
||||
|
||||
@Override |
||||
public boolean isBeforeFirst() { |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public boolean isAfterLast() { |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public int getColumnIndex(String s) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public int getColumnIndexOrThrow(String s) throws IllegalArgumentException { |
||||
throw new UnsupportedOperationException("Not yet implemented"); |
||||
} |
||||
|
||||
@Override |
||||
public String getColumnName(int i) { |
||||
return null; |
||||
} |
||||
|
||||
@Override |
||||
public String[] getColumnNames() { |
||||
return new String[0]; |
||||
} |
||||
|
||||
@Override |
||||
public int getColumnCount() { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public byte[] getBlob(int i) { |
||||
return new byte[0]; |
||||
} |
||||
|
||||
@Override |
||||
public String getString(int i) { |
||||
return mData; |
||||
} |
||||
|
||||
@Override |
||||
public void copyStringToBuffer(int i, CharArrayBuffer charArrayBuffer) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public short getShort(int i) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public int getInt(int i) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public long getLong(int i) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public float getFloat(int i) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public double getDouble(int i) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public int getType(int i) { |
||||
return 0; |
||||
} |
||||
|
||||
@Override |
||||
public boolean isNull(int i) { |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public void deactivate() { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public boolean requery() { |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public void close() { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public boolean isClosed() { |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public void registerContentObserver(ContentObserver contentObserver) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public void unregisterContentObserver(ContentObserver contentObserver) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public void registerDataSetObserver(DataSetObserver dataSetObserver) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public void unregisterDataSetObserver(DataSetObserver dataSetObserver) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public void setNotificationUri(ContentResolver contentResolver, Uri uri) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public Uri getNotificationUri() { |
||||
return null; |
||||
} |
||||
|
||||
@Override |
||||
public boolean getWantsAllOnMoveCalls() { |
||||
return false; |
||||
} |
||||
|
||||
@Override |
||||
public void setExtras(Bundle bundle) { |
||||
|
||||
} |
||||
|
||||
@Override |
||||
public Bundle getExtras() { |
||||
return null; |
||||
} |
||||
|
||||
@Override |
||||
public Bundle respond(Bundle bundle) { |
||||
return null; |
||||
} |
||||
} |
||||
} |
||||
Loading…
Reference in new issue