🧑🏻‍💻시니어개발자🧑🏻‍💻

그동안 17편을 거쳐서 웹 개발 React&Python으로 웹개발(링크서비스)를 개발 했으며, 

혼자 프론트/백엔드를 하다 보면 복잡함을 느끼며, 수정작업이 이루어지면 백엔드와 프론트엔드 여러 소스들을 거쳐서 관련 내용을 반영해야 하는 어려움이 있을 수 있다. 하지만, 반복적인 개발 과정을 통해서 여러분의 실력을 높일 수 있을 것이다.

최대한 STEP BY STEP로 소스를 추가하면서 설명하려고 노력했으나,

더 복잡해 졌는지 알 수 없지만, 일단 차근차근 따라해보면 좋을 듯 하다.

또한 본 소스를 공개하면서 여러분과 함께 WIN-WIN이 될 수 있을 거라고 믿으며, 수정과 발전을 해 가면서 여러분들 만의 레퍼런스 소스가 되길 바란다.

누구나 개발할 수 있는 소스이며, 단지 한번도 전체적인 개발 경험을 못한분들을 위한 것이므로, 완벽한 소스 내용이 아님을 다시 한번 말씀드리며, 제 1편을 마치고자 한다.

 링크서비스 git : https://github.com/firstvalue1/LINKSERVICE.git

보시다 수정이나, 의견 있으시면 git에 남겨주시기 바랍니다.

다음은 링크서비스를 기본으로 추가적인 기능들을 계속 게시 할 예정입니다.

#12. React에서 Drag & Drop을 이용한 이미지 업로드

React에서 등록화면에서 이미지를 Drag&Drop 할수 있도록 구현을 했다.

그럼 이젠 등록화면의 마무리로 저장기능을 구현해보자.

1.1.  이미지 저장기능 제작

이미지 저장기능(linkSevice.uploadImage) 은 아직 API 제작 및 Service선언을 하지 않았다.

     ☞ 설명차원에서 서버단에 API제작 시 제외 했다. 앞단에서 뭔 지 모른 상태에서 소스를 미리 제작하지 않고,

          이해를 돕기 위해 지금 내용을 반영했다.

링크정보를 DB에 저장 시 우리는 미리 /api/link/create API 을 사전에 제작했다.

하지만, 실제 화면에서 DB 저장 시 2가지가 더 추가되어야 한다.

첫째, 이미지 파일 자체를 저장하는 기능

둘째, 이미지 파일명(URL)을 링크정보 DB에 저장하는 기능

⎟⎜이미지 저장 기능

이미지 업로드는 보통 DB에 직접 넣는 방법과 서버에 이미지를 보관하는 방법이 있다. 장단점은 있으나, 이미지를 DB에 저장하는 방식은 향후 이미지 호출 시 속도와 DB용량과 유지보수에 불편함이 있어, 별도 서버에 보관하는 방식으로 진행한다.

기업의 개발은 CDN을 사용할 수 있으므로, 별도 보관 방식을 추천한다.

이미지 업로드 제작하면서, 다시한번 서버단과 클라이언트단의 API제작 관련해서 정리해보자.

1)   서버 RESTful API제작

- 이미지 보관 폴더 지정 ( config.py )

- 이미지 업로드후 이미지 파일 이름과 URL을 DB에 보관

- 이미지 업로드 / 삭제 CLASS 제작

- API 선언

2) 클라이언트 API 호출

   - API config에 서버단 API 호출 url관리 ( api.config.js )

- 서비스에 API 호출 const 지정 ( service.js )

⎟⎜서버단 API 제작

⌘ config.py ( 위치: linkservice/server/config/config.py )

--------------------------------------------------------------------------------------------------

앞에서 config.py에 개발계(Development)와 운영계(Production) 이미지 저장 위치를 지정 했었다.

#이미지 위치 설정
    image_folder = os.path.normpath(os.path.join(dir, os.pardir)) + '/client/public/images/'
    COVER_IMAGE_FORDER = image_folder
    IMAGE_FORDER = image_folder
    IMAGE_URL = 'http://127.0.0.1:3000/images/'

image_folder는 현재 디렉토리의 부모 디렉토리 ( /linkservice) 을 확인해서 /client/public/images 디렉토리를 가리킨다.

( 해당 폴더에 images 디렉토리를 만들자 )

☞ NAS나 CDN 저장 시 image_folder에 위치를 지정하면 된다.
☞ COVER_IMAGE_FORDER 는 향후 커버 이미지를 추가/변경 할 예정이라 미리 설정했다.

⌘ links_model.py ( 위치: linkservice/server/models/links_model.py )

--------------------------------------------------------------------------------------------------

기존에 links_model.py에 2가지가 추가적으로 필요하다.

이미지 업로드후 링크정보에 이미지 이름을 매핑 시키기 위해서 이미지 이름을 저장하는 method와 현재 DB의  id 시퀀스 값을 알아내는 method가 필요하다.

id의 현재 시퀀스를 알아야 하는 이유는 저장순서를 잘 생각하면 필요성이 보인다.

이미지가 먼저 저장 되면 id을 알 수 없으므로, 1)링크정보(이름,태그 등)가 먼저 저장되어 시퀀스인 id값이 생성한 다음 2)이미지를 저장해야 한다.

from sqlalchemy.sql import text

query에 raw string 형태의 SQL문을 전달하기 위해서 sqlalchemy.sql.text 을 사용해야 한다.

우선 sqlalchemy.sql.text 을 import 하고, 아래 소스를 추가한다.

# 링크 이미지 정보를 DB에 저장하기 위한 코드
# id와 파일이름 혹은 이미지 링크를 파라메타를 받아 처리
    @classmethod
    def update_filename(self, id, filename):
        try:
            query = "update links set imageurl = :v2 where id = :v1"
            db.session.execute(text(query), {'v1':id, 'v2':filename})
        except:
            db.session.rollback()
            print('update_filename : 오류발생')
            print(query)
        finally:
            db.session.commit()
            db.session.close()

# 링크정보가 저장된 현재 시퀀스 id 값을 알아낸다. 
	@classmethod
	def currval_id(self):
		result = db.session.query(func.max(self.id)).scalar()
		return result

⌘ image.py ( 위치: linkservice/server/src/image.py )

-------------------------------------------------------------------------------------------------

이미지 관련 Resource을 제작하기 위해서 image.py을 하나 생성한다.

image.py에서는 썸네일 정도의 이미지만 있으면 되므로, 1) 이미지를 resizing을 하고, 2)이미지 파일을 폴더에 저장한 다음, 3) 링크정보 DB에 이미지 파일명(URL)을 매핑 시킨다.

☞ DB에 저장되는 이미지 파일명은 실제 CDN혹은 NAS 의 URL형태로 저장된다.

   config.py의 IMAGE_URL 값을 참고하기 바랍니다.

from flask_restful import Resource
from flask import jsonify, request, current_app
from PIL import Image, ImageOps
from models.links_model import LinkModel

"""
UPLOAD  IMAGE /api/link/image 
"""
class ImageUpload(Resource):
    def post(self):
        f = request.files['image']
        folder = current_app.config.get('IMAGE_FORDER')
        img_url = current_app.config.get('IMAGE_URL')

        img = Image.open(f)
        
        # 이미지를 강제적으로 Resizing한다.
        # Resizing을 안해도 좋으나, 파일 용량을 줄이고자 반영
        img_resize = img.resize((50,50), Image.LANCZOS)
        img_resize = ImageOps.exif_transpose(img_resize)
        img_resize = img_resize.convert('RGB')

        id = LinkModel.currval_id()
        file_name = str(id) + '_' + str(date_function.today()) + '.' + f.filename.rsplit('.', 1)[1].lower()
        img_resize.save(folder + file_name)
		LinkModel.update_filename(id, img_url + file_name)

        return '이미지가 저장되었습니다..'

프론트엔드에서 formData로 보낸 image을 request.files로 받아 Python의 이미지 처리 pillow(PIL) 라이브러리를 사용하여 이미지를 Resizing한다.

또한 파일 이름을 변경한다. 이유는 한글 혹은 같은 파일 이름이 있을 수 있기에 대부분 사이트를 보면 명명규칙(Naming rule)에 맞게 변경하여 자체 보관한다.

여기서는 파일명 Naming rule을 다음과 같이 하기로 하자. ( 각자 정해도 무방 한다.)

   ► ID_날짜.확장자

        📌 DB에 이미지 파일 저장 시 image_url + file_name임을 상기하기 바란다.

또한, 이미지를 업로드 뿐만 아니라, 링크정보가 수정/삭제 시 기존 이미지를 변경해주는 작업도 필요함으로 미리 작성한다.

"""
CHANGE  IMAGE /api/link/image/<int:id>
"""
class ImageChange(Resource):
    def put(self, id):
        f = request.files['image']
        folder = current_app.config.get('IMAGE_FORDER')
        img_url = current_app.config.get('IMAGE_URL')

        img = Image.open(f)
        # 이미지를 강제적으로 Resizing한다.
        # Resizing을 안해도 좋으나, 파일 용량을 줄이고자 반영
        img_resize = img.resize((50,50), Image.LANCZOS)
        img_resize = ImageOps.exif_transpose(img_resize)
        img_resize = img_resize.convert('RGB')

        file_name = str(id) + '_' + str(date_function.today()) + '.' + f.filename.rsplit('.', 1)[1].lower()
        img_resize.save(folder + file_name)

        LinkModel.update_filename(id, img_url + file_name)

        return '이미지가 수정되었습니다..'

ImageUpload() 와 ImageChange() 의 차이점은 id 값을 가지고 있느냐 아니면 currval_id가지고 생성하느냐 차이다.

소스를 하나로 병합해도 될지 여러분들이 직접 해보시면 좋을 듯 하다.

⌘ server.py ( 위치: linkservice/server/server.py )

--------------------------------------------------------------------------------------------------

API에 ImageUpload Resource을 추가한다.

server.py에 ImageUpload을 import하고,

from src.image import ImageUpload

api resource에 추가한다.

api.add_resource(ImageUpload, '/api/link/image')
api.add_resource(ImageChange, '/api/link/image/<int:id>')

⎟⎜클라이언트단(프론트 엔드) API 호출

⌘ api.config.js ( 위치: linkservice/client/src/component/api/api.config.js )

-------------------------------------------------------------------------------------------------

서비스명 API을 추가한다.

⌘ service.js ( 위치: linkservice/client/src/component/service/service.js )

-------------------------------------------------------------------------------------------------

linkService에서 API을 호출하여 이미지를 저장하는 함수를 추가한다.

모두 작성되면, 이젠 테스트를 해보자

http://localhost:3000/create 로 접속 후 테스트 데이터를 넣어보고 등록 한다.

정상적으로 등록되었다면 초기화면에서 확인해보자.

http://locahost:3000

관리자모드 화면을 만들어 등록/편집/삭제/순서변경이 가능하게 Prototype UI을 구성해 보자.

#8. 프론트엔드 화면개발 (component 제작)

데이터까지 출력되는 것을 확인했으니, 이젠 디자인을 해보자.

⌘ links.css ( 위치: linkservice/client/src/css/links.css)

⌘ links.jsx ( 위치: linkservice/client/src/component/links.jsx)

---------------------------------------------------------------------------------------------------------

CSS을 위한 폴더를 만들고 links.css파일을 생성한다.

모든 CSS는 links.css에 넣어두었다.

link.css에 우선 link-container와 link-wrapper영역을 만들어주고,

.link-container {
    margin-bottom: 6px;
    cursor: move;
}
.link-wrapper {
    padding: 12px;
box-shadow: 0em 0em 0.1em #000000;
    border-radius: 10px;
}

link-show 영역에는 link image와 link name이 보여주도록 한다.

.link-show {
    display: flex;
    align-items: center;
}
.link-img {
    width: 40px;
    height: 40px;
    border-radius: 50%;
    object-fit: cover;
}
.link-title {
    flex-direction: column;
    margin-left: 10px;
min-width: 200px;
    width: 70%;
    font-weight: 600;
}

⌘ links.jsx에서 CSS을 import하고 CSS들을 적용해본다.

⎮결과화면

링크정보를 여러 개 등록해서 확인해 본다.

JSON 데이터 중 활용하지 않는 항목을 추가적으로 화면에 적용해보자.

⎮링크정보 걸기

link-show 부분에 onClick이벤트를 추가한다.

이젠 클릭하면 linkurl항목의 정보에 따라 페이지 이동이 된다.

⎮태그정보 표시

link-wrapper 부분에 tag 표시를 해보자.

태그는 여러 개가 있을 수 있으나, 여기서는 최대 3개까지만 입력이 가능(화면 제약사항) 하고,

태그의 구분자는 / 로 해서 구분한다. (예,  태그1/태그2/태그3 )

태그의 내용을 표시해준다.

태그 관련 css을 추가한다

.tag-container {
    display: flex;
    flex-wrap: nowrap;
}
.tag-row {
    flex-basis: 90px;
}
.tag-button {   
    flex-basis: 21%;
    height: 20px;
    border-radius: 6px;
    margin-right: 15px;
    text-align: center;
    font-size: 4px;
    color: rgb(218, 213, 213);
}
.tag-blue {
    background-color: rgb(82, 65, 234); 
}

마지막 태그는 제주도/귤/할인 여러 개로 되어 있기 때문에 분할을 해야 한다.

그리고 여러 개 태그도 각각 색상을 다르게 버튼을 만들어 보자.

tag button 색상을 다르게 하기 위해서 classList에 다른 색상을 담아 적용해보자.

참고로, 조금 다른 방식으로child component인 TagList(Props)을 만들어 렌더링을 하는 방식도 있다.

위 소스에서 누락된 게 하나 있다.

바로 tag 값이 없을 경우도 빈 항목에 tag-orange css가 적용되어 버린다.

그래서 tag값이 있을 경우만 렌더링 되도록 조건을 하나 더 줘서 해결한다.

!tag 을 or 조건으로 추가한다.

!tag || tag.split('/').map( (tag, index)=>

물론 child function인 TagList(Props)을 안하고,

LinkMain()에서 바로 렌더링을 해도 무방한다. 아래 같은 식으로 해도 결과는 같으니 소스 참고만 하길 바란다.

개발 소스 방식은 여러가지 방식이다. 뭐가 옳다, 그르다 을 판단하는 것은 맞지 않다. 단, 좀더 가독성과 Performance, 유지보수 등을 고려하여 회사기준 혹은 개발자들과 협업해서 코딩 기준에 맞춰서 개발하면 된다.

이젠, 색상관련 css를 추가하자.

.tag-orange {
    background-color: rgb(200, 173, 108);
}
.tag-grin {
    background-color: rgb(18, 161, 139); 
}

실제 복잡하다고 볼 수 있지만, 전체적으로 포맷만 이해한다면 다른 사이트를 구축하는데 많은 도움이 될 것으로 생각된다.

하지만, 여러가지 기능을 추가하면서 어려웠던 기억이 있어서 이제부터

TO-DO 리스트를 만들어 하나씩 완성해보자.

( 화면설계를 다시 한번 참고하길 바란다.)

다음편에는 링크서비스의 등록화면을 제작해보자.

1.1. 프로젝트 폴더 구조 및 환경설정

프로젝트 폴더 구조는 프론트엔드와 백엔드를 나누고자 client / server로 구분 한다.

⎮프로젝트 폴더 : linkserver/

       |-------- client ( React 구조)

       |-------- server ( Python구조 )

⎮프로젝트 폴더를 만들고  Client 환경과 Server 환경을 구성해 보겠다.

터미널을 열어서,

     > mkdir linkservice

     > cd linkservice

⎮프로젝트 폴더에서 react 환경으로 client 폴더 생성

     > npx create-react-app client

⎮프로젝트 폴더에서 python가상환경으로 server폴더 생성

     > python3 -m venv server

 ⎮프로젝트 폴더인 linkservice 아래에 client와 server환경이 구축되었다. 

 다음편에는  Python Flask로 API 제작을 해보자.

1.    개발 준비

1.1. 사전 준비 작업

백엔드(BACK-END) : Python, Flask, SQLAlchemy을 통해 RESTful API제작,

프론트엔드(FRONT-END) : React, Bootstrap, material ui 을 사용하여 page 제작

데이타베이스(DB) : PostgreSQL

1.2. 설치 프로그램

설치방법은 별도 설명하지 않으며, 필요시 검색하시면 많은 자료들이 나와 있다.

👀 백엔드(BACK-END)

· Python3.6.X ( 운영체제에 맞게 설치 )

다운로드 사이트 : https://www.python.org/downloads/

· POSTMAN

다운로드 사이트: https://www.getpostman.com/products

· PostgreSQL 최신버전( 운영체제에 맞게 설치 )

다운로드 사이트: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

· DBeaver Community 버전( 운영체제에 맞게 설치 )

다운로드 사이트: https://dbeaver.io/download/

 DBeaver는 DB툴이므로 다른 DB툴을 가지고 있으면 별도 설치 안 해도 된다.

👀 프론트엔드(FRONT-END)

· Node.js 와 NPM

다운로드 사이트 : https://nodejs.org/ko/download/

· NPX 설치 : 명령 프롬프트에서 실행> npm install npx -g

· Yarn 설치 : 명령 프롬프트에서 실행> npm install yarn -g

1.    개발 개요

IT기업을 퇴사 후 개발 공부를 시작하면서 어떤 프레임워크/라이브러리를 배울까 고민하면서 예전에 잠깐 공부했던 Angularjs을 다시 해볼까 했으나, 가장 인기 있는 프레임워크/라이브러리를 배우기로 마음 먹으면서React와 Python 개발을 진행했다.

다니던 회사는 JAVA의 위주의 MSA, 자체 프레임워크 솔류션등 사용하여, 최신 프레임워크/라이브러리를 배울 시간도 없었고, 과장급 이후 부터는 개발보다는 BA 역할만 하다 보니, 프레임워크/라이브러리를 새롭게 공부하는것이 어려움이 있었다.

본 내용은 약 2달간 React와 Python을 공부하면서 구축한 내용의 소스를 개발 단계부터 하나하나 따라 할수 있도록 공유하여 많은 분들과 나누고자 한다.

내용을 정리하다보니, 초보 혹은 첫 프로젝트 신입은 어려울 수 있을 것 같다는 생각이 든다.

소스 위주의 내용이므로, 소스내에 주석처리를 했다고 했으나, 많이 부족할 수도 있으며, 기본적인 개념은 알고 있다는 가정하에 진행되므로, 필요시 검색을 통해 추가적으로 공부를 하시는 것을 추천한다.

개발할 때 개념적인 설명만 하는 자료가 많아, 실제 운영되는 참고소스를 찾기가 어려운 경험이 있었고, 이런 경험을 초보 개발자들에게 조금이나마 도움을 주고자 모든 소스를 직접 구현하는것을 따라하면서 개발 경험을 익히기 바라는 마음에 앞으로 계속 여기에 기록을 남기면서 진행할 예정이다.

   ※ 최종 소스는 마지막 단계  or 중간단계에 git으로 공유할 예정이다.

1.1. 무엇을 만들 것인가?

개발 공부를 시작하면서 무작정 시작하는 것 보다 어떤 것을 만들지 목표를 정해서 공부를 하면 좋을 듯 하다.

요즘은 많은 인플루언스나 유투버 등 크리에이터 분들이 다양한 콘텐츠를 연결해주는 멀티링크 사이트들이 많이 사용한다.

멀티 링크 서비스는 인스타그램, 블로그, 마켓 등 여러가지 링크를 한곳에 등록해서 사용할 수 있다

     예) 링크트리(Linktree), 인포크링크(Inpock link), 링크믹스(Link Mix), 리틀리(litt.ly), 링크온(Linkon), 리트링크(Lit.Link) 등등

           약 20여개가 존재하는 것으로 알고 있다.

간단한 서비스인 만큼 사업 목적으로 개발이 아니므로, 멀티유저나 멀티컴퍼니 같은 서비스는 제외하고, 기본 기능과 사이트에 운영에 필요한 기능만 골라 링크서비스를 구현해 보고자 한다.

다음편은 간단한 설계를 진행하겠다.

※ 본 포스팅은 계속 수정될 수 있습니다.