Hammock 微服务框架指南

Hammock 微服务框架指南

hammock CDI Based Microservices 项目地址: https://gitcode.com/gh_mirrors/hammo/hammock

项目介绍

Hammock 是一个基于 CDI（Contexts and Dependency Injection）的微服务框架，旨在简化微服务的搭建过程。它允许开发者轻松地启动一个web服务器并部署REST API，通过采用最佳实践来构建运行时环境，从而使开发者能够专注于核心业务逻辑。Hammock支持多种容器如Undertow、Weld、Apache Johnzon等，并且提供了一个简单的入门途径，尤其适用于那些希望利用MicroProfile标准的项目。

项目快速启动

要迅速开始您的Hammock之旅，首先确保您的开发环境已配置好Java和Maven或Gradle。

添加依赖

选择适合您的容器配置，以下以使用MicroProfile标准为例：

使用Micrprofile Distribution:

<dependency>
    <groupId>ws.ament.hammock</groupId>
    <artifactId>dist-microprofile</artifactId>
    <version>2.1</version>
</dependency>

对于Cochise版本，用于不同的容器配置:

<dependency>
    <groupId>ws.ament.hammock</groupId>
    <artifactId>dist-microprofile-cochise</artifactId>
    <version>2.1</version>
</dependency>

启动应用

创建主类以启动Hammock：

import ws.ament.hammock.Bootstrap;

public class QuickStartApp {
    public static void main(String[] args) {
        Bootstrap.start();
        // 这里可以添加应用程序初始化代码
    }
}

确保在执行此步骤前，已经正确配置了所有必要的依赖和服务加载器。

应用案例和最佳实践

最佳实践：配置与安全

• 配置: 利用Apache DeltaSpike进行配置管理，设置默认的服务器端口（8080）及静态文件目录。
• 安全性: 实现Identity接口来管理用户身份验证，使用@LoggedIn和@HasAllRoles注解实现访问控制。

示例：添加基本认证

在需要保护的方法上添加注解，例如：

@LoggedIn
@Path("/protected")
public class ProtectedResource {
    @GET
    public String getProtectedInfo() {
        return "Secure Information";
    }
}

并在你的项目中加入安全支撑的依赖：

<dependency>
    <groupId>ws.ament.hammock</groupId>
    <artifactId>security-spi</artifactId>
    <version>2.1</version>
</dependency>

典型生态项目

Hammock作为一个灵活的框架，可与多种技术栈结合。常见的生态搭配包括但不限于：

• 利用Swagger UI进行API文档化。
• 集成Camel实现复杂的集成方案。
• 结合Metrics收集和监控服务性能。
• 采用Flyway进行数据库迁移管理。

通过这些生态项目，你可以增强Hammock应用的功能性和可靠性，比如通过Swagger UI轻松暴露和测试RESTful API。

---

以上是Hammock框架的基本引导和几个关键点的简介，更详细的文档和实例可以在其GitHub页面和官方wiki中找到。记得调整上述示例中的版本号以匹配最新的发布版本。

hammock CDI Based Microservices 项目地址: https://gitcode.com/gh_mirrors/hammo/hammock