Flutter书籍信息查询插件isbndb的使用

Dart/Flutter包用于使用ISBNdb API

这个包是一个可以直接使用的ISBNdb API。

⚠️ 你需要一个API密钥才能使用此服务。要获取它，请在ISBNdb上创建一个帐户。

你可以免费试用7天。

API特性

这个包允许你使用ISBNdb API的所有功能。

在对API进行任何请求之前，你需要用以下代码初始化服务类：

final isbnDb = ISBNdb("your_key_here");

书籍

获取书籍详情

final book = isbnDb.getBook("9781092297370");
final book = isbnDb.getBook("9781092297370", withPrices: true);

使用ISBN列表获取多本书籍（需要ISBNdb.com上的Pro计划）

final books = isbnDb.getBooksFromISBNs(["9781092297370", "9781680506952"]);

搜索书籍

final books = isbnDb.getBooks("Google Flutter", { 
    page: 1, 
    pageSize: 20, 
});

BookColumn 是一个枚举，包含以下值：

• title - 仅在书籍标题中搜索
• author - 仅按给定作者搜索书籍
• date_published - 仅搜索特定年份的书籍，例如1998

作者

获取作者详情

final author = isbnDb.getAuthor("Bussi Michel", { 
    page: 1, 
    pageSize: 20, 
});

搜索作者

final author = isbnDb.getAuthors("werber", { 
    page: 1, 
    pageSize: 20, 
});

出版商

获取出版商详情

final publisher = isbnDb.getPublisher("Nathan", { 
    page: 1, 
    pageSize: 20, 
});

搜索出版商

final publisher = isbnDb.getPublishers("Nathan", { 
    page: 1, 
    pageSize: 20, 
});

主题

获取主题详情

final subject = isbnDb.getSubject("Flutter");

搜索主题

final subject = isbnDb.getSubjects("flutter", { 
    page: 1, 
    pageSize: 20, 
});

模型

AuthorQueryResult

Author

BookQueryResult

Book

Merchant

PublisherQueryResult

Publisher

SubjectQueryResult

Subject

第三方包

这个应用程序使用了一些外部库：

• ✅ Freezed 用于生成不可变模型
• ✅ Dio 用于HTTP请求

致谢

这个包最初是我个人需求而创建的，但你可以自由使用它，它涵盖了ISBNdb API的所有功能，我会维护它。

我没有与ISBNdb有任何关系，我只是需要使用这个API并创建了这个库。

如果你有问题，请在Twitter上提问。

许可证

LICENSE: MIT

示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:intl/intl.dart';
import 'package:isbndb/isbndb.dart';

void main() async {
  runApp(App());
}

class App extends StatefulWidget {
  App({Key? key}) : super(key: key);

  [@override](/user/override)
  createState() => _AppState();
}

class _AppState extends State<App> {
  bool isLoading = false;
  Book? book;
  final textEditingController = TextEditingController();

  [@override](/user/override)
  void initState() {
    super.initState();
    textEditingController.addListener(() {
      final value = textEditingController.text;
      if (value.length == 13) {
        _search(value);
      }
    });
  }

  [@override](/user/override)
  void dispose() {
    textEditingController.dispose();
    super.dispose();
  }

  Future<void> _search(String isbn) async {
    setState(() {
      isLoading = true;
      book = null;
    });

    final isbnDb = ISBNdb("your_key_here");

    try {
      final _book = await isbnDb.getBook(isbn);
      SystemChannels.textInput.invokeMethod('TextInput.hide');
      setState(() {
        book = _book;
        isLoading = false;
      });
    } catch (e) {
      setState(() {
        isLoading = false;
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          backgroundColor: Colors.amber,
          title: TextField(
            keyboardType: TextInputType.number,
            style: TextStyle(fontSize: 18),
            controller: textEditingController,
            decoration: InputDecoration(
              hintText: "Type an ISBN...",
              focusedBorder: InputBorder.none,
              enabledBorder: InputBorder.none,
              suffixIcon: Container(
                child: IconButton(
                  onPressed: () {
                    textEditingController.clear();
                    setState(() {
                      book = null;
                    });
                  },
                  icon: Icon(Icons.clear, size: 28, color: Colors.black),
                ),
              ),
            ),
          ),
        ),
        body: Padding(
          padding: EdgeInsets.all(15),
          child: LayoutBuilder(builder:
              (BuildContext context, BoxConstraints viewportConstraints) {
            if (isLoading) {
              return Center(
                child: CircularProgressIndicator(),
              );
            } else if (book != null) {
              return SingleChildScrollView(
                child: ConstrainedBox(
                  constraints: BoxConstraints(
                    minHeight: viewportConstraints.maxHeight,
                  ),
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.start,
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: <Widget>[
                      if (book!.image != null)
                        Container(
                          height: 200,
                          width: 150,
                          child: Image.network(book!.image!),
                        ),
                      BookRow(label: "Title:", value: book!.title),
                      if (book!.authors != null)
                        BookRow(
                            label: "Author(s):",
                            value: book!.authors!.join(' - ')),
                      if (book!.pages != null)
                        BookRow(
                            label: "Number of pages:",
                            value: "${book!.pages!} pages"),
                      if (book!.publisher != null)
                        BookRow(label: "Publisher:", value: book!.publisher!),
                      if (book!.datePublished != null)
                        BookRow(
                            label: "Published on:",
                            value: DateFormat.yMMMMd()
                                .format(book!.datePublished!)),
                      if (book!.synopsys != null)
                        BookRow(label: "Synopsys:", value: book!.synopsys!),
                    ],
                  ),
                ),
              );
            } else {
              return Text("ISBN example to test this app: 9781092297370");
            }
          }),
        ),
      ),
    );
  }
}

class BookRow extends StatelessWidget {
  const BookRow({
    Key? key,
    required this.label,
    required this.value,
  }) : super(key: key);

  final String label;
  final String value;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Padding(
      padding: EdgeInsets.only(top: 10),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Text(
            label,
            style: TextStyle(
              fontSize: 17,
              fontWeight: FontWeight.bold,
              color: Colors.grey.shade700,
            ),
          ),
          Text(
            value,
            style: TextStyle(
              fontSize: 17,
            ),
          ),
        ],
      ),
    );
  }
}