Quartz.NET 快速入门教程

1. 项目目录结构及介绍

在 Quartz.NET 的源代码仓库中，目录结构通常如下：

quartznet/
├── src/               # 主要的源代码目录
│   ├── Quartz/        # Quartz 核心库源码
│   ├── Quartz.Server/  # 示例服务器应用程序
│   └── ...             # 其他相关组件或示例
└── samples/           # 示例应用及测试代码
    ├── ConsoleSample/  
    ├── ...             
└── build/              # 构建脚本和配置
└── ...                 # 其它辅助文件（如文档、许可证等）

• src/Quartz/: 包含 Quartz.NET 框架的核心类库。
• src/Quartz.Server/: 提供了一个简单的基于控制台的应用程序，用于展示如何启动和运行 Quartz.NET 定时任务调度器。
• samples/: 各种示例应用，用于演示如何集成 Quartz.NET 到你的应用程序中。

2. 项目的启动文件介绍

在 src/Quartz.Server 目录下的 Program.cs 文件是服务器应用程序的入口点。这个文件中的 Main() 函数是程序执行的起点，其中包含了初始化 Quartz 调度器并启动它的逻辑。

using System;
using Quartz.Impl;

namespace Quartz.Server
{
    public class Program
    {
        public static void Main(string[] args)
        {
            Console.WriteLine("Quartz.NET Server v{0}", typeof(Program).Assembly.GetName().Version);

            try
            {
                var starter = StdServerStartupFactory.Create();
                starter.Run(args);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
                Environment.Exit(-1);
            }
        }
    }
}

StdServerStartupFactory.Create() 方法创建一个默认的服务器实例，然后 starter.Run(args) 执行启动过程。

3. 项目的配置文件介绍

Quartz.NET 支持通过 XML 或者 App.config 配置文件进行设置。通常，配置文件位于你的应用程序根目录下，例如 app.config 或 quartz.net.config。

以下是一个基本的 app.config 示例，展示了如何配置 Quartz.NET：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="quartz" type="System.Configuration.NameValueSectionHandler, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
  </configSections>

  <quartz>
    <!-- 
      Configure the job store that will be used to persist job data.
      -->
    <jobStore type="Quartz.Impl.AdoJobStore.JobStoreTX, Quartz">
      <property name="DataSource" value="DefaultDS" />
      <property name="TablePrefix" value="QRTZ_" />
      <property name="UseProperties" value="true" />
    </jobStore>

    <!-- 
      Configure the connection string and provider for your database.
      -->
    <providers>
      <add name="DefaultDS" connectionString="YOUR_CONNECTION_STRING_HERE" providerName="System.Data.SqlClient" />
    </providers>

    <!-- 
      Configure the scheduler factory.
      -->
    <scheduler>
      <instanceId>NON_CLUSTERED</instanceId>
      <threadPriority>Normal</threadPriority>
      <useClustered>false</useClustered>
      <shutdown钩AfterWaitTimeInSeconds>60</shutdownHookAfterWaitTimeInSeconds>
    </scheduler>
  </quartz>
</configuration>

在这个例子中，配置了数据库连接字符串、作业存储类型以及调度器的一些属性。记得替换 YOUR_CONNECTION_STRING_HERE 为实际的数据源连接字符串。

通过正确配置这些参数，你可以自定义 Quartz.NET 的行为，比如作业存储方式、线程优先级、集群模式等。