《信息系统分析与设计新浪微博桌面客户端java版开发文档.doc》由会员分享，可在线阅读，更多相关《信息系统分析与设计新浪微博桌面客户端java版开发文档.doc（43页珍藏版）》请在三一办公上搜索。
1、信息系统分析与设计新浪微博桌面客户端java版开发文档目 录第1章 引言11.1 选题背景11.2 研究的目标和意义21.3 研究思路2第2章 系统的相关技术32.1 J2SE介绍32.2 OAuth验证机制32.3 JSON解析52.4 XML解析7第3章系统的分析123.1 技术可行性研究123.2 需求分析123.3 形式化说明技术143.3.1 形式化图表流程图说明143.3.2 形式化功能说明15第4章系统的设计164.1 总体设计功能图164.1.1 用户登录界面设计174.1.2 用户登录界面设计184.2 系统数据的设计20第5章 详细设计215.1 登陆界面设计215.2 验
2、证界面设计225.3 用户界面设计235.4 修改界面设计235.4.1 修改用户个人信息245.4.2 修改用户个人隐私245.4.3 修改信息提醒功能255.5 查找用户并加关注265.5.1 查找用户265.5.2 查找用户并取消关注275.6 关于帮助界面设计275.7 关于消息提醒界面设计27第6章系统的编程实现296.1 登陆验证296.2 登陆线程同步306.3 首页数据获取326.4 用户信息修改356.5 搜寻新用户366.6 刷新首页376.7 即时消息提醒37第7章 结论397.1 系统达到的目标397.2 后续改进39参考文献40致谢41附录42外文资料原文43译 文4
3、5第1章 引言第1章 引言1.1 选题背景21世纪以来，全球进入一个新经济时代互联网时代，互联网络和信息通信的迅猛发展创造了一个无疆界的数字世界，交易几乎可以瞬时在世界各地完成，服务产品也不例外。网络营销工具服务产品更有其独特的优势利用信息技术带来的便捷。近几年来，互联网发展的十分的快速，许多新型的网络媒体以及网络营销工具都应运而生。新浪作为一家服务于中国及全球华人社群的领先在线媒体及增值资讯服务提供商，拥有多家地区性网站，以服务大中华地区与海外华人为己任，通过旗下五大业务主线为用户提供网络服务的网站。此外，新浪是中国的四大门户网站之一，和搜狐、网易、腾讯并称为“中国四大门户”。目前，新浪网已
4、经成为下辖北京新浪、香港新浪、台北新浪、北美新浪等覆盖全球华人社区中文网站的全球最大中文门户。在这种竞争时代，针对现在互联网上如雨后春笋般不断冒出各类型的网络营销工具，新浪模仿国外知名的Twitter，并结合当前中国特有的现象，打造出适合国人的一个交流平台。新浪微博于2009年8月正式进入中文上网主流人群视野。根据相关公开数据，截至2010年1月，微博在全球已经拥有7500万注册用户。在2009年8月新浪网推出“新浪微博”内测版，成为门户网站中第一家提供微博服务的网站，微博正式进入中文上网主流人群视野。新浪微博作为国内第一个推出微博的网站，并同时在推广期间利用名人效应吸引大量用户，奠定新浪微博
5、的用户基础。根据首因效应，第一个大规模推广微博的网站势必在用户心中留下深刻印象。此外，新浪微博的平台从一开始就从运营模式着手，有一套较为完善成熟的审核机制，既可以满足中国互联网信息安全规则的需要，又不挫伤使用者的积极性，特别是在用户的分级制度上借鉴新浪“名人博客”的成功经验，利用名人效应和适当的炒作，很快就聚集了大量的人气，根据51免费论文NETJ控的社会化网络统计，新浪微博虽然才推出几个月时间，但已经在极短的时间内成为国内微博客的领跑者。1.2 研究的目标和意义通过对新浪官方提供的SDK(版本号 weibo4j-2010-12-27)的分析，理解了如何通过OAuth授权来请求服务器验证并获取
6、到数据。并且掌握了GET、POST、DELETE方法的使用，能够写出SDK中未封装的方法。在此基础上，通过Netbeans IDE7.0 开放平台，通过可视化开发界面，开放桌面JAVA版的客户端应用。意义是了解了新浪微博API的运行机制，如何对新浪提供的API接口去封装一个方法，对学习的能力有进一步的提升。开发的最终目标是能够实现桌面客户端JAVA版，并且实现新浪微博的基本功能，例如：让微博，发图片，搜索好友，获取微博信息等功能。1.3 研究思路应用程序主要是针对的新浪提供的SDK而展开的，再深入分析用户可能会用到的功能和用户喜欢的界面UI设计，实现新浪微博网页版功能，进而移植到桌面客户端，使
7、用户体验更加丰富和方便，并且在后续版本开放中，可以充分发挥桌面平台的优势，开发出更多和新浪微博相关的各种插件服务功能。在应用的开发中，主要要弄清是如何请求数据和发送数据的，对API接口需要从最初了解其功能到最终的掌握其方法。考虑到是即时通讯应用软件，并且微博更新的速度较快，主要侧重于“即时收发数据”，并且做到数据发送的完整和迅速。在整个系统中没有设置数据库来存放用户数据，只是在系统中设置了存放系统配置的文件。39第2章 系统的相关技术第2章 系统的相关技术2.1 J2SE介绍随着Internet网络的迅速发展，基于互联网的企业应用要求软件平台具有开放性、分布性和平台无关性。于是就相继出现了RP
8、C/COM/CORBA等技术，但这些技术在实际应用中存在着许多不足和局限。它们的特定协议难以通过防火墙，因而不适于Web上的应用开发。为了进一步开发基于Web的应用，出现了Sun公司的Sun ONE(Open Net Environment 开发网络环境)和Microsoft公司的。NET等Web 服务技术体系。 Sun ONE体系结构以Java语言为核心，包括J2SE/J2EE/J2ME和一系列的标准、技术及协议。它包括Sun独有的iPlanet软件系列，其中有在市场上受欢迎的LDAP目录服务器软件，以及Forte for Java便于在任何环境下书写Java 语言的软件工具。我们很容易就能
9、从网上免费获得和使用包括Java 集成开发环境、Java数据库和中间件(Application Server)服务器等产品，以及它们的源代码。Sun ONE更接近或能满足互联网在智能化Web服务方面对分布性、开发性和平台无关性的要求。2.2 OAuth验证机制OAUTH认证授权就三个步骤，三句话可以概括：1. 获取未授权的Request Token2. 获取用户授权的Request Token3. 用授权的Request Token换取Access Token当应用拿到Access Token后，就可以有权访问用户授权的资源了。这三个步骤是对应OAUTH的三个URL服务地址。上面的三个步骤中，
10、每个步骤分别请求一个URL，并且收到相关信息，并且拿到上步的相关信息去请求接下来的URL直到拿到Access Token。具体每步执行信息如下：A. 使用者（第三方软件）向OAUTH服务提供商请求未授权的Request Token。向Request Token URL发起请求。B. OAUTH服务提供商同意使用者的请求，并向其颁发未经用户授权的oauth_token与对应的oauth_token_secret，并返回给使用者。C. 使用者向OAUTH服务提供商请求用户授权的Request Token。向User Authorization URL发起请求，请求带上上步拿到的未授权的token与
11、其密钥。D. OAUTH服务提供商将引导用户授权。该过程可能会提示用户，你想将哪些受保护的资源授权给该应用。此步可能会返回授权的Request Token也可能不返回。如Yahoo OAUTH就不会返回任何信息给使用者。E. Request Token 授权后，使用者将向Access Token URL发起请求，将上步授权的Request Token换取成Access Token。请求的参数见上图，这个比第一步A多了一个参数就是Request Token。F. OAUTH服务提供商同意使用者的请求，并向其颁发Access Token与对应的密钥，并返回给使用者。G. 使用者以后就可以使用上步返
12、回的Access Token访问用户授权的资源。从上面的步骤可以看出，用户始终没有将其用户名与密码等信息提供给使用者（第三方软件），从而更安全。获取request token创建request token以及相应的密钥（secret）询问用户是否授权使用该客户端用户授权或者拒绝如果用户同意授权，则转向您的应用。用request token向新浪换取access token创建并返回access token 以及secret获取该access token 的信息并且获取用户的信息（图 2-1 OAUTH认证机制流程图）2.3 JSON解析JSON(JavaScript Object Notati
13、on) 是一种轻量级的数据交换格式。易于人阅读和编写，同时也易于机器解析和生成。它基于JavaScript（Standard ECMA-262 3rd Edition - December 1999）的一个子集。 JSON采用完全独立于语言的文本格式，但是也使用了类似于C语言家族的习惯（包括C, C+, C#, Java, JavaScript, Perl, Python等）。这些特性使JSON成为理想的数据交换语言。JSON 可以将 JavaScript 对象中表示的一组数据转换为字符串，然后就可以在函数之间轻松地传递这个字符串，或者在异步应用程序中将字符串从 Web 客户机传递给服务器端程
14、序。这个字符串看起来有点儿古怪，但是 JavaScript 很容易解释它，而且 JSON 可以表示比名称 / 值对更复杂的结构。事实上大部分现代计算机语言都以某种形式支持它们。这使得一种数据格式在同样基于这些结构的编程语言之间交换成为可能。JSON具有以下这些形式：对象是一个无序的“名称/值对”集合。一个对象以“”（左括号）开始，“”（右括号）结束。每个“名称”后跟一个“:”（冒号）；“名称/值 对”之间使用“,”（逗号）分隔。 （图 3-1）数组是值（value）的有序集合。一个数组以“”（左中括号）开始，“”（右中括号）结束。值之间使用“,”（逗号）分隔。 （图 3-2）值（value）可
15、以是双引号括起来的字符串（string）、数值(number)、true、false、 null、对象（object）或者数组（array）。这些结构可以嵌套。 （图 3-3） 字符串（string）是由双引号包围的任意数量Unicode字符的集合，使用反斜线转义。一个字符（character）即一个单独的字符串（character string）。 字符串（string）与C或者Java的字符串非常相似。 （图 3-4）数值（number）也与C或者Java的数值非常相似。除去未曾使用的八进制与十六进制格式。除去一些编码细节。（图 3-5）2.4 XML解析XML的解析方式有两种： 一是通过
16、文档模型解析，也就是通过父标签索引出一组标记。另外一种方法是遍历节点（document 以及 childNodes）。这个可以通过递归来实现，不过解析出来的数据仍旧是形式各异，往往也不能满足预先的要求。通过GET方法获取到的新浪微博数据是以XML或者JSON的形式返回的，这就要求我们要用XML类或者JSON类进行解析，通过某一个KEY来获取到其String值。对于XML解析，使用JDK自带类库操作XML。部分实现功能代码如下所示：/*XML类解析开始*/public static Dom newDom(String rootName) throws XmlExceptionDocument d
17、oc = null;try DocumentBuilder dombuilder = DocumentBuilderFactory.newInstance().newDocumentBuilder(); doc = dombuilder.newDocument(); doc.setXmlStandalone(true); catch (Exception e) throw new XmlException(e.getMessage(), e); Element root = doc.createElement(rootName); doc.appendChild(root); return n
18、ew Dom(root);public static Dom getRoot(InputStream is) throws XmlException Document doc = null; try DocumentBuilder dombuilder = DocumentBuilderFactory.newInstance().newDocumentBuilder(); doc = dombuilder.parse(is); catch (Exception e) throw new XmlException(e.getMessage(), e); Element root = doc.ge
19、tDocumentElement(); return new Dom(root);public static Dom getRoot(String xmlFile) throws XmlExceptiontryInputStream is = new FileInputStream(xmlFile);Dom root = getRoot(is); is.close(); return root; catch (Exception e) throw new XmlException(e.getMessage(), e);public String getAttributeValue(String
20、 attributeName)return e.getAttribute(attributeName); public boolean existElement(String elementName)NodeList nodeList = e.getElementsByTagName(elementName);if (nodeList = null) | (nodeList.getLength() 1) return false; return true;public String elementText(String elementName)Element element = (Elemen
21、t)e.getElementsByTagName(elementName).item(0);Node textNode = element.getFirstChild();if (textNode = null) return ;eturn textNode.getNodeValue();public Dom element(String elementName)NodeList nodeList = e.getElementsByTagName(elementName);if (nodeList = null) | (nodeList.getLength() 1) return null;
22、Element element = (Element) nodeList.item(0); return new Dom(element);public List elements(String elementName) List eList = new ArrayList(); NodeList nodeList = e.getElementsByTagName(elementName); if (nodeList = null) return eList; for (int i = 0; i nodeList.getLength(); i+) Node node = nodeList.it
23、em(i); if (node.getNodeType() = Node.ELEMENT_NODE) Element element = (Element) node; eList.add(new Dom(element); return eList;/*XML解析类结束*/加载用户选择文档指定了文档的内容类型吗？使用匹配的列表内容类型使用的是文档内容类型的最近子项的列表内容类型使用具有相同文档模板的第一个列表内容类型文档内容类型匹配列表内容类型吗？列表的文档内容类型是文档内容类型的子项吗？指定了文档的模板了吗？将默认的内容类型分配给文档上载文档并将匹配的属性升级到列表否是否是是是否（图2-2
24、 XML解析流程图）第3章 系统的分析第3章系统的分析3.1 技术可行性研究在申请课题之前，对新浪官方提供的SDK(版本号 weibo4j-2010-12-27)进行了分析。对SDK中封装的方法进行了测试，并且对未封装的方法也进行了重新的补充，在新浪的开发平台的“工具”中，对接口进行了相应的测试，（接口URL: 对SDK熟悉了之后，选择了Netbeans IDE 7.0作为开发环境，SDK的版本为jdk1.6.0_25，构架好开发环境后，首先进行了OAuth验证，返回request token后，用新浪微博账号进行授权，返回access token，在通过类解析获取到pin，通过pin和acc
25、ess token来获取到当前账号的信息，表示登陆已经成功。登陆成功后，表面可以通过此方法获取到用户的其他信息，并且可以对SDK中的方法进行测试了。先后测试了public_timeLine（获取到最新更新的用户微博，默认是返回20条信息），接着测试了favorites_timeLine（用户所关注的微博信息）和friends_timeLine（用户首页的微博信息）。测试完三种类型的微博列表后，至此已经可以得出一个结论，可以根据类似的方法获取到其他的微博列表，并且可以调整SDK中的方法。例如，可以增加方法List statuses = weibo.getFriendsTimeline(int c
26、ount);通过传递count值来设定返回的微博数（缺省值为20，最大的值为200）。至此，可行性研究已经结束，测试的结果表明，可以进行客户端应用的相关开发。3.2 需求分析可行性研究完成后，接下来经行的则是需求分析。对于一个桌面客户端，针对的是广大的用户，首先要从用户的角度出发，思考哪些是用户所需要的内容，哪些是用户最关心的内容，哪些是最吸引用户的内容等。对于客户端的功能。新浪微博首页URL: 新浪微博客户端JAVA版，主要实现了下面的功能：1. 用户OAuth登陆验证2. 用户界面UI的设计，微博icon的设计2. 获取用户的信息并在首页上显示3. 用户首页微博列表4. 随机用户微博列表5
27、. 关注用户微博列表6. 我列表7. 用户收到的评论列表8. 用户粉丝列表以及用户最新的一条微博信息9. 用户所有微博列表10. 页面翻页功能（默认返回每页20条微博信息）11. 登陆未读消息提醒，提示音设置12. 用户登陆后，即时消息提醒13. 搜索新用户，并且可以加关注14. 可以取消关注过的某个用户15. 用户个人设置，包括个人信息修改、用户隐私设置和消息提示音开关这三个方面的内容16. 发文字微博，发图片微博，发文字加图片的微博信息17. 对获取到的所有用户的微博消息的评论数、转发数的显示。18. 刷新首页数据19. 关于/帮助，主要介绍了应用的一些功能和使用方法。3.3 形式化说明技
28、术3.3.1 形式化图表流程图说明下图主要介绍了应用进行大体的流程图：SinaMain.java功能：程序的入口SinaLog.java启动功能：显示登陆框新用户第一次登陆是否授权（Y/N）选择N退出系统选择YSinaLoading.Java启动线程1启动，进度条显示，整个过程中进程1、2同步进程2启动登陆获取信息当获取用户信息完毕后，初始化用户界面，此时SinaFrame.java启动，并且即时获取消息线程SinaRemindThreadAfter.java启动。进入用户首页如果有新消息，调用SinaRemind.java类，显示弹出对话框用户选择1用户选择2用户选择3用户选择4用户选择N系
29、统退出System.exit(0);对用户做出的不同选择进行相应，显示相应的信息或者错误提示信息。整个过程中，线程互斥访问jTextPane1并显示获取到的数据。例如，当进程1获取完数据时，SinaFrame.flag=false当获取完数据以后，SinaFrame.flag=true;进程通过这种方式互斥访问，确保获取到的数据在显示的时候不会出现错乱的现象。（应用程序运行流程图）注：其中用户选择（N=1,2,3,4,5,6，），表示在需求分析中，所提到的各种已经实现了的功能。3.3.2 形式化功能说明新浪微博SDK提供的方法（略），下面列出自己写的类方法：SinaMain.java /程序的
30、入口 SinaLog.java /登陆界面 SinaAu.java /授权登陆frame SinaLoading.java /验证用户账号合法性的线程 SinaFrame.java /用户首页 SinaMentionThread.java /打开应用程序时的第一次提醒， SinaMentionThreadAfter.java /在SinaMentionThread.java运行结束后，启动并每隔15秒自动去获取服务器数据，看是否有新的消息，如果有新消息到达，则弹出对话框提示，10秒后自动关闭；如果没有消息到达，处于静默状态GetFriendsTimeLine.java /获取用户首页数据 Ge
31、tPublicTimeLine.java /获取随机微博数据 GetMentionsTimeLine.java /获取用户数据 GetUserFavoritesTimeLine.java /获取用户关注的数据 GetUserFollowersTimeLine.java /获取用户粉丝数据 GetUserTimeLine.java /获取用户数据 SinaRefresh.java /刷新首页 SinaModify.java /系统设置 第4章 系统的设计SinaSearch.java /用户搜索 SinaAbout.java /关于/帮助 SinaSendMessage.java /发文本信息
32、SinaSendPicMessage.java /发图片信息 SinaSendMotions.java /发表情信息 第4章系统的设计4.1 总体设计功能图总体设计主要包括下面3方面：验证界面、登录界面、用户界面。登录界面（OAuth授权登录）登录界面（登录进度条及信息显示）第二次跳过授权登录用户界面（用户可以使用各种功能）登录 成功退出新用户（图 4-1 总体设计功能图）4.1.1 用户登录界面设计（图 4-2 登陆界面设计）登陆界面主要分为3个部分，如（图4-2所示）：第1部分：应用程序LOGO设计。第2部分：用户名和密码输入框。第3部分：登陆按钮，主要采取了mouse事件来切换显示不同的
33、图片。产生动态的效果。4.1.2 用户登录界面设计（图4-3 用户界面设计）如图4-2所示，用户界面分为5个部分组成：第1部分：用户个人信息显示，主要包括：用户图像、昵称、描述、地理位置、粉丝数、被关注数、微博数。另有两个按钮功能：从上到下分别是刷新和查找功能。刷新：刷新用户首页数据；查找：查找用户所想关注的对象，并且加关注。查找用户已经关注过的对象，并且取消关注。第2部分：微博列表显示。可以显示的有以下7个方面：A: 用户的微博列表B: 随机用户微博列表C: 用户首页微博列表D: 关注的用户最新微博列表E: 用户的粉丝最新微博列表F: 用户自己的微博列表G: 以上每隔列表中，均显示每项博文转
34、发（transmit）数和评论数（comments）第3部分：状态提示信息和翻页信息这部分主要实现：如果用户选中了某个列表页面，会有相应的提示，当用户发表文字微博的时候，会动态显示用户还能输入多少字符（一次微博最多可以发280个字符，即140个汉字）。最右边的是左右翻页功能，当选中某个页面显示的时候，会把标志位置成相应的标识，当翻页的时候，会根据标识位决定是对哪个页面进行翻页。当每页获取到（20/20）时，表示当页信息获取完毕。第4部分：用户微博文本输入区这部分主要实现：接受用户输入的字符，并且传递出去。当用户的输入为空的时候，会提示用户“输入不能为空”。第5部分：功能按钮区域功能从左到右依次
35、为：设置、我、随机数据、用户首页、发表情、发图片、发微博。其中每个功能均使用到一个独立的线程，线程之间互斥访问第5章 详细设计jTextPane1（第2部分区域），显示相应的数据，确保jTextPane1在显示数据的时候不会发生混乱。在本界面进行UI设计的时候，为了增加动态效果，在鼠标经过某个按钮的时候，采用下面的方法，例如：当鼠标进入jButton4的时候private void jButton4MouseEntered(java.awt.event.MouseEvent evt) jButton4.setIcon(newImageIcon(getClass().getResource(/s
36、rc/home_1.png); b.当鼠标离开某个jButton4的时候private void jButton4MouseExited(java.awt.event.MouseEvent evt) jButton4.setIcon(newImageIcon(getClass().getResource(/src/home.png);4.2 系统数据的设计输入框接收用户输入，获取一个String值Weibo实例化对象weibo（OAuth验证）用户输入数据读取配置文件中的Access token一个读入文件流对象weibo.getPublicTimeLine();调用各种方法新浪服务器http
37、协议相应请求，返回XML或者JSON解析XML或JSON（图 4-4 系统数据的设计图）上图反应了获取新浪微博服务器上的数据所要经历的一些步骤，在整个过程中，授权（OAuth）和对返回来的数据的解析是最主要的两个方面。第5章 详细设计5.1 登陆界面设计（图5-1 登陆界面）登陆界面采用的是Color(102, 102, 255)的背景，如（图5-1所示），左右按钮分别采用的是两张图片，当鼠标经过的时候，显示另一张图片，以右边的登陆界面为例，当鼠标经过时候，切换成另一张图片，代码如下private void jLabel4MouseEntered(java.awt.event.MouseEve
38、nt evt) jLabel4.setIcon(new ImageIcon(getClass().getResource(/src/log_1.gif);private void jLabel4MouseExited(java.awt.event.MouseEvent evt) jLabel4.setIcon(new ImageIcon(getClass().getResource(/src/log.gif);5.2 验证界面设计（图5-2用户是否授权使用客户端）当用双击打开jar应用文件后，首先会通过OAuth验证：具体的过程为，首先通过调用SDK中的Weibo.java 新建一个对象Wei
39、bo weibo=new Weibo(); 通过weibo.getOAuthRequestToken(); 方法会得到返回的requestToken，此时要求用户选择是否授权使用该应用，会弹出如上（图5-2）的对话框：（图5-3 验证界面）如果用户选择“是”，则会进入验证阶段（图5-3所示），如果用户选择“否”，则会调用方法System.exit(0);直接退出客户端。当用户授权后，会传递出用户名userId和passwd，此时通过name_password=userId=+s1+&+passwd=+s2; postUrl(requestToken.getAuthorizationURL()+
40、&oauth_callback=xml&display=xml&+name_password); 来得到返回的XML，通过对XML的解析类parseXml获取到pin = parseXml(xml);accessToken = requestToken.getAccessToken(pin);weibo.setToken(accessToken.getToken(),accessToken.getTokenSecret();此时weibo对象已经可以来直接通过GET方法来获取新浪微博服务器上的数据了。至此，OAuth验证结束。5.3 用户界面设计（图5-3 用户个人信息）通过上面的方法已经实例
41、化一个weibo对象后，便可以通过GET方法来获取服务器数据了。首先要初始化用户数据，以下所用的方法依次获取到用户id、地理位置、screenName、关注人数、图像、被关注的人数、发微博次数、心情短语。id=weibo.getAuthenticatedUser().getId()+; location=weibo.getAuthenticatedUser().getLocation().toString();screenName=weibo.getAuthenticatedUser().getScreenName().toString();friendsCount=weibo.getAuth
42、enticatedUser().getFriendsCount();pfileImageURL=weibo.getAuthenticatedUser().getProfileImageURL().toString();followersCount=weibo.getAuthenticatedUser().getFollowersCount();statusesCount=weibo.getAuthenticatedUser().getStatusesCount();description=weibo.getAuthenticatedUser().getDescription();然后把获取到的数据在jFrame中的jPanel1中显示出来，效果如（图5-3所示）。5.4 修改界面设计本界面实现的功能主要是对用户个人信息的修改，对用户隐私设置的修改，对系统提示音的设置这三个方面。5.4.1 修改用户个人信息（图5-4 修改用户数据）修改用户个人信息数据如（图5-4所示），首先通过方法获取到用户昵称、用户描述、用户博客地址、和用户ID的消息，如果用户需要修改个人信息，则需要把“修改个人信
