https://www.gravatar.com/avatar/7a0c24f697ea1587001c36d00039b60f?s=240&d=mp

Eclipse用法:使用Javadoc导出项目的API文档

技术文档是项目的重要组成部分,Javadoc则是Java技术文档的基础之一。Javadoc为Java代码生成一组便于使用的API文档,作为沟通工具,这些文档可提供有益的帮助,使团队成员理解其他成员正在进行的工作。

当然,要获得良好的Javadoc文档,要求源代码中有精心编写的有意义的注释,对任何工具而言,这都是苛刻的要求。这不是本文的重点内容。

本文将具体讲述使用Eclipse开发工具导出项目的Javadoc文档的步骤和常见的问题。

 

  • **Eclipse导出文档操作步骤 **  
  1. 根据Javadoc文档的说明标准,对项目中的类、接口等文件精心编写注释(具体注释要求,请见《如意彩客户端编码规范文档》-注释规范)。

  2. 选中要生成javadoc的项目,右键->Export(导出)。选择Java->javadoc,点击Next>。 http://img.blog.csdn.net/20130828174310578?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvcDEwNjc4Njg2MA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

  3. 分别选择如下选项,点击Next。 javadoc command:设置javadoc命令的路径。

select types for which javadoc will be generated:选择需要生成的项目

Create javadoc for members with visibility:选择生成文档的类和方法的访问范围。

Destination:选择生成文档的目标目录。

http://img.blog.csdn.net/20130828174349625?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvcDEwNjc4Njg2MA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

  1. 在Documenet title中填入生成文档的名称,其它选择默认,点击Next。 http://img.blog.csdn.net/20130828175055093?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvcDEwNjc4Njg2MA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

  2. 在VM options中填入

,具体的编码方式,根据你的项目 的编码方式决定。点击Finish。

注意:如果编码方式不对,会出现编码错误报错!!!

http://img.blog.csdn.net/20130828174827593?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvcDEwNjc4Njg2MA==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

u3d接口回调的方式

在u3d开发中,如果想传递一个接口道另一个脚本中回调,需要传递当前脚本绑定的游戏对象

比如

this.gameObject;

在接收接口的脚本中,获取接口的方法如下

Interface myInterface = (Interface) GetComponent(typeof(Interface));

参考:http://answers.unity3d.com/questions/60357/getcomponent-and-interfaces.html

android中intent.setFlags方法中的参数值含义

一. intent.setFlags()方法中的参数值含义:

1.FLAG_ACTIVITY_CLEAR_TOP: 例如现在的栈情况为:A B C D 。D此时通过intent跳转到B,如果这个intent添加FLAG_ACTIVITY_CLEAR_TOP标记,则栈情况变为:A B。如果没有添加这个标记,则栈情况将会变成:A B C D B。也就是说,如果添加了FLAG_ACTIVITY_CLEAR_TOP标记,并且目标Activity在栈中已经存在,则将会把位于该目标activity之上的activity从栈中弹出销毁。这跟上面把B的Launch mode设置成singleTask类似。简而言之,跳转到的activity若已在栈中存在,则将其上的activity都销掉。

**2.FLAG_ACTIVITY_NEW_TASK:**例如现在栈1的情况是:A B C。C通过intent跳转到D,并且这个intent添加了FLAG_ACTIVITY_NEW_TASK标记,如果D这个Activity在Manifest.xml中的声明中添加了Task affinity,系统首先会查找有没有和D的Task affinity相同的task栈存在,如果有存在,将D压入那个栈,如果不存在则会新建一个D的affinity的栈将其压入。如果D的Task affinity默认没有设置,则会把其压入栈1,变成:A B C D,这样就和不加FLAG_ACTIVITY_NEW_TASK标记效果是一样的了。注意如果试图从非activity的非正常途径启动一个activity(例见下文“intent.setFlags()方法中参数的用例”),比如从一个service中启动一个activity,则intent比如要添加FLAG_ACTIVITY_NEW_TASK标记(编者按:activity要存在于activity的栈中,而非activity的途径启动activity时必然不存在一个activity的栈,所以要新起一个栈装入启动的activity)。简而言之,跳转到的activity根据情况,可能压在一个新建的栈中。

3.FLAG_ACTIVITY_NO_HISTORY:例如现在栈情况为:A B C。C通过intent跳转到D,这个intent添加FLAG_ACTIVITY_NO_HISTORY标志,则此时界面显示D的内容,但是它并不会压入栈中。如果按返回键,返回到C,栈的情况还是:A B C。如果此时D中又跳转到E,栈的情况变为:A B C E,此时按返回键会回到C,因为D根本就没有被压入栈中。简而言之,跳转到的activity不压在栈中。

4.FLAG_ACTIVITY_SINGLE_TOP:和Activity的Launch mode的singleTop类似。如果某个intent添加了这个标志,并且这个intent的目标activity就是栈顶的activity,那么将不会新建一个实例压入栈中。简而言之,目标activity已在栈顶则跳转过去,不在栈顶则在栈顶新建activity。

二.intent.setFlags()方法中参数的用例:

很多人使用startActivity时候,会碰到如下的异常: Caused by: android.util.AndroidRuntimeException: Calling startActivity() from outside of an Activity  context requires the FLAG_ACTIVITY_NEW_TASK flag. Is this really what you want? 都知道,Context中有一个startActivity方法,Activity继承自Context,重载了startActivity方法。如果使用Activity的startActivity方法,不会有任何限制,而如果使用Context的startActivity方法的话,就需要开启一个新的task(编者按:参见一.2.的编者按),遇到上面那个异常的,都是因为使用了Context的startActivity方法。解决办法是:Java代码中加一个flag,即intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)。这样就可以在新的task里面启动这个Activity了。

 

原文地址:http://blog.csdn.net/berber78/article/details/7278408

3014考古重大发现(搞笑)

网络传播的,来源没找到,转发过来。

3014年,考古现场内,人头攒动,工作人员小心地刨去旧土,正在进行紧张的补救处理。

陈教授认为,301号墓室可能追溯到1000年前,墓主年龄不大,在生前似乎颇有显赫地位,之所以这样判定,乃是因为在墓室中,还发现了3位陪葬人员,3位人牲可能是奴隶,也可能是墓主的妾室,在DNA鉴定前,暂时无法确定。

“1位墓主,3位陪葬,这在同时代出土的墓室中,是不多见的,我想我们要改写历史了。”

张教授却持不同意见,他哼了一鼻子,看起来很不屑。

“老陈啊,你还是要加强你的姿势水平啊,你难道不知道,1000年前,有一种墓室,叫学生宿舍吗,往往都是4人合葬,高低错落,你凭什么认为,这就是陪葬?我看呐,是群葬!“

记者们一片哗然,纷纷掏出小本子记录。

陈教授摆摆手,他认为,现在不是讨论下葬规格的时候,只要弄清了墓主的身份,自然迎刃而解。

张教授摇摇头,叹了口气。

“老陈啊,谈何容易,我们发现,原本墓室中的卫生纸,已经被盗墓者盗取了,证据就是在墓室上方发现了一个盗洞。”

陈教授如遭雷击,因为按照考古常理,只要找到卫生纸,就能通过还原其上的DNA,精准的定位墓主身份,至于为什么总是能在卫生纸上发现DNA,至今还是一个未解之谜。

“这是我国考古界的又一大损失!”

“不慌,虽然没找到卫生纸,但是我们发现了这个!”

陈教授挥挥手,助手捧上密封袋,从里面儿小心捏出个手掌大小的塑料块儿。

“这是什么?”陈教授问。

张教授微微一笑。

“我想我们终于发现了传说中的陪葬品——手机。”

隔空对话,凭空取像,还能发表情,震动,甚至与人对话,考古界一直认为这只是古人的臆想,没想到,今日发现了第一例实物。

“放屁!三星堆出土的那台三星,大是大,但后来经过考据,只是个切菜用的砧板,我看这个塑料壳子,搞不好是块儿窑砖。”

张教授摇摇头,说老陈啊,你的姿势水平落后就算了,还急躁,你只看外形,却没有注意花纹,我们仔细的清理过,在这台手机的背部,有一块儿浅浅的印花,确实出自古人笔法,造型类似苹果,我们认为,这个手机,很好的代表了乔家坡遗址的S型上层文化。

见陈教授还是不服,张教授戴上白手套,捏过那台塑料壳子,在右侧突起轻轻长摁。

开机了。

“我操。”

记者们炸锅了,闪光灯不停。

“老陈,它还有电。”

陈教授蹲在地上,哭得泣不成声。

“这是我国考古界的大发现啊!”

陈教授认为,这台手机,按规格,和罗家店发现的4号殉葬人牲,既传说中的软体女尸一样,是我国,不,是世界考古大发现。

“不一样,我认为那件所谓的软体女尸,应该不是人牲,反倒是奴隶制后期出现的人牲替代品,墓室中罕见,但不能说没有,文献中有记载的名称,应该是充气娃娃,这东西在档次上不如手机,我们这个,才是真正的国宝。”

正说着,手机的屏幕亮了。

陈教授说,老张,不管别的,咱们先看看,能不能从手机上找出墓主的身份,携此神器入葬,这人绝非常人,只怕是皇室也未可知。

“一个皇帝,一个历史上漏掉的皇帝,天呐…”

众人的视线下,张教授轻轻点击铃音。

“通过古曲,我们能轻易的辨别墓主的文化年代,因为不同时期的文化作品,有非常显著的区分。”

随着张教授的点击,一阵叮咚作响的古曲从手机中飘出,时隔1000年,还是如此美妙,众人屏息凝神,陶醉其中。

“今天,我怎——么不开心?”

“摩擦,摩擦…”

陈教授一拍桌子,不用说了,确实是1000年前的作品,这首曲子,应该是原始人类在失恋后的自然感情流露,在现今的河北一代仍有流传,如果我猜的没错,这首曲子,叫做我的花瓣靴。

“对对,我奶奶就会唱,我的花瓣靴,最是伤,是伤是伤,最是伤。”

有河北记者表示赞同。

“那么好,我们来看它的界面,我认为,手机的界面,能够判定墓主的生活习惯。”

随着张教授的拨弄,界面上出现了各种软件,当然,现在它们都处于停用阶段,但是能够与古人一样轻触屏幕,张教授垂老的手指仍然不住抖动。

“老陈,你看。”

随着张教授点开一款叫微信的软件,众人的心都揪到了嗓子眼。

软件中,出现了许多照片,都是古代的美女,尖下巴,大眼睛,穿着古代人称之为丝袜的礼服。

“好漂亮。”

张教授不禁喃喃自语,这些自拍被上传到大屏幕上,台下的记者们也经不住点头,全身说不出的火热。

“这么多漂亮的女人,墓主地位显赫是必须的,这些女人如果不是她的妻妾,那很可能是嫔妃,我依然认为,墓主是一位帝王。”

“是啊,这么多漂亮的嫔妃,这位帝王只怕是纵欲而死,历史上的名声不好,所以直接被史官抹去了吧。”

张教授擦了擦鼻血,指着其中一张。

”你看,这个女的,胸脯很大,确实符合1000年前以胸为美的价值观…等等,这个女人的名字怎么是四个字…"

“老张啊,这应该是古代东瀛敬献的美女,这位帝王,艳福不浅啊。”

众人哄笑,老张一震,浑身如同过电一般,若不是助手上前搀扶,只怕就要脑溢血而亡,他是太激动了,因为这一刻,就像一道闪电,照亮了我国考古界的永夜。

“这…这里有聊天记录!”

“在吗,女神?” >

“呵呵。” >

“在干嘛呢,女神。” >

“去洗澡了哦,等会聊。” >

“睡了吗?” >

“恩。” >

Android SDK国内更新

如果不嫌麻烦,可以直接用代理和VPN,可以选择GoAgent, Shadowsocks 和 OpenVPN。(ps: goagent 我遇到证书问题没有解决)以下是更改hosts直接更新的办法。

Mac/Linux 直接在 /etc/hosts 中,Windows在 X:\Windows\System32\drivers\etc\hosts (X为你的系统盘符) 添加如下项:

更新 Android Studio 和 InteliJ IDEA 插件所需

54.247.69.204   plugins.intellij.net

更新 Android SDK 的地址

203.208.46.146  dl-ssl.google.com

随后在 SDK Manager 选项中勾选 Force https://...source to be fetched using http://… 如此即可。

原文:http://www.cryse.org/android-studio-sdk-update-in-china/