안드로이드 블루투스 관련 앱을 만들어보고 싶어, 해당 내용에 관한 글을 정리했습니다.

Bluetooth Low Energy (BLE)

기기간에 마스터, 슬레이브 관계를 형성하여 통신하는 bluetooth classic과 비슷한 무선 통신을 할 수 있었다. 그러나 전력량이 많았다. 기존의 문제이던 전력 소모량을 줄여, 스마트 기기인 스마트 밴드, 워치, 글래스 등에서 사용됩니다.
Classic Bluetooth의 경량화 버전을 목표로 bluetooth 4.0의 일부로 발표 되었습니다. 블루투스 표준화 그룹인 SIG에 의해서 개발되기 전까지 Nokia의 사내 프로젝트로 시작했습니다.

BLE 를 지원하는 기기는 Advertise mode (= broadcast ) 와 Connection mode로 통신을 합니다.

img

Advertise Mode (= Broadcast Mode )란?

주변의 디바이스 유무에 관계없이 자신의 signal을 일방적으로 계속 보내는 것을 말합니다. signal을 일방적으로 보내기 때문에 보안에 취약합니다. 디바이스에 자신의 존재를 알릴 때 사용하지만 observer에 전송할 작은양의 data를 보낼 때도 사용하기도 합니다.

Advertise 방식은 주로 디바이스가 자신의 존재를 알리거나, 적은 양(31Bytes 이하)의 User 데이터를 보낼 때도 사용됩니다. 한 번에 보내야 하는 데이터 크기가 작다면, 굳이 오버헤드가 큰 connection 과정을 거쳐 데이터를 보내기 보다, 단순히 advertise를 통해 한번에 보내는게 더 효율적이기 때문입니다. 전송크기 제한을 보완하기 위해 Scan Request, Scan Response을 이용해서 추가적인 데이터를 주고 받을 수 있습니다.

Advertise 방식은 signal을 일방적으로 뿌리는 것이기 때문에, 보안에 취약합니다.

일대 다 방식.

  • advertiser(boardcaster) : Non-Connectable Advertising Packet signal을 주기적으로 보내는 기기 ( ex. 스마트 워치, 밴드 등 )
  • observer : advertiser가 보내는 packet을 듣기 위해 주기적으로 scanning 하는 기기 ( ex. 폰 )
  • Advertising type 의 신호를 일정주기로 보냅니다.

Connection Mode란?

양방향으로 데이터를 주고 받거나, advertising으로만 데이터를 주고 받기에는 data 양이 많을 경우 Connection Mode로 통신합니다. 일대 일 방식으로 데이터를 교환한다. 디바이스간의 channel hopping 규칙을 정해놓고 통신을 하기 때문에 안전합니다.

Central ( Master )

다른 device와 connection을 맺기 위해 Connection advertise signal을 주기적으로 scan하고, 해당 디바이스에 연결 요청합니다.

연결 후에는 주기적으로 data 교환을 주도 합니다. ( ex. 폰 )

Peripheral ( Slave )

다른 device와 conneciton을 위해 advertise signal을 주기적으로 보낸다. 이를 수신한 Central 디바이스가 Connection request를 보내면 이를 수락하여 Connection 합니다. ( ex. 스마트 밴드 )

Protocol Stack

디바이스들이 bluetooth로 통신하기 위해 Protocol Stack을 가지고 있는데, 통신 규약인 protocol이 쌓여 있는 것을 Protocol Stack 이라 한다. Protocol Stack을 거치면서 packet 이 분석된다.

  • Application - App
  • Host - GAP ( Generic Access Profile ) , GATT(Generic Attribute Profile)
  • Controller - Link Layer, Physical Layer

Physical Layer

Bluetooth Signal과 통신할 수 있는 회로가 구성되어 있다. Analog 신호 <-> Digital 신호

2.4GHz 신호를 40개의 channel로 나누어 통신하는데 그 중 3개는 Advertising Channel, 나머지 37개는 Data Channel이다.

Link Layer

5가지의 state를 가지고 있다. 각 디바이스는 서로 연결되는 과정에서 State 를 변화 시킨다.

  • Standby : Signal packet을 보내지도, 받지도 않는 상태
  • Advertising : advertising packet을 보내고, 해당 advertising packet에 대한 상대 디바이스의 response를 받을 수 있고, 줄 수 있는 상태
  • Scanning : Advertising channel에서 scanning 하고 있는 상태
  • Initial : advertiser의 connectable advertising packet을 받은 후 Connection request를 보낸 상태
  • Connection : connection 이 후의 상태

Generic Access Profile ( GAP )

서로 다른 제조사가 만든 BLE끼리 호환할 수 있도록 하는 역할.
GAP은 서로 다른 제조사가 만든 BLE 디바이스들간에 서로 호환되어 통신할 수 있도록 주춧돌 역할을 한다. 어떻게 디바이스간에 서로를 인지하고, Data를 Advertising하고, Connection을 맺을지에 대한 프레임워크를 제공한다.

또한 GAP에서는 BLE 통신을 위해 Role, Mode, Procedure, Security, Additional GAP data format 등을 정의한다.

## Role

  • Central: Link layer에서 Master 역할에 상응. 다른 디바이스의 Advertising Packet을 듣고, Connection을 시작할 때 시작된다.
  • 메인 컴퓨터, 스마트폰, 태블릿PC의 역할
  • Peripheral: Link layer에서 Slave 역할에 상응. Advertising Packet을 보내서 Central 역할의 디바이스가 Connection을 시작할 수 있도록 유도.
  • 센서기능이 달린 디바이스들의 역할
  • Generic Attribute Profile ( GATT )

BLE data 교환을 관리. 디바이스들이 data를 발견하고, 읽고, 쓰는 것을 가능하게 하는 기초적인 data model과 procedure을 정의한다.

Connection mode일 때 GATT 서비스와 Characteristic을 이용하여 양방향 통신을 한다.

주요 용도에 대한

  • iBeacon prefix(9 byte) : 비콘의 설정이나 특성 값이 기록되는 부분입니다. iBeacon 헤더 정보라 생각하시면 됩니다. 우리가 손대지 않고 정해진 값을 사용해도 됩니다.
  • UUID (16 byte) : 사실 iBeacon에서 가장 중요한 데이터는 UUID, Major, Minor 값입니다. 이 값을 추출한 뒤, 서버에 보내서 내가 어느 위치에 있는지, 이 비콘이 어떤 역할을 하는지, 그래서 사용자에게 어떤 정보를 보여주는 것이 좋은지 판단하게 됩니다. iBeacon 관련 공식 문서를 보면 주변에서 스캔한 UUID, Major, Minor 로 사용자의 위치를 판단하는 예시들을 언급하는데, iBeacon 장치가 위치기반 서비스의 일부임을 표시하기 위해 미리 정해둔 UUID 를 사용합니다. UUID는 꼭 표준에 지정된 값을 쓸 필요는 없으며, 서비스 개발자가 임의로 지정해서 사용해도 됩니다.
  • Major (2 byte), Minor (2 byte) : UUID 와 함께 사용자의 위치(Major, Minor = 지역, 세부 장소)를 판별하는데 주로 사용됩니다. 하지만 사용방법이 고정된 것은 아니며, 개발자가 이 값들을 임의의 목적으로 사용할 수도 있습니다. 예를 들어, 온도와 습도 데이터를 Major, Minor 데이터로 보낼 수도 있습니다. 물론 이 경우 비콘을 스캔 하는 장치도 해당 데이터를 온도, 습도로 인식하도록 만들어야 합니다.
  • TX Power(1 byte) : 비콘 장치가 신호를 송출할 때의 power 레벨을 여기에 적어 보내줍니다. 비콘 신호를 수신할 때 신호 세기를 알 수 있기 때문에 TX power 보다 얼마나 감소했는지를 계산하고, 대강의 거리를 짐작할 수 있습니다. 하지만 이렇게 계산된 거리는 대략적인 추정치입니다. 비콘 신호는 주변 상황이나 움직임, 장애물에 의한 변동이 심할 수 있습니다.

References

  1. https://binux.tistory.com/26
반응형

소프트웨어에 개발에서 실수를 했을 때, 간단히 돌아오는 방법이 있습니다. GIT을 사용해서 프로젝트를 관리한다면 실수에서 벗어나는데 큰 도움이 됩니다.

1. 추적 된 파일 추적 금지

빈번히 발생하는 일 중에 node_modules를 포함해서 commit 했고, .gitignore파일이 없다는 것을 발견 했습니다. 이제서야 .gitignorenode_modules를 추가 했지만, git은 여전히 node_modules 을 추적하고 있습니다.
git base에 commit이 되면서 git이 계속변경 사항을 추적하기 때문입니다. 이를 중지하기 위해서는 아래와 같이 입력 합니다.

git base 에 있는 파일이 삭제 됩니다.

git rm -r --cached node_modules

2. 마지막 commit 수정

local -> git remote 로 commit을 했습니다. 그 후 커밋 파일에 변경 사항을 포함하는 것을 잊었습니다. 또는 가장 최근 커밋한 동일한 커밋에 연결하려는 새 파일을 추가합니다.

git은 이전 커밋을 잠금 해제하고 새 파일을 추가 할 수 있습니다.

git add newfile
git commit --amend -no-edit

--no-edit: commit 메세지를 변경하지 않고, comiit을 수정합니다.

3. 마지막 commit 메세지 수정

위의 수정내용과 비슷합니다. git에 commit을 했는데, commit 한 메세지가 원하는 내용과 달라졌습니다.

git commit --amend -m '메세지가 #2 로 바뀜'

4. 작업 폴더내의 작업내역 삭제

프로젝트를 진행하고 있습니다. 코드를 수정하는 동안 프로그램이 손상되었고, 실제로 무엇이 잘못 되었는지 파악할 수 없게 되었습니다.
현재 작업내용을 취소하고 마지막 commit 시점으로 돌아가야 할 것 같습니다.

git restore .

또는

git reset --hard

이 작업 local 저장소에서 최근 커밋으로 복원 합니다. 커밋하지 않는 내용은 모두 손실 됩니다.

5. 특정파일에 대한 작업 내용 취소

local 저장소의 파일을 수정했습니다. 히지만, test.js 파일의 변경 사항이 의미가 없었다는 것을 알고, 폐기하려고 합니다.

git restore test.js

6. 시간을 거슬러 이전 버전으로 파일 복원

위의 명령어와 달리 파일을 이전 특정 시점 상태로 돌아가기를 원합니다. test.js 파일을 최근 commit 된 내용이 v10 이지만, v2 시점으로 돌아가려고 합니다.

git log


commit d94629103526ddfa0715ca9393362a3b70e097b
Merge: aa034a93 1809aa89
Date:   Tue Aug 9 07:40:00 2022 +0900

    Merge pull request #15 from aaaaaday/master

commit 1809aklflkajlkhfeff890913ec751b36167560
Date:   Sun Aug 7 16:26:45 2022 +0100

    리뷰에 따라 수정 완료

commit 1b93eehwkhflwkehf280b513806b000dd033b9f
Date:   Sat Aug 6 00:58:16 2022 +0100

    원문과 최대한 라인수 일치하도록 수정

를 통해 복원하려고 하는 시점의 commit hash 를 찾습니다.

git restore --source <commit-hash> <파일이름>

7. 삭제한 파일 복원 (이전 commit)

프로젝트를 새로 변경하고 있는데 사용되지 않는 파일이 표시됩니다. 계속해서 파일을 삭제 했습니다.
그러나, 삭제한 파일 deleted_file.js가 필요하다는 것을 알게 되었습니다.

git restore deleted_file.js

8. local 저장소의 모든 변경사항을 remote 상태로 취소합니다.

local repo 브런치에세 몇가지 변경 사항과 commit을 했습니다. 그런데, 변경 사항을 모두 pull을 받았을 당시로 되돌리려고 합니다.

git reset --hard origin/master

commit 되지않는 파일은 영구적으로 삭제 됩니다.

9. 추적되지 않는 파일 삭제 (untracked file)

프로젝트에 여러 개의 새 파일을 만들고 일부 파일도 수정했습니다. 접근 방식을 변경했으며 이제 생성한 새 파일이 더 이상 필요하지 않지만, 수정된 파일 변경 사항을 유지하기로 결정했습니다.
Git은 추적되지 않은 파일을 제거하는 명령을 제공합니다.

git clean -f

git clean 명령에는 force 지시문(또한 --force)을 의미하는 -f 플래그가 필요합니다.

이 작업에는 추적되지 않은 파일 삭제가 됩니다. Git에서 커밋되지 않은 작업을 제거하는 것은 취소할 수 없습니다.

기본적으로 이 명령은 .gitignore로 지정된 추적되지 않은 폴더나 파일을 제거하지 않습니다. 무시된 파일을 제거하려면 -x 옵션을 지정하십시오. 또한 git clean은 디렉토리에서 재귀적으로 작동하지 않습니다.
이것은 우발적인 영구 삭제를 방지하기 위한 또 다른 안전 메커니즘입니다. 디렉토리를 제거하려면 다음과 같이 -d 플래그를 사용하십시오.

자식 청소 -df 이렇게 하면 추적되지 않은 파일과 디렉토리가 지워지지만 .gitignore 파일에 나열된 파일과 디렉토리는 제거되지 않습니다.

10. commit 을 다른 branch로 전환

프로젝트가 발전했으며 현재 newsletter 추가와 layout 미세 조정이라는 두 가지 기능을 작업하고 있습니다. newletterlayout이라는 두 개의 별도 분기를 만들었으며 각 분기를 관련 기능인 뉴스레터 및 레이아웃 전용으로 지정했습니다.

현재 뉴스레터 기능을 추가하고 있으며 뉴스레터 분기에서 몇 가지 커밋을 수행하고 있습니다. 다음에 프로젝트로 돌아올 때 레이아웃 기능에 대해 작업하려고 하는데 연결된 레이아웃 분기로 전환하는 것을 잊었습니다. 잘못된 뉴스레터 분기에서 레이아웃 기능을 추가하고 커밋했습니다.

나중에 뉴스레터 분기에 추가한 커밋이 실제로 레이아웃 분기에 속한다는 사실을 알게 됩니다.

따라서 커밋 추가 레이아웃 기능이 뉴스레터 분기에서 올바른 레이아웃 분기로 이동되기를 원합니다.

Git에서 수행할 작업은 다음과 같습니다.

newleter 지점으로 checkout

git checkout newletter

레이아웃 기능을 추가한 커밋의 커밋 해시를 찾아 복사합니다. 다음 명령을 실행합니다.

git log
# aceew89e0ac

이 커밋으로 적용하려는 올바른 브랜치를 확인하십시오. 우리의 경우:

git checkout layout

# 확인한 hash을 layout branch에 적용
git cherry-pick <commit-hash> 

그런 다음 뉴스레터 분기를 확인합니다.

git checkout newletter
# 잘못 commit 한 내용을 삭제 합니다.
git reset HEAD~1 --hard
or
git reset HEAD^ --hard

HEAD~1은 뉴스레터 브랜치를 재설정하여, 가장 최근 커밋 뒤로 하나의 커밋을 옮기고 다른 곳으로 이동한 커밋을 제거한다는 의미입니다. 우리의 경우 이 newletter 분기에 대한 최신 커밋은 layout 기능이 있는 커밋이었습니다.

11. 삭제된 branch 부활시키기

더 이상 기능 브랜치가 필요하지 않다고 생각하고 삭제했습니다. 다음번에는 삭제가 실수였다는 사실을 알 수 있습니다. 이 황당한 사건에 대해서 당황해 합니다. 당신은 불가능하게 시간을 되돌려 그것을 되찾고 싶어합니다.
삭제된 브랜치를 되돌리고 싶어합니다.

삭제된 브랜치를 복구하는 방법은 다음과 같습니다.

명령을 실행할 때 나열될 삭제된 분기의 커밋 해시를 찾아 복사합니다.

git reflog

그런 다음 다음과 같이 분기를 다시 만듭니다.

git branch <new-branch-name> <삭제된 브런치 hash>

이것은 <deleted-branch-commit-hash>까지의 모든 작업을 포함할 분기를 다시 생성합니다. <deleted-branch-commit-hash>가 삭제된 분기의 최신 작업이 아닌 경우, 최신 작업이 있는 커밋을 얻을 때까지 새 커밋 해시를 찾을 수 있습니다.
git branch를 입력하면 이전에 삭제한 브랜치가 다시 나열되는 것을 볼 수 있습니다. 이것은 Origin(remote)에서 브랜치가 삭제된 경우에도 작동합니다.

<branch-name>이 원하는 이름이 아닌 경우 git branch -m <branch-name> <new-branch-name>으로 이름을 바꾸면 됩니다.

삭제된 브랜치를 성공적으로 되돌리는 열쇠는 올바른 커밋 해시를 찾는 것입니다. 커밋의 이름을 똑똑하게적 지정하십시오. 그것은 많은 도움이됩니다.

12. 잘못된 commit 되돌리기

팀에서 새 버전의 프로젝트를 출시했습니다. 추가된 모든 새로운 기능이 절대적인 마스터 클래스임을 모두 확신합니다. 잠시 후 팀 리더의 긴급 전화로 새 버전에 중요한 결함이 있으며 즉시 수정해야 한다는 연락이 왔습니다. 엔지니어링 팀은 긴급 조치를 취해야 하며, 앉아서 결함을 찾는 것은 긴급한 문제에 대한 적절한 대응이 아닙니다.

가장 빠른 응답 중 하나는 오류가 발생하기 쉬운 릴리스에 대한 변경 사항을 취소하는 것입니다. 따라서 커밋에 대한 변경 사항을 취소하고 싶습니다.

Git에서 진행하는 방법은 다음과 같습니다.

변경 사항을 취소하려는 커밋(깨진 커밋)의 커밋 해시를 찾아 복사합니다.

git log
# 해당 커밋에 지정된 변경 사항 되돌리기
git revert <잘못 된 commit-hash>

git revert는 되돌린 변경 사항으로 새 커밋을 만듭니다.

깨진 커밋에 지정된 모든 변경 사항은 새 커밋에서 롤백됩니다. 예를 들어, 깨진 커밋에서 제거된 모든 것이 새 커밋에 추가되고, 깨진 커밋에서 추가된 모든 것이 새 커밋에서 제거됩니다.
생성될 커밋 되돌리기에 대한 기본 커밋 메시지와 함께 기본 편집기가 팝업됩니다. 원하는 대로 수정할 수 있습니다.

13. merge(병합) 취소

기능 분기의 새로운 변경 사항에 만족합니다. 기능 브랜치를 메인 브랜치에 병합할 준비가 된 것 같습니다. 따라서 기본 분기에서 기능 분기를 병합하고, 새 변경 사항을 원격 저장소에 푸시합니다.

잠시 후, 병합이 실제로는 그다지 좋은 코드가 아니라는 것을 알게 되었습니다. 그래서 병합을 취소하고 싶습니다.

# master branch로 이동합니다
git checkout master
# 병합 commit의 hash를 확인합니다
git log
# 되돌리기
git revert -m 1 <merge-commit-hash>

병합의 분기는 해당 병합의 부모입니다.

일반적으로 git은 병합의 어느 쪽(부모)이 메인라인으로 간주되어야 하는지 모르기 때문에 병합을 되돌릴 수 없습니다. git revert -m 1 메인라인의 상위 번호를 지정하고 지정된 상위 항목에 상대적인 변경 사항을 되돌리기 위해 revert를 허용합니다.

일반적으로 git merge 중에 가장 먼저 기록되는 부모는 병합할 때 있던 분기입니다. 여기서 오류의 경우 메인 브랜치에서 체크아웃하는 동안 feature 브랜치를 병합했습니다. 따라서 -m 1은 주 분기를 지정합니다.

14. 이전 버전으로 롤백

프로젝트를 이전 버전으로 롤백할 수 있습니다. 이렇게 하면 최근에 깨진 커밋 이전에 올바르게 작동하던 버전으로 돌아가려고 합니다.

여기에 표시된 git 명령은 기록을 다시 씁니다. 다른 사람과 소프트웨어 프로젝트를 공동 작업할 때는 적합하지 않습니다. 부득이 작업을 하게 된다면 다른 사람들에게 해당 내용을 공유하여야 합니다.

따라서 리포지토리의 기록을 되감아 프로젝트의 이전 버전으로 이동하려고 합니다.

git reset --hard <commit-hash>

git reset은 HEAD 포인터(따라서 작업 트리)를 이전 버전(<commit-hash>)으로 이동합니다.
이 버전 이후의 커밋은 프로젝트 기록에서 제거됩니다.

--hard 플래그는 스테이징 영역과 작업 트리를 재설정합니다.

git reset --mixed <commit-hash>와 같은 --mixed 플래그를 사용하면 저장소를 작업 트리의 지정된 커밋 해시 보존 파일로 다시 재설정합니다. 이후 커밋에 있었지만 재설정한 커밋에는 없는 파일은 추적되지 않는 파일이 됩니다.

--mixed 플래그는 인덱스(스테이징 영역)를 처리하는 방식에 차이가 있지만 --soft와 가까운 사촌이 있습니다.

--mixed 플래그는 스테이징 영역(색인)을 재설정하지만 작업 트리는 재설정하지 않습니다. 따라서 다음 커밋에서 추적되지 않은 파일을 추가하려면 git add 다음 git commit해야 합니다.

--soft 플래그는 스테이징 영역이나 작업 트리를 재설정하지 않습니다. 따라서 다음 커밋에서 추적되지 않은 파일을 추가하려면 git commit만 하면 됩니다.

15. 이전 커밋 메시지 수정

프로젝트 진행에 만족합니다. 프로젝트 기록을 살펴보고 있습니다. 하지만, 모호한 커밋 메시지를 발견했습니다. 따라서 이 메시지를 논리적 의미를 설명하는 더 나은 메시지(더 나은 설명이 있는 메시지)로 변경하려고 합니다.

Git에서 대화형(interactive) rebase를 사용하여 기록에서 더 깊은 커밋 메시지를 편집할 수 있습니다. 커밋 메시지를 변경하려는 커밋의 커밋 해시를 찾아 복사합니다.

rebase 대화형 세션을 엽니다.

git rebase -i <commit-hash>

편집기가 나타납니다.

위의 샘플 대화형 rebase 세션에서 1행에 오타가 있음을 알 수 있습니다. 이 오타를 수정하고 더 나은 설명 메시지를 제공하겠습니다.

편집기에서 수행하려는 작업만 지정합니다. 지금 당장 커밋 메시지를 다시 작성하고 싶을 수 있지만, 그렇게 하지는 않습니다. rebase -i는 SHA(커밋 해시) 열 이후의 모든 것을 무시합니다. 그 뒤의 텍스트는 커밋 해시가 무엇인지 기억하는 데 도움이 됩니다.

커밋의 내용을 유지하지만 커밋 메시지를 편집하려면 메시지를 변경하려는 커밋에 대해 reword action 명령을 지정하십시오. 다음과 같이 첫 번째 열의 단어 선택을 단어 reword(또는 r만)로 바꾸면 됩니다.

 (1 year, 7 months ago) Auto Deploy (Merge pull request #3 from node/translation/ch03 - github-actions[bot]
noop

# Rebase 53723b64..53723b64 onto 53723b64 (1 command)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup [-C | -c] <commit> = like "squash" but keep only the previous
#                    commit's log message, unless -C is used, in which case
#                    keep only this commit's message; -c is same as -C but
#                    opens the editor
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
#         create a merge commit using the original merge commit's
#         message (or the oneline, if no original merge commit was
#         specified); use -c <commit> to reword the commit message
# u, update-ref <ref> = track a placeholder for the <ref> to be updated
#                       to this position in the new commits. The <ref> is
#                       updated at the end of the rebase
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#

Reword 리베이스 작업

그런 다음 편집기를 저장하고 닫습니다.

마지막으로 git은 커밋 메시지를 변경할 수 있는 편집기를 엽니다. 커밋 메시지를 더 나은 것으로 변경하십시오.

이전 커밋 메시지 업데이트

마지막으로 편집기를 저장하고 닫을 수 있습니다. 커밋은 새 커밋 메시지로 업데이트됩니다.

16. 오래된 커밋 삭제

오래된 커밋이 당신을 귀찮게 할 수 있으며 프로젝트 기록에서 삭제되기를 원할 수 있습니다. 따라서 이 커밋이 더 이상 프로젝트 기록에 나타나지 않기를 원합니다.

다음과 같이 이 커밋을 삭제할 수 있습니다.

먼저, 예정된 커밋의 커밋 해시를 찾아 복사합니다.

git log

git rebase -i <commit-hash>

커밋을 삭제하기 위한 drop 액션 단어를 지정합니다:

pick f39873d 안녕
pick c33dih3 방가워
drop 24dddvw 삭제하고 싶은 commit
pick dpojafe 하하하

편집기를 저장하고 닫습니다. 예정된 커밋은 프로젝트 기록에서 제거됩니다.

17. 이전 커밋에 새로운 변경사항 수정

프로젝트에 변경 사항을 추가하려는 상황이 발생할 수 있습니다. 그러나 이 변경 사항은 특정 변경 사항을 처리하던 당시의 커밋과 관련이 있습니다.

예를 들어, 프로젝트는 여러 커밋으로 발전했으며 아마도 가장 최근 커밋을 프로젝트의 v5로 브랜드화할 수 있습니다. file.js을 만들었습니다. 당신은 이 파일이 아마도 프로젝트 v2에서 더 깊은 기록의 이전 커밋의 일부가 되기를 원합니다.

Git에서는 새로운 변경 사항을 커밋에 다시 결합하여 이전 커밋을 편집할 수 있습니다.

단계는 다음과 같습니다.

편집용으로 표시하려는 커밋의 커밋 해시를 찾아 복사합니다.

git log

#rebase interactive
git rebase -i "<commit-hash>^"

<commit-hash> 끝에 캐럿(^)을 추가하는 방법에 유의하십시오. 이렇게 하면 이 표시된 커밋을 편집한 후 커밋의 원래 연대기로 돌아가고 싶다고 Git에 알릴 수 있습니다. git rebase -i "<commit-hash>^"를 실행하면 git log에 표시된 <commit-hash>가 가장 최근 커밋으로 표시되기 때문입니다.

이 명령을 실행하면 기본 편집기가 나타나고, <commit-hash>를 언급하는 줄에서 편집할 작업 동사 선택을 수정합니다.

작업 트리와 프로젝트 기록은 이제 이전에 커밋했을 때의 상태입니다. git log를 실행하면 <commit-hash>가 가장 최근 커밋임을 알 수 있습니다. 작업 트리에 생성한 파일(file.js)이 여전히 있으며 가장 최근 커밋으로 수정할 수 있는 좋은 기회입니다. 이 시점에서 가장 최근 커밋이 편집하려는 커밋임을 기억하십시오.

따라서 다음과 같이 수정하십시오.

git add file.js
git commit --amend --no-edit
# 기록을 정상순서로 되돌리기
git rebase --contirnue

이런 식으로 file.js을 추가하여 <commit-hash>에 지정된 커밋을 편집했습니다.

경고: 이렇게 하면 해당 시점부터 기록이 다시 작성됩니다. 팀 환경에서 프로젝트를 작업할 때는 좋은 생각이 아닙니다.

팀프로젝트에서는 기록을 다시 쓰는 것은 지양해야 합니다. 많은 소스 꼬임이 발생할 수 있습니다.

반응형

유용한 학습 사이트

텍스트

문자열

문자열의 자료형은 &'static str'이다.

  • &은 메모리 내의 장소를 참조하고 있다는 의마(mut가 없으므로 값의 변경을 허용하지 않음)
  • 'static'은 문자열 데이터가 프로그램이 끝날 때까지 유효하다는 의미이다 (절대로 Drop 되지 않는다)
  • str은 언제가 유효한 utf-8 바이트 열을 가리키고 있다는 의미
    fn main() {
      let a: &'static str = "hi";
      println!("{} {}", a, a.len());
    }

예외 처리 문자

어떤 문자들은 시각적으로 표현하기 어려우므로, 예외 처리 코드로 대체해서 쓴다.

  • \n: 줄바꿈
  • \r: 캐리지 리턴
  • \t: 탭
  • \\: 역슬래시
  • \O: NULL
  • \': 작은 따옴표
fn main() {
    let a: &'static str = "Ferris says:\t\"hello\"";
    println!("{}", a);
}

원시 문자열

원시 문자열은 r#"로 시작하고 "#로 끝나며 문자열을 있는 그대로 쓰는데 사용한다.

fn main() {
    let a: &'static str = r#"
        <div class="advice">
            Raw strings are useful ofr some situations.
        </div>
    "#;
    println!("{}", a);
}

파일에서 몬자열 가져오기

매우 큰 텍스트가 필요하다면 include_str! 매크ㄹㅗㄹㅡ 이용해 ㄹㅗ컬 파일에서 텍스트를 읽어오는 방식을 고려해보자

fn main() {
    let html = include_str!("test.html");
    println!("{}", html);
}

문자열 슬라이스

메모리 상의 바이트 열에 대한 참조이며, 언제나 유효한 UTF-8이어야 한다.
&str에서 자주 사요하는 메소드는 다음과 같다

  • len은 문자열 바이트 길이를 가겨온다. (글자수 아님)
  • start_withends_with는 기본적인 비교에 쓰인다
  • is_empty는 길이가 0일 경우 true를 리턴한다.
  • find는 주어진 텍스트가 처음 등장하는 위치인 Option<usize> 값을 리턴한다.
fn main() {
    let a = "hi.";
    println!("{}", a.len());
    let first_word = &a[0..2];
    let secord_word = &a[3..7];
    println!("{} {} ", first_word, secord_word);
}

문자

rust에서는 utf-8 바이트 열을 char 타일의 벡터로 돌려주는 기능을 제공하다.
char 하나는 4byte다.

fn main() {
    let chars = "hi there 😄".chars().collect::<Vec<char>>();
    println!("{}", chars.len());
    println!("{}", chars[9] as u32);
}

스트링

UTF-8 바이트 열을 힙 메모리에 소유하는 구조체
문자열과는 달리 변경하거나 기타 등들을 할 수 있다. (메모리가 힙에 있기 때문)
자주 사용하는 메소드는 다음과 같다.

  • push_str은 스트링의 맨 뒤에 UTF-8 바이트들을 더 붙일 때 사용한다.
  • replce는 utf-8 바이트 열을 다른 것으로 교체할 때 사용한다.
  • to_lowercaseto_uppercase는 대소문자를 비교할 때 사용한다.
  • tim은 공백을 제거할 때 사용한다.
fn main() {
    let mut helloworld = String::from("hello      ");
    helloworld.push_str("world ");
    helloworld = helloworld + "!";
    println!("{}", helloworld);
    let mut trim_to_right = helloworld.trim().to_string();
    trim_to_right = trim_to_right + "!";
    println!("{}", trim_to_right);
}

함수 매개변수로서의 텍스트

문자열과 스트링은 일반적으로 함수에 문자열 슬라이스 형태로 전달된다.
이 방법은 소유권을 넘길 필요가 없어 대부분의 경우에 유연한다.

fn say_it_loud(msg: &str) {
    println!("{}!!!!", msg.to_string().to_uppercase());
}
fn main() {
    say_it_loud("hello");
    say_it_loud(&String::from("goodbye"));
}

스트링 만들기

concatjoin은 스트링을 만드는 간단한지만 강력한 방법

fn main() {
    let helloworld = ["Hello", " ", "World", "!"].concat();
    let abc = ["a", "b", "c"].join("");
    println!("{}", helloworld);
    println!("{}", abc);
}

스트링 양식 만들기

format! 매크로는 값이 어디에 어떻게 놓일지 매개번수화된 스트링을 정의해 생성한다.
println!과 같이 매개변수화된 스트링을 사용한다

fn main() {
    let a: i32 = 42;
    let f: String = format!("secret to lite: {}", a);
    println!("{}", f);
}

##스트링 변환
to_string을 사용해 많은 데이터 바입을 스트링으로 변환할 수 있다.
제네릭 함수 parse로 스트링이나 문자열을 다른 데이터 타입을 갖는 값으로 변환할 수 있다. 이 함수는 실패할 수도 있기 때문에 Result를 리턴한다.

fn main() -> Result<(), std::num::ParseIntError> {
    let a = 42;
    let a_string = a.to_string();
    let b = a_string.parse::<i32>()?;
    println!("{} {}", a, b);
    Ok(())
}

객체 지향 프로그래밍(OOP)

OOP란 무엇인가

객체 지향프로그래밍은 다음과 같은 상징적 특징을 갖는 프로그래밍 언어를 뜻한다.

  • 캡슐화(Encapulation): 객체라 불리는 단일 타입의 개념적 단위에 데이터와 함수를 연결
  • 추상화(Abstraction): 데이터와 함수를 숨겨 객체의 상세 구현 사항을 알기 어렵게 함
  • 다형성(Polymorphism): 다른 기능적 관점에서 객체와 상호 작용하는 능력
  • 상속(Inheritance): 다른 객체로부터 데이터와 동작을 상속받는 능력

RUST는 OOP가 아니다

Rust에서는 어떠한 방법으로도 데이터와 동작의 상속이 불가능하다.

  • 구조체는 부모 구조체로부터 필드를 상속받을 수 없다.
  • 구조체는 부모 구조체로부터 함수를 상속받을 수 없다.

메소드 갭슐화하기

Rust는 메소드가 연결된 구조체인 객체라는 개념을 지원한다.
모든 메소드의 처번째 매개변수는 메소드 호출과 연관된 인스턴스에 대한 참조여야한다.

  • &self: 인스턴스에 대한 변경 불가능한 참조
  • &mut self: 인스턴스에 대한 변경 가능한 참조
    메소드는 impl 키워드를 쓰는 구현 블록 안에 정의 한다.
struct SeaCreature {
    noise: String,
}

impl SeaCreature {
    fn get_sound(&self) -> &str {
        &self.noise
    }
    fn set_sound(&mut self, new_noise: &str) {
        self.noise = new_noise.to_string();
    }
}
fn main() {
    let creature = SeaCreature {
        noise: String::from("blub"),
    };
    println!("{}", creature.get_sound());
}

선택적 노출을 통한 추상화

Rust는 객체의 내부 동작을 숨길 수 있다
기본적으로, 필드와 메소드들은 그들이 속한 모듈에서만 접근 가능하다.
pub 키워드는 구조체의 필드와 메소드를 모듈 밖으로 노출시킨다.

struct SeaCreature {
    pub name: String,
    noise: String,
}

impl SeaCreature {
    pub fn get_sound(&self) -> &str {
        &self.noise
    }
    fn set_sound(&mut self, new_noise: &str) {
        self.noise = new_noise.to_string();
    }
}
fn main() {
    let creature = SeaCreature {
        name: String::from("Ferris"),
        noise: String::from("blub"),
    };
    println!("{}", creature.get_sound());
}

다형성과 트레잇

  • Rust는 트레잇으로 다형성을 지원한다. 트레잇은 메소드의 집합을 구조체 데이터 타입에 연결할 수 있게 해준다.
  • 먼저 트레잇 안에 메소드 원형을 정은한다. 구조체가 트레잇을 구현할 때, 실제 데이터 타입이 무엇인지 알지 못하더라도 트레잇 데이터 타입을 통해 간접적으로 구조체와 상호 작용할 수 있도록 협약을 맺게 된다.
  • 구조체의 구현된 트레잇 메소드들은 구현 블록 안에 정의된다.
struct SeaCreature {
    pub name: String,
    noise: String,
}

impl SeaCreature {
    pub fn get_sound(&self) -> &str {
        &self.noise
    }
}

trait NoiseMaker {
    fn make_noise(&self);
}

impl NoiseMaker for SeaCreature {
    fn make_noise(&self) {
        println!("{}", &self.get_sound())
    }
}

fn main() {
    let creature = SeaCreature {
        name: String::from("Ferris"),
        noise: String::from("blub"),
    };
    creature.make_noise();
}

트레잇에 구현된 메소드

  • 트레잇에 메소드를 구현해 넣을 수 있다
  • 함수가 구조체 내부의 필드에 직접 접근할 수는 없지만, 트레잇 구현체들 사이에서 동작을 공유할 때 유용하게 쓰인다.
    struct SeaCreature {
      pub name: String,
      noise: String,
    }
    

impl SeaCreature {
pub fn get_sound(&self) -> &str {
&self.noise
}
}

trait NoiseMaker {
fn make_noise(&self);
fn make_alot_of_noise(&self) {
self.make_noise();
self.make_noise();
self.make_noise();
}
}

impl NoiseMaker for SeaCreature {
fn make_noise(&self) {
println!("{}", &self.get_sound())
}
}

fn main() {
let creature = SeaCreature {
name: String::from("Ferris"),
noise: String::from("blub"),
};
creature.make_alot_of_noise();
}


## 동적 vs 정적 디스패치

- 메소드는 다음의 두 가지 방식으로 실행된다.
    - 정잭 디스패치(Static Dispatch): 인스턴스의 데이터 트입을 알고 있는 경우, 어떤 함수를 호출해예 하는지 정확히 알고 있다.
    - 동적 디스패치(Dynamic Dispatch): 인스턴스의 데이터 타입을 모르는 경우, 올바른 함수를 호촐할 방법을 찾아야 한다.
- 트레잇의 자료형인 `&dyn MyTrait`은 동적 디스패치를 통해 객체의 인스턴스들을 간접적으로 작동시킬 수 있게 해준다.
- Rust에서는 동적 디스패치를 사용할 경우 사람들이 알 수 있도록 트레잇 자료형 앞에 `dyn`을 붙일 것을 권고한다.

```rust
struct SeaCreature {
    pub name: String,
    noise: String,
}

impl SeaCreature {
    pub fn get_sound(&self) -> &str {
        &self.noise
    }
}

trait NoiseMaker {
    fn make_noise(&self);
}

impl NoiseMaker for SeaCreature {
    fn make_noise(&self) {
        println!("{}", &self.get_sound())
    }
}
fn static_make_noise(creature: &SeaCreature) {
    creature.make_noise();
}
fn dynamic_make_noise(noise_maker: &dyn NoiseMaker) {
    noise_maker.make_noise();
}

fn main() {
    let creature = SeaCreature {
        name: String::from("Ferris"),
        noise: String::from("blub"),
    };
    static_make_noise(&creature);
    dynamic_make_noise(&creature);
}

트레잇 객체

  • 객체의 인스턴스를 &dyn MyTrait 데이터 타입을 가진 매개 변수로 넘길 때, 이를 트레잇 객체라고 한다.
  • 트레잇 객체는 인스턴스의 올바른 메소드를 간접적으로 호출할 수 있게 해주며, 인스턴스에 대한 포인터와 인스턴스 메소드들에 대한 함소 포인터 목록을 갖는 구조체이다

크기를 알 수 없는 데이터 다루기

  • 트레잇은 원본 구조체를 알기 어렵게 하느라 원래 크기 또한 알기 어렵다.
  • Rust에서 크기를 알 수 없는 값이 구조체에 저장될 때는 두 가지 방법으로 처리된다.
    • generics: 매개 변수의 데이터 타입을 효과적으로 활용해 알려진 데이터 타입 및 크기의 구조체/함수를 생성한다
    • indirection: 인스턴스를 힙에 올림으로써 실제 데이터 타입의 크기 걱정이 없이 그 포인터만 저장할 수 있는 간접적인 방법을 제공한다.

제네릭 함수

  • Rust의 제네릭은 트레잇과 함께 작동한다. 개매 변수 데이터 타입 T를 정의할 때 해당 인자가 어떤 트레잇을 구현해야 하는지 나열함으로써 인자에 어떤 데이터 타입을 쓸 수 있는지 제한할 수 있다.
  • 제네릭을 이용하면 컴파일 시 데이터 타입과 크기를 알 수 있는 정적 데이터 타입이 함수가 만들어지며, 따라서 정적 디스패치와 함께 크기가 정해진 값으로 저장할 수 있게 된다.
struct SeaCreature {
    pub name: String,
    noise: String,
}

impl SeaCreature {
    pub fn get_sound(&self) -> &str {
        &self.noise
    }
}

trait NoiseMaker {
    fn make_noise(&self);
}

impl NoiseMaker for SeaCreature {
    fn make_noise(&self) {
        println!("{}", &self.get_sound())
    }
}
fn generic_make_noise<T>(creature: &T)
where
    T: NoiseMaker,
{
    creature.make_noise();
}

fn main() {
    let creature = SeaCreature {
        name: String::from("Ferris"),
        noise: String::from("blub"),
    };
    generic_make_noise(&creature);
}

제네릭 함수줄여쓰기

fn generic_make_noise<T>(creature: &T)
where
    T: NoiseMaker,
{
    creature.make_noise();
}

// 아래와 같이 변경 가능

fn generic_make_noise(creature: &impl NoiseMaker) {
    creature.make_noise();
}

스마트 포인터

BOX

  • BOX는 스택에 있는 데이터를 힙으로 옮길 수 있게 해주는 자료 구조다.
  • 스마트 포인터로도 알려진 구조체이며 힙에 있는 데이터를 가리키는 포인터를 들고 있다.
  • 크기가 알려져 있는 구조체이므로(왜냐하면 포인터만 들고 있으므로) 필드의 크기를 알아야하는 구조체에 뭔가의 참조를 저장할 때 종종 사용된다.
struct SeaCreature {
    pub name: String,
    noise: String,
}

impl SeaCreature {
    pub fn get_sound(&self) -> &str {
        &self.noise
    }
}

trait NoiseMaker {
    fn make_noise(&self);
}

impl NoiseMaker for SeaCreature {
    fn make_noise(&self) {
        println!("{}", &self.get_sound())
    }
}

struct Ocean {
    animals: Vec<Box<dyn NoiseMaker>>,
}

fn main() {
    let ferris = SeaCreature {
        name: String::from("Ferris"),
        noise: String::from("blub"),
    };
    let sarah = SeaCreature {
        name: String::from("Sarah"),
        noise: String::from("swish"),
    };
    let ocean = Ocean {
        animals: vec![Box::new(ferris), Box::new(sarah)],
    };
    for a in ocean.animals.iter() {
        a.make_noise();
    }
}

참조 다시보기

  • 참조는 근본적으로 메모리 상의 어떤 바이트들의 시작 위치를 가리키는 숫자일 뿐이며, 유일한 용도는 특정 타입의 데이터가 어디에 존재하는지에 대한 개념을 나타내는 것이다.
  • 일반 숫자와 차이점은 Rust에서 참조가 가리키는 값보다 더 오래 살지 않도록 수명을 검증한다는 거다. ( 안그러면 그걸 사용핼을 때 오류가 날 것이다)

원시 포인터

  • 참조는 더 원시적인 자료형인 원시 포인터로 변환될 수 있다
  • 원시 포인터는 숫자와 마찬가지고 거의 제한없이 여기저기 복사하고 이동할 수 있다.
  • Rust는 원시 포인터가 가리키는 메모리 위치의 유효성을 보증하지 않는다.
  • 원시 포인터에는 두 종류가 있다
    • *const T: 데이터 타입 T의 데이터를 가리키는 절대 변경되지 않는 원시 포인터
    • *mut T: 데이터 타입 T의 데이터를 가리키는 변경될 수 있는 원시 포인터
  • 원시 포인터는 숫자와 상호 변환이 가능하다. (예: uszie)
  • 원시 포인터는 안전하지 않은 코드의 데이터에 접근할 수 있다
fn main() {
    let a = 42;
    let memory_location = &a as *const i32 as usize;
    println!("memory location: {}", memory_location);
}![[Javascript _ Null 과 undefined]]

역참조

  • 참조(예: &i32) 를 통해 참조되는 데이터를 접근/변경하는 과정을 역참조라고 한다.
  • 참조로 데이터를 접근/변경하는 데에는 두 가지 방법이 있다.
    • 변수 할당 중에 참조되는 데이터에 접근
    • 참조되는 데이터의 필드나 메소드에 접근
  • Rust에는 이를 가능케 하는 강력한 연산자가 있다.

* 연산자

  • * 연산자는 참조를 역참조하는 명시적인 방법이다.
fn main() {
    let a: i32 = 42;
    let ref_ref_ref_a: &&&i32 = &&&a;
    let ref_a: &i32 = **ref_ref_ref_a;
    let b: i32 = *ref_a;
    println!("{}", b);
}
  • .연산자는 참조의 필드와 메소드에 접근하는 데에 쓰인다. (좀 더 미묘하게 동작하는데, 참조 열을 자동으로 역참조한다.)
struct Foo {
    value: i32,
}

fn main() {
    let f = Foo { value: 42 };
    let ref_ref_ref_f = &&&f;
    println!("{}", ref_ref_ref_f.value);
    // -> println!("{}", (***ref_ref_ref_f).value);
}

스마트 포인터

  • Rust에서는 & 연산자로 이미 존재하는 데이터의 참조를 생성하는 기능과 대불어, 스마트 포인터라 불리는 참조 같은 구조체를 생성하는 기능을 제공한다.
  • 고수준에서 보자면 참조는 다른 데이터 타입에 대한 접근을 제공하는 데이터 타입이라고 볼 수 있다. 스마타 포인터가 일반적인 참조와 다른 점은, 프로그래머가 작성하는 내부 로직에 기반해 동작하는 거다.
  • 일반적으로 스마트 포인터는 구조체가 *.연산자로 연참조될 때 무슨 일이 발생할 지 지정하기 위해 Deref, DerefMut, Drop 트레잇을 구현한다.
use std::ops::Deref;

struct TattleTell<T> {
    value: T,
}

impl<T> Deref for TattleTell<T> {
    type Target = T;

    fn deref(&self) -> &T {
        println!("{} was used!", std::any::type_name::<T>());
        &self.value
    }
}

fn main() {
    let foo = TattleTell {
        value: "secret message",
    };
    println!("{}", foo.len());
}
// &str was used!
// 14

위험한 스마트 코드

  • 스마트 포인터는 안전하지 않는 코드를 꽤 자주 쓰는 경향이 있다. 앞서 말했듯이, 스마트 포인터는 rust에서 가장 저수준의 메모리를 다루기 위한 일반적인 도구다.

  • 무엇이 안전하지 않은 코드일까? 안전하지 않는 코드는 rust 컴파일러가 보증할 수 없는 몇가지 기능이 있다는 예외사항을 제외하고는 일반적인 코드와 완전히 똑같이 동작한다.

  • 안전하지 않는 코드의 주 기능은 원시 포인터를 역참조하는 것이다. 이는 원시 포인터를 메모리 상의 위치에 가져다 놓고, “데이터 구조가 여기 있다!”고 선언한 뒤 사용할 수 있는 데이터 표현으로 변환하는 걸 의미한다. (즉, *const u8u8로)

  • Rust에서는 메모리에 쓰여지는 모든 바이트의 의미를 추적하는 방법이 없다. 원시 포인터로 쓰이는 임의의 숫자에 무엇이 존재하는지 보증할 수 없기 때문에, 역참조를 unsafe { ... } 블록 안에 넣는다.

    fn main() {
      let a: [u8; 4] = [86, 14, 63, 12];
      let pointer_a = &a as *const u8 as usize;
      println!("Data memory location: {}", pointer_a);
    
      let pointer_b = pointer_a as *const f32;
      let b = unsafe { *pointer_b };
      println!("I swear this is a pie! {}", b);
    }
    

// Data memory location: 140701859722372
// I swear this is a pie! 0.00000000000000000000000000000014718419


## 익숙한 친구들

- 이미 본 적이 있는 `Vec<T>`나 `String` 같은 스마트 포인터를 생각해 보자.
- `Vec<t>` 는 바이트들의 메모리 영역을 소유하는 스마트 포인터다. Rust 컴파일러는 이 바이트들에 뭐가 존재하는지 모른다. 스마트 포인터는 관리하는 메모리 영역에서 내용물을 꺼내기 위해 자기가 뭘 의미하는지 해석하고, 데이터 구조가 그 바이트들 내 어디에서 시작하고 끝나는지 추척하며, 마지막으로 원시 포인터를 데이터 구조로, 또 쓰기 편한 깔금한 인터페이스로 역참조한다. (예: `my_vec[3]`)
- `String`는 바이트들의 메모리 영역을 추적하며, 쓰여지는 내용물이 언제나 유효한 UTF-8이도록 프로그램적으로 제한하며, 그 메모리 영역을 `&str` 데이터 타입으로 역참조할 수 있도록 도와준다.
- 두 데이터 구조 모두 원시 포인터에 대한 안전하지 않은 역참조를 사용한다.
- 
```rust
use std::alloc::{alloc, Layout};
use std::ops::Deref;

struct Pie {
    secret_recipe: usize,
}

impl Pie {
    fn new() -> Self {
        let layout = Layout::from_size_align(4, 1).unwrap();
        unsafe {
            let ptr = alloc(layout) as *mut u8;

            ptr.write(86);
            ptr.add(1).write(14);
            ptr.add(2).write(15);
            ptr.add(3).write(92);
            Pie {
                secret_recipe: ptr as usize,
            }
        }
    }
}
impl Deref for Pie {
    type Target = f32;
    fn deref(&self) -> &f32 {
        let pointer = self.secret_recipe as *const f32;
        unsafe { &*pointer }
    }
}

fn main() {
    let p = Pie::new();
    println!("{:?}", *p);
}
// result:
// 1.6106674e17

힙에 할당 된 메모리 Box::

Box는 데이터를 스택에서 힙으로 옮길 수 있게 해주는 스마트 포인터다. 이를 역참조하면 마치 원래 데이터 타입이었던 것처럼 힙에 할당 된 데이터를 편하게 쓸 수 있다.

struct Pie;

impl Pie {
    fn eat(&self) {
        println!("tastes better on the heap!");
    }
}
fn main() {
    let heap_pie = Box::new(Pie);
    heap_pie.eat();
}
// result : tastes better on the heap!

참조 카운팅 Rc::

  • Rc는 스택에 있는 데이터를 힙으로 옮겨주는 스마트 포인터다. 이는 heap에 놓인 데이터를 변경 불가능하게 대여하는 기능을 갖는 다른 Rc 스마트 포인터를 복제할 수 있게 해준다.
  • 마지막 스마트 포인터가 Drop될 때에만 힙에 있는 데이터가 할당 해제된다.
use std::rc::Rc;

struct Pie;

impl Pie {
    fn eat(&self) {
        println!("tastes better on the heap!");
    }
}
fn main() {
    let heap_pie = Rc::new(Pie);
    let heap_pie2 = heap_pie.clone();
    let heap_pie3 = heap_pie2.clone();

    heap_pie3.eat();
    heap_pie2.eat();
    heap_pie.eat();
    println!(
        "heap_pie3 = {:p}, heap_pie2 = {:p}, heap_pie = {:p}",
        heap_pie3, heap_pie2, heap_pie
    );
}
// result
// tastes better on the heap!
// tastes better on the heap!
// tastes better on the heap!
// heap_pie3 = 0x7fa007f05c80, heap_pie2 = 0x7fa007f05c80, heap_pie = 0x7fa007f05c80

접근 공유하기 RefCell::

  • RefCell은 보통 스마트 포인터가 보유하는 컨테이너 구조로서, 데이터를 가져오거나 안에 있는 것에 대한 변경 가능한 또는 불가능한 참조를 대여할 수 있게 해준다.
  • 데이터를 대여할 때, Rust는 런타임에 메모리 안전 규칙을 적용해 남용을 방지한다.
    “단 하나의 변경 가능한 참조 또는 여러 개의 변경 불가능한 참조만 허용하며, 둘 다는 안됨”
    이 규칙을 어기면 RefCell은 패닉을 일으킨다.
use std::cell::RefCell;

struct Pie {
    slices: u8,
}

impl Pie {
    fn eat(&mut self) {
        println!("tastes better on the heap!");
        self.slices -= 1;
    }
}
fn main() {
    let pie_cell = RefCell::new(Pie { slices: 8 });
    {
        let mut mut_ref_pie = pie_cell.borrow_mut();
        mut_ref_pie.eat();
        mut_ref_pie.eat();
    }

    let ref_pie = pie_cell.borrow();
    println!("{} slices left", ref_pie.slices);
}
// result:
// tastes better on the heap!
// tastes better on the heap!
// 6 slices left

스레드 간에 공유하기 Mutex::

  • Mutex는 보통 스마트 포인터가 보유하는 컨테이너 데이터 구조로서, 데이터를 가져오거나 안에 있는 것에 대한 변경 가능한 또는 불가능한 참조를 대여할 수 있게 해준다.
  • 잠긴 대여를 통해 운영체제가 동시에 오직 하나의 CPU만 데이터에 접근 가능하도록 하고, 원래 스레드가 끝날 때까지 다른 스레드들은 막음으로써 대여남용을 방지한다.
  • Mutex는 여러 개의 CPU 스레드가 같은 데이터에 접근하는 걸 조율하는 방법이다.
  • 특별한 스마트 포인터인 Arc도 있는데, 스레드-안전성을 가진 참조 카운타 증가 방식을 사용한다는 걸 제외하고는 Rc와 동일하다.
    • 동일한 Mutex에 다수의 참조를 가질 때 종종 사용되곤 한다.
use std::sync::Mutex;

struct Pie;
impl Pie {
    fn eat(&self) {
        println!("tastes better on the heap!");
    }
}
fn main() {
    let mutex_pie = Mutex::new(Pie);

    let ref_pie = mutex_pie.lock().unwrap();
    ref_pie.eat();
}
// result
// tastes better on the heap!

스마트 포인터 조합하기

스마트 포인터는 한계가 있는 것처럼 보이지만, 조합해서 사용하면 매우 강력해질 수 있다.

  • Rc<Vec<Foo>> : 힙에 있는 변경 불가능한 데이터 구조의 동일한 벡터를 대여할 수 있는 복수의 스마트 포인터를 복제할 수 있게 해준다.
  • Rc<RefCell<Foo>>: 복수의 스마트 포인터가 동일한 Foo구조체를 변경 가능하게 또는 불가능하게 대여할 수 있게 해 준다.
  • Arc<Mutex<Foo>>: 복수의 스마트 포인터가 임시의 변경 가능한 또는 불가능한 대여를 CPU 스레드 독점 방식으로 잠글 수 있게 해준다.
use std::{cell::RefCell, rc::Rc};

struct Pie {
    slices: u8,
}
impl Pie {
    fn eat_slice(&mut self, name: &str) {
        println!("{} ate a slice of pie!", name);
        self.slices -= 1;
    }
}
struct SeaCreature {
    name: String,
    pie: Rc<RefCell<Pie>>,
}
impl SeaCreature {
    fn eat(&self) {
        let mut p = self.pie_borrow_mut();
        p.eat_slice(&self.name);
    }
    fn pie_borrow_mut(&self) -> std::cell::RefMut<Pie> {
        self.pie.borrow_mut()
    }
}
fn main() {
    let pie = Rc::new(RefCell::new(Pie { slices: 8 }));
    let ferris = SeaCreature {
        name: String::from("ferris"),
        pie: pie.clone(),
    };
    let sarah = SeaCreature {
        name: String::from("sarah"),
        pie: pie.clone(),
    };
    ferris.eat();
    sarah.eat();

    let p = pie.borrow();
    println!("{} slices left", p.slices)
}
// result
// ferris ate a slice of pie!
// sarah ate a slice of pie!
// 6 slices left/

프로젝트 구성과 구조

프로그램/라이브러리 작성하기

  • 프로그램은 main.rs 라 불리는 파일에 최상위 모듈을 갖고 있다.
  • 라이브러리는 lib.rs라 불리는 최상위 모듈을 갖고 있다.

다른 모듈과 crate 참조하기

  • 모듈 내의 항목은 전체 모듈 경로인 std::f64::consts::PI를 이용해 참조할 수 있다.
  • 더 간단한 방법은 use 키워드를 사용하는 거다. ㅣㅇ를 이용하면 모듈에서 쓰고자 하는 특정 항목을 전체 경로를 쓰지 않고도 코드 어디에서든 사용할 수 있다.
    • 예를 들어, use std::f64::consts:PI를 쓰면 main 함수에서 PI만으로 사용할수 있다
  • std는 유용한 데이터 구조 및 OS와 상호 작용할 수 있는 함수로 가득한 표준 라이브러리(Standard Library)의 crate다.

여러 개의 항목은 참조하기

복수의 항목을 하나의 모듈 경로로 참조하고 싶다면 다음과 같이 사용하면 된다.

use std::f64::consts::{PI, TAU}

모듈 작성하기

코드를 생각할 때 보통은 디렉토리로 구성된 파일 구조를 떠올린다.
Rust에서는 모듈을 선언하는 두가지 방법이 있다.

  1. foo.rs 라는 파일이름
  2. foo라는 이름의 디렉토레이 들어있는 파일 mod.rs

모듈 계층구조

한 모듈은 다른 모듈에 의존할 수 있다. 모듈과 하위 모듈 사이에 관계를 지어주려면, 부모 모듈에 코드 mod foo;를 작성하면 된다.
foo.rs 파일이나 foo/mod.rs 파일을 찾아 범위 내의 foo 모듈 안에 그 내용물을 삽입한다.

인라인 모듈

  • 하위 모듈은 모듈의 코드 내에 직접 치환 될 수 있다.
  • 인라인 모듈의 가장 흔한 용도는 유닛 테스트를 만들 때다. Rust가 테스트에 쓰일 때에만 존재하는 인라인 모듈을 만들 수 있다.
#[cfg(test)]
mod tests {
    use super::*;
    // test code
}

내부 모듈 참조하기

rust에서는 use경로에 사용할 수 있는 몇가지 키워드를 통해 원하는 모듈을 빠르게 가져다 쓸 수 있다.

  • create : 최상위 모듈
  • super: 현재 모듈의 부모 모듈
  • self: 현재 모듈

내보내기

기본적으로 모듈의 구성원들은 외부에서 접근이 불가능하다. (자식 모듈에게까지도!) pub 키워드를 사용하면 모듈의 구성원들을 접근 가능하게 할 수 있다.
기본적으로 crate의 구성원들도 외부에서 접근이 불가능하다. 크레이트의 최상위 모듈에 pub를 표시하면 구성원들을 접근 가능하게 할 수 있다.

구조체 가시성

구조체도 함수와 마찬가지로 pub를 사용해 모듈 외부로 무엇을 노출할 지 선엉할 수 있다

pub struct SeaCreature {
    pub animal_type: String,
    pub name: String,
    pub arms: i32,
    pub legs: i32,
    weapon: String,
}

Prelude 모듈

use로 가져오지 않았는데, 어떻게 Vec, Box를 사용할 수 있을까? 이는 표준 라이브러리의 prelude 모듈 덕분이다.
Rust의 표준 라이브러리에서는 std::prelude::**로 내보내기 된 모든 것들이 어디에서든 자동으로 사용 가능하다. Vec, Box가 바로 이런 경우이며, 다른 것들 (Opton, Copy 등 )도 마찮가지다.

반응형

'개발 > rust' 카테고리의 다른 글

RUST 학습 1주차  (0) 2022.10.17
RUST 소개  (0) 2022.10.09
rust 유용한 명령어  (0) 2022.10.07

Tour of RUST #1

유용한 학습 사이트

Cargo project 만들기

바이너리 파일을 생성하는 프로젝트

$ cargo new [프로젝트명]
# Cargo.toml, main.rs 생성

라이브러리 파일을 생성하는 프로젝트

$ cargo new [프로젝트명] -lib
# Cargo.toml, lib.rs 가 생성

유용한 도구

rustfmt

  • Rust 팀에서 개발, 관ㄹㅣ하고 있는 공식 포맷터(Formatter)
  • 공식 스타일 가이드라인을 참고해서 자동으로 코드 스타일을 수정
cargo fmt

clippy

  • Rust 팀에서 개발, 간리하고 있는 코드 린터 (Linter)
  • 현재 코드의 문제점을 파악하고, 자동으로 수정할 수 있다.
cargo clippy

변수

let 키워드 사용

변수의 자료형을 대부분 유추할 수 있다.

변수 숨김(Variable Shadowing)을 지원

변수의 이름은 언제나 snake_case형태로 짓는다.

fn main() {
    let x = 13;
    println!("{}", x);

    let x: f64 = 3.14159;
    println!("{}", x);

    let x;
    x = 0;
    println!("{}", x);
}

Rust에서 변수는 기본적으로 변경 불가(Immutable) 타입이다.

변경 가능(Mutable)한 값을 원한다면 mut키쿼드로 표시해줘야 한다.

fn main() {
    let mux x = 42;
    println!("{}", x);
    x = 13;
    println!("{}", x);
}

2. 기본 데이터 구조

기본 자료형

부울값: bool

부호가 없는 정수형: 양의 정수를 나타내는 u8, u16,u32, u64, u128

부호가 있는 정수형 - 양/음의 정수를 나타내는 i8, i16, i32, i64, i128

포인터 사이즈 정수: 메모리에 있는 값들의 인덱스와 크리를 나타내는 usize, isize

부동소수점: f32, f64

튜플(tuple): stack에 있는 값들의 고정된 순서를 전달하기 위한 (value, value, …)

배열(array): 컴파일 타임에 정해진 길이를 갖는 유사한 원소들의 모음(Collection)인 [value, value, …]

슬라이스(slice): 런타임에 길이가 정해지는 유사한 원소들의 collection

str(문자열 slice): 런타임에 길이가 정해지는 텍스트

자료형 변환을 할 때는 as 키워드를 사용한다. ( Rust에서는 숫자형 자료형을 쓸 때 명시적으로 사용해야 한다.)

fn main{
    let a = 13u8;
    let b = 7u32;
    let c = a as u32 + b;
    println!("{}", c);

    let t = true;
    println!("{}", t as u8);
}

상수

상수는 변수와 달리 반드시 명시적으로 자료형을 지정해야 한다.

상수의 이름은 언제나 SCREAMING_SNAKE_CASE형태로 짓는다.

const PI: f32 = 3.14159;

fn main() {
    println!(
        PI
    );
}

배열

고정된 길이로 된 모든 같은 자료형의 자료를 갖는 Collection

[T; N]으로 표현한다.

  • T는 원소의 자료형
  • n은 컴파일 타임에 주어지는 고정된 길이

각각의 원소는 [x] 연산자로 가져올 수 있다

fn main() {
    let nums: [i32; 3] = [1,2,3];
    println!("{:?}", nums);
    println!("{}", nums[1]);
}

함수

함수의 0개 또는 그 이상의 인자를 가진다.

함수의 이름은 언제나 snake_case형태로 짓는다.

fn add(x: i32, y: i32) -> i32 {
    return x + y;
}

fn main() {
    println!("{}", add(42,13));
}

여러개의 리턴 값

함수에서 튜플(Tuple)을 리턴하면 여러개의 값을 리턴할 수 있다.

fn swap(x: i32, y: i32) -> (i32, i32) {
    return (y, x);
}

fn main() {
    let result = swap(123, 321);
    println!("{} {}", result.0, result.1);

    let (a,b,) = swap(result.0, result.1);
    println!("{} {}", a, b);
}

아무것도 리턴하지 않기

함수에 리턴형을 지정하지 않는 경우 빈 튜플을 리턴하는데, ()로 표현한다.

fn make_nothing() -> () {
    return ();
}

fn make_nothing2() {
    // Do nothing
}

fn main() {
    let a = make_nothing();
    let b = make_nothing2();

    pritnln!("The value of a: {:?}", a);
    println!("The value of b: {:?}", b);
}

if/else if/else

조건문에 괄호가 없다

fn main() {
    let x = 42;
    if x < 42 {
        println!("Less then 42");
    } else if x == 42 {
        println!("Eqeual 42");
    } else {
        println!("Greater than 42");
    }
}

loop

무한 반복문이 필요할 때 사용

fn main() {
    let mux x = 0;
    loop {
            x += 1;
            if x == 49 {
                break;
            }
    }
    println!("{}", x);
}

while

반복문에 조건을 간단히 넣을 수 있다

조건의 평가 결과가 false인 경우, 종료한다.

fn main() {
    let mux x = 0;
    while x != 42 {
            x += 1;
    }
}

for

..연산자는 시작 숫자에서 끝 숫자 전까지의 숫자들을 생성하는 반복자를 만든다.

..=연산자는 시작 숫자에서 끝 숫자까지들을 생성하는 반복자를 만든다.

fn main() {
    for x in 0..5 {
        println!("{}", x);
    }

    for x in 0..=5 {
        println!("{}", x);
    }
}

match

switch를 대체하는 구문

모든 케이스를 빠짐없이 처리해야 한다.

fn main() {
    let x = 41;

    match x {
        0 => {
            println!("Foudn 0");
        }
        1 | 2 => {
            println!("Fount 1 or 2!");
        }
        3..=9 => {
            println!("Fount between 3 and 9!");
        }
        matched_num @ 10..=100 => {
            println!("Fount {} between 10 and 100!", matched_num);
        }
        _ => {
            println("Found something else!");
        }
    }
}

구조체

필드(Filed)들의 Collection

메모리 상에 필드들을 어떻게 배치할 지에 대한 컴파일러의 청사진

struct SeaCreature {
    animal_type: String,
    name: String,
    arms: i32,
    legs: i32,
    weapon: String,
}

3. 기초적인 흐름 제어

메소드 호출하기

스태틱 메소드(Static Methods)

  • 자료형 그 자체에 속하는 메소드
  • ::연산자를 이용해 호출

인스턴스 메소드(Instance Methods)

  • 자료형의 인스턴스에 속하는 메소드
  • .연산자를 이용해 호출
fn main() {
    let s = String::from("Hello world!");
    println!("The length of {} is {}.", s, s.len());
}

메모리에 데이터 생성하기

코드에서 구조체를 인스턴스화(Instaniate)하면 프로그램은 연관된 필드 데이터들을 메모리 상에 나란히 생성한다.

구조체의 필드값들은 .연산자를 통해 접근한다.

struct SeaCreature {
    animal_type: String,
    name: String,
    arms: i32,
    legs: i32,
    weapon: String,
}

fn main() {
    let ferris = SeaCreature {
        animal_type: String::from("crab"),
        name: String::from("Ferris"),
        arms: 2,
        legs: 4,
        weapon: String::from("claw"),
    }

열거형

enum키워드를 통해 몇 가지 태그된 원소의 값을 갖는 새로운 자료형을 생성할 수 있다

match와 함께 사용하면 품질 좋은 코드를 만들 수 있다.

enum Species {
    Crab,
    Octopus,
    Fish,
    Clam,
}

struct SeaCreature {
    spcies: Species,
    name; String,
}

fn main() {
    let ferris = SeaCreate {
        species: Species::Crab,
        name: String::from("Ferris"),
    }
    match ferris.species {
        Species::Crab => println("{} is Crab", ferries,name),
        Species::Octopus => println("{} is Octopus", ferries,name),
        Species::Fish => println("{} is Fish", ferries,name),
        Species::Clam => println("{} is Clam", ferries,name),
    }
}

4. Generic 자료형

Generic 자료형

structenum을 부분적으로 정의해, 컴파일러가 컴파일 타임에 코드 사용을 기반으로 완전히 정의된 버전을 만들 수 있게 해준다.

struct BagOfHolding<T> {
    item: T,
}

fn main() {
    let i32_bag = BagOfHolding::<i32> { tiem: 42 };
  let bool_bag = BagOfHolding::<bool> { item: true };
  let float_bag = BagOfHolding { item: 3.14 };
  let bag_in_bag = BagOfHolding {
    item: BagOfHolding { item: "boom!" },
  };

  println!(
    "{} {} {} {}",
    i32_bag.item, bool_bag.item, float_bag.item, bag_in_bag.item.item
  );
}

Option

null을 쓰지 않고도 Nullable한 값을 표현할 수 있는 내장된 Generic 열거체

enum Option<T> {
    None,
    Some(T),
}
struct BagOfHolding<T> {
    item: Option<T>,
}

fn main() {
    let i32_bag = BagOfHolding::<i32> { item: None };
    if i32_bag.item.is_none() {
        println!("Nothing!")
    } else {
        println!("Found Something!")
    }

    let i32_bag = BagOfHolding::<i32> { item: Some(42) };
    if i32_bag.item.is_some() {
        println!("Found Something!")
    } else {
        println!("Nothing!")
    }

    match i32_bag.item {
        Some(v) => println!("Found {}!", v),
        None => println!("Nothing!"),
    }
}

Result

실패할 가능성이 있는 값을 리턴할 수 있도록 해주는 내장된 Genric 열거체

enum Result<T, E> {
    Ok(T),
    Err(E),
}
fn do_something_that_might_fail(i: i32) -> Result<f32, String> {
    if i == 42 {
        Ok(3.14)
    } else {
        Err(String::from("Not match!"))
    }
}

fn main() {
    let result = do_something_that_might_fail(12);
    match result {
        Ok(value) => println!("Success: {}", value),
        Err(error) => println!("Error: {}", error),
    }
}

우아한 오류 처리

Result와 함께 쓸 수 있는 강력한 연산자 ?

do_somrthing_that_might_fail()?

match do_something_that_might_fail() {
    Ok(v) => v,
    Err(e) => return Err(e),
}
fn do_something_that_might_fail(i: i32) -> Result<f32, String> {
    if i == 42 {
        Ok(13.0)
    } else {
        Err(String::from("Not match!"))
    }
}

fn main() -> Result<(), String>{
    let v = do_something_that_might_fail(42)?;
    println!("Found {}", v);
    Ok(())
}

추한 옵션/결과 처리

간단한 코드를 작성 할 때에도 Option/Result를 쓰는 것은 귀찮은 일일 수 있다

unwap이라는 함수를 사용해 빠르고 더러운 방식으로 값을 가져올 수 있다.

  • Option/Result 내부의 값을 꺼내오고
  • enumNone/Err인 경우에는 panic!
fn do_something_that_might_fail(i: i32) -> Result<f32, String> {
    if i == 42 {
        Ok(13.0)
    } else {
        Err(String::from("Not match!"))
    }
}

fn main() -> Result<(), String> {
    let v = do_something_that_might_fail(42).unwrap();
    println!("Found {}", v);

    let v = do_something_that_might_fail(1).unwrap();
    println!("Found {}", v);
    Ok(())
}

벡터

  • Vec구조체로 표현하는 가변 크기의 리스트
  • Vec!머크로를 통해 손쉽게 생성할 수 있다.
  • iter()메소드를 통해 반복자를 생성할 수 있다.
fn main() {
    let mut float_vec = Vec::new();
    float_vec.push(1.3);
    float_vec.push(2.4);
    float_vec.push(3.5);

    let string_vec = vec![String::from("Hello"), String::from("World")];

    for word in string_vec.iter() {
        println!("{}", word);
    }
}

5. 소유권과 데이터 대여

소유권 및 범위 기반 리소스 관리

자료형을 인스턴스화해 변수명에 할당(Binding)하면, Rust 컴파일러가 전체 생명주기(Lifetime) 동안 검증할 메모리 리소스를 생성한다.

할당된 변수는 리소스의 소유자(Owner)라고 한다.

Rust는 범위(scope)가 끌나는 곳에서 리소스를 소멸하고 할당 해제한다.

이 소멸과 할당 해제를 의미하는 용어로 drop을 사용한다. ( C++ 에서는 Resource Acquisition Is Initialization(RAII)라고 부른다)

구조체가 Drop될 때 구조체 자신이 제일 먼저 Drop되고, 이후 자식들이 각각 Drop된다.

소유권 이전

소유자가 함수의 인자로 전달되면, 소유권은 그 함수의 매개 변수로 이동(Move)된다.

이동된 이후에는 원래 함수에 있던 변수는 더 이상 사용할 수 없다.

struct Foo {
    x: i32,
}

fn do_somerhing(f: foo) {
    println!("{}", f.x);
}

fn main() {
    let foo = Foo { x: 42 };
    do_something(foo);
}

소유권 리턴하기

소유권은 함수에서도 리턴될 수 있다.

struct Foo {
    x: i32,
}

fn do_somerhing() -> {
    Foo {x: 42}
}

fn main() {
    let foo =    do_something(foo);
}

참조로 소유권 대여하기

&연산자를 통해 참조로 리소스에 대한 접근 권한을 대여할 수 있다

참조도 다른 리소스와 마찬가지로 Drop된다.

struct Foo {
    x: i32,
}

fn main() {
    let foo = Foo { x: 42};
    let f = &foo;
    println!("{}", f.x);
}

참조로 변경 가능한 소유권 대여하기

&mut연산자를 통해 리소스에 대해 변경 가능한 접근 권한도 대여할 수 있다.

리소스의 소유자는 변경 가능하게 대여된 상태에서 이동되거나 변경될 수 없다.

struct Foo {
    x: i32,
}

fn do_something(f: Foo) {
    println!("{}", f.x);
}

fn main() {
    let mut foo = Foo { x:42 };
    let f= &mut foo;

    // do_something(foo); // error: use of moved value: `foo`
    // foo.x = 13;
    f.x = 13;
    println!("{}", foo.x);

    foo.x = 7;
    do_something(foo);
}

역참조

&mut참조를 이용해 *연산자로 소유자의 값을 설정할 수 있다.

*연산자로 소유자의 값의 복사본도 가져올 수 있다.(복사 가능한 경우만)

fn main() {
    let mut foo =42;
    let f = &mut foo;
    let bar = *f;
    *f = 13;
    println!("{}", bar);
    println!("{}", foo);
}

대여한 데이터 전달하기

Rust의 참조 규칙

  • 단 하나의 변경 가능한 참조 또는 여러개의 변경 불가능한 참조만 허용하며, 둘다는 안된다.
  • 참조는 그 소유자보다 더 오래 살 수 없다.

보통 함수로 참조를 넘겨줄 때에는 문제가 되지 않는다.

struct Foo {
    x: i32,
}

fn do_something(a: &Foo) -> &i32 {
    return &a.x;
}
fn main() {
    let mut foo = Foo { x: 42 };
    let x = &mut foo.x;
    *x = 13;
    let y = do_something(&foo);
    println!("{}", y);
}

명시적인 생명주기

Rust 컴파일러는 모든 변수의 생명 주기를 이해하며, 참조가 절대로 그 소유자보다 더 오래 존재하지 못하도록 검증을 시도한다.

함수에서 어떤 매개 변수와 리턴 값이 서로 같은 생명 주기를 공유하는지 식별할 수 있도록 심볼로 표시해 명시적으로 셩명 주기를 지정할 수 있다.

생명 주기 지정자는 언제나로 시작한다. (ex: ‘a, ‘b, ‘c)

struct Foo {
    x: i32,
}

fn do_something<'a>(foo: &'a Foo) -> &'a i32 {
    return &foo.x;
}

fn main() {
    let mut foo = Foo { x: 42 };
    let x = &mut foo.x;
    *x = 43;
    let y = do_something(&foo);
    println!("{}", y);
}

여러 개의 생명 주기

생명 주지 지정자는 컴파ㅊ일러가 스스로 함수 매개 변수들의 생명 주기를 판별하지 못하는 경우, 이를 명시적으로 지정할 수 있게 도와준다.

struct Foo {
    x: i32,
}

fn do_something<'a, 'b>(foo_a: &'a Foo, foo_b: &'b Foo) -> &'b i32 {
    println!("{}", foo_a.x);
    println!("{}", foo_b.x);
    return &foo_b.x;
}

fn main() {
    let foo_a = Foo { x: 42 };
    let foo_b = Foo { x: 12 };
    let x = do_something(&foo_a, &foo_b);
    println!("{}", x);
}

정적인 생명주기

static변수는 컴파일 타임에 생성되어 프로그램의 시작부터 끝까지 존재하는 메모리 리소스다. 이들은 명시적으로 자료형을 지정해 주어야 한다.

static생명 주기는 프로그램이 끝날 때까지 무한정 유지되는 메모리 리소스다. 따라서 static이라는 특별한 생명주기 지정자를 갖는다.

static한 리소스는 절대 drop 되지 않는다.

만약 static 생명 주기를 갖는 리소스가 참조를 포함하는 경우, 그들도 모두 static이어야 한다. (그 이하의 것들은 충분히 오래 살아남지 못한다)

static PI: f64 = 3.1415;

fn main() {
    static mut SECRET: &'static str = "swordfish";

    let msg: &'static str = "Hello World";
    let p: &'static f64 = &PI;
    println!("{} {} ", msg, p);
    unsafe {
        SECRET = "abracadbra";
        println!("{}", SECRET);
    }
}

데이터 자료형의 생명주기

함수와 마찬가지로 데이터 자료형의 구성원들도 생명 주기 지정자로 지정할 수 있다.

Rust는 참조가 품고 있는 데이터 구조가 참조가 가리키는 소유자보다 절대 오래 살아남지 못하도록 검증한다.

아무것도 아닌 것을 가리키는 참조를 들고 다니는 구조체는 있을 수 없다.

struct Foo<'a> {
    i:&'a i32
}

fn main() {
    let x = 42;
    let foo = Foo {
        i: &x
    };
    println!("{}", foo.i);
}
반응형

'개발 > rust' 카테고리의 다른 글

RUST 학습 2주차  (0) 2022.10.24
RUST 소개  (0) 2022.10.09
rust 유용한 명령어  (0) 2022.10.07

타오나스 구매해서 minidlna 구성을 하려고 합니다. 공유기에서 자체 설치가 가능하기 때문에 설치할 수 있습니다.

jailfreebsd 11.3 버전을 생성하고, minidlna 을 설정 한다.

기본 포트는 8200 입니다.

$ pkg update -y && pkg upgrade -y
$ pkg install minidlna

minidlna가 설치가 완래 되면 아래의 conf 파일을 설정하자.

/usr/local/etc/minidlna.conf

# /usr/local/etc/minidlna.conf
#media_dir=/opt 
media_dir=/media 월하는 마운트 한 폴더로 설정
db_dir=/var/db/minidlna
log_dir=/var/log

/etc/rc.conf

# /etc/rc.conf
minidlna_enable="YES"

명령어

파일 재스캔

$ minidlna -R

서비스 시작

$ service minidlna start
반응형

와일드카드 *.도메인 SSL 설정
단점은 3개월마다 갱신을 수동으로 진행해야 한다

PACKAGE 설치

  • RHEL/CentOS 7:
   $ yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
  • RHEL/CentOS 8:
   $ yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

certbot 설치

$ sudo yum instal certbot 

인증서만 설치하기

Certbot 은 인증서까지 자동으로 등록해 주는 기능을 가지고 있다. 하지만, 한 서버에 다양한 도메인 주소를 통해서 접속해 들어온다면 자동 설치를 피하고 인증서 파일만 생성해서 직접 등록하는 방식을 사용해야 할 경우도 있다.

certonly 옵션을 사용하면, 인증서 파일만 생성 된다.

모든 서브도메인 등록(wildcard SSL)

*.도메인.com 을 모두 SSL 인증파일로 등록을 하기 위해서는 아래와 같이 수동으로 등록을 해야 하며, 도메인의 TXT 항목에 추가 정보를 입력해야 한다.
이를 통해서 간단한 인증서 파일을 생성할 수 있다.

$ certbot certonly --manual --preferred-challenges=dns --email email@domain.com --server https://acme-v02.api.letsencrypt.org/directory --agree-tos -d *.domain.com -d domain.com
[root@cobuy-1086 /home/apache-tomcat-8.0.53]# certbot certonly --manual --preferred-challenges=dns --email email@example.com --server https://acme-v02.api.letsencrypt.org/directory --agree-tos -d *.domain.com
Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator manual, Installer None
Starting new HTTPS connection (1): acme-v02.api.letsencrypt.org
Obtaining a new certificate
Performing the following challenges:
dns-01 challenge for domain.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NOTE: The IP of this machine will be publicly logged as having requested this
certificate. If you're running certbot in manual mode on a machine that is not
your server, please ensure you're okay with that.

Are you OK with your IP being logged?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please deploy a DNS TXT record under the name
_acme-challenge.domain.com with the following value:

vw_KsZ02nFdfisajYxxRK_aIjiags20Gz3R9QpeJH0c

Before continuing, verify the record is deployed.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Press Enter to Continue

여기서 STOP !!!!!!!!!!!!!!!!! 하고
여기서 자신의 도메인의 _acme-challenge.[도메인]에 TXT의 값을 추가한다.

시간이 조금 많이 걸릴 수 있다.

그리고 설치를 계속 한다.

Waiting for verification...
Cleaning up challenges

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/domain.com-0001/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/domain.com-0001/privkey.pem
   Your cert will expire on 2020-12-17. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot
   again. To non-interactively renew *all* of your certificates, run
   "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

리뉴얼

다음 면령어로 자동갱신을 실행 할 수 있다. crontab에 설정을 통해서 2개월마다 설정하는 것을 추천한다.

$ certbot renew
반응형

RUST_소개

1. RUST란

  • https://www.rust-lang.org
  • 모질라 재단에서 2010년 7월 7일 처음 발표
  • 현재는 러스트 재단으로 독립해서 개발되고 있음

RUST 언어의 특징

  • 안전한 메모리 관리
  • 철저한 예외나 에러 관리
  • 특이한 enum 시스템
  • 트레이트
  • 하이지닉 매크로
  • 비동기 프로그래밍
  • 제네릭

Rust Playground

설치방법

  • Window
  • Linux subsystem for linux
  • Linux and MacOS

Rust 디스어셈블리

반응형

'개발 > rust' 카테고리의 다른 글

RUST 학습 2주차  (0) 2022.10.24
RUST 학습 1주차  (0) 2022.10.17
rust 유용한 명령어  (0) 2022.10.07

rust 유용한 명령어

업데이트와 제거

업데이트

$ rustup update

제거

$ rustup self uninstall

Cargo

프로그램 체크

빌드 보다 적은 시간을 사용하면서, 문법이나 실행이 되는지 확인할 수 있다.

$ cargo check

빌드

$ cargo build

rustfmt

  • Rust 팀에서 개발, 관ㄹㅣ하고 있는 공식 포맷터(Formatter)
  • 공식 스타일 가이드라인을 참고해서 자동으로 코드 스타일을 수정
cargo fmt

clippy

  • Rust 팀에서 개발, 간리하고 있는 코드 린터 (Linter)
  • 현재 코드의 문제점을 파악하고, 자동으로 수정할 수 있다.
cargo clippy

변수

패키지 문서 만들기

현재 의존 패키지들이 참조하는 문서들을 빌드해서 브라우저 문서로 만들어 줍니다.

$ cargo doc --open
        Finished dev [unoptimized + debuginfo] target(s) in 0.02s
        Opening /Users/forteleaf/works/rust/hello_cargo/target/doc/hello_cargo/index.html
반응형

'개발 > rust' 카테고리의 다른 글

RUST 학습 2주차  (0) 2022.10.24
RUST 학습 1주차  (0) 2022.10.17
RUST 소개  (0) 2022.10.09

리눅스 서버를 다루다보니, 터미널을 매일사용하고 있습니다. 저는 기본으로 fish, tmux. alacritty 을 이용해서 작업을 하고 있습니다. 제가 사용하는 것들의 주요 특징들은 가볍고 빠릅니다.
iterm2는 전혀 성에 차지 않습니다. wasp와 같은 터미널 프로그램은 쓸만합니다. 하지만, 기본기로 돌아가면 alacritty 사용을 권하고 싶습니다. (rust 로 작성되어 있다는 점도 무시할 수 없습니다.)

현재 사용중인 stack

오늘부터 도전!

자주가는 reddit.comr/unixpron에는 커스텀화 된 화면들을 공유하고 자신들의 설정을 공유하는 곳입니다. 리눅스 사용자들을 위한 곳입니다. 리눅스도 같이 사용하고 있는 저에게는 지루한 랩탑을 좋은 놀이깜으로 만들어주는 곳입니다. (리눅스에 대해서도 학습하면서...)
아래 적용하려고 하는 도구들도 이 곳에서는 많이 사용하는 것들입니다.

여기서 최신 도구들을 몇개 사용해 보려고 합니다. 선정이유는 다들 rust로 작성되어 있는 점입니다. rust를 사랑하는 개발자로서 이 세팅은 반드시(!) 좋을 것 같습니다.

아래 TOOLS 를 사용하려고 하고, 장점에 대해서 설명하려고 합니다.

  • nushell
  • startship
  • zellij

nushell

rust로 작성된 최신 데이터 지향 쉘입니다. 기본적인 구성만으로 자동완성 및 기타 유용한 기능을 사용하기 위해 여러 설정을 할 필요가 없습니다.

아직 사용하기에는 여러문제들이 보임.

설치

$ brew install nushell
.......
$ nu
✘  ~  nu
No environment config file found at /Users/forteleaf/Library/Application Support/nushell/env.nu
Would you like to create one with defaults (Y/n):

Config file created at: /Users/forteleaf/Library/Application Support/nushell/env.nu
No config file found at /Users/forteleaf/Library/Application Support/nushell/config.nu
Would you like to create one with defaults (Y/n):

Config file created at: /Users/forteleaf/Library/Application Support/nushell/config.nu
     __  ,
 .--()°'.' Welcome to Nushell,
'|, . ,'   based on the nu language,
 !_-(_\    where all data is structured!

Please join our Discord community at https://discord.gg/NtAbbGn
Our GitHub repository is at https://github.com/nushell/nushell
Our Documentation is located at http://nushell.sh
Tweet us at @nu_shell

Nushell has been around for:
3yr 4month 3wk 1day 23hr 37min 48sec 769ms 498µs

You can disable this banner using the config nu command
to modify the config.nu file and setting show_banner to false.

let-env config {
    show_banner: false
    ...
}

장점

  1. Linux, macOS, Window 에서 작동
  2. nu pipeline은 구조화 된 데이터를 사용.
    안전하게 선택, 필터링, 정렬을 사용
  3. 강력한 플러그인

단점

  1. command 학습이 필요함.
    shell이름을 확인하려고 했는데....

    `echo $SHELL`
    Error: nu::parser::variable_not_found (link)
    
    × Variable not found.
    ╭─[entry #12:1:1]
    1 │ echo $SHELL
    ·      ───┬──
    ·         ╰── variable not found
    ╰────

nushell는 데이터 표현을 테이블 저장합니다. 마치 DB의 쿼리를 이용해서 물러오는 것 같습니다. 기본 zsh, fish, bash 등에 익숙해 있다면 생소한`cui
화면 처럼 보이기도 합니다.

/Users/forteleaf/vagrant〉ls                                                                                                                             09/28/2022 11:43:33 PM
╭───┬──────────┬──────┬───────┬──────────────╮
│ # │   name   │ type │ size  │   modified   │
├───┼──────────┼──────┼───────┼──────────────┤
│ 0 │ kubeset  │ dir  │ 320 B │ 2 months ago │
│ 1 │ window10 │ dir  │ 128 B │ 2 months ago │
╰───┴──────────┴──────┴───────┴──────────────╯
  1. 미완성적인 부분
    기존에 것들과 차이가 나고 PATH등 설정을 새로 해야함

starship

  • 호환성 우선
  • RUST 를 이용한 최고의 퍼포먼스와 안정성
  • 세심한 CUSTOM

Starship은 간단한 yaml 파일에 매우 다양한 구성 옵션을 제공 합니다. 그러나 nushell과 마찬가지로 처음에는 구성이 필요하지 않습니다. 모든 기본값이 이미 설정되어 있습니다! 바로 사용할 수 있는 멋진 구성 사전 설정을 제공합니다.

Starship은 다른 여러 도구 및 기술과 자동으로 통합됩니다. 패키지 버전을 표시하고(예: Poetry 프로젝트에 있을 때) AWS 리전, kubernetes 컨텍스트 및 네임스페이스를 표시할 수 있습니다. 간단히 말해서 모든 것과 작동합니다. 여기에서 전체 통합 목록을 살펴보십시오.


현재는 pastel Powerline으로 설정해서 사용하고 있습니다.

rust 로 작성되어 있어서 빠르다고 생각했지만, 별 차이를 느낄 수 없었습니다.

zellij

tmux와 매우 유사한 기능을 가지고 있습니다. 이쁜 라인이 생겨서 화면을 구분할 수 있는 큰 장점이 있습니다. 그런데 이로 인해서 볼 수 있는 text가 조금은 줄어듭니다. 한줄 정도 차이지만, 신경이 쓰입니다.

설치

$ brew install # Zellij
or
# zsh
bash <(curl -L zellij.dev/launch)

# fish
bash (curl -L zellij.dev/launch | psub)

장점

  • 기존에 사용하던 tmux의 단축키가 호환
  • 이쁨
  • layout 저장 (tmuxinator를 사용하고 있어서 ....)
  • pane 이동 기능이 직관적이고 편리

단점

  • tmuxinator 를 사용하고 있는데 이와 같은게 안 보임
  • ctrl+p 로 과거 실행했던 메뉴를 찾는데, 단축키가 설정되어 있음(pane 설정용)
    별도의 세팅을 해야되는 아쉬움
  • synchronize-pane 기능이 없다. 2021년에 기능이 추가 됨

기존에 사용하던 tmux의 단축키의 익숙함 때문에 zellij 에 적응이 안됩니다. 그리고, 기본 repository 에서 tmux 를 실행할 수 있는데, 굳이 zellij 를 설치해서 사용할 필요가 있을까 싶습니다.

반응형

'개발 > 리눅스' 카테고리의 다른 글

arch ctrl <-> caps lock swap  (0) 2023.01.02
freebsd | minidlna 구축  (0) 2022.10.13
ansible - 자동화의 시작  (0) 2022.07.14
Gitlab-CE 업그레이드  (0) 2022.07.05
LINUX | Linus Torvalds 가 우분투, 데비안을 싫어하는 이유  (0) 2020.07.13

intellij 에서 java 코드를 쓰는 중간에 아래와 같은 경고가 나오는 것을 볼 수 있다.

결론

Raw Type은 작업하기 어렵고, 버그를 일으킬 수 있습니다. 가능하면 Raw Type으로 작성하는 일은 지양해야 할 것 같습니다.

Raw use of parameterized class 'List'
List is a parameterized type of interface List while List is a raw type of interface List.

List list = new ArrayList(); // raw type

List<Integer> listIntegers = new ArrayList<>(); // parameterized type

아래와 같은 예시 코드가 있습니다. 빌드 후 실행은 되는 코드 입니다. 하지만, methodB의 파라메터를 보면 List 라는 Raw Type으로 작성이 되어있습니다.
그리고 위와 같은 경고 메세지를 보게 됩니다.

@Test  
public void methodA() {  
    List<String> parameterizedList = new ArrayList<>();  
    parameterizedList.add("Hello Folks");  
    methodB(parameterizedList);  
}  

public void methodB(List rawList) { // raw type!  
    rawList.add(1);  
}}

methodB에 의해서 추가 된 List값을 불러오려고 하면 오류가 납니다. 코드가 컴파일되고(동일한 경고와 함께) 실행될 때 ClassCastException이 발생합니다. 이것은 method get(int index)String 유형의 변수에 할당할 수 없는 Integer를 반환할 때 발생합니다.

public void methodA() {
    List<String> parameterizedList = new ArrayList<>();
    parameterizedList.add("Hello Folks");
    methodB(parameterizedList);
    String s = parameterizedList.get(1);
}

public void methodB(List rawList) {
    rawList.add(1);
}

아래와 같은 methodA에서 methodB에서 실행한 값을 가져오려고 하면 에러가 발생합니다.

java.lang.ClassCastException: java.lang.Integer cannot be cast to java.lang.String

반응형

+ Recent posts