通用DSP广告投放引擎（GAE）使用教程

通用DSP广告投放引擎（GAE）使用教程

1. 项目目录结构及介绍

gae/
├── data/
├── src/
│   ├── main/
│   └── test/
├── travis.yml
├── LICENSE
├── README.md
├── gae.idx
├── mock-idx.txt
├── pom.xml
└── ...

目录结构说明

• data/: 存放项目的数据文件，如IP字典、索引文件等。
• src/: 项目的源代码目录，包含主代码和测试代码。
  • main/: 主代码目录，包含项目的核心逻辑。
  • test/: 测试代码目录，包含项目的单元测试和集成测试代码。
• travis.yml: Travis CI 配置文件，用于持续集成。
• LICENSE: 项目的开源许可证文件，本项目使用MIT许可证。
• README.md: 项目的说明文档，包含项目的简介、使用方法等。
• gae.idx: 全量索引文件，用于广告投放引擎的初始化。
• mock-idx.txt: 模拟索引文件，用于测试和演示。
• pom.xml: Maven 项目配置文件，定义了项目的依赖和构建配置。

2. 项目启动文件介绍

启动文件

项目的启动文件是 src/main/java/org/fh/gae/GaeHttpServer.java，该文件是GAE的HTTP网络通讯逻辑的入口，使用Vert.x框架启动HTTP服务。

启动步骤

1. 构建项目: 使用Maven构建项目，生成可执行的JAR文件。

   mvn clean package -Dmaven.test.skip=true
   

2. 运行项目: 使用生成的JAR文件启动GAE服务。

   java -jar target/gae.jar --gae.server.port=9000 --gae.index.kafka=true --gae.index.file.path=/ --gae.index.file.name=gae.idx --gae.dict.ip=IP字典文件名
   

3. 项目的配置文件介绍

配置文件

项目的配置文件主要在 src/main/resources/application.yaml 中，该文件包含了GAE的各项配置参数。

配置参数说明

• gae.server.port: 指定GAE服务的监听端口，默认为9000。
• gae.index.kafka: 控制是否从Kafka中读取增量索引，默认为false。
• gae.index.file.path: 全量索引文件的存放路径。
• gae.index.file.name: 全量索引文件的名称。
• gae.dict.ip: IP字典文件的路径和名称。

示例配置

gae:
  server:
    port: 9000
  index:
    kafka: true
    file:
      path: /
      name: gae.idx
  dict:
    ip: IP字典文件名

通过以上配置，可以灵活地调整GAE的行为，以适应不同的部署环境和需求。