hammock - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #go #golang #android #linux #docker #macos #awesome #ios #mcp #openai

hammock

(★ 109)

CDI Based Microservices

파일 탐색기

최종 버전 다운로드 (.zip)

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/hammock-project/hammock

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd hammock

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Maven (Java)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java 프로젝트를 빌드/실행하려면 필요합니다.
Maven mvn 명령어를 쓰기 위한 빌드 도구입니다.

cd bootstrap-owb2

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

mvn clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

✅ BUILD SUCCESS 메시지가 뜨면 성공입니다. target/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Hammock
=======

[![Gitter chat](https://badges.gitter.im/hammock-project/gitter.png)](https://gitter.im/hammock-project/Lobby)
[![Build Status](https://travis-ci.org/hammock-project/hammock.png)](https://travis-ci.org/hammock-project/hammock)
[![Maven Central](https://img.shields.io/maven-central/v/ws.ament.hammock/hammock-core.svg)](http://search.maven.org/#search%7Cga%7C1%7Cws.ament.hammock)

![Hammock](https://hammock-project.github.io/img/src/Large.png)

_Building Microservices so easily you're laying in a Hammock!_

Hammock is a simple to use framework for bootstrapping CDI, launching a web server and being able to deploy REST APIs.  It takes a best practice approach to creating a runtime for you, so that you can focus on the important stuff.

Read through some of the basics to get started, or view the [wiki](https://github.com/hammock-project/hammock/wiki)

## Getting Started

First, add some dependencies to your project.  Easiest way to start is with a Micrprofile Distribution - Standard or Cochise

### Using Maven

Containers bring in transitive dependencies to bring up your runtime.

#### Using Undertow, Weld, Apache Johnzon, CXF

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

#### Using Apache Tomcat, OpenWebBeans, Johnzon, CXF

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

### Launching your first app

Now that you have your dependencies in order, you can launch your first app.

#### Using Hammock's Bootstrap

Hammock has a bootstrap class, `ws.ament.hammock.Bootstrap` which will start CDI for you.  It uses implementations of `Bootstrapper` to start the appropriate container.

#### Using Your Container's Bootstrap

You can also bootstrap your container directly.  Since Hammock is implemented as a suite of CDI components, no extra work is required.

#### Use your own Bootstrap

You may want your own bootstrap, to do some pre-flight checks.  Just make sure you either initialize Hammock or Weld when you're done.  Your main might look as simple as

```java
public class CustomBootstrapper implements Bootstrapper {

public void start() {
        new PreflightChecks().verify();
        new Weld().initialize();
    }

public void stop() { }
}
```

Make sure you add this to the `ServiceLoader`

#### Executable JARs

You'll likely want to create an executable JAR.  Just shade in all dependencies using your favorite build tool, and set the main class to your choice of main class.  I recommend using [Capsule](http://www.capsule.io/)

### Configuration

Configuration is provided via Apache DeltaSpike.  The default configuration uses port 8080 for your webserver and /tmp for your static file directory.  You'll likely want to configure those for your project.

### Security

Basic security support is available.  Two CDI interceptors are in use, one for verifying a user is logged in and another for verifying roles.  To make use of security, you'll need to implement the `Identity` interface and make it a bean to represent the user currently be acted upon, usually of `RequestScope`.  
* `@LoggedIn` annotate a class or method, and an interceptor will check that the user is logged in for this method invocation.
* `@HasAllRoles()` annotate a class or method, and an interceptor will check that the current identity has all of the roles defined.

To add the security runtime to your app, just include this dependency.

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

### Issue Tracking

Have a feature request? Or found an issue? Please use [github issues](https://github.com/hammock-project/hammock/issues) to let us know!