二、Web工程目录结构

首先我们创建一个基于 Voovan 的 Web 服务需要遵循一定的目录结构,这个结构是保证 Web 服务正常运行的前提.

下面我们以http://webserver.voovan.org的目录结构为蓝本进行介绍,首先我们先来看下目录结构图:输入图片说明

项目我们介绍的时候会对目录进行分类,分为:二进制目录,Web服务静态资源目录,配置目录来进行介绍.

硬编码、Stream 方式实现可不依赖此目录结构，但路由、模块方式需要依赖此目录结构。

1.二进制目录

二进制目录包含: classes目录、lib目录 和 bin目录. classes目录: 和 Servlet 标准的 WEB-INF/classes 目录含义相同,存放 class 文件的目录. lib目录: 和 Servlet 标准的 WEB-INF/lib 目录含义相同,存放 jar 文件的目录. bin目录: 这个目录中默认保存 voovan 的 jar 包.

其中（classes 和 bin）目录会在应用启动的时候自动加载进 JVM ,不需要特别的通过-cp 参数来指定.

2.Web服务静态资源目录

WEBAPP目录: 这个目录就是当前 Web 站点的静态资源目录,是当前站点的根目录,所有对静态资源的访问都是基于这个目录来完成请求的.

这个目录是可以在配置目录中的web.json 中进行配置的,具体配置参数如下:

  1. "ContextPath": "WEBAPP"

详细配置请参照: [HTTP服务配置文件] 进行配置.

3.配置目录

conf目录: 这个目录就是当前 Web 服务的配置目录,可以对 Web 服务进行配置: 端口,ip,路由,模块,统一异常页面等. conf/web.json: 服务配置文件,可配置端口,ip,路由,模块等相关服务属性. conf/mime.json: mime配置文件,可针对特殊的文件扩展名进行 mime 类型的配置, 系统自带了默认的配置org/voovan/http/server/conf/mime.json. conf/error.json: 统一异常配置文件,可针对 java 的异常配置出不同异常的异常页面,方便对用户的友好展示. conf/error-page目录: 统一异常展示页面管理目录.具体在异常时展示的页面模板可在此进行配置.

详细配置请参照: [HTTP服务配置文件] 进行配置.

3.启动脚本

  1. #!/usr/bin/env bash
  2. java -jar ./bin/voovan-framework.jar $*

4.下载Voovan WebServer并开始使用

[Voovan WebServer 下载]

本Voovan WebServer下载后包含 VoovanMonitor 监控工具,如果不需要,直接清空 lib 和 WEBAPP 目录即可。