日语单词检索WebService 账户API和示例更新

为了让大家更好的了解WebService的API，本博客将定时更新示例程序，最新示例程序拥有了检索API和账户API部分的功能：

 上图演示的是账户登录后获取用户单词本的截图。

示例工程的源代码：WebServiceSample.rar

这次公布的API如下所示：

用户账户服务

地址：http://www.magicdict.com/WebService/AppAPI.asmx

方法

GetWordBookList

功能：

获得用户生词本

参数：

Username

用户名

Password

密码

Login

功能：

登陆

参数：

Username

用户名

Password

密码

NewAccount

功能：

新用户

参数：

Username

用户名

Password

密码

Email

电子邮件

OprWordBook

功能：

操作单词本

参数：

Username

用户名

Password

密码

IsAdd

是否为添加

WordID

单词号码

DictType

字典类型

DisplayText

表示文字

当前网站的账号只是用做操作生词本用的，登陆和新用户就不用介绍了。

GetWordList是一个获取指定用户的生词列表的服务，通过它，我们可以获得指定用户的生词本。

OprWordBook是一个操作用户生词本的服务，通过它，我们可以添加或者删除生词本中的内容。

生词本并不记录单词实体，只是记录了单词的字典类型和单词番号。

登陆和获得生词本的示例代码：

 1        /// <summary>
 2         /// 用户名
 3         /// </summary>
 4         String UserName ;
 5         /// <summary>
 6         /// 密码
 7         /// </summary>
 8         String Password ;
 9         /// <summary>
10         /// 获得生词本
11         /// </summary>
12         /// <param name="sender"></param>
13         /// <param name="e"></param>
14         private void cmdGetWordBook_Click(object sender, EventArgs e)
15         {
16             //定义服务
17             AccountAPI api = new AccountAPI();
18             WordBookInfo[] WordBookList = api.GetWordBookList(UserName, Password);
19             lstWordList.Items.Clear();
20             for (int i = 0; i < WordBookList.Length; i++)
21             {
22                 lstWordList.Items.Add(new ListViewItem(
23                     new String[] {(i+1).ToString(), 
24                                   WordBookList[i].WordID, 
25                                   WordBookList[i].DictType, 
26                                   WordBookList[i].DisplayText, 
27                                   WordBookList[i].LastEditTime.ToString() }));
28             }
29               
30         }
31         /// <summary>
32         /// 登陆
33         /// </summary>
34         /// <param name="sender"></param>
35         /// <param name="e"></param>
36         private void cmdLogin_Click(object sender, EventArgs e)
37         {
38             UserName = txtUsername.Text;
39             Password = txtPassword.Text;
40             //定义服务
41             AccountAPI api = new AccountAPI();
42             AccountResult t = api.Login(UserName, Password);
43             switch (t)
44             {
45                 case AccountResult.OK:
46                     MessageBox.Show("成功登陆");
47                     cmdGetWordBook.Enabled = true;
48                     break;
49                 case AccountResult.UsernameOrPasswordError:
50                     MessageBox.Show("错误的用户名和密码");
51                     break;
52                 case AccountResult.UnKnownException:
53                     MessageBox.Show("未知错误");
54                     break;
55                 default:
56                     MessageBox.Show("不应该在登陆里面出现的返回值");
57                     break;
58             }
59         }
60     }

如果任何人想做一个日语检索的桌面或移动应用，需要什么定制的网络服务，请使用博客园短信联系，更多API正在重构提取中。该工程的式样书正在整理中。

在线日语单词检索服务： www.magicdict.com