# zhiqim_httpd

**Repository Path**: zhiqim/zhiqim_httpd

## Basic Information

- **Project Name**: zhiqim_httpd
- **Description**: Zhiqim Httpd即知启蒙WEB容器，纯Java开发，全面实现HTTP服务，比Tomcat/Jetty更轻便，配置更简单和规范。自集成MVC/MVP模式框架，直接从HTTP连接到Action，使用ZML作为视图层比JSP/Servlet更简单。在后台工程嵌入式WEB中优势更明显。
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://zhiqim.org/project/zhiqim_framework/zhiqim_httpd.htm
- **GVP Project**: No

## Statistics

- **Stars**: 114
- **Forks**: 1
- **Created**: 2018-08-16
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: webframework

**Tags**: None

## README

### 什么是“知启蒙WEB容器”？
---------------------------------------
      “知启蒙WEB容器（zhiqim_httpd）”是Zhiqim Development Kit面向WEB开发的多例服务，提供更简洁配置、积木式组件模块和天然的模型模板设计，适用于各种大型负载均衡WEB服务群集、中小型组件模板化WEB工程和微型嵌入式HTTP/WEB服务。

<br>

### 知启蒙WEB容器的优点
---------------------------------------
1、ZhiqimHttpd仅依赖JDK1.7+和ZhiqimKernel、ZhiqimZML。15年自主研发和创新的坚持，值得信赖。<br>
2、纯Java的WEB容器，比Tomcat/Jetty更轻量级的HTTP服务器，继承ZhiqimKernel的简洁配置和多例服务的能力。<br>
3、抛弃Servlet/JSP规范，基于ZhiqimKernel/ZhiqimZML创新型的WEB容器规范，集成MVC/MVP架构，简单许多框架的学习成本。<br>
4、在开发调试阶段，以ZhiqimKernel启动服务，无需依赖Tomcat/Jetty等容器，简化ZhiqimStudio/Eclipse中开发调试配置。<br>
5、工程打包发布后，以ZhiqimKernel配置启动，只需配置JRE路径，简化Tomcat/Jetty/Jboss等学习成本和部署成本。<br>
6、自主创新的积木式组件模型，提供包括数据库表、页面和功能一起打包的组件开发模式，更彻底的模块化解藕，使得大中型项目积木式搭建、众包协同成为可能。<br>
7、适应复杂部署的能力，多端口监听、多服务配置、多虚拟目录配置、负载均衡、群集模式等（Nginx + 知启蒙WEB容器群集 + Redis）各种部署。<br>
8、嵌入式WEB开发最佳应用，比JDK自带Http Server功能更完善，比Jetty等WEB容器更轻量简便。支持零配置注解方式和规约配置两种方案 <br>
9、兼容Servet容器，通过zhiqim_servlet.jar适配到Tomcat/Jboss等容器中一样简单（不损耗知启蒙服务和知启蒙组件的支持），项目迁移影响极小。<br>
<br>


### 知启蒙WEB工程目录结构&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://zhiqim.org/download/zhiqim_example/zhiqim_guestbook_V1.5.0_src.zip">下载留言本示例</a>
---------------------------------------
![知启蒙WEB工程目录结构](https://zhiqim.org/project/images/115034_b075df06_2103954.png "知启蒙WEB工程目录结构")
<br>


### 知启蒙WEB容器简要配置说明
---------------------------------------

```
1、在[./conf/zhiqim.xml]的[config]项中增加多文件配置key=httpd，value=./conf/httpd.xml <br>
2、在[./conf/zhiqim.xml]的[service]项中配置key=httpd，value=org.zhiqim.httpd.HttpServer的HTTP服务 <br>
3、在[./conf/httpd.xml]文件中配置[httpd]项目中，并包括监听和上下文件环境的配置。<br>
```

**一、[./conf/zhiqim.xml]配置如下：**


```
    <group id="config" desc="系统其他配置文件，./开头表示工程相对路径下，绝对路径使用/或d:/等（Windows也使用顺斜杠作路径）">
        <item key="httpd" value="./conf/httpd.xml" update="false" desc="日志配置文件"/>
    </group>

    <group id="service" desc="系统服务配置，有依赖时注意顺序，系统按顺序加载，按倒序销毁">
        <item key="httpd" value="org.zhiqim.httpd.HttpServer" update="false" desc="HTTP服务"/>
    </group>
```

**二、[./conf/httpd.xml]配置如下：**


```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ZHIQIM-CONFIG PUBLIC "-//ZHIQIM //DTD Zhiqim-Config Configuration 1.4.0//EN" "http://zhiqim.org/xmldtds/zhiqim_config_1_4_0.dtd">
<zhiqim-config>

    <group id="httpd" desc="HTTP服务">
        <item key="listen" value="httpd.listen" update="false" desc="HTTP服务的监听器" />
        <item key="context" value="httpd.root" update="false" desc="HTTP服务下包括的上下文环境，多个用逗号隔开" />
    </group>
    
    <group id="httpd.listen" desc="HTTP监听器">
        <item key="scheme" value="HTTP" update="false" desc="HTTP或HTTPS协议" />
        <item key="port" value="80" update="false" desc="监听端口" />
        <item key="minPoolSize" value="5" update="false" desc="HTTP处理线程池最小值" />
        <item key="maxPoolSize" value="10" update="false" desc="HTTP处理线程池最大值" />
    </group>
        
    <group id="httpd.root" desc="HTTP根上下文环境">
        <item key="path" value="/" update="false" desc="上下文环境路径，必填" />
        <item key="resourceType" value="directory" update="false" desc="资源目录类型classpath|directory，无资源时可不配置" />
        <item key="resourcePath" value="./resource" update="false" desc="资源目录，无资源时可不配置" />
        <item key="welcomeUrl" value="/index.htm" update="false" desc="欢迎页，无资源时可不配置，/开头" />
    </group>

</zhiqim-config>
```

<br>

### 知启蒙WEB容器上下文配置
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ZHIQIM-CONFIG PUBLIC "-//ZHIQIM //DTD Zhiqim-Config Configuration 1.5.0//EN" "http://zhiqim.org/xmldtds/zhiqim_context_1_5_0.dtd">
<zhiqim-context>

    <!-- 属性配置 -->
    <attribute name="系统引导程序" key="bootstrap" value="org.zhiqim.example.gbook.Bootstrap"/>

    <!-- 拦截器 -->
    <interceptor name="检查管理员是否登录" key="chkLogin" class="org.zhiqim.example.gbook.interceptor.ChkAdminLogin"/>
    
    <!-- sessionUser-->
    <sessionUser name="前端" path="*" class="org.zhiqim.example.gbook.SessionUser" />
    
    <!-- 访客部分 -->
    <action name="首页" path="/index.htm" view="/zview/index.zml" class="org.zhiqim.example.gbook.action.IndexAction"/>
    <action name="留言" path="/leaveMessage.htm" view="/zview/leaveMessage.zml" redirect="/index.htm" class="org.zhiqim.example.gbook.action.LeaveMessageAction"/>

    <!-- 管理员部分 -->
    <action name="管理员登录" path="/adminLogin.htm" view="/zview/adminLogin.zml" redirect="/adminList.htm" class="org.zhiqim.example.gbook.action.AdminLoginAction"/>
    <action name="管理员退出" path="/adminLogout.htm" redirect="/index.htm" class="org.zhiqim.example.gbook.action.AdminLogoutAction"/>

    <action name="管理员首页" interceptor="chkLogin" path="/adminList.htm" view="/zview/adminList.zml" class="org.zhiqim.example.gbook.action.AdminListAction"/>
    <action name="管理员回复留言" interceptor="chkLogin" path="/adminReply.htm" view="/zview/adminReply.zml" redirect="/adminList.htm" class="org.zhiqim.example.gbook.action.AdminReplyAction"/>
    <action name="管理员删除留言" interceptor="chkLogin" path="/adminDelete.htm" redirect="/adminList.htm" class="org.zhiqim.example.gbook.action.AdminDeleteAction"/>

</zhiqim-context>
```

<br>



### 知启蒙技术框架与交流
---------------------------------------
![知启蒙技术框架架构图](https://zhiqim.org/project/images/101431_93f5c39d_2103954.jpeg "知启蒙技术框架架构图.jpg")<br><br>
QQ群：加入QQ交流群，请点击[【458171582】](https://jq.qq.com/?_wv=1027&k=5DWlB3b) <br><br>
教程：欲知更多知启蒙WEB容器，[【请戳这里】](https://zhiqim.org/project/zhiqim_framework/zhiqim_httpd/tutorial/index.htm)