Hasor 开源项目教程

Hasor 开源项目教程

hasorHasor是一套基于 Java 语言的开发框架，区别于其它框架的是 Hasor 有着自己一套完整的体系，同时还可以和先有技术体系做到完美融合。它包含：IoC/Aop容器框架、Web框架、Jdbc框架、RSF分布式RPC框架、DataQL引擎，等几块。项目地址:https://gitcode.com/gh_mirrors/ha/hasor

1. 项目目录结构及介绍

在Hasor项目中，典型的目录结构如下：

.
├── buildSrc             # 构建相关的辅助目录
├── docs                 # 文档相关资料
├── modules              # 存放各个模块的源代码
│   ├── hasor-core       # 核心模块
│   ├── hasor-db         # 数据库相关模块
│   ├── hasor-web        # Web应用相关模块
│   └── ...               # 其他模块
├── src                  # 主体源代码目录
│   ├── main
│   │   ├── java         # Java源代码
│   │   └── resources    # 配置文件和资源
│   └── test
│       ├── java         # 测试代码
│       └── resources    # 测试资源
└── ...                  # 其他支持文件

这个结构展现了Hasor的模块化组织方式，其中buildSrc用于构建过程中的自定义逻辑，docs存放文档，modules包含了不同功能领域的子模块，而src/main和src/test分别对应主代码和测试代码。

2. 项目的启动文件介绍

Hasor作为Java框架，其启动通常涉及到一个主类，该类通常实现了某种启动接口或包含特定的启动逻辑。例如，对于Web应用，启动类可能实现javax.servlet.ServletContainerInitializer接口，而在命令行应用中，启动类可能包含public static void main(String[] args)方法。

以一个典型的Web应用为例，启动类（如com.example.MyApplicationStarter）可能会如下所示：

package com.example;

import net.hasor.core.Hasor;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

public class MyApplicationStarter implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        // 初始化Hasor容器
        Hasor.createApp(sce.getServletContext(), new AppModule());
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        // 关闭Hasor容器
        Hasor.shutdown();
    }
}

在这个例子中，contextInitialized方法是Web应用启动时调用的，它创建并启动Hasor容器；contextDestroyed则是在应用关闭前释放资源。

3. 项目的配置文件介绍

Hasor支持多种配置文件格式，包括XML、YAML、Properties等。典型的配置文件位于src/main/resources下，并命名为app.conf或app.xml等。

app.conf (Properties格式)

# 配置项示例
hasor.data-source.url = "jdbc:mysql://localhost:3306/mydb"
hasor.data-source.username = "username"
hasor.data-source.password = "password"

# 插件配置
hasor.web.filter.register-class = com.example.MyFilter

app.xml (XML格式)

<config>
    <bean id="dataSource" class="net.hasor.db.jdbc.SimpleDataSource">
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
        <property name="username" value="username"/>
        <property name="password" value="password"/>
    </bean>

    <!-- 配置Web Filter -->
    <web-filter id="myFilter" className="com.example.MyFilter"/>
</config>

配置文件可以用来设置数据源、配置Bean、声明Web过滤器等，具体的配置项取决于Hasor及其使用的模块。通过这些配置，Hasor能在启动时自动组装应用所需的组件和服务。

hasorHasor是一套基于 Java 语言的开发框架，区别于其它框架的是 Hasor 有着自己一套完整的体系，同时还可以和先有技术体系做到完美融合。它包含：IoC/Aop容器框架、Web框架、Jdbc框架、RSF分布式RPC框架、DataQL引擎，等几块。项目地址:https://gitcode.com/gh_mirrors/ha/hasor