지난 포스트에서 MobX 의 기본적인 사용 방법과, 리액트에서는 어떻게 사용하는지 알아보았습니다. MobX 를 조금 더 복잡한 프로젝트에서 사용을 한다면 어떻게 해야 할까요? 추가적으로, 어떻게 해야 컴포넌트의 업데이트 성능을 최적화 하면서 프로젝트를 구성 할 수 있는지 알아보도록 하겠습니다.
MobX 를 조금 더 심화적으로 다뤄보기 위해서, 이번엔 슈퍼마켓을 추상적으로 구현해보겠습니다.
그리고, 우리가 여러개의 스토어를 사용하는 방법도 다뤄볼 것이므로, 카운터는 그대로 유지할건데요, 그런데 앞으로 만들게 될 컴포넌트가 꽤 많아질 예정이니, components 라는 디렉토리를 만들어서 Counter.js 를 그 안에 넣어주도록 하겠습니다.
그리고, App 컴포넌트에서 Counter 경로도 고쳐주세요.
import React, { Component } from 'react';
import Counter from './components/Counter';
class App extends Component {
render() {
return (
<div>
<Counter />
</div>
);
}
}
export default App;
우리는, 다음과 같은 기능을 구현해볼 것입니다.
이 슈퍼마켓은, 좌측의 상품을 하나 누를 때 마다 우측에 갯수가 한개씩 올라갑니다. 그리고, 우측에서는 총합 얼마나 내야되는지 계산을 해주고, 갖다 놓기를 누르면 다시 한개씩 되돌려놓습니다.
우선 기능을 구현하기 전에, 컴포넌트들의 유저인터페이스부터 만들어주겠습니다!
import React from 'react';
import './SuperMarketTemplate.css';
const SuperMarketTemplate = ({ items, basket }) => {
return (
<div className="SuperMarketTemplate">
<div className="items-wrapper">
<h2>상품</h2>
{items}
</div>
<div className="basket-wrapper">
<h2>장바구니</h2>
{basket}
</div>
</div>
);
};
export default SuperMarketTemplate;
.SuperMarketTemplate {
width: 768px;
display: flex;
border: 1px solid black;
margin-left: auto;
margin-right: auto;
margin-top: 3rem;
}
.SuperMarketTemplate h2 {
margin-top: 0;
}
.SuperMarketTemplate>div {
padding: 1rem;
flex: 1;
}
.SuperMarketTemplate .items-wrapper {
background: #f8f9fa;
}
SuperMarketTemplate 는 그냥 템플릿 형태의 컴포넌트로서 한쪽에는 상품을, 한쪽에는 장바구니를 props 로 받아와서 보여줍니다.
import React from 'react';
import SuperMarketTemplate from './SuperMarketTemplate';
const SuperMarket = () => {
return <SuperMarketTemplate items={null} basket={null} />;
};
export default SuperMarket;
SuperMarket 컴포넌트는 SuperMarketTemplate 안에, 나중에 우리가 만들 Basket 과 ShopItemList 를 전달해서 보여줄 것입니다. 지금은 아직 안만들었으니 null 만 넣어주세요.
그리고나서, SuperMarket 를 App 에서 보여주겠습니다.
import React, { Component } from 'react';
import Counter from './components/Counter';
import SuperMarket from './components/SuperMarket';
class App extends Component {
render() {
return (
<div>
<Counter />
<hr />
<SuperMarket />
</div>
);
}
}
export default App;
좌측의 상품들부터 보여줘볼까요?
import React from 'react';
import './ShopItem.css';
const ShopItem = ({ name, price }) => {
return (
<div className="ShopItem">
<h4>{name}</h4>
<div>{price}원</div>
</div>
);
};
export default ShopItem;
.ShopItem {
background: white;
border: 1px solid #495057;
padding: 0.5rem;
border-radius: 2px;
cursor: pointer;
}
.ShopItem h4 {
margin-top: 0;
margin-bottom: 1rem;
}
.ShopItem:hover {
background: #495057;
color: white;
}
.ShopItem+.ShopItem {
margin-top: 1rem;
}
import React from 'react';
import ShopItem from './ShopItem';
const items = [
{
name: '생수',
price: 850,
},
{
name: '신라면',
price: 900,
},
{
name: '포카칩',
price: 1500,
},
{
name: '새우깡',
price: 1000,
},
];
const ShopItemList = () => {
const itemList = items.map(item => <ShopItem {...item} key={item.name} />);
return <div>{itemList}</div>;
};
export default ShopItemList;
이렇게 만들어 주고 나서, ShopItemList 를 SuperMarket 에서 보여주겠습니다.
import React from 'react';
import SuperMarketTemplate from './SuperMarketTemplate';
import ShopItemList from './ShopItemList';
import Basket from './BasketItemList';
const SuperMarket = () => {
return <SuperMarketTemplate items={<ShopItemList />} basket={null} />;
};
export default SuperMarket;
이제 우측의 장바구니도 구현해주겠습니다.
import React from 'react';
import './BasketItem.css';
const BasketItem = ({ name, price, count }) => {
return (
<div className="BasketItem">
<div className="name">{name}</div>
<div className="price">{price}원</div>
<div className="count">{count}</div>
<div className="return">갖다놓기</div>
</div>
);
};
export default BasketItem;
.BasketItem {
display: flex;
width: 100%;
}
.BasketItem .name {
flex: 2;
}
.BasketItem .price {
flex: 1;
}
.BasketItem .count {
flex: 1;
}
.BasketItem .return {
margin-left: auto;
color: #f06595;
cursor: pointer;
}
.BasketItem .return:hover {
text-decoration: underline;
}
.BasketItem+.BasketItem {
margin-top: 1rem;
}
import React from 'react';
import BasketItem from './BasketItem';
const BasketItemList = () => {
return (
<div>
<BasketItem name="포카칩" price={1500} count={2} />
<BasketItem name="생수" price={850} count={1} />
<hr />
<p>
<b>총합: </b> 3850원
</p>
</div>
);
};
export default BasketItemList;
지금은, BasketItemList 에서 실제 데이터를 사용하지 않고, 하드코딩하여 가짜 데이터를 보여주었습니다.
다 만드셨다면 이 컴포넌트도 SuperMarket 에서 basket props 로 전달해주세요.
import React from 'react';
import SuperMarketTemplate from './SuperMarketTemplate';
import ShopItemList from './ShopItemList';
import BasketItemList from './BasketItemList';
const SuperMarket = () => {
return (
<SuperMarketTemplate items={<ShopItemList />} basket={<BasketItemList />} />
);
};
export default SuperMarket;
여기까지 하고 나면, 다음과같은 UI 가 나타날것입니다
기능을 곧 구현해줄 텐데, 그 전에 개발도구를 설치해주겠습니다. 필수적인 작업은 아니지만, 있으면 우리가 어떤 값을 바꿨을 때 어떠한 컴포넌트들이 영향을 받고, 업데이트는 얼마나 걸리고, 어떠한 변화가 일어났는지에 대한 세부적인 정보를 볼 수 있게 해줍니다.
$ yarn add mobx-react-devtools
설치를 한 다음엔 App.js 에서 적용해주면 됩니다.
import React, { Component } from 'react';
import Counter from './components/Counter';
import SuperMarket from './components/SuperMarket';
import DevTools from 'mobx-react-devtools';
class App extends Component {
render() {
return (
<div>
<Counter />
<hr />
<SuperMarket />
{process.env.NODE_ENV === 'development' && <DevTools />}
</div>
);
}
}
export default App;
market 스토어를 만들어주겠습니다.
import { observable, action, computed } from 'mobx';
export default class MarketStore {
@observable selectedItems = [];
@action
put = (name, price) => {
// 존재하는지 찾고
const exists = this.selectedItems.find(item => item.name === name);
if (!exists) {
// 존재하지 않는다면 새로 집어넣습니다.
this.selectedItems.push({
name,
price,
count: 1,
});
return;
}
// 존재 한다면 count 값만 올립니다.
exists.count++;
};
@action
take = name => {
const itemToTake = this.selectedItems.find(item => item.name === name);
itemToTake.count--;
if (itemToTake.count === 0) {
// 갯수가 0 이면
this.selectedItems.remove(itemToTake); // 배열에서 제거처리합니다.
}
};
@computed
get total() {
console.log('총합 계산...');
return this.selectedItems.reduce((previous, current) => {
return previous + current.price * current.count;
}, 0);
}
}
방금 만든 스토어를 index.js 에서 Provider 에 넣어주세요.
import React from 'react';
import ReactDOM from 'react-dom';
import { Provider } from 'mobx-react';
import './index.css';
import App from './App';
import registerServiceWorker from './registerServiceWorker';
import CounterStore from './stores/counter';
import MarketStore from './stores/market';
const counter = new CounterStore();
const market = new MarketStore();
ReactDOM.render(
<Provider counter={counter} market={market}>
<App />
</Provider>, document.getElementById('root'));
registerServiceWorker();
아이템을 추가하는 기능부터 구현하겠습니다!
import React from 'react';
import ShopItem from './ShopItem';
import { inject, observer } from 'mobx-react'; // 불러오기
const items = [
{
name: '생수',
price: 850,
},
{
name: '신라면',
price: 900,
},
{
name: '포카칩',
price: 1500,
},
{
name: '새우깡',
price: 1000,
},
];
// **** onPut 함수 추가됨
const ShopItemList = ({ onPut }) => {
const itemList = items.map(item => (
<ShopItem {...item} key={item.name} onPut={onPut} />
));
return <div>{itemList}</div>;
};
// **** inject, observer 적용
export default inject(({ market }) => ({
onPut: market.put,
}))(observer(ShopItemList));
함수형 컴포넌트에 inject 와 observer 를 적용할땐 이렇게 내보내주는 과정에서 사용하시면 조금 더 깔끔합니다.
이제, ShopItem 에서. 클릭시 onPut 에 현재 자신의 name과 price 를 넣어서 호출하도록 설정을 해주겠습니다.
import React from 'react';
import './ShopItem.css';
const ShopItem = ({ name, price, onPut }) => {
return (
<div className="ShopItem" onClick={() => onPut(name, price)}>
<h4>{name}</h4>
<div>{price}원</div>
</div>
);
};
export default ShopItem;
먼저 BasketItemList 부터 구현해보겠습니다.
import React from 'react';
import BasketItem from './BasketItem';
import { inject, observer } from 'mobx-react';
const BasketItemList = ({ items, total, onTake }) => {
const itemList = items.map(item => (
<BasketItem
name={item.name}
price={item.price}
count={item.count}
key={item.name}
onTake={onTake}
/>
));
return (
<div>
{itemList}
<hr />
<p>
<b>총합: </b> {total}원
</p>
</div>
);
};
export default inject(({ market }) => ({
items: market.selectedItems,
total: market.total,
onTake: market.take,
}))(observer(BasketItemList));
그리고 그 내부의 BasketItem 를 구현해줄건데요, 여기서 주의하실 점은 리스트를 렌더링하시게 될 때에 내부에 있는 컴포넌트에도 observer 를 구현해주어야, 성능적으로 최적화가 일어난다는 점 입니다.
import React from 'react';
import './BasketItem.css';
import { observer } from 'mobx-react';
const BasketItem = ({ name, price, count, onTake }) => {
return (
<div className="BasketItem">
<div className="name">{name}</div>
<div className="price">{price}원</div>
<div className="count">{count}</div>
<div className="return" onClick={() => onTake(name)}>갖다놓기</div>
</div>
);
};
export default observer(BasketItem);
또는, 다음과 같이 observer 를 하단이 아닌 위에서 설정해줘도 동일하게 작동합니다.
import React from 'react';
import './BasketItem.css';
import { observer } from 'mobx-react';
const BasketItem = observer(({ name, price, count, onTake }) => {
return (
<div className="BasketItem" onClick={() => onTake(name)}>
<div className="name">{name}</div>
<div className="price">{price}원</div>
<div className="count">{count}</div>
<div className="return">갖다놓기</div>
</div>
);
});
export default BasketItem;
이제 모든 기능이 잘 작동 할 것입니다!
지금은 counter 와 market 이 전혀 관계가 없기 때문에 서로간의 접근은 불필요 한 상황이지만, 만약에 해야한다면 어떻게 해야하는지 알아봅시다.
스토어끼리 접근을 하려면, 우리는 RootStore 라는것을 만들어주어야 합니다.
stores 에 index.js 라는 파일을 만들어보세요.
import CounterStore from './counter';
import MarketStore from './market';
class RootStore {
constructor() {
this.counter = new CounterStore(this);
this.market = new MarketStore(this);
}
}
export default RootStore;
여기서, 다른 스토어들을 불러오고 constructor 에서 각 스토어를 만들어준 다음에, this.스토어명 = new 새로운스토어(this)
이런식으로 입력해줍니다. 뒷부분에서 this 를 파라미터를 넣어주는게 중요합니다. 이렇게 함으로서 각 스토어들이, 현재 루트 스토어가 무엇인지 알 수 있게 됩니다.
우리가 각 스토어를 만들 떄 루트 스토어를 파라미터로 넣어주었으니, 이를 따로 값으로 저장해두게끔 해주겠습니다.
import { observable, action } from 'mobx';
export default class CounterStore {
@observable number = 0;
// **** 추가됨
constructor(root) {
this.root = root;
}
@action increase = () => {
this.number++;
}
@action decrease = () => {
this.number--;
}
}
import { observable, action, computed } from 'mobx';
export default class MarketStore {
@observable selectedItems = [];
// **** 추가됨
constructor(root) {
this.root = root;
}
// 이하 생략..
}
이제, 프로젝트의 엔트리 index.js 에서 Provider 쪽에 스토어를 전달해줄 차례입니다. 다음과 같이 루트 스토어를 만들고 spread 문법으로 Provider 쪽에 props 를 풀어주시면 자동으로 counter 스토어와 market 스토어가 전달됩니다.
import React from 'react';
import ReactDOM from 'react-dom';
import { Provider } from 'mobx-react'; // MobX 에서 사용하는 Provider
import './index.css';
import App from './App';
import registerServiceWorker from './registerServiceWorker';
import RootStore from './stores';
const root = new RootStore(); // *** 루트 스토어 생성
ReactDOM.render(
<Provider {...root}> {/* *** ...root 으로 스토어 모두 자동으로 설정 */}
<App />
</Provider>,
document.getElementById('root')
);
registerServiceWorker();
이제 다 끝났습니다! 만약에, market 에서 counter 에 접근하고 싶다면, this.root.counter.number 이런식으로 조회해서 사용해보면 됩니다. 한번, 현재 스토어의 값에 따라 한번 상품을 클릭 할 시 몇개를 집어올 지 정해줘보도록 하겠습니다.
우선 편의상 카운터의 기본 값을 1로 해주겠습니다.
import { observable, action } from 'mobx';
export default class CounterStore {
@observable number = 1; // **** 기본 값 1로 업데이트
// **** 추가됨
constructor(root) {
this.root = root;
}
@action
increase = () => {
this.number++;
};
@action
decrease = () => {
this.number--;
};
}
그 다음에, market 에서 상품을 한번 집어 올 때 마다 카운터에 있는 상태의 갯수만큼 들고오게 구현을 해보겠습니다.
@action
put = (name, price) => {
const { number } = this.root.counter;
// 존재하는지 찾고
const exists = this.selectedItems.find(item => item.name === name);
if (!exists) {
// 존재하지 않는다면 새로 집어넣습니다.
this.selectedItems.push({
name,
price,
count: number,
});
return;
}
exists.count += number;
};
이렇게 하면, 예를들어 카운터의 값이 2면, 한번 상품이 클릭 될 때마다 두개씩 받아옵니다.
mobx-react 를 사용하게 될 때, 성능이 망가지지 않으려면 지켜줘야 하는 몇가지 규칙 이 있는데 이에 대해서 알아보겠습니다.
리스트가 렌더링 될 때는 성능에 대해서 신경을 써주셔야 하는데요, 리스트 컴포넌트에 리스트 관련 props 만 넣는것을 권장합니다. 예를 들어서 다음과 같은 코드는 비효율 적입니다.
@observer class MyComponent extends Component {
render() {
const {todos, user} = this.props;
return (<div>
{user.name}
<ul>
{todos.map(todo => <TodoView todo={todo} key={todo.id} />)}
</ul>
</div>)
}
}
이런 코드는 별로 좋지 않습니다. 왜냐하면 user.name 이 바뀔때도 컴포넌트가 리렌더링 되기 때문이죠. 이러한 구조 대신 아예 리스트를 잘 분리시켜서 다음과 같이 하는 것이 좋습니다.
@observer class MyComponent extends Component {
render() {
const {todos, user} = this.props;
return (<div>
{user.name}
<TodosView todos={todos} />
</div>)
}
}
@observer class TodosView extends Component {
render() {
const {todos} = this.props;
return <ul>
{todos.map(todo => <TodoView todo={todo} key={todo.id} />)}
</ul>)
}
}
여기서 세부 참조 (혹은 역참조) 란, 우리가 특정 객체의 내부의 값을 조회하는것을 말합니다. 예를 들어서 우리가 장바구니의 정보들을 보여줄 때 다음과 같은 코드를 사용했었는데요,
const itemList = items.map(item => (
<BasketItem
name={item.name}
price={item.price}
count={item.count}
key={item.name}
onTake={onTake}
/>
));
여기서 item 에서 name, price, count 를 조회하는것이, 세부참조입니다.
만약에, 코드를 이런식으로 하면 업데이트 성능 최적화를 이뤄낼 수 있습니다.
const itemList = items.map(item => (
<BasketItem
item={item}
key={item.name}
onTake={onTake}
/>
));
변동이 일어날 수 있는 count 값의 세부참조를 우리는 BasketItem 컴포넌트 내부에서 하게 된다면, 더 높은 성능으로 컴포넌트를 업데이트 할 수 있습니다. 여기서 item.name 값은 바뀌지 않기 때문에 key 설정 부분에선 문제가 되지 않습니다.
SuperMarket 의 컴포넌트 최적화는 우리가 잠시 후에 진행해볼것입니다.
컴포넌트에 함수를 전달해 줄 때에는 미리 바인딩 하는것이 좋고, 파라미터가 유동적일땐 파라미터를 넣는 작업을 컴포넌트 밖이 아니라 안에서 하는것이 좋습니다.
예를들어서 다음과 같은 코드는 썩 좋은 코드가 아닙니다.
render() {
return <MyWidget onClick={() => { alert('hi') }} />
}
그 대신에 이렇게 하는것이 좋습니다.
render() {
return <MyWidget onClick={this.handleClick} />
}
handleClick = () => {
alert('hi')
}
그리고 다음과 같은 코드 또한 별로 좋지 않습니다.
const ShopItemList = ({ onPut }) => {
const itemList = items.map(item => (
<ShopItem {...item} key={item.name} onPut={() => onPut(item.name, item.price)} />
));
return <div>{itemList}</div>;
};
그 대신에 우리가 이전에 작성했던 코드처럼 onPut={onPut}
이렇게 전달하고 파라미터는 컴포넌트 내부에서 넣어주는것이 좋죠.
const ShopItemList = ({ onPut }) => {
const itemList = items.map(item => (
<ShopItem {...item} key={item.name} onPut={onPut} />
));
return <div>{itemList}</div>;
};
const ShopItem = ({ name, price, onPut }) => {
return (
<div className="ShopItem" onClick={() => onPut(name, price)}>
<h4>{name}</h4>
<div>{price}원</div>
</div>
);
};
우리는 프로젝트를 만들 때 3번 규칙은 잘 따라줬지만, 1번과 2번은 조금은 부족하게 따라줬습니다. 예를들어서, BasketItemList 에서 세부 참조를 바로 해줬었고, total 값을 리스트에서 props 로 받아오게 했습니다.
때문에, 만약에 상품의 갯수가 달라지게 될 때, BasketItemList 에서도 리렌더링이 일어났고, BasketItem 에서도 리렌더링이 일어났습니다.
보시면, 신라면을 추가했을 때 리스트 전체적인 렌더링을 했고, 나머지 생수/새우깡/포카칩은 리렌더링은 이미 최적화가 이뤄져서 (observer 가 자동으로 해줬습니다) 리렌더링이 되지 않았고, 신라면만 리렌더링이 됐죠.
사실 지금의 성능도 충분하긴 하지만. 여기서 조금만 고쳐주면 BasketItemList 의 렌더링을 방지해서 배열 map 하는 작업 자체를 생략할 수도 있습니다.
첫번째로, 총합이 나타나는 부분을 컴포넌트화 해주겠습니다.
import React, { Component } from 'react';
import { observer, inject } from 'mobx-react';
@inject(({ market }) => ({ total: market.total }))
@observer
class TotalPrice extends Component {
render() {
const { total } = this.props;
return (
<div>
<hr />
<p>
<b>총합: </b> {total}원
</p>
</div>
);
}
}
export default TotalPrice;
편의상 클래스형태로 작성해주었는데요, 함수형으로 작성하던, 클래스형으로 작성하던 큰 상관은 없습니다. 클래스형태로 작성하면 decorator 를 편하게 쓸 수 있다는 장점이 존재합니다.
그리고 이 컴포넌트를 SuperMarketTemplate 의 total 이라는 값으로 JSX 형태로 전달해주겠습니다.
import React from 'react';
import SuperMarketTemplate from './SuperMarketTemplate';
import ShopItemList from './ShopItemList';
import BasketItemList from './BasketItemList';
import TotalPrice from './TotalPrice';
const SuperMarket = () => {
return (
<SuperMarketTemplate
items={<ShopItemList />}
basket={<BasketItemList />}
total={<TotalPrice />}
/>
);
};
export default SuperMarket;
import React from 'react';
import './SuperMarketTemplate.css';
const SuperMarketTemplate = ({ items, basket, total }) => {
return (
<div className="SuperMarketTemplate">
<div className="items-wrapper">
<h2>상품</h2>
{items}
</div>
<div className="basket-wrapper">
<h2>장바구니</h2>
{basket}
{total}
</div>
</div>
);
};
export default SuperMarketTemplate;
그 다음, BracketItemList 에서 props 로 받아오던 total 은 없애고, 세부 참조를 BracketItem 내부에서 하도록 수정해주겠습니다.
import React from 'react';
import BasketItem from './BasketItem';
import { inject, observer } from 'mobx-react';
const BasketItemList = ({ items, total, onTake }) => {
const itemList = items.map(item => (
<BasketItem item={item} key={item.name} onTake={onTake} />
));
return <div>{itemList}</div>;
};
export default inject(({ market }) => ({
items: market.selectedItems,
onTake: market.take,
}))(observer(BasketItemList));
import React from 'react';
import './BasketItem.css';
import { observer } from 'mobx-react';
const BasketItem = observer(({ item, onTake }) => {
return (
<div className="BasketItem">
<div className="name">{item.name}</div>
<div className="price">{item.price}원</div>
<div className="count">{item.count}</div>
<div className="return" onClick={() => onTake(item.name)}>
갖다놓기
</div>
</div>
);
});
export default BasketItem;
이렇게 하면 최적화가 끝납니다!
BracketItemList 컴포넌트 전체가 리렌더링된것이 아니라, 그 내부의 TotalPrice 와 필요한 아이템만 업데이트가 되고있습니다. 물론, 지금은 체감되는 차이가 없겠지만 앱의 규모가 커진다면, 이렇게 최적화를 해주면 확실히 체감 될 것입니다.
Reference
맨 마지막 수정부분인
코드에서 item={item} 으로 매개변수를 넘겨주면 BasketItem.js가 렌더링을 안합니다.
<BasketItem {...} name={item.name} price={item.price} count={item.count /> (기존)
또는
<BasketItem {...} {...item} /> (spread)
으로 변경하면 잘 됩니다.
검색해본결과 deep한 속성의 변화는 observable이 안된다고 그러는데 아마 이 버그하고 연관이 있는 것일까요 :) !?
잘 읽었습니다. 질문이 있는데요. Mobx Store 간에 접근 할때 MarketStore 안에 CounterStore 를 Import 하는 것만으로도 접근할수 있는데 굳이 RootStore 를 별도로 만들어서 접근하게 하는 이유가 장점이 있을까요? github 를 봐도 그냥 import 해서 사용하는 경우가 있어서 어떤 방식으로 해야 되는지 궁금하네요.
최적화를 위해서 Mobx에선 shouldComponentUpdate는 따로 구현 안 해도 되는듯 하네요?
스토어끼리 접근하는것도 간편하네요. 리덕스는 thunk 미들웨어 사용해서 했는데.