Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/solutena/observable
https://github.com/solutena/observable
design-pattern observable observablecollection observer-pattern unity
Last synced: about 7 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/solutena/observable
- Owner: solutena
- Created: 2024-10-15T15:58:30.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-12T19:27:10.000Z (about 1 month ago)
- Last Synced: 2024-11-12T20:26:14.941Z (about 1 month ago)
- Topics: design-pattern, observable, observablecollection, observer-pattern, unity
- Language: C#
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Observable
옵저버 패턴을 구현하여 값이 변경될 때 구독자들에게 알림을 보내는 기능을 제공합니다.
# 설치
1. URL 복사
2. 패키지 매니저에서 Add Package from Git URL 선택
3. 복사한 URL로 설치
# Observable\
단일 값(예: int, string, bool)의 변화를 감지할 수 있게 하는 객체입니다.
이 객체는 주로 데이터가 변경될 때 해당 변화를 구독자들에게 알리는 데 사용됩니다.
## 이벤트
- **OnChanged:** 값이 변경될 때마다 호출됩니다. 이를 통해 값이 변경될 때 특정 동작을 수행할 수 있습니다.
## 사용법
직렬화 및 역직렬화 시 데이터를 적절히 처리하는 방법을 보여주는 예제입니다.
```csharp
using System;
using UnityEngine;
[Serializable]
public class Example : ISerializationCallbackReceiver
{
[SerializeField] int hp;
public Observable HP { get; set; }
public void OnAfterDeserialize()
{
hp = HP;
}
public void OnBeforeSerialize()
{
HP = new Observable(hp);
}
}
```
### 이벤트 구독
```csharp
Hp.OnChanged += (int value) =>
{
Debug.Log($"값 변경됨: {value}");
};
```
# ObservableCollection
여러 개의 값이 있는 컬렉션(List, Dictionary 등)의 변경 사항을 감지할 수 있도록 설계된 컬렉션입니다.
## 함수
- **Add:** 항목을 컬렉션에 추가하고 `OnAdd` 이벤트를 발생시킵니다. 후에 `OnChanged` 이벤트를 발생시킵니다.
- **Remove:** 항목을 컬렉션에서 제거하고 `OnRemove` 이벤트를 발생시킵니다. 후에 `OnChanged` 이벤트를 발생시킵니다.
- **Clear:** 모든 항목을 삭제하고 `OnRemove` 이벤트를 개별 항목에 대해 발생시킵니다. 후에 `OnChanged` 이벤트를 발생시킵니다.
- **Refresh:** 컬렉션을 다시 알림 상태로 만들어 강제로 `OnChanged` 이벤트를 발생시킵니다.
## 이벤트
- **OnAdd:** 항목이 추가될 때 발생하는 이벤트입니다. 추가된 항목을 매개변수로 전달합니다.
- **OnRemove:** 항목이 삭제될 때 발생하는 이벤트입니다. 삭제된 항목을 매개변수로 전달합니다.
- **OnChanged:** 컬렉션에 변경이 생길 때마다 호출되는 이벤트입니다. 전체 컬렉션을 매개변수로 전달합니다.
## 사용법
`ObservableCollection` 클래스는 `ICollection`나 `IEnumerable`로 초기화할 수 있습니다.
```csharp
List list = new();
HashSet hashset = new();
Dictionary dictionary = new();
var observableList = new ObservableCollection(list);
var observableHashSet = new ObservableCollection(hashset);
var observableDictionary = new ObservableCollection>(dictionary);
```
직렬화 및 역직렬화 시 데이터를 적절히 처리하는 방법을 보여주는 예제입니다.
```csharp
using System;
using System.Collections.Generic;
using System.Linq;
using UnityEngine;
[Serializable]
public class Example : ISerializationCallbackReceiver
{
[SerializeField] List list;
public ObservableCollection List { get; set; }
public void OnAfterDeserialize()
{
list = List.ToList();
}
public void OnBeforeSerialize()
{
List = new ObservableCollection(list);
}
}
```
### 이벤트 구독
```csharp
List.OnAdd += item => Debug.Log($"항목 추가됨: {item}");
List.OnRemove += item => Debug.Log($"항목 제거됨: {item}");
List.OnChanged += collection => Debug.Log("컬렉션이 변경되었습니다.");
```