这篇文章主要是讲述如何通过豆瓣API获取书籍的信息,起初看到这个内容我最初的想法是在"C# 网络编程之网页简单下载实现"中通过HttpWebResponse类下载源码,再通过正则表达式分析获取结点标签得到信息.但后来发现可以通过豆瓣API提供的编程接口实现.
该文章仅是基础性C#网络编程文章,尝试测试了下豆瓣API,并没什么高深的内容.但希望对大家有所帮助,仅供学习.
(警告:文章仅供参考,提供一种想法,否则访问多次-10次被403 forbidden莫怪.建议认证使用豆瓣API)
一.豆瓣API介绍
在开发之前你需要申请创建一个应用,从而获取一个新的API Key(唯一标识你的Connect站点和API使用者).
正如豆瓣API快速入门(http://www.douban.com/service/apidoc/guide)中例子:这个示例中展示了使用API获得ID为1220562的书的信息, 请求的url如下(注意将{yourapikey}替换为你的API
Key).
http://api.douban.com/book/subject/1220562?apikey={yourkeyapi}
返回的XML文档如下所示:
<?xml version="1.0" encoding="UTF-8"?> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/"> <id>http://api.douban.com/book/subject/1220562</id> <title>满月之夜白鲸现</title> <category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#book"/> <author> <name>[日] 片山恭一</name> </author> <link href="http://api.douban.com/book/subject/1220562" rel="self"/> <link href="http://book.douban.com/subject/1220562/" rel="alternate"/> <link href="http://img3.douban.com/spic/s1747553.jpg" rel="image"/> <link href="http://m.douban.com/book/subject/1220562/" rel="mobile"/> <summary>那一年,是听莫扎特、钓鲈鱼和家庭破裂的一年。说到家庭破裂,母亲怪自己当初没有找到好男人,父亲则认为当时是被狐狸精迷住了眼,失常的是母亲,但出问题的是父亲……。</summary> <db:attribute name="isbn10">7543632608</db:attribute> <db:attribute name="isbn13">9787543632608</db:attribute> <db:attribute name="title">满月之夜白鲸现</db:attribute> <db:attribute name="pages">180</db:attribute> <db:attribute name="translator">豫人</db:attribute> <db:attribute name="author">[日] 片山恭一</db:attribute> <db:attribute name="price">15.00元</db:attribute> <db:attribute name="publisher">青岛出版社</db:attribute> <db:attribute name="binding">平装</db:attribute> <db:attribute name="pubdate">2005-1</db:attribute> <db:tag count="125" name="片山恭一"/> <db:tag count="59" name="日本"/> <db:tag count="53" name="日本文学"/> <db:tag count="36" name="小说"/> <db:tag count="31" name="满月之夜白鲸现"/> <db:tag count="14" name="爱情"/> <db:tag count="8" name="純愛"/> <db:tag count="8" name="外国文学"/> <gd:rating average="7.0" max="10" min="0" numRaters="322"/> </entry>
此时,我需要做的就是通过输入的URL获取返回的XML中的数据,通过HttpWebRequest和HttpWebResponse获取HTTP请求和应答,并解析XML中的信息(较难).后来我才发现如果想试验下API,豆瓣是允许在不申请API Key情况下进行API调用(每分钟请求不超过10次).也就是说我在程序中输入网址如下即可返回XML.
http://api.douban.com/book/subject/1220562
二.C#获取豆瓣书籍信息
1.添加命名空间
using System.Net; //HTTP using System.IO; //文件 流操作 using System.Text.RegularExpressions; //正则表达式 using System.Xml; //Xml文档
2.添加按钮点击事件
//点击按钮"获取信息" private void button1_Click(object sender, EventArgs e) { richTextBox1.Clear(); //获取输入的URL string url = textBox1.Text.ToString(); //HttpWebRequest对象实例:该类用于获取和操作HTTP请求 创建WebRequest对象 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url); //HttpWebResponse对象实例:该类用于获取和操作HTTP应答 HttpWebResponse response = (HttpWebResponse)request.GetResponse(); //构造字节流 StreamReader reader = new StreamReader(response.GetResponseStream()); //流从头读至尾 string xmlUrl = reader.ReadToEnd(); reader.Close(); response.Close(); //调用自定义函数获取XML信息 GetInfoXML(xmlUrl); }
3.自定义函数获取书籍信息
//获取豆瓣XML内容并显示 private void GetInfoXML(string xmlUrl) { try { //实例Xml文档 XmlDocument xmlDoc = new XmlDocument(); //从指定字符串加载xml文档 xmlDoc.LoadXml(xmlUrl); //实例解析、加入并移除集合的命名空间及范围管理 XmlNamespaceManager xmlNM = new XmlNamespaceManager(xmlDoc.NameTable); //将给定命名空间添加到集合 xmlNM.AddNamespace("db", "http://www.w3.org/2005/Atom"); //获取文档根元素 XmlElement root = xmlDoc.DocumentElement; //选择匹配Xpath(内容)表达式的结点列表 //函数原型:SelectNodes(string xpath,XmlNamespaceManger nsmgr) XmlNodeList nodes = root.SelectNodes("/db:entry", xmlNM); //获取子节点信息 foreach (XmlNode nodeData in nodes) { foreach (XmlNode childnode in nodeData.ChildNodes) { string str = childnode.Name; switch (str) { case "title": string name = "标题名称:" + childnode.InnerText + "\r\n\r\n"; richTextBox1.AppendText(name); break; case "author": string author = "作者:" + childnode.InnerText + "\r\n\r\n"; richTextBox1.AppendText(author); break; case "db:attribute": { //获取<db:attribute name="XXX">的属性 switch (childnode.Attributes[0].Value) { case "pages": string pages="总页数:"+childnode.InnerText+"\r\n\r\n"; richTextBox1.AppendText(pages); break; case "price": string price="价格:"+childnode.InnerText+"\r\n\r\n"; richTextBox1.AppendText(price); break; case "publisher": string publisher="出版社:"+childnode.InnerText+"\r\n\r\n"; richTextBox1.AppendText(publisher); break; case "pubdate": string pubdate="出版日期:"+childnode.InnerText+"\r\n\r\n"; richTextBox1.AppendText(pubdate); break; } break; } case "summary": //显示内容 WordWrap设置为true自动换行(无需调用Split函数或求字符长度) string summary="内容:"+childnode.InnerText+"\r\n\r\n"; richTextBox1.AppendText(summary); break; case "link": //结点属性是Attributes[0]却失败,不能获取 if (childnode.Attributes[1].Value == "image") { //获取image路径 <link rel="image" href="http://xxx.jpg"/> string imagePath = childnode.Attributes[0].Value; //下载图片 string imageName = "local.jpg"; System.Net.WebClient client = new System.Net.WebClient(); //下载指定URL资源到本地文件夹 //函数原型 DownloadFile(string address,string fileName) client.DownloadFile(imagePath,imageName); //从本地文件中加载图片 this.pictureBox1.Image = Image.FromFile(imageName); //图像原图大小 this.pictureBox1.SizeMode = PictureBoxSizeMode.Zoom; //下载第二张图片时总是出现"WebClient请求期间发生异常" } break; } //switch } //foreach } //foreach } catch (Exception msg) //异常处理 { MessageBox.Show(msg.Message); } } //GetInfoXML
4.运行结果如下
源网址中的书籍信息介绍如下图所示:
三.遇到的问题及总结
由上图可以发现我输入的网址没有包含API key也能获取,但我在测试时总是使用的.然后同时我也遇到了一些问题:
1.豆瓣API获取书籍信息接口,需要传subjectID或isbnID(国际标准书号),但我想实现的是只知道书名,就能获取书籍的信息,而不是仅仅传入一串URL,这些分析都让程序内容实现,这是接下来需要做的.
2.在使用WebClient和DownloadFile(string address,string fileName)下载图片时,当获取第二张图片总会提示错误"WebClient请求期间发生异常",不知道为啥,但不想使用stream或并发获取图片,仅想知道这是为啥?
3.这仅仅是一篇基础性的介绍使用豆瓣API的文章,目前豆瓣针对已经授权用户(开发API采用OAuth协议进行鉴权)可以实现很多功能,后面如果有时间可以写些“查看用户信息、用户友邻信息、增删改查用户收藏、查看评论”的文章.
最后希望该文章对大家有所帮助,如果文章中有错误或不足之处,还请海涵.同时文章也参考了一些资料,感谢这些作者.
(By:Eastmount 2014-5-2 下午3点 原创:http://blog.csdn.net/eastmount)
参考资料:
1.豆瓣API快速入门
http://www.douban.com/service/apidoc/guide
2.c#使用豆瓣API-sun8134
这里非常感谢该文章,在解析XML中我使用SelectSingleNodes方法失败后,参考了他的方法,也推荐大家去阅读
http://www.cnblogs.com/sun8134/archive/2010/12/15/1906879.html
3.豆瓣客户端-zh19900207 该文章仅有界面,但也是我想实现的功能描述
http://blog.csdn.net/zh19900207/article/details/8586000
4.XmlNode.SelectNodes 方法
http://msdn.microsoft.com/zh-cn/library/4bektfx9.aspx