OpenTripPlanner 项目教程

1. 项目的目录结构及介绍

OpenTripPlanner (OTP) 是一个开源的多模式行程规划器，其目录结构如下：

OpenTripPlanner/
├── src/
│   ├── main/
│   │   └── java/  # 主要Java服务器代码
│   └── client/
│       └── javascript/  # 基于Leaflet的JavaScript客户端代码
├── test/
│   └── performance/  # 性能测试代码
├── doc/  # 项目文档
├── script/  # 脚本文件
├── LICENSE  # 项目许可证
├── README.md  # 项目介绍
├── pom.xml  # Maven项目配置文件
├── mkdocs.yml  # MkDocs配置文件
└── ...

主要目录介绍：

• src/main/java/：包含OpenTripPlanner的主要Java服务器代码。
• src/client/javascript/：包含基于Leaflet的JavaScript客户端代码，主要用于测试。
• test/performance/：包含性能测试代码。
• doc/：包含项目的文档文件。
• script/：包含项目的脚本文件。

2. 项目的启动文件介绍

OpenTripPlanner 的启动文件是 src/main/java/org/opentripplanner/standalone/OTPMain.java。这个文件是OpenTripPlanner的主入口点，负责初始化服务器并启动服务。

启动步骤：

1. 编译项目：使用Maven编译项目，生成一个统一的JAR文件。

   mvn clean package
   

2. 运行JAR文件：编译完成后，在target/目录下会生成一个名为otp-VERSION.jar的JAR文件。使用以下命令启动服务：

   java -jar target/otp-VERSION.jar
   

3. 项目的配置文件介绍

OpenTripPlanner 的配置文件主要包括以下几个：

1. pom.xml

这是Maven项目的配置文件，定义了项目的依赖、插件、构建配置等。

2. mkdocs.yml

这是MkDocs的配置文件，用于生成项目的文档网站。

3. config.json

这是OpenTripPlanner的运行时配置文件，定义了服务器的各种参数，如端口、数据源、日志级别等。

配置示例：

{
  "port": 8080,
  "dataSources": {
    "gtfs": "path/to/gtfs.zip",
    "osm": "path/to/osm.pbf"
  },
  "logLevel": "INFO"
}

配置文件的使用：

在启动OpenTripPlanner时，可以通过命令行参数指定配置文件的路径：

java -jar target/otp-VERSION.jar --config path/to/config.json

通过以上步骤，您可以成功启动并配置OpenTripPlanner项目。