本项目包括以下几个部分：
- 数据获取模块 (MessageGetter)
- 使用Weka的独立情绪分析模块 (NLPPart) 以及打包好的项目文件 (ZLNLPLibs)
- 数据分析模块 (OfflineStatistic)
- 后台服务器模块 (HappyCityLight)
- 前台网页部分 (WebPages)
- 部署或初始化要用到的脚本(script file)
- 部署用的文件(Develop)
1.安装java8 sdk
本项目主要使用JAVA作为程序语言，由于自然语言处理模块使用了一个第三方库需要使用JAVA8，所以整个项目也使用JAVA8，如果需要更改需要更改自然语言处理模块。本项目大部分组件都使用Java编写所以可以很好地支持多种平台。
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
默认路径安装
2.IDE Eclipse (JavaEE)
本项目推荐使用Eclipse作为开发工具，使用Eclipse可以直接导入项目文件而不需要做过多更改。
http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/mars2
直接解压缩
3.MySQL 5.7
本项目使用MySQL作为结构化数据存储数据库，可以不使用MySQL5.7，用其他的版本也可以。但是MySQL5.7原生支持直接存储JSON格式的数据或许对以后的扩展更方便。推荐使用MySQLWorkbench作为数据库操作软件
http://dev.mysql.com/downloads/mysql/
默认路径安装,安装时选择安装为开发环境 设置用户名和密码
设置数据库的默认字符集为utf8mb4 https://mathiasbynens.be/notes/mysql-utf8mb4
4.Redis 3.0
本项目使用Redis作为内存缓存数据库，Redis不是使用Java开发所以不同平台需要不同的客户端。
- http://redis.io/download (Linux)
- https://github.com/MSOpenTech/redis (Windows)
- https://medium.com/@petehouston/install-and-config-redis-on-mac-os-x-via-homebrew-eb8df9a4f298#.rhrdn6z6q (Mac OS X)
5.Tomcat 8.0 (Deployer)
本项目使用Tomcat8作为后台服务器，开发环境可以直接下载压缩包。
http://tomcat.apache.org/download-80.cgi
直接解压缩至文件夹
部署环境为部署在服务上长时间运行的环境，可以是本地服务器也可以是云服务器。部署环境要与开发环境一致但是要更改某些设置。
- 可以只安装JRE不安装JDK
- Tomecat 服务器端口设置为80/443, 并设置服务器防火墙打开这个端口, 加入系统服务并开机自动运行
- MySQL 安装时选择服务器设置并开机自动运行，设置防火墙打开MySQL的网络端口（默认为3306）
-
下载项目的源代码，解压缩至文件夹
-
打开Eclipse，导入所有工程项目 (File -> Import -> General -> Existing Projects into Workspace)
-
选择源代码文件夹中的所有项目（如果不想对线上版本做出任何改动，选择 Copy projects into workspace）
-
设置Eclipse的服务器环境为Tomcat8 (Properties -> Server -> Runtime Enviroments -> add Tomecat 8.0)
-
导入数据库表结构 (MySQLWorkbench -> Data Import/Restore -> Import from Self-Contained File Choose -> Dump Structure and Data -> Start Import)
-
数据库初始化文件在Deploy/script file/文件夹中
- cdpsavingstructure.sql 为数据存储数据库表结构
- cdpwebserverdatabase.sql 为网站后台服务器数据库表结构以及数据
- controllerdb.sql 为数据获取模块控制数据库表结构及数据
- DatabaseInit.sql 为三个数据库表结构以及少量数据
-
设置项目数据库地址、用户名、密码为本机的数据库
- 后台服务器： /HappyCityLight/src/com/citydigitalpulse/webservice/app/ServerConfig.java
- 统计模块： /OfflineStatistic/src/com/citydigitalpulse/OfflineStatistic/app/AppConfig.java
- 数据采集模块： /TwitterStreamGetter2SQL/src/com/citydigitalpulse/collector/TwitterGetter/app/Config.java
-
改变数据采集模块上传的目标地址，以本地为例： (public static String DCI_SERVER_URL = "http://localhost:8080/HappyCityLight/api/";)
本项目网站后台服务器使用Tomcat8.0作为服务器但是也可以使用更加轻便的Jetty(https://en.wikipedia.org/wiki/Jetty_(web_server)).
将后台服务器通过Eclipse打包成war文件，直接拷贝到Tomcat文件夹中的Webapp文件夹中即可，若Tomcat服务器正在运行则会自动解压缩，若不在运行则需要手动启动Tomcat服务器。建议每次更新版本的时候重新启动Tomcat。
部署到服务器之后服务器上输入 http://localhost/(WAR_FILE_NAME) 即可访问，若将war文件命名为ROOT则可以直接输入http://localhost进行访问
将Deploy文件夹中的GetterServer文件夹拷贝到数据获取服务器中即可
- MessageGetter4Twitter_lab_split.jar 是Twitter实时抓取程序，在抓取数据的同时会将数据直接存储到数据存储数据库并进行日期的分库操作
- init.sql 用来初始化Twitter获取程序，每当重新打开Twitter抓取程序的时候需要运行该SQL脚本重置状态数据库
- YesterdayStatiisticAndUpdate2days.jar 用来统计前一天的获取的数据，进行情绪判断并分区域统计，最后将统计结果存到数据库中
- StatiisticAndUpdate.jar 用于手动指定分析与统计的时间段，可以通过修改statistic_settings.txt文件来指定不同的日期
可以编写自动运行脚本来实现一些自动化的操作，以Windows为例，可以在管理工具中的计划任务中设定自动运行的程序或脚本。目前本项目中有两个脚本：
- TwitterStreamCollector_start.bat 用于在开机的时候自动启动数据抓取模块
- YesterdayStatiisticAndUpdate.bat 用于运行前一天的数据统计（目前服务器上是每天凌晨2：00进行）