신비한 비

Cargo는 Rust 언어의 패키지 관리자 및 빌드 도구입니다. 의존성 관리, 프로젝트 빌드, 테스트 실행 및 프로그램 배포 등을 도와줍니다. Rust 커뮤니티에서는 Cargo가 표준 빌드 도구로 자리 잡고 있으며, Rust 개발자에게 큰 편리함을 제공합니다.

Cargo 설치 및 사용법 Rust를 설치할 때 Cargo가 함께 설치됩니다. Rust를 아직 설치하지 않았다면, Rust 입문부터 전문가까지 - Hello World! 시리즈의 첫 번째 편을 참고하거나 공식 웹사이트에서 다운로드하여 설치할 수 있습니다. 설치가 완료되면 다음 명령어를 사용하여 Cargo가 제대로 설치되었는지 확인할 수 있습니다:

cargo --version
# cargo 1.68.0 (115f34552 2023-02-26)

위 명령어를 실행하면 Cargo의 버전이 출력되며, 이는 설치가 성공적으로 이루어졌음을 나타냅니다. 환경 검사가 완료되었으므로, 이제 Cargo를 배우기 시작할 차례입니다. 이전 글에서 사용한 명령어 중 하나는 "cargo new"입니다. 이 명령어는 첫 번째 Rust 프로젝트를 생성했습니다. 이전 글을 보지 않은 독자는 다음 명령어를 실행하여 프로젝트를 만들어 볼 수 있습니다.

cargo new hello_world

위 명령어는 현재 디렉토리에 hello_world라는 새 프로젝트를 생성합니다. hello_world는 프로젝트 이름으로, 필요에 따라 수정할 수 있습니다. 프로젝트를 만든 후, hello_world 디렉토리를 엽니다. 디렉토리 구조는 다음과 같습니다.

/
├── Cargo.lock
├── Cargo.toml
├── crate-information.json
├── src/
│   ├── main.rs
└── target/
└── tools/

Cargo가 생성한 가장 기본적인 프로젝트 구조로, src 디렉토리(개발 소스 코드 저장), Cargo.toml 파일(프로젝트 메타데이터, 컴파일 빌드, 제3자 라이브러리 종속성 관리 등)을 포함합니다. src 디렉토리에서 main.rs라는 파일을 볼 수 있으며, 이는 Rust 프로그램의 진입점으로 기본적인 main() 메서드를 구현합니다.

fn main() {
	println!("Hello, world!");
}

위의 코드는 main() 함수 안에 println!("Hello, world!"); 라는 매우 간단한 프로그램입니다. 이 프로그램은 명령 프롬프트 창에 "Hello, world!"라는 문장을 출력하는 기능을 합니다. VS Code에서 F5를 누르면 첫 번째 프로그램을 실행할 수 있습니다.

만약 VS Code 시작 구성을 구성하지 않았다면, 프로그램을 실행하기 전에 Cargo가 먼저 build 명령을 사용하여 프로젝트를 빌드하고 실행 가능한 파일을 생성합니다. 이제 cargo 명령어를 하나 더 배워보겠습니다.

cargo build

이 명령은 프로젝트 루트 디렉토리에서 target 디렉토리를 생성하고, 그 안에 빌드 후 생성된 이진 파일이 포함됩니다. 기본적으로 Cargo는 hello_world라는 이름의 이진 파일을 생성합니다.

이진 파일을 생성하지 않고 프로젝트를 컴파일하고 싶을 때는 다음 명령어를 사용합니다.

cargo check

이 명령은 코드가 컴파일될 수 있는지를 확인하지만, 이진 파일을 생성하지 않습니다.

빌드가 완료된 후 다음 명령어를 사용하여 프로그램을 실행할 수 있습니다.

cargo run

이 명령은 프로젝트를 자동으로 빌드하고 실행합니다. 모든 것이 정상적으로 실행된다면, "Hello, world!"와 같은 출력을 볼 수 있을 것입니다.

자주 사용되는 Cargo 명령어들

이전 섹션에서는 Cargo의 new, build, run, check 네 가지 명령어를 사용했었는데, 이 외에도 Cargo는 다양한 명령어를 제공합니다. 그 중에서 가장 자주 사용되는 몇 가지 명령어를 소개하고 주석을 달아보겠습니다.

• new: 이 명령어는 새로운 Rust 프로젝트를 생성합니다. 프로젝트 이름과 타입(바이너리(bin) 또는 라이브러리(lib)) 두 개의 매개변수가 있으며, 기본적으로 이 명령어는 바이너리(bin) 프로젝트를 생성합니다.

• init: 이 명령어는 현재 디렉토리를 Rust 프로젝트로 초기화합니다. src 디렉토리와 Cargo.toml 파일이 생성됩니다.

• check: 이 명령어는 코드를 컴파일할 수 있는지 검사하지만, 바이너리 파일은 생성하지 않습니다.

• build: 이 명령어는 Rust 프로젝트를 컴파일하고 바이너리 파일을 생성합니다. 만약 프로젝트가 이미 컴파일되었다면, build 명령어는 컴파일 과정을 건너뛸 것입니다.

• run: 이 명령어는 Rust 프로젝트를 컴파일하고 실행합니다. 만약 프로젝트가 이미 컴파일되었다면, run 명령어는 컴파일 과정을 건너뛸 것입니다.

• test: 이 명령어는 프로젝트 내의 테스트를 실행합니다. 테스트 코드는 보통 src/test.rs나 src/lib.rs 파일에 작성됩니다.

• bench: 이 명령어는 프로젝트 내의 벤치마크 테스트를 실행합니다. 벤치마크 테스트는 코드의 성능을 테스트하기 위해 사용됩니다.

• doc: 이 명령어는 프로젝트 문서를 생성합니다. 보통 Rust 내장 문서 도구인 rustdoc을 사용하여 문서를 생성합니다.

• clean: 이 명령어는 프로젝트 빌드 파일과 생성된 바이너리 파일을 모두 삭제합니다.

• update: 이 명령어는 프로젝트 내의 의존성을 업데이트합니다.

• publish: 이 명령어는 프로젝트를 crates.io에 배포하여 다른 사람들이 사용할 수 있게 합니다.

더 많은 명령어는 cargo --help 또는 cargo <command> --help로 확인할 수 있습니다.

사용자 정의 확장 명령어

의존성 관리 Rust 프로젝트에서는 Cargo를 사용하여 의존성을 관리할 수 있습니다

이어서, 우리는 Cargo를 사용하여 종속성을 관리할 수 있습니다. Cargo.toml 파일을 편집하여 종속성을 추가할 수 있습니다.

예를 들어, 우리가 rand 라이브러리를 사용하여 난수를 생성하려고 한다면, 다음과 같은 내용을 Cargo.toml 파일에 추가할 수 있습니다:

[dependencies]
rand = "0.8.4"

이 명령어는 Cargo에게 rand 라이브러리를 사용하려고 한다는 것을 알리며, 버전 0.8.4를 사용하고자 한다는 것을 지정합니다. 파일을 저장한 후, 다음 명령을 사용하여 종속성을 설치할 수 있습니다:

cargo build

이 명령은 종속성을 자동으로 다운로드하고 설치합니다. 종속성을 사용할 때는, main.rs 파일에 다음과 같은 문장을 추가해야 합니다:

use rand::Rng;

fn main() {
let mut rng = rand::thread_rng();
let n: u8 = rng.gen();
println!("Random number: {}", n);
}

여기서 우리는 rand 라이브러리의 Rng 트레이트와 thread_rng 함수를 사용하여 난수를 생성합니다.

버전 관리

위의 예제에서는 0.8.4 버전의 rand 라이브러리 의존성을 지정하고, 명령 프롬프트에서 무작위 숫자를 출력했습니다. 이번에는 의존성 관리를 더 자세히 배워봅시다.

특정 버전을 지정하는 것 외에도, 논리 연산자를 사용하여 버전 범위를 제어할 수 있습니다. 아래는 구체적인 예시입니다.

=: 특정 버전과 동일합니다. 버전 번호를 직접 입력하는 것과 같습니다.

: 특정 버전보다 높은 버전입니다. <=: 특정 버전보다 작거나 같은 버전입니다. ~: 특정 버전과 비슷합니다. 예를 들어, 1.2.3은 대략 1.2.3과 같으며, 마지막 숫자가 다른 경우에도 허용됩니다. 예를 들어, 1.2.4입니다. ^: 특정 버전과 호환됩니다. 예를 들어, ^1.2.3은 1.2.x 시리즈의 모든 버전과 호환되지만 2.0.0 이상 버전과는 호환되지 않습니다.

예를 들어, 0.7.3 이상 0.8.4 미만 버전의 라이브러리 의존성을 지정하려면 다음과 같이 작성할 수 있습니다.

[dependencies]
rand = ">=0.7.3, <0.8.4"

의존성 항목의 기능 지정

일부 라이브러리는 여러 기능을 제공하여 일부 기능을 활성화하거나 비활성화 할 수 있습니다. 예를 들어, serde 라이브러리는 파생 매크로를 활성화하는 derive 기능을 제공합니다. 의존성 항목의 기능을 지정하려면 다음 구문을 사용할 수 있습니다.

[dependencies]
라이브러리_이름 = { version = "버전", features = ["기능_이름"] }

log는 로그 기록을 위한 라이브러리입니다. 다음은 몇 가지 일반적인 기능과 사용 예시입니다.

• std: log의 표준 라이브러리 지원을 활성화하여 표준 라이브러리 환경에서 log를 사용할 수 있습니다.

• env_logger: log의 환경 변수 지원을 활성화하여 환경 변수를 사용하여 로그 출력을 제어할 수 있습니다.

• log4rs: log4rs 지원을 활성화하여 log4rs 라이브러리를 사용하여 로그 출력을 구성할 수 있습니다.

• simplelog: simplelog 지원을 활성화합니다. simplelog 라이브러리를 사용하여 로그 출력을 구성할 수 있습니다.

다음은 예제입니다: [dependencies] log = { version = "0.4", features = ["std"] }

[dependencies]
log = { version = "0.4", features = ["std"] }

[dependencies]
log = { version = "0.4", default-features = false }

일부 경우에는 로컬 파일 시스템에 있는 라이브러리를 사용해야 할 수 있습니다. 이를 위해 의존성 경로를 지정할 수 있습니다:

[dependencies]
rand = { path = "../rand" }

이 예제에서는 "../rand" 경로의 "rand" 라이브러리를 지정하고 있습니다. 이는 Cargo 컴파일러에게 우리의 프로젝트가 로컬 파일 시스템에 있는 "rand" 라이브러리를 필요로 함을 알려줍니다. "cargo build" 명령을 실행하면, Cargo는 자동으로 지정된 경로의 "rand" 라이브러리를 컴파일하고 프로젝트에 추가합니다.

로컬 파일 시스템에서 라이브러리를 사용하는 것 외에도, git 저장소에서 라이브러리를 사용할 수 있습니다. 의존성 git 저장소를 지정하려면 다음 구문을 사용할 수 있습니다:

[dependencies]
rand = { git = "https://github.com/rust-lang-nursery/rand.git" }

메타데이터

이전 섹션에서는 Cargo의 품질 관리 및 의존성 관리 기능을 설명했습니다. 이번 섹션에서는 Cargo.toml 파일에서 정의된 프로그램 메타데이터 (예 : 프로그램 이름, 버전, 작성자, 설명 등)를 설명합니다.

makefileCopy code
[package]
##    프로젝트 이름
name = "hello_world"
##    버전
version = "0.1.0"
##    작성자, 여러 명일 경우 쉼표로 구분
authors = ["Your Name <your_email@example.com>"]
##    프로젝트 설명
description = "A hello world program in Rust."
##    Rust 언어 버전, 현재 2015, 2018 및 2021 세 가지 버전을 지원합니다.
edition = "2021"

기본 메타데이터 이외에도, [package.metadata] 아래에서 전용 메타데이터를 사용자 정의할 수 있습니다.

makefileCopy code
[package.metadata]
url = "https://github.com/username/hello-world"
doc = "https://docs.rs/hello-world"
repository = "https://github.com/username/hello-world.git"

결론

이를 통해 Rust 언어의 패키지 관리자 및 빌드 도구인 Cargo를 사용하여 새로운 Rust 프로젝트를 만들고, Rust 프로그램을 작성하고, 프로그램을 빌드하고 실행하며, 의존성을 추가하는 방법을 배웠습니다.

내저장소 바로가기 luxury515

Rust 란?

라스츠 냐 ? 러스츠냐 ? 그거시 뭐가 중요헌디? 그냥 러스트라고 읽자.

Rust는 Mozilla에서 개발한 시스템 수준 프로그래밍 언어로, 안전성, 병렬성, 성능을 제공하기 위해 만들어졌습니다. 메모리 안전성과 데이터 경합 없음의 특성을 갖추고 있어 고성능 서버 애플리케이션, 운영 체제, 게임 등을 작성하는 데 사용할 수 있습니다.

초보자는 공식 Rust 온라인 편집기 Play Rust Online 을 사용하여 학습할 수 있습니다.

Rust 개발 환경 구축 먼저, Rust 공식 웹 사이트의 다운로드 페이지에서 해당되는 32비트 또는 64비트 설치 파일을 선택하고 다운로드합니다. 저는 64비트 설치 파일을 선택하여 설치했습니다.

혹은 Linux 나 MacOS 는

$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

설치 확인

없데이트 (뭐 이제 방금설치 했는데 업데이트 해라고 ? 아니그런건 아니고 그냥 나중에 업데이트는 이런 명령어로 할수 있다는…^^ )

rustup update

vscode 를 사용예정이면 아래 extension 을 설치 하면 된다.

개발 생산성을 도와주는 플러그인도 설치를 해라. 뭐 개인적인 취향대로 설치하면되지만 추후 더 익숙해지면 선택해서 갈아타면 될것이고, 이번 강좌는 따라하는거라 일단 요거로 통일부탁 합니당.

rust 프로젝트에서 핵심역할을 하는 Cargo.toml 파일일 좀더 이쁘게 보여주여주는 놈. 요것도 주저없이 설치해라.

프로젝트 생성.

vscode 에서 terminal 열고 (기존 react , vue 등 vscode를 좀 다뤄 보신 분이라면 잘 할것임. 아무곳에나 폴더 하나 말들고 `code .` 하면 vscode 가 자동 열림....)

cargo new myproject

아래와 같이 폴더가 생성 된다.

/
├── Cargo.lock
├── Cargo.toml
├── crate-information.json
├── src/
│   ├── main.rs
└── target/
└── tools/

여기서 main.rs 파일을 열고.

개발자라면 누구나 1000 번 정도는 만들어봣을듯한 핼로우월드 를 직접 타이핑해본다. 아님 이걸 그냥 복붙해서 쓰셈.

fn main() {
    println!("Hello, world!");
}

자 이제 두근두근 나의 첫 rust 여행의 문을 열어 제껴보자!

cargo run

더 나아가서 VSCode 설정.

launch.json 파일을 만들고.

{
    "version": "0.2.0",
    "configurations": [
        {
            // VS Code에 표시되는 구성 이름입니다.
            "name": "Debug Rust",
            // Rust 언어의 디버거 유형은 lldb입니다.
            "type": "lldb",
            // Rust 언어의 디버그 요청 유형은 launch입니다.
            "request": "launch",
            // 실행 가능한 파일 경로입니다. target/debug 디렉토리의 실행 가능한 파일까지 지정해야합니다.
            "program": "${workspaceFolder}/target/debug/myproject",
            // 실행 가능한 파일의 인수입니다. 비워 둘 수 있습니다.
            "args": [],
            // 작업 디렉토리입니다. 프로젝트 루트 디렉토리로 지정해야합니다.
            "cwd": "${workspaceFolder}",
            // 디버깅 이전에 수행해야하는 작업입니다. 일반적으로 빌드 작업입니다.
            "preLaunchTask": "cargo build"
        }
    ]
}

VS Code 에서 F5 단축키 로 실행.

결론.

이 튜토리얼에서는 VS Code를 사용하여 Rust 언어 개발 환경을 구축하는 방법을 소개하고 몇 가지 예제 코드 및 구성을 제공합니다. 이 튜토리얼을 통해 독자는 Rust 프로젝트를 생성하는 방법, 코드 작성, 코드 실행 및 디버깅하는 방법을 이해할 수 있습니다.

내저장소 바로가기 luxury515

들어가면서…

Spring Data JPA는 개발자가 데이터베이스와 상호작용할 때 일반적으로 발생하는 작업들을 단순화하는 몇 가지 도구를 제공합니다. 이 중에서, Paging과 Sorting을 위한 기능을 Pageable과 Sort 객체를 통해 제공합니다.

Pageable을 사용하면, 특정 페이지의 데이터를 가져오거나 페이지별로 데이터를 검색할 수 있습니다. 예를 들어, 사용자의 계정 정보를 페이징하면서 가져오거나, 특정 시간 범위 내의 로그 정보를 페이지별로 검색하는 등의 작업을 할 수 있습니다.

Sort를 사용하면, 특정 컬럼을 기준으로 데이터를 정렬할 수 있습니다. 예를 들어, 사용자의 이름으로 오름차순으로 정렬하거나, 최근 등록된 게시글을 내림차순으로 정렬하는 등의 작업을 할 수 있습니다.

이제, 실제로 Spring Data JPA에서 Pageable과 Sort를 사용하는 방법을 살펴보겠습니다.

Paging을 위한 Pageable 사용법

Paging을 위해서는, Repository 메소드의 파라미터로 Pageable 객체를 받아와야 합니다. 예를 들어, 다음과 같은 UserRepository가 있다고 가정해보겠습니다.

public interface UserRepository extends JpaRepository<User, Long> {

    Page<User> findAll(Pageable pageable);

}

위 코드에서, UserRepository는 JpaRepository를 상속하고 있습니다. findAll 메소드의 파라미터로 Pageable 객체를 받아와서, Page<User> 타입의 결과를 반환하도록 정의되어 있습니다. 따라서, 다음과 같이 Pageable 객체를 만들어서 UserRepository의 findAll 메소드에 전달할 수 있습니다.

Pageable pageable = PageRequest.of(0, 10);
Page<User> users = userRepository.findAll(pageable);

위 코드에서, PageRequest.of(0, 10)은 첫 번째 페이지에서 10개의 데이터를 가져오도록 Pageable 객체를 생성하는 코드입니다. 이제, UserRepository의 findAll 메소드에 위 Pageable 객체를 전달하면, 첫 번째 페이지의 사용자 정보 10개를 가져올 수 있습니다.

• Sorting을 위한 Sort 사용법

Sorting을 위해서는, Repository 메소드의 파라미터로 Sort 객체를 받아와야 합니다. 예를 들어, 다음과 같은 UserRepository가 있다고 가정해보겠습니다.

public interface UserRepository extends JpaRepository<User, Long> {

    List<User> findAll(Sort sort);

}

위 코드에서, UserRepository는 JpaRepository를 상속하고 있습니다. findAll 메소드의 파라미터로 Sort 객체를 받아와서, List<User> 타입의 결과를 반환하도록 정의되어 있습니다. 따라서, 다음과 같이 Sort 객체를 만들어서 UserRepository의 findAll 메소드에 전달할 수 있습니다.

Sort sort = Sort.by("name").ascending();
List<User> users = userRepository.findAll(sort);

위 코드에서, Sort.by("name").ascending()은 사용자 이름으로 오름차순으로 정렬하는 Sort 객체를 생성하는 코드입니다. 이제, UserRepository의 findAll 메소드에 위 Sort 객체를 전달하면, 사용자 정보를 이름으로 오름차순으로 정렬한 결과를 가져올 수 있습니다.

• Paging과 Sorting을 함께 사용하는 방법

Paging과 Sorting을 함께 사용하기 위해서는, Repository 메소드의 파라미터로 Pageable과 Sort 객체를 모두 받아와야 합니다. 예를 들어, 다음과 같은 UserRepository가 있다고 가정해보겠습니다.

public interface UserRepository extends JpaRepository<User, Long>{

    Page<User> findAll(Pageable pageable, Sort sort);

}

위 코드에서, UserRepository는 JpaRepository를 상속하고 있습니다. findAll 메소드의 파라미터로 Pageable과 Sort 객체를 모두 받아와서, Page<User>타입의 결과를 반환하도록 정의되어 있습니다. 따라서, 다음과 같이 Pageable과 Sort 객체를 만들어서 UserRepository의 findAll 메소드에 전달할 수 있습니다.

Pageable pageable = PageRequest.of(0, 10);
Sort sort = Sort.by("name").ascending();
Page<User> users = userRepository.findAll(pageable, sort);

위 코드에서, PageRequest.of(0, 10)은 첫 번째 페이지에서 10개의 데이터를 가져오도록 Pageable 객체를 생성하는 코드입니다. Sort.by("name").ascending()은 사용자 이름으로 오름차순으로 정렬하는 Sort 객체를 생성하는 코드입니다. 이제, UserRepository의 findAll 메소드에 위 Pageable과 Sort 객체를 전달하면, 첫 번째 페이지의 사용자 정보 10개를 이름으로 오름차순으로 정렬한 결과를 가져올 수 있습니다.

이상으로, Spring Data JPA에서 Paging과 Sorting을 위한 Pageable과 Sort 객체를 사용하는 방법에 대해서 살펴보았습니다.

결론

Spring Data JPA에서 Paging과 Sorting을 위한 Pageable과 Sort 객체를 사용하면, 간단하게 데이터를 페이지로 나누어 가져오거나, 원하는 기준으로 데이터를 정렬할 수 있습니다. Pageable 객체를 사용하여 페이징 처리를 하면, 대용량의 데이터를 효과적으로 처리할 수 있고, Sort 객체를 사용하여 원하는 기준으로 데이터를 정렬할 수 있습니다. 또한, Pageable과 Sort 객체를 함께 사용하여 원하는 페이지의 데이터를 정렬하여 가져올 수 있습니다. 이를 통해 Spring Data JPA를 사용하는 개발자들은 간편하게 데이터를 처리할 수 있습니다.

내저장소 바로가기 luxury515

<insert id="insertKycInfo">

INSERT INTO `okcoin_broker`.`user_kyc_info`(
`user_id`,
`kyc_info`,
`type`,
`country_id`,
`level`,
`status`,
`fail_reason`,
`remark`,
`create_time`,
`update_time`,
`exp_date`
) VALUES
<foreach collection="userKycInfo" item="element" index="index" open="(" separator="),(" close=")">

#{element.user_id},
<choose>
<when test="element.kyc_info ==null">null,</when>

<when test="element.kyc_info ==''">null,</when>

<otherwise>#{element.kyc_info},</otherwise>
</choose>
#{element.type},
#{element.country_id},
#{element.level},
#{element.status},
#{element.fail_reason},
#{element.remark},
date_format(STR_TO_DATE(#{element.create_time}, '%Y-%m-%d %H:%i:%s'), '%Y-%m-%d %H:%i:%s'),
date_format(STR_TO_DATE(#{element.update_time}, '%Y-%m-%d %H:%i:%s'), '%Y-%m-%d %H:%i:%s'),
<choose>
<when test="element.exp_date ==null">null</when>

<when test="element.exp_date ==''">null</when>

<otherwise>date_format(STR_TO_DATE(#{element.exp_date}, '%Y-%m-%d %H:%i:%s'), '%Y-%m-%d %H:%i:%s')</otherwise>
</choose>
</foreach>
ON DUPLICATE KEY UPDATE
user_id = VALUES(user_id),
<choose>
<when test="element.kyc_info ==null">kyc_info = null,</when>

<when test="element.kyc_info ==''">kyc_info = null,</when>

<otherwise>kyc_info = VALUES(kyc_info),</otherwise>
</choose>
type = VALUES (type),
country_id = VALUES (country_id),
level = VALUES (level),
status = VALUES (status),
fail_reason = VALUES (fail_reason),
remark = VALUES (remark),
create_time = date_format(STR_TO_DATE(VALUES(create_time), '%Y-%m-%d %H:%i:%s'), '%Y-%m-%d %H:%i:%s'),
update_time = date_format(STR_TO_DATE(VALUES(update_time), '%Y-%m-%d %H:%i:%s'), '%Y-%m-%d %H:%i:%s'),
<choose>
<when test="element.exp_date ==null">exp_date = null</when>

<when test="element.exp_date ==''">exp_date = null</when>

<otherwise>exp_date = date_format(STR_TO_DATE(VALUES(exp_date), '%Y-%m-%d %H:%i:%s'), '%Y-%m-%d %H:%i:%s')</otherwise>
</choose>
</insert>

내저장소 바로가기 luxury515