入门指南
入门
你可以通过多种方式开始使用 Apache Camel,例如:
- 使用在线项目生成器
- 使用 Camel CLI(命令行工具)
还有一些其他替代方法:
- 将 Camel 添加到现有项目中
- 使用 IDE 工具向导
- 使用带可视化设计器的 UI 工具
- 使用 Maven Archetype(项目骨架)
- 克隆现有示例并进行修改
使用在线项目生成器
你可以使用 Spring Boot Initializer,这是一个同样支持 Camel 的 Spring Boot 生成器。不过,该生成器不允许用户对可使用的组件、数据格式、kamelet 等进行细粒度的控制。
还有 Code with Quarkus,即 Quarkus 生成器,它对 Camel 提供了出色的支持。
从命令行(CLI)开始
Camel CLI 既可以与 JBang 一起安装和使用(步骤 1a),也可以作为纯独立的 Camel 安装方式使用(步骤 1b)。
安装和使用 Camel CLI
Camel 使用 JBang 来运行 Camel CLI。只需几步,你就能轻松上手。
步骤 1a
首先根据你的平台安装 JBang。
安装完 JBang 后,你可以通过调用版本命令来确认它是否正常工作:
$ jbang version
0.141.0然后将 Camel 安装到 JBang 中,步骤如下:
$ jbang app install camel@apache/camel然后,你可以通过执行以下命令来检查 Camel 是否已安装并正常工作:
$ camel version
JBang version: 0.141.0
Camel CLI version: 4.18.0安装并使用 Camel 独立命令行工具
步骤 1b
下载所需 Camel 版本对应的 Camel Launcher .zip 发行包。
例如,要从 Maven Central 下载 Camel 4.18.2,请点击并下载 .bin.zip 文件,然后将该文件解压到一个工作目录中:
$ unzip camel-launcher-4.18.2-bin.zip
$ cd camel-launcher-4.18.2随后,你可以从 bin 文件夹中执行所提供的脚本:
$ bin/camel.sh version
JBang version: 0.141.0
Camel CLI version: 4.18.2你也可以将 camel-launcher 解压到共享目录,并把它的 bin 目录添加到 $PATH 环境变量中,这样就可以在终端的任意位置执行 camel 命令。 |
|---|
使用 Camel CLI
第 2 步
创建你的第一个 Camel 集成
$ camel init hello.yaml你也可以使用 Java 或 XML 代替 YAML。例如 camel init hi.java。 |
|---|
第 3 步
运行 Camel 集成
$ camel run hello.yamlBang,Camel 集成现已运行。你可以使用 ctrl + c 来停止该集成。
第 4 步
Camel 让你可以随时修改代码,操作非常简单。你可以按如下方式进入实时编码模式:
$ camel run hello.yaml --dev处于实时编码模式时,只要保存了对 hello.yaml 的修改,Camel 就会自动加载更新后的版本。
第 5 步
请务必查阅 Camel CLI 文档,以了解 Camel CLI 更多的强大功能。你还会了解到如何使用 Camel CLI 将你构建的内容 导出 为一个纯正的 Camel Spring Boot 或 Camel Quarkus 项目。
参见 camel wrapper 命令,它可用于安装 Camel CLI 并将其固定到指定版本,该安装对给定的项目/目录是本地的(类似于 Maven Wrapper 的工作方式)。 |
|---|
开始使用 Camel 的其他方式
将 Camel 添加到现有项目
你可以将 Camel 添加到任何 Java 项目中,例如将必要的 Camel 依赖项添加到项目的构建文件(Maven 或 Gradle)中。
使用 IDE 工具向导
一些 IDE 提供了创建新项目的向导,其中部分向导通过 Spring Boot Initializer 或 Code with Quarkus 支持 Apache Camel。
使用带可视化设计器的 UI 工具
Apache Camel 有许多 UI 设计器,可帮助你熟悉 Camel,并阐明你能用 Camel 做什么。
其中不乏开源且支持官方 Apache Camel 发行版的工具:
- Apache Camel Karavan - 拥有可在网页浏览器中运行的在线 UI 设计器。
- Kaoto - 同样拥有可在网页浏览器中运行的在线 UI 设计器。
Camel Karavan 和 Kaoto 都可以作为插件直接安装到 Visual Studio Code 这个 IDE 中。
使用 Maven Archetype
Apache Camel 自带一组 Camel Maven Archetype,你可以用它们来创建新的 Camel 项目。
克隆现有示例进行修改
GitHub 上托管着大量 Camel 示例,你可以克隆并修改它们,例如 Camel Spring Boot 示例。
另请参阅
要熟悉并学习 Apache Camel 的基本概念,建议查看 架构,并顺着该页面上的链接继续阅读。
评论
登录后参与评论
KnowForge