标签：netbeans

说实话，这个插件等了很久了。自从NB升级到7.0了，原来的scala插件就再也不能用了，即使用了以前的插件，也无法在新版的NB下运行。
直到前一阵子才发现，原来，终于有人更新了这个插件。。
怕多介绍了之后会影响别人的想法，我也不能过分主观的说太多这个插件的优点，就平常的介绍一下下吧。官网地址是：http://plugins.netbeans.org/plugin/36598/nbscala-2-8-x

官方的介绍就一句话：Scala plugin for NetBeans 7.0, works with Scala 2.8.x
附了一张小图片：


想用的人可以开始用了。

这两天一直在试用phpstorm，本以为这个IDE是基于IntelliJ IDEA的，所以性能上不会有太高的体现，但在整体试用过程中，却发现，它果然还是一个不错的软件。当然你说它吃内存不？嗯，比较吃内存，但它有一个调节功能，如：power safe mode，可以在降低IDE性能的同时，释放一部分资源。

而且该软件在状态栏有一个内存使用情况，单击还可以释放内存，看到那个483了没，表示它最大会占用483M内存。于是你到任务管理器的时候，它最多可以占用483.。。不会再上去了，不象netbeans或者firefox之类的特占内存软件一样，会持续上升。

在试用过程中，觉得软件对于对象的识别和智能完成确实不错，对于HTML等的校验也相对比较完善。当然对于代码中错误的定位、warning等的显示都比较迅速和快捷，不象netbeans那样较缓慢，让人几乎感觉不错这是一款基于java的软件。实在让人吃惊。

软件的启动速度和打开速度都是非常的惊人，对于版本控制软件也支持的挺好，扫描项目的时间也相对netbeans来说较短。总体来说，不错

软件有点大，70M，不过，这是含 Jre的版本，这样说来，它其实与netbeans也差不太多了。毕竟，netbeans 46M+jre，也差不多70M了，而且这样的版本里，还有一些插件是不全的，还需要额外下载。
安装完后，240多M与netbeans+jre的大小也差不多。
嗯，快捷页和字符编码以及IDE的字体需要额外的调整一下，我是对着netbeans调整的，而且把快捷键也设成了与netbeans一样。一下子就适应了过来。HOHO
不过，netbeans有一个功能是phpstorm没有的，那就是，将项目save to other directory，这个功能非常好，它使得我在用svn的项目时，可以将代码export到WEB目录下，对于这个目录里的测试，所生成的一些无用文件等不会影响到svn目录，不会污染原SVN项目。phpstorm没有该功能，遗憾啊。。。

昨天安装的ubuntu到今天也算是差不多有一天了，用起来嘛，没有什么明显的障碍，事实上和以前的区别也不是特别的大，所以其实上我更多的就是在尝试使用新的界面。
安装好ubuntu后，第一步就是update和重新更换语言包，添加五笔输入法，这些搞定后，我接着就是apt-get install sun-java6-jre，然后在运行的时候同时去netbeans.org下载了netbeans，然后更新了我的firefox所有常用插件，并把我在台式机上的收藏夹，密码，同步了回来。再装了svn就一切都几乎和以前一样了。

接着就是一直操作新界面，起初的时候觉得还行，因为就象一个快捷方式在左边或者说状态栏在左边，但紧接而来的问题就是，该界面学苹果学的不像呀。把菜单栏缩在以前的顶部状态栏上，OK，这没问题，但是窗口用着用着就突然无法正常最大化了也不能拖动了，最明显的就是我用firefox的时候，按ctrl+u看源码，居然就随便浮动了一个小窗口在右侧不能放大不能缩小不能移动。害得我源码也无法看。然后鼠标移动到顶部菜单栏后也无法双击放大缩小（那个控制按钮不见了，firefox刚启动的时候会有这些控制按钮），这反而影响了我的工作效率。所以，在使用了两三个小时后，我退出了这个界面，回到了gnome。。。。。
其实，新界面还是很不错的，至少他的程序组菜单就相对比较方便，只是我更喜欢把常用的拖出来（虽然他可以拖到左侧那可以自动隐藏的状态栏上并锁定在上面，但左侧那一条的反应好象不是特别灵敏，或许是我的机器太烂了吧？）

最后插一句，如果想回到gnome，很方法的，注销当前用户，然后登录的时候，界面选择ubuntu classic就OK了，以后会自动认到gnome的。

我不知道是我的PHPDOC版本有问题还是有我的netbeans版本有问题，反正，我在netbeans里调 用生成phpdoc没有成功
但是我在命令行下，以及WEB管理界面，我都成功生成了。

OK说一下我的步骤
1、下载phpdocumentor并解压到某个目录
2、修改phpdoc.bat，把set PHPCli的路径改成我的PHP实际路径
3、在命令行下运行phpdoc，会提示你选择哪一个INI文件，选择0.即使用默认的phpdocumentor.ini
4、然后运行。。phpdoc -d xxx -t xxx就over了。
这是最简单的方法
然后是进入WEB管理，这时候，要把phpdocument解压到WEB可访问的目录下，打开http://localhost/xxx/phpdoc.php会跳转到builder目录下
然后设置一下directoy目录和Target目录。同时也可以选择生成的格式，最后选择create，就直接创建成功了。。

然而我在官方的介绍下（视频）我却没有配置成功。。。不知道怎么回事，想知道官方是怎么下载的，可以到官方看一下视频。。。地址是：http://netbeans.org/kb/docs/php/screencast-phpdoc.html



如果觉得我说的简单，这里有一份比较详细的介绍：

写文档是一项乏味却不得不做的工作，而编写API级的文档更是意味着大量的重复劳动和难以保持的一致性。这里我们要推荐给大家的，是支持PHP5语法分析的文档工具——phpDocumentor。

使用phpDocumentor不仅可以自动从代码中提取出函数和方法定义，还可以自动处理各个class之间的关系，并据此生成class tree。你还可以选择将文档生成html、chm或者pdf。有了phpDocumentor，文档工作变得轻松了很多。


安装phpDocumentor

在pear下安装phpDocumentor是一件极其简单的事情，只需要在cmd窗口中cd 到php安装目录下，然后输入

Pear install phpDocumentor


Pear就会自己下载并完成phpDocumentor的安装。

在phpDocumentor成功安装后，php安装目录下会多出来一个phpdoc.bat。这个文件就是我们用来生成文档的批处理文件了。

〈? 相关知识 ?〉


phpDocumentor是phpDoc的升级版本，是专门为支持php5语法而重写的文档工具，当你的php版本为5时，运行phpDoc.bat，它会自动去调用phpDocumentor。所以文章中的提到的phpDoc和phpDocumentor实际上是相同的。

在phpdoc.bat所在目录下，输入

Phpdoc –h

会得到一个phpDocumentor的详细参数列表。

我们从其中选出几个常用的来看看：

〈? 命令解释 ?〉

-f
要进行分析的文件名，多个文件用逗号分割

-d
要分析的目录，多个目录用逗号分割

-t
生成的文档的存放路径

-o
输出的文档格式，结构为输出格式:转换器名:模版目录，例如：HTML:frames:phpedit

我们会用到的就这几个了，其他的命令请大家阅读help的提示信息。

试用phpDocumentor

下面我们就以pear中的phpUnit2为例，演示一下如何使用phpDocumentor来生成文档。

首先，把我们需要的参数确定下来：

〈? 命令参数 ?〉

-d
C:Program FilesEasyPHP5phpPEARPHPUnit2

-t
C:Program FilesEasyPHP5phpphpunit2doc

-o
HTML:frames:phpedit


根据上边的参数，我们组合出下边的命令：

Phpdoc -d “C:\Program Files\EasyPHP5\php\PEAR\PHPUnit2” -t “C:\Program Files\EasyPHP5\php\phpunit2doc” -o “HTML:frames:phpedit”
运行上边的命令后，phpDocumentor开始解析源文件并输出工作信息。

命令运行完成后，我们的文档就已经生成好了。 进入我们指定的目标目录，用浏览器打开index.html就可以看见生成的文档了。 文档界面由frame分成了三个部分，左上是包信息，左下是导航信息，右边则是详细的信息呈现页。

上边的图很清楚地描述出了文档的内容： (膘叔：原文就没有图。)

索引、函数列表、类列表、文件列表和子包。

点击上边的class(es)链接，我们可以清晰的看见整个包的class tree。




我们点击其中一个class，就进入了class的描述页面。

Class描述页面主要包含以下几方面内容：



l 描述：版权、作者、类层次等

l 类变量

l 类常量

l 方法

l 继承的变量

l 继承的方法：非常有用的一个功能

怎么样，是不是很详细呢？如果要生成chm，可以把前边的-o参数改为”CHM:default: default”，这样phpDocumentor会为你生成好chm项目文件，只要用微软的chm工具进行编译就可以得到可用的chm文件了。


用phpDocumentor为自己的代码生成文档

虽然phpDocumentor可以自动从代码中分析出一些信息，但是，要形成一份详尽的文档还是需要我们在编码中进行配合的。为了让phpDocumentor读懂我们的代码，我们需要注意一些编码规范和在注释中增加一些tag：

〈? Tags ?〉

@author
作者信息

@const
由define定义的常量

@deprecate
不建议使用的API

@global
全局变量

@package
包信息

@param
函数参数

@return
返回值

@see
参考函数

@since
引入时间

@static
静态变量

@var
类成员变量

这里只是简单的列出了常用的一些Tag，大家可以阅读phpDocumentor的文档，里边有非常详细的编码规范。关于phpDocumento就介绍到这里，希望大家都能好好利用这个工具来规范自己的文档。

PS：phpDocumentor也有Web界面的，你可以访问http://phpdoc.org获取Web版本。Web版本的安装很简单，直接放到web可以访问的目录就可以运行了。


〈? 环境要求 ?〉

PHP：5.0.0

OS: 平台独立，本文演示OS为windows

这里还有一篇操作步骤的：

phpDocumentor有两种正式的安装方法。
（以下都翻译自pear.php.net的文档, -- xieye --）

第一种方式是从pear.php.net 或 sourceforge.net下载压缩包并解压。另一种方式是通过pear安装

注意：以下假定用户使用PHP5，window系统！

第一种方法：
下载后，如果希望使用命令行接口，解压到任意路径（假设在C:\Program Files\），
修改C:\Program Files\PhpDocumentor-1.4.2\phpdoc.bat
把第一行修改SET phpCli=C:\usr\local\php\cli\php.exe
令等号右边的值为php.exe的路径
我的机器是SET phpCli=D:\php5\php.exe

在命令行输入C:\Program Files\PhpDocumentor-1.4.2\phpdoc,其实是一个批处理文件
会出现一个dos界面，给你选择ini文件。
后面就不知道了。


如果想使用web接口，你必须先把apache和php装好，把PhpDocumentor-1.4.2这个文件夹
拷贝到文档根目录下，然后在浏览器url栏输入：
http://localhost/PhpDocumentor-1.4.2/phpdoc.php
然后浏览器会自动跳转，选择index.html,后面的操作就很简单了。





第二种方法：通过pear安装
进入dos的php目录
输入pear install -a PhpDocumentor

如果想使用web接口，则必须首先改变一个配置，
pear config-set data_dir /path/to/document_root/pear
最后的路径应该是/php文档根路径/pear
(也可以在web接口中改变这个值)

我没在第二种方法的web接口试验成功。


如果使用web接口的话，还有选择，
一种是每次都选择输入文件，输出文件之类。
另一种是使用一个配置文件，里面把什么都定义好，
进入页面后，先选择这个配置文件，然后点击“创建”按钮，

这次nightly build的BUG太让人郁闷了，已经影响到我的正常开发了。。

动不动就抛个出错的异常，比如：Trying to remove null annotation

有人就提问了（不是我）。。。

I have had no end of trouble with 20110208000 (I was unable to get
latest beta this morning).

My problems have mostly revolved around editing properties files.

So far today I have received:

IllegalStateException: Trying to remove null annotation 8
URL Loading Failed with 502 error 7
IllegalStateException: limitOffset=xxxx > docLength=yyyy 6
Checking Password Failed 2
Read Timed Out 5
Junit failed to install properly


This is just from editing the single properties file.

I have submitted multiple errors, both through the "report issue" and
the "review&
& report" methods. The "report issue" is working, but the "review &
report" appears to be failing consistently,


Eric M. Smith

收到的回复是。。。

Hi Eric,
we faced a problem during the day with the server logging exceptions. It
should be fixed now and we'll do our best to avoid such situation in the future.

Thanks for understanding and your help,
*Marian

好吧，我就等他们的修复了，只是，等待是最让人难熬的事情。。。我现在是一删除空行什么的就出错，还有就是有时候括号匹配的时候如果多了少了，就立马抛出异常，抛就抛呗，editor居然白屏，看不到编辑的内容。。。这才让人郁闷。

最近，使用UBUNTU作为了我在单位的常用开发环境，虽然有时候还是不太习惯，但大多时间里我还是能够顺利的使用了。
比如，我的开发工具选择了Netbeans这个基于JAVA的IDE，他有一个好处就是跨平台，因此，在WIN用使用了它之后，到LINUX下再使用的时候，就很顺利了（而且MAC下面也有该软件，如果哪天我用MAC了，它也能用，HOHO）

浏览器，FIREFOX，这个就不多说了，反正我的插件和WIN下一样（fastdial,firefox sync,search status,firebug,firecookie,readitlater等），也没有什么不习惯的地方了。

没有editplus，但是有gedit。

邮件，没有foxmail，但是有很多类似的，比如thunderbird

FTP，我在win下用filezilla因此，UBUNTU下也可以用这个，很爽。

唯独几个不爽的就是IM了，都不太好用。MSN吧，不太好，GTALK算是比较正常的，QQ吧，问题多。。不得已，经用virtualBox装了一个虚拟机，里面跑起了XP，然后在里面跑QQ。。。（最主要的原因是WEBQQ和LINUXQQ不支持讨论组，而我们部门偷懒，没用架群，直接用讨论组了。。。）

再接下来不爽的就是，明明我smbmount开发机上共享的目录到本地的，但权限总是1002，除了root外无法更改。但是用GUI界面的：ConnectServer工具，就可以直接连接上（问题在于连接上后，找不到在映射在哪个目录下，无法直接用IDE打开了）

最后netbeans直接打开remote功能，本地保存代码的时候，自动提交到remote上去。至此，几乎没有不能完成的工作了。（好象除了网银等不支持外，其他都可以接受，以前的aliedit的xpi不支持了。。伤心，不过刚才试了一下建行的网行，用firefox顺利打开，可惜我建行里没钱，也没有开通更多功能，失败呀）

界面嘛，就是关闭在左边不太舒服，还好几乎所有的软件都支持ctrl+w（关闭），问题也就显得不那么明显了。当然也算是习惯一下，等哪天我用苹果的时候，就可以少习惯几天了。阿Q很开心

Ubuntu10的时候，如果你进行netbeans的安装（PHP版），你会发现，界面十分模糊，仿佛是英文缩小成了很小很小的一部分，但是，如果你create a project，你又发现，很多英文又显示得好好的。
怎么办？菜单英文全部不能显示正常，都是模糊的一团，如果你在win下操作熟练，你可以轻松的找到option菜单，但是即使你设置了标准 的dialog Input作为你的界面字体，菜单等仍然保持模糊状态。
查询了一下google，好象很多采用java的程序都有类似情况发生，所幸，netbeans可以通过netbeans.conf里地配置来进行处理，这时候，你可以打开/usr/local/netbeans xx.xx/conf/netbeans.conf，修改netbeans_default_options，在最后的一个选 项里加上：--laf com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel，再进行重启。OK，菜单全部出现了，而且非常秀丽。

最后诉诉苦，为了安装ubuntu，我遇到了很多问题，比如我为了备份winodws盘里的数据，先用tar把数据简单的tar了一下（没有压缩，而且打包成一个文件，方便COPY），然后。。。先是昨天用网络进行COPY，25G的文件，COPY成了80多G还没有完事。今天上午用移动硬盘先COPY，但先忘了移动硬盘是fat32的，只能最大4G，在COPY到4G的时候出错了。然后格式化成NTFS，再继续拷贝，结果到22G的时候，移动硬盘过热，突然自己就断了，心啊，哇凉哇凉的。最后突然想起linux的操作可以用scp进行COPY，而且局域网里有linux系统，于是我用scp进行COPY，果然。半小时不到就COPY完了。等系统装完再Scp回来，真的很方便。

然后遇到的问题是smbmount，把linux通过samba共享出来的目录，用smbmount到本地，但会突然发现，用户组都变成了1102之类的，而且我在root权限下，无法chown该mount回来的目录。但root用户可以更改该目录下的数据，而默认用户无法修改，打开后保存的时候会造成数据丢失。郁闷。。。

目前用下来，装B很快乐。Over

Editplus和netbeans是什么我想不用详细介绍了吧。一般做PHP开发的人，几乎都了解这两个玩意。
Editplus是韩国人开发的，Netbeans是Sun的产品。

先说Netbeans吧，嗯，他们的东西还算不错，只是让我们写PHP的人郁闷的是，它没有自动换行（line wrap），所幸，6.10开始，这个功能已经被加进去了。现在用6.10M1的版本都可以进行尝试，但在尝试前，请记住（扫描项目的时候，不要设置换行，否则80%的机率会让你的NB爆掉）。

官方这样解释：

Guys from editor infrastructure asked me to help him to test new editor infrastructure that brings up also line wrapping features. Probably you remembered that this feature was enabled during NetBeans 6.9 development, but because it introduced many problems and there wasn't time to stabilize it enough, it's not in NetBeans 6.9 available.

We would like to stabilize the new infrastructure as much as possible before it will be switch on to be be available by default.You can enable the feature in development build through command line option: -J-Dorg.netbeans.editor.linewrap=true . Do it only with a development build, even if the optoin works in NetBeans 6.9, the new infrastructure is not stable enough there.

So I would like to ask you, if you use a latest development build, run the build with the mentioned option. You can start NetBeans from command line with the option or place the option in the ${nb_dir}/etc/netbeans.conf file (add into netbeans_default_options).

When you started NetBeans with this, there should be Line Wrapping option in the formatter.

When you find out an issue with it, please report it in our Bugzilla. For such issue the product should be Editor, component Painting & Printing and please mark all reports with the status whiteboard: linewrap so we can easily track them. The tentative plan is to enable this again for M1 of NetBeans 6.10 but this all depends on the additional feedback and testing.

只是换行后多了一个回车显示着而且不能消失，看起来有点挫。。

接下来说Editplus，昨天晚上，乔大姐（HonestQiao，乔楚）兴冲冲的在群里说，Editplus支持PCRE的正则了，大家快更新啊，不更新会后悔的。。于是到官方看了一下changelog，然后进行了更新。

再接下来就测试，结果，让人大吃一斤的是，有很多正则条件输进去，立刻就把Editplus给爆了，比如：?\d、.*+?之类的，还有就是.*能够匹配一行，.*?一个也不能匹配。

不过简单的正则匹配还是没问题的（如果你升级了该版本，建议你在正则搜索前，先保存你的代码，否则可能会想哭但是哭不出来）

官方的changeLog: 'Use TR1 regular expression' option ('Preferences'->'General').

据说，最后乔大姐忍不住发邮件去鄙视那位开发者了。

怎么说呢，netbeans这个IDE工具是目前我用的时间最长的一款IDE，以前也用过其他的一些IDE，不过，在算上版权问题后，这是目前唯一一款值得推荐的IDE吧？komodoEdit和netbeans相比，功能差了很多。当然各人习惯不一样，有的人喜欢拿GVIM来配置，把它配置成一款符合自己使用习惯的IDE，这，我也没话说。

正好看到cnbeta上说了6.9.1发布了，仔细看了一下更新内容，对于PHP来说，只有一小部份的更新，那就是：支持 PHP Zend 框架。这让我很吃惊。事实上，虽然我挺力挺这款IDE，但对他还是有抱怨的，或许在以前的贴子里也发表过，这里我再发发牢骚。。
用到现在nb让我郁闷的有几件事
1、同一项目中不能存在两种编码的文件。。。否则读取可能会是乱码（不过，这个能忍，自己的项目能够保证，主要是别人的）

2、耗内存，还有就是项目扫描，好几次就死在这上面了，卡死了

3、自动換行。配置里的自动换行永远是灰色的。。明明有这玩意却不能用。太让人郁闷了。。。

其他。。。好象还都能忍受 。在6.9更新的时候（http://wiki.netbeans.org/NewAndNoteworthy69#PHP），我们也看到，6.9对于PHP最大的更新其实就是formatter。格式化代码更优秀和准确了（在团队中，可以更方便的把代码格式化成同一风格，方便后来人），还有一个就是改进了语法检测。

虽然问题有一堆 ，不过，我还是推荐它。除非出来一款更好的（还要能跨平台，比如当我用LINUX进行IB的时候，我也有功能强劲的IDE可用）

让我幸福的是，在netbeans写的hello world编译成功了。原来一直没有成功过。介绍一下出错情况，免得有人再走冤枉路吧。。

1、由于我是采用了netbeans for php，因此在安装的scala插件时提示我没有JDK，下载完JDK后，在netbeans/etc/netbeans.conf中指定jdk的路径

2、重启netbeans，进入插件栏，再选择scala。

3、会帮我安装涉及到的一些包，大约有10个左右（没事，这个是自动识别的）

4、安装完重启后，再进行插件栏，选择Scala，终于可以安装了。

5、新建Scala项目，会有一个简单的hello world，OK，直接按F6进行调试，会发现错误，告诉你没有在启动的时候设定Dscala.home的路径。

6、下载scala源码（好象用2.8的较好吧？），扔到某个目录下。如：d:\program files\scala，修改netbeans/etc/netbeans.conf文件，在netbeans_default_options的选项的最后加上:-J-Dscala.home=d:\progra~1\scala ，【请仔细看好左边的字，路径是d:\progra~1\scala，而不是完整的d:\program files\scala，因为完整的路径有空格，所以导致路径每次都认为是/netbeans/files/scala】也没有找到类似资料。。。

7、重启netbeans，按下F6，输出：

init:
deps-jar:
Compiling 1 source file to D:\My Documents\NetBeansProjects\ScalaApplication1\build\classes
No changes to recompile
compile:
run:
Hello, world!
BUILD SUCCESSFUL (total time: 6 seconds)

OK，至此一切正常。
最后我是参考：http://pierre8r.blogspot.com/2009/09/installing-scala-plugin-for-netbeans-on.html，失败。。。全局路径好象没啥用。
也看过：http://www.cnscala.com/viewthread.php?tid=49&highlight=netbeans，还是没用。。。后来我干脆是根据出错信息自己改了改（其实就是那个Dscala.home的路径，原来一直是采用完整路径所以一直失败。）