使用Intellij IDEA社区版创建web项目并引入jersey实现Restful接口

基本的操作和代码编写不多说了，网上一找一大把，主要记录一下踩的坑，也算给自己留个印象。由于本人是在业余时间尝试和学习，所以遇到的坑估计也都是很浅显的问题。

Intellij IDEA使用的是社区版，免费的，相对功能也少很多，比如不能直接创建web项目。所以结果是在创建普通项目后，联接tomcat来测试，通过maven来打包。

项目创建和设置都有段时间了，没有记录，都忘记了。但是当时还是遇到了一些坑的，想不起来了，也都不复杂，当时做到有servlet就放下了。

近期又拿起来，是为了增加Restful风格的接口。从网上找了找说是Jersey很好用，于是尝试使用Jersey。

因为没有Java的实际工程经验，都是自己摸索的（本职C++），所以就算对Java本身的语法、更基础的算法和数据模型没什么不理解的，关键的问题出在了项目结构、构建以及一些辅助工具的使用上，这里的坑都踩在了maven上（同样的，对于ant或者grandle也没有使用经验，一点借鉴都没有）。

实际上只要在自动生成的pom.xml文件里添加正确的Jersey依赖就可以了，让maven把必要的文件下载下来就可以使用；不过我走了不少弯路，具体来说有：

1、自己下了一个Jersey的lib包。开始时引入了这个比较大的包去开发，到后来发现这个包直接可以删除，因为只要依赖正确，maven会下载所需的包，不需要完整的包。

2、能够运行，但是打包成war以后部署在tomcat里不能使用。这里开始是犯了一个低级错误，把source文件夹设置给取消掉了，所以没有生成对应的class；后来发现在Intellij IDEA里，如果先用maven的clean再用maven的package命令，打包出来还是没有class文件。似乎只有测试运行一次，才能正确打包，不知道是我设置的问题还是IDE的问题。

3、找不到Jersey的servlet。这个就是没有正确添加依赖（因为我没有使用spring或者struct2框架，所以引入 的注入是jersey-hk2，应该要根据实际框架调整）：

基础的servlet依赖

4、后来使用POJO方式直接向前端返回JSON数据，也就是Jersey框架要完成一个将POJO直接转换为JSON的功能，这时如果没有设置依赖会报500错误，tomcat控制台打印出的问题是（class名自定）：

org.glassfish.jersey.message.internal.WriterInterceptorExecutor$TerminalWriterInterceptor.aroundWriteTo MessageBodyWriter not found for media type=application/json, type=class servlet.usingJersey$tmpClass, genericType=class servlet.usingJersey$tmpClass

究其原因，是下面这个引用：

POJO转JSON的引用

5、所有的依赖要有正确的版本设置。另外前面列出的是最新的Jersey版本，以前似乎还有其它前缀的版本，不是org.glassfish.jersey.xxx的，找资料时要注意。

6、这个和Jersey无关，是前端ajax请求restful接口的小坑：如果设置ajax请求的contentType为"application/json"，返回的值必须是标准的JSON，否则会走到请求设置的error函数，而不是success函数。另外在success里，函数接到的参数已经是JSON对象了，不需要再做parse动作。

以上把基础的坑都踩到了，能够成功部署一个Jersey的Restful风格的服务。接下来就是具体的业务实现了。