H-Servlet框架教程【第二章】第一个接口

（Tips：从此处开始以IDEA环境为例，Eclipse以此类比。文件编码均为：UTF-8）

（此章节默认并且您已配置完毕Tomcat运行环境And能正常启动运行）

一、创建配置文件

请在src目录下新建文件configuration.conf文件，请注意名称必须且唯一
并且后缀名为.conf
H-Servlet框架教程【第二章】第一个接口
然后复制以下内容至文件内：

[server]
#静态文件目录路径，默认为'/'
#如果想不使用自带的静态文件过滤，可以将静态文件全部放在单独的文件夹下，与接口路径错开。
#例如：静态文件存放在：'/static/'下，API使用'/'或者其他路径。
staticFilePath=/;

#开启静态文件过滤log，如果为True所有请求静态文件的log都会被打出
enableStaticFileLog=false;


#开启请求错误提示，如果为TRUE当请求方式与方法设置不同时会返回提示方法应该是什么
enableRequestErrorTip=false;

#关闭空返回值的警告
disabledNullReturnWaring=true;

#开启文件上传功能
enableFileUpload=true;

#域名设置
domain=localhost;

[static]
#static file filter config , this can configure static file ignore list;
#静态文件过滤器配置，这里可以配置过滤器忽略列表
#filter type has: 1.auto 2.custom 3.off
#过滤器类型有：自动、自定义、关闭
#if type is 'auto' OR 'off', next config does not work
#如果为自动或关闭，下一个配置项将不会被启用
filterType=auto;

#list
#use JSON
#singe line!!!
filterList=[];

#文件上传配置
#此处设置受[server]根下enableFileUpload设置项影响是否其有效
#若设置项为false，下方配置将不会进行解析
[upload]
#文件上传接收类，只能指定一个且继承类FileUploadProcessFactory，并实现相关方法

这个文件包含了框架的所有配置或将来会加入的配置。

二、创建包

在src下创建包cn.heshiqian.example
H-Servlet框架教程【第二章】第一个接口

三、配置web.xml

打开web.xml文件，添加以下标签:

<servlet>
        <servlet-name>main</servlet-name>
        <servlet-class>cn.heshiqian.framework.h.servlet.servlet.MainProcessServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>main</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <context-param>
        <param-name>classesPackagePath</param-name>
        <param-value>cn.heshiqian.example</param-value>
    </context-param>

请注意不要将classesPackagePath这个修改为其他名称，框架只会获取这个param-name如果修改会抛出异常
其中param-value填写你的业务类最大一层包名

四、新建Service类

H-Servlet框架教程【第二章】第一个接口
注意，不使用IDEA右键菜单的新建Servlet，而是新建基本的Java Class类

然后键入以下代码：

package cn.heshiqian.example;

import cn.heshiqian.framework.h.servlet.annotation.Mapping;
import cn.heshiqian.framework.h.servlet.annotation.RequestUrl;

@Mapping
public class Service {

    @RequestUrl(value = "/first")
    public String first(){
        return "Thanks for using ♪(･ω･)ﾉ";
    }

}

五、运行项目

若出现以下信息，代表框架启动成功
H-Servlet框架教程【第二章】第一个接口
访问：http://localhost:8080/first URL
你应该会出现这样的页面：

恭喜你，框架已经成功运行在你的项目上了。

END:一些问题

如果在跟随配置或运行中出现问题，如果你知道如何解决的，还请麻烦在评论区留下你的方法以及建议，我会修改框架和改进。
如果不知道如何解决，留言告诉我，尽量帮你解决（づ￣3￣）づ╭❤～

H-Servlet框架教程【第二章】第一个接口 2018年10月12日23:05:00 By Heshiqian