IDEA中文项目问题解决小记

公司的WEB项目是GBK编码的，组里基本上都是用eclipse的，IDEA中碰到的很多问题都要重新去解决。

1. 输出乱码问题

先倒不提代码中输出的中文了，编译、mvn build以及tomcat日志都有乱码。网上搜了一下，比较靠谱的是：

http://www.kafeitu.me/tools/2013/03/26/intellij-deal-chinese-disorderly-code.html

这里提到的解决方案。这个方案基本上能够解决IDEA的乱码问题，除了在调用autoconfig的时候还是会输出乱码，这时还是需要在pom文件中指定一下maven-autoconfig-plugin的编码。默认是没有指定的，这样它会用系统默认的，如果LC_ALL环境变量为空，那就会使用MacRoman，显然这对中文输出是有问题的。修改pom后如下：

<plugin>                                             
	<groupId>com.alibaba.citrus.tool</groupId>          
	<artifactId>maven-autoconfig-plugin</artifactId>    
	<version>1.0.9</version>                            
	<configuration>                                     
		<exploding>true</exploding>                        
		<explodedDirectory>                                
			${warExplodedDirectory}                           
        </explodedDirectory>                         
        <charset>GBK</charset>                       
	</configuration>                                    
	<executions>                                        
		<execution>                                        
			<phase>package</phase>                            
			<goals>                                           
				<goal>autoconfig</goal>                          
			</goals>                                          
		</execution>                                       
	</executions>                                       
</plugin>                                            

这样就能完美地解决build以及tomcat的输出了。

不过在iTerm2中手动调mvn build，输出还是有乱码。无解。。。

2. IDEA中使用maven的问题

这个不知道是不是我IDEA没配置好。maven默认是已经集成在IDEA中的，但是在打包项目时，却报找不到maven，并提示设置M2_HOME环境变量，错误信息如下：

IDEA [FATAL_ERROR] Cannot start Maven: No valid Maven installation found

这个问题在stackoverflow上也有记录：http://stackoverflow.com/questions/8221587/intellij-cant-find-my-m2-home-why-is-that

我先在~/.zshrc中设置export M2_HOME=/usr/share/maven，但是没有用。后来上网查了一下，说mac的shell环境变量，未必能够被GUI应用程序读到。于是按照

http://www.dowdandassociates.com/content/howto-set-an-environment-variable-in-mac-os-x-slash-etc-slash-launchd-dot-conf/

这篇文章讲的，把环境变量加到了/etc/launched.conf中（需要重启）。这样就能使用maven build了。

3. autoconfig的配置值注入问题

关于autoconfig，见这里：http://openwebx.org/docs/autoconfig.html

项目使用了maven filtering来配置autoconfig，配置如下：

<build>                                               
	<finalName>my_project_name</finalName>                          
	<filters>                                            
		<filter>${user.home}/antx.properties</filter>       
	</filters>                                           
	<resources>                                          
		<resource>                                          
			<directory>src/main/resources</directory>          
			<filtering>true</filtering>                        
		</resource>                                         
	</resources>                                         
	......                                       

结果是，项目中一部分xml文件的placeholder值被替换了，另一部分却没有。

刚开始以为是maven版本导致的问题，因为我本机用的是maven 3.0，而公司服务器上的是maven 2.1。网上搜了一下，3.0倒确实有一个因为注释中出现了“@"符号而导致这个文件的值没法被替换的情况。不过看了下项目中，并没有这个特殊符号，排除了这个问题。

后来师兄在看日志输出的时候发现一行：

[WARNING] Using platform encoding (MacRoman actually) to copy filtered resources, i.e. build is platform dependent!

看起来有可能是编码的问题，这个问题，stackoverflow中给的方案是，在pom中将project.build.sourceEncoding设为确定的编码。

我用的是另外一种方案：添加maven-resources-plugin，并指定编码，具体如下：

<plugin>                                             
    <groupId>org.apache.maven.plugins</groupId>      
    <artifactId>maven-resources-plugin</artifactId>  
    <version>2.6</version>                           
    <configuration>                                  
        <encoding>GBK</encoding>                     
    </configuration>                                 
</plugin>                                            

这个问题之所以没有在服务器上重现，是因为公司的web服务器的系统编码都已经设置成了GB18030，直接把这个问题给规避掉了，汗。。。

4. 一些杂项

问题2讲到了用maven，这个项目中使用maven，其实是在Run --> Edit Configurations里的，也就是说配置web项目的启动选项的时候指定的。因为pom文件里配置了一些特殊的goal如使用autoconfig打包配置等。

因为应用是使用tomcat的，所以在Edit Configurations，首先要添加一个tomcat6的server。具体过程见这篇文章：

http://my.oschina.net/tsl0922/blog/94621

这时最下面有一个Before launch的选项，默认是只选make的，因为我们项目是使用maven的，所以还需要选中"Run Maven Goal”，然后指定一下具体的web项目以及maven的lifecycle（一般至少是package，可以选install）。

这里的VM parameters，就涉及到了问题1的编码问题，需要添加-Dfile.encoding=UTF-8参数。如果应用需要较多内存，可能还需要调整内存。

还有一个问题是，这里的maven是不能指定参数的。而我们build项目时，并不希望maven来运行unit tests。没办法，只好改pom文件，添加一个maven-surefire-plugin。具体如下：

<plugin>                                           
    <groupId>org.apache.maven.plugins</groupId>    
    <artifactId>maven-surefire-plugin</artifactId> 
    <version>2.8.1</version>                       
    <configuration>                                
        <skipTests>${skipTests}</skipTests>        
    </configuration>                               
</plugin>                                          

其中skipTests是在properties段中配置的：

<properties>                                          
    <skipTests>true</skipTests>              
</properties>                                                                      

这样就变成默认是不运行UT的了。

总体经验就是，mac用户真心不容易啊，各种小白鼠各种踩坑。。。