|
楼主 |
发表于 2011-8-16 19:48:14
|
显示全部楼层
为了让大家更好的了解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.WordID,
25 WordBookList.DictType,
26 WordBookList.DisplayText,
27 WordBookList.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
网站地址 http://www.magicdict.com/
有兴趣的写信给我 root#magicdict.com [convert # to @ ]
或者加MSN mynightelfplayer@hotmail.com
|
|