말춘이의 블로그

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

Log 유틸은 콘솔에 현재시각과 스레드이름을 함께 출력하는 클래스이다. EventUtil 클래스 get_event 메소드는 xing 에서 제공하는 res파일을 기반으로 이벤트 객체를 생성해주는 메소드이다.

import datetime
import threading
import win32com
 
 
class Log:
 
    @staticmethod
    def write(msg):
        print("["+datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')+"]["+threading.currentThread().getName()+"] "+msg)
 
 
class EventUtil:
 
    @staticmethod
    def get_event(service_id, event_handler_class):
        event = win32com.client.DispatchWithEvents("XA_DataSet.XAReal", event_handler_class)
        event.ResFileName = "C:/eBEST/xingAPI/Res/" + service_id + ".res"
        event_handler_class.event = event
        return event

buycycle.name

[파이썬] eBest Xing api 실시간조회, 테스트 및 실행 화면 (8)

말춘이 — Sat, 22 Feb 2020 15:48:25 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

지금까지 구현된 모듈을 테스트해보겠다. ConnectionManager, NWS, S3_ 스레드들을 초기화하고 명령어를 넣는 작업을 해준다.

import time
 
from name_yalsooni.crawler_py.ebest.manager.connection import ConnectionManagerFactory
from name_yalsooni.crawler_py.ebest.realtime.query.nws import NWS
from name_yalsooni.crawler_py.ebest.realtime.query.s3 import S3
from name_yalsooni.crawler_py.ebest.util import Log
 
 
class RunnerRealTime:
 
    cm = None
 
    def execute(self):
        Log.write("Process Start Up..")
        Log.write("-- ConnectionManager Start --")
        self.cm = ConnectionManagerFactory.get_instance()
        self.cm.start()
 
        Log.write("-- [NWS] NEWS Start --")
        nws_event = NWS()
        nws_event.start()
 
        Log.write("-- [S3_] KOSPI Start --")
        s3_event = S3()
        s3_event.start()
 
        Log.write("-- Push Command --")
        # 뉴스 요청
        nws_command = dict()
        nws_command[nws_event.CM_NWCODE] = "NWS001"
        nws_event.call(nws_command)
 
        # GS건설 체결정보 요청
        s3_command = dict()
        s3_command[s3_event.CM_SHCODE] = "006360"
        s3_event.call(s3_command)
 
        # 10초 지연 후 APPEND 명령어
        time.sleep(10)
 
        # 현대건설 체결정보 요청
        s3_command[s3_event.CM_SHCODE] = "000720"
        s3_event.append_call(s3_command)
 
        while True:
            time.sleep(5)
 
 
def main():
    RunnerRealTime().execute()
 
 
if __name__ == "__main__":
    main()

- 실행 동영상

buycycle.name

[파이썬] eBest Xing api 실시간조회, S3_ 코스피체결 구현 (7)

말춘이 — Sat, 22 Feb 2020 15:46:32 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

S3_ 쿼리는 요청하는 종목코드에 대해 체결 내역 정보를 실시간으로 수신받을 수 있다.

from name_yalsooni.crawler_py.ebest.realtime.queryjob import EventHandler
from name_yalsooni.crawler_py.ebest.realtime.queryjob import QueryThreadJob
from name_yalsooni.crawler_py.ebest.util import Log, EventUtil
 
 
class S3EventHandler(EventHandler):
    def OnReceiveRealData(self, code):
        shcode = self.event.GetFieldData("OutBlock", "shcode")
        price = self.event.GetFieldData("OutBlock", "price")
        Log.write(code + " : " + shcode + " - " + price)
 
 
class S3(QueryThreadJob):
    _OP_APPEND = "APPEND"
    CM_SHCODE = "SHCODE"
 
    def __init__(self):
        QueryThreadJob.__init__(self, "RT_S3_KOSPI", 0.1)
 
    def _operation_init(self):
        self._operation_dict[self._OP_APPEND] = self._operation_append
 
    def _operation_call(self, command):
        self._event = EventUtil.get_event("S3_", S3EventHandler)
        self._event.SetFieldData("InBlock", "shcode", command[self.CM_SHCODE])
        self._event.AdviseRealData()
        Log.write("Request done : " + command[self.CM_SHCODE])
 
    def _operation_append(self, command):
        self._event.SetFieldData("InBlock", "shcode", command[self.CM_SHCODE])
        self._event.AdviseRealData()
        Log.write("Request done : " + command[self.CM_SHCODE])
 
    # push append command
    def append_call(self, command):
        command[self.CM_COMMAND] = self._OP_APPEND
        self._push_command(command)

- 7 Line : OnReceiveRealData
이베스트 서버로부터 응답이 수신되면 해당 메소드가 호출된다.
등록된 종목의 코드와 가격을 출력한다.

- 18 Line
생성자에서 스레드이름과 큐 타임아웃을 파라미터로 넘긴다.

- 20 Line : _operation_init
  뉴스 요청과 달리 코스피체결 요청은 기본 오퍼레이션에 종목을 추가할 수 있는 'APPEND' 오퍼레이션이 하나 더있다.
  기본 오퍼레이션인 'CALL'은 상위클래스인 QueryThreadJob에서 등록해주기 때문에 등록 과정은 필요없다.
  하지만 'APPEND'오퍼레이션은 _operation_init 메소드에서 _operation_dict 딕셔너리에 등록 해준다.

- 23 Line : _operation_call
코스피체결 요청에 필요한 파라미터를 설정하고 AdviseRealData 메소드를 통해 해당 쿼리를 요청한다.
이 메소드에서 요청할 수 있는 이벤트 객체를 생성하기 때문에 최초의 호출은 이 메소드부터 호출되어야 한다.

- 23 Line : _operation_append
코스피체결 요청은 다수의 종목을 등록할 수 있다. 오퍼레이션 'CALL'을 통해 요청된 상태에서 'APPEND'를 통해 다수의 종목을 등록한다.

buycycle.name

[파이썬] eBest Xing api 실시간조회, NWS 뉴스 요청 구현 (6)

말춘이 — Sat, 22 Feb 2020 15:44:58 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

NWS 쿼리는 요청 시 종료 전까지 최신 뉴스에 대한 정보를 수신받을 수 있다.

from name_yalsooni.crawler_py.ebest.realtime.queryjob import EventHandler
from name_yalsooni.crawler_py.ebest.realtime.queryjob import QueryThreadJob
from name_yalsooni.crawler_py.ebest.util import Log, EventUtil
 
 
class NWSEventHandler(EventHandler):
    def OnReceiveRealData(self, code):
        title = self.event.GetFieldData("OutBlock", "title")
        Log.write(code + " : " + title)
 
 
class NWS(QueryThreadJob):
    CM_NWCODE = "NWCODE"
 
    def __init__(self):
        QueryThreadJob.__init__(self, "RT_NWS", 0.5)
 
    def _operation_init(self):
        pass
 
    def _operation_call(self, command):
        self._event = EventUtil.get_event("NWS", NWSEventHandler)
        self._event.SetFieldData("InBlock", "nwcode", command[self.CM_NWCODE])
        self._event.AdviseRealData()

- 16 Line
생성자에서 스레드이름과 큐 타임아웃을 파라미터로 넘긴다.

- 19 Line
상위 클래스인 QueryThreadJob에서 operation 딕셔너리에 기본 오퍼레이션인 'CALL'은 등록해 줬다.
뉴스 요청의 오퍼레이션은 'CALL' 하나 밖에 없으므로 해당 메소드는 등록 해줄께 없다, pass한다.

- 21 Line : _operation_call
_operation_call 메소드에선 뉴스의 알맞은 요청 파라미터를 설정하고 AdviseRealData() 메소드를 통해 요청한다.
이벤트 객체 생성 시 등록된 NWSEventHandler의 OnReceiveRealData메소드의 의해 응답이 수신된다.

buycycle.name

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

말춘이 — Sat, 22 Feb 2020 15:34:18 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

QueryThreadJob은 모든 요청 쿼리들의 상위 클래스이다.
공통부분을 상위 클래스에서 정의, 구현함으로써 불필요한 중복 코드를 쉽게 제거할 수 있다. 또한 요청 쿼리에 대한 표준을 구축함으로써 생산성이 향상될 것이다. 이 클래스를 상속받는 요청 쿼리들은 각각의 스레드로 별도 동작한다. 뉴스정보와 코스피 체결 클래스를 구현할 것인데 이 클래스를 상속받아 구현하게 된다.

from abc import *
 
from name_yalsooni.crawler_py.ebest.definition import ThreadJob
from name_yalsooni.crawler_py.ebest.manager.connection import ConnectionManagerFactory
from name_yalsooni.crawler_py.ebest.util import Log
from name_yalsooni.crawler_py.ebest.xasession import XASessionEventHandler
 
 
class EventHandler:
    event = None
 
 
class QueryThreadJob(ThreadJob):
    __metaclass__ = ABCMeta
 
    _OP_CALL = "CALL"
 
    _event = None
    _thread_name = None
 
    _operation_dict = None
    _connection_manager = None
 
    @abstractmethod
    def _operation_init(self):
        pass
 
    @abstractmethod
    def _operation_call(self):
        pass
 
    def __init__(self, thread_name, command_queue_timeout):
        ThreadJob.__init__(self, thread_name, command_queue_timeout)
        self._thread_name = thread_name
        self._operation_dict = dict()
 
    def _init(self):
        Log.write(self._thread_name + " init..")
        self._connection_manager = ConnectionManagerFactory.get_instance()
 
        #기본 오퍼레이션 등록
        self._operation_dict[self._OP_CALL] = self._operation_call
        self._operation_init()
 
    def _execute(self, command):
        if not XASessionEventHandler.login_flag:
            self._connection_manager.login_call()
 
        try:
            operation = self._operation_dict[command[self.CM_COMMAND]]
            operation(command)
        except KeyError:
            Log.write("Not found operation key : " + command[self.CM_COMMAND])
 
    def _shutdown(self):
        self._event.UnadviseRealData()
 
    # push call command
    def call(self, command):
        command[self.CM_COMMAND] = self._OP_CALL
        self._push_command(command)

- 25, 29 Line
_operation_init, _operation_call 추상화 메소드를 선언한다.

- 42 Line
_operation_dict 딕셔너리에 오퍼레이션 객체를 보관한다.

- 50 Line
_operation_dict에서 명령어로 오퍼레이션 객체를 꺼낸다.
오퍼레이션 객체가 존재 하지 않으면 예외가 발생된다.

이제 QueryThreadJob클래스를 상속받아 구현하는 뉴스정보와 코스피 체결정보 클래스를 구현해보겠다.

buycycle.name

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

말춘이 — Sat, 22 Feb 2020 15:32:59 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

ConnectionManager 구현에 앞서 이베스트와 커넥션을 담당하는 XAConnector부터 구현하도록 하겠다.
XAConnector클래스는 이베스트에서 제공하는 API 중 커넥션과 로그인 관련 요청과 응답을 구현한 것이다. 프로세스가 기동 되면 ConnectionManager 스레드가 시작되며 XAConnector 참조하여 연결을 관리하는 역할을 한다.

import pythoncom
import win32com.client as win_client
 
from name_yalsooni.crawler_py.ebest.util import Log
 
 
class XASessionEventHandler:
    login_state = 0
    connect_state = 0
    login_flag = False
 
    def OnLogin(self, code, msg):
        if code == "0000":
            Log.write("login success")
            Log.write(str(msg))
            XASessionEventHandler.login_flag = True
            XASessionEventHandler.login_state = 1
            XASessionEventHandler.connect_state = 1
        else:
            Log.write("login fail")
            Log.write(str(msg))
            XASessionEventHandler.login_state = 2
 
    def OnDisconnect(self):
        XASessionEventHandler.login_flag = False
        XASessionEventHandler.login_state = 0
        XASessionEventHandler.connect_state = 0
        Log.write("Disconnect Server")
 
 
class XAConnector:
    __ebest_address = "hts.ebestsec.co.kr"
    __ebest_port = 20001
    __ebest_id = "이베스트 아이디"
    __ebest_pw = "이베스트 패스워드"
    __ebest_cpwd = "공인인증서 패스워드"
 
    __xa_session = None
 
    def connect_server(self):
        if self.__xa_session is None:
            self.__xa_session = win_client.DispatchWithEvents("XA_Session.XASession", XASessionEventHandler)
        return self.__xa_session.ConnectServer(self.__ebest_address, self.__ebest_port)
 
    def is_connected(self):
        if self.__xa_session is None:
            result = False
        else:
            result = self.__xa_session.IsConnected()
        return result
 
    def login(self):
        if not XASessionEventHandler.login_flag:
            self.__xa_session.Login(self.__ebest_id, self.__ebest_pw, self.__ebest_cpwd, 0, 0)
            while XASessionEventHandler.login_state == 0:
                pythoncom.PumpWaitingMessages()
        return XASessionEventHandler.login_flag
 
    def get_account_list(self):
        account_list = []
        account_ctn = self.__xa_session.GetAccountListCount()
 
        for i in range(account_ctn):
            account_num = self.__xa_session.GetAccountList(i)
            account_list.append(account_num)
        return account_list
 
    def disconnect_server(self):
        if XASessionEventHandler.login_flag:
            self.__xa_session.DisconnectServer()
            XASessionEventHandler.login_state = 0
            XASessionEventHandler.connect_state = 0

- 12 Line : OnLogin 메소드
이벤트 핸들러의 OnLogin 메소드는 로그인 요청에 대한 응답 이벤트이다.
code에 대한 값이 '0000'이면 로그인이 정상적으로 처리 됐다는 의미다.

- 24 Line : OnDisconnect 메소드
이벤트 핸들러의 OnDisconnect 메소드는 연결해제에 대한 응답 이벤트이다.

- 40 Line : connect_server 메소드
XA_Session.XASession 객체를 얻어와 이베스트서버에 커넥션을 연결한다.
연결이 완료되면 True값을 반환한다.

- 44 Line : is_connected 메소드
  현재 커넥션이 유효한 상태인지 확인할 수 있는 메소드이다.
  정상적인 커넥션이라면 True 값을 반환한다.
  각 쿼리들이 요청 전 해당커넥션이 유효한지 물을 때 사용된다.

- 51 Line : login 메소드
정상적으로 연결된 후 로그인을 요청할 수 있는 메소드이다.
파라미터 값으로 아이디, 패스워드, 공인인증서 패스워드가 입력되며 로그인에 대한 결과는 이벤트 핸들러의 OnLogin 메소드가 호출된다.

- 58 Line : get_account_list 메소드
로그인이 완료되면 자신의 계좌목록을 얻어 올 수 있다.

- 67 Line : disconnect_server 메소드
이베스트 서버와의 연결을 끊는다.

XAConnector클래스를 참조하는 ConnectionManager클래스를 구현해보도록 하겠다.
ConnectionManager의 객체는 하나만 두기 위해 ConnectionManagerFactory클래스에서 싱글톤으로 사용한다.

import threading
import time
 
from name_yalsooni.crawler_py.ebest.xasession import XAConnector
from name_yalsooni.crawler_py.ebest.xasession import XASessionEventHandler
from name_yalsooni.crawler_py.ebest.util import Log
from name_yalsooni.crawler_py.ebest.definition import ThreadJob
 
 
# 연결 관리
class ConnectionManager(ThreadJob):
 
    _CM_LOGIN = "LOGIN"
    _CM_LOGOUT = "LOGOUT"
 
    _xa_connector = None
    _login_result = None
 
    def __init__(self):
        ThreadJob.__init__(self, "ConnectionManager", 10)
        self.lock = threading.Lock()
 
    # 스레드 초기화
    def _init(self):
        Log.write("ConnectionManager init..")
        self._xa_connector = XAConnector()
 
    # 스레드 수행
    def _execute(self, command):
        with self.lock:
            if command[self.CM_COMMAND] == self._CM_LOGIN:
                self._xa_connect()
            elif command[self.CM_COMMAND] == self._CM_LOGOUT:
                self._xa_disconnect()
 
    # 스레드 종료
    def _shutdown(self):
        pass
 
    # 연결 하기
    def _xa_connect(self):
        if self._xa_connector.is_connected() is False:
            self._xa_connector.connect_server()
            self._login_result = self._xa_connector.login()
            # if self.__login_result:
                # account_list = self.__xa_connector.get_account_list()
                # for account in account_list:
                #     Log.write("account number : " + account)
 
        return self._login_result
 
    # 연결 해제
    def _xa_disconnect(self):
        self._xa_connector.disconnect_server()
 
    # 연결 응답 대기
    def _waiting_login(self):
        while XASessionEventHandler.login_state == 0:
            time.sleep(0.2)
 
    # 연결 해제 응답 대기
    def _waiting_logout(self):
        while XASessionEventHandler.login_state != 0:
            time.sleep(0.2)
 
    # 연결 요청
    def login_call(self):
        command = dict()
        command[self.CM_COMMAND] = self._CM_LOGIN
        self._push_command(command)
        self._waiting_login()
 
    # 연결 해제 요청
    def disconnect_call(self):
        command = dict()
        command[self.CM_COMMAND] = self._CM_LOGOUT
        self._push_command(command)
        self._waiting_logout()
 
 
class ConnectionManagerFactory:
 
    _connection_manager = ConnectionManager()
 
    @staticmethod
    def get_instance():
        return ConnectionManagerFactory._connection_manager

- 19 Line : __init__
앞서 구현된 ThreadJob 생성자를 확인하면,파라미터 값으로 스레드 이름과 Queue.get의 타임아웃 값을 넣어줘야 한다.
threading.Lock() 객체를 생성하는 이유는 로그인과 로그아웃 메소드의 순차처리를 위해서다.

- 26 Line
맨 위에서 구현된 XAConnector의 객체를 스레드 초기화 구문에서 생성한다.

- 67 Line : login_call 메소드
로그인 명령어를 큐에 삽입 후 _waiting_login 메소드를 통해 이벤트리스너가 수신받기 전까지 기다린다.

- 74 Line : disconnect_call 메소드
로그아웃 명령어를 큐에 삽입 후 _waiting_logout 메소드를 통해 이벤트리스너가 수신받기 전까지 기다린다.

- 86 Line : get_instance 메소드
ConnectionManager 객체를 싱글톤으로 사용한다.

이렇게 구현된 ConnectionManager는 모든 정보조회 요청의 상위 클래스인 QueryThreadJob에서 참조한다.
이제 QueryThreadJob과 이것을 상속받아 구현하는 요청 클래스들을 구현해보겠다.

buycycle.name

[파이썬] eBest Xing api 실시간조회, ThreadJob 구현 (3)

말춘이 — Sat, 22 Feb 2020 15:29:24 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

buycycle.name

2번째 글에서 언급했던 클래스 다이어그램을 기반으로 중추적 역할인 ThreadJob을 구현한 소스는 다음과 같다.

import threading
import queue
import pythoncom
 
from name_yalsooni.crawler_py.ebest.util import Log
from abc import *
 
 
# 병행처리기 - 추상화
class ThreadJob(threading.Thread):
    __metaclass__ = ABCMeta
 
    CM_COMMAND = "COMMAND"
    CM_SHUTDOWN = "SHUTDOWN"
 
    # 초기화
    @abstractmethod
    def _init(self):
        pass
 
    # 실행
    @abstractmethod
    def _execute(self, command):
        pass
 
    # 셧다운
    @abstractmethod
    def _shutdown(self):
        pass
 
    # 생성자
    def __init__(self, thread_name, command_queue_timeout):
        threading.Thread.__init__(self, name=thread_name)
        self.running = True
        self.commandQueue = queue.Queue()
        self.command_queue_timeout = command_queue_timeout
 
    # Thread start..
    def run(self):
        pythoncom.CoInitialize()
        self._init()
        self._waiting_queue()
 
    # 셧다운 명령어 요청
    def shutdown_call(self):
        self._push_command(self.CM_SHUTDOWN)
 
    # 명령어 대기
    def _waiting_queue(self):
        while self.running:
            try:
                command = self.commandQueue.get(True, self.command_queue_timeout)
            except queue.Empty as em:
                pythoncom.PumpWaitingMessages()
                continue
 
            Log.write("Request Command : " + command[self.CM_COMMAND])
            if command[self.CM_COMMAND] == self.CM_SHUTDOWN:
                self._shutdown()
                pythoncom.CoUninitialize()
            else:
                try:
                    self._execute(command)
                except Exception as ex:
                    Log.write("*EXCEPTION* EXECUTE COMMAND : " + str(ex))
 
    # 명령어를 큐에 삽입
    def _push_command(self, command):
        self.commandQueue.put(command)

위의 소스코드 중 주요 부분만 살펴보겠다.

- 32 Line
객체생성시 큐객체를 생성한다. 이 큐는 명령어를 보관하는데 사용한다.

- 39 Line : Thread.run 메소드
  새로운 스레드 생성시 pythoncom.CoInitialize() 메소드를 필수로 호출해야한다.
  _init 메소드는 상속받는 자식 클래스에게 구현을 위임한다.
  해당 메소드를 호출 후 _waiting_queue 메소드를 호출함으로 명령어 대기에 들어간다.

- 52 Line
  queue객체에서 get메소드를 사용하여 명령어를 획득한다.
  이 메소드는 블록이 가능하며, 지정된 타임아웃만큼 명령어를 대기한다.
  이 메소드에 타임아웃을 걸지 않을 경우 응답 이벤트의 수행시간이 없어 행에 걸리게 된다.

- 58 Line
  command는 딕셔너리 객체이다. 상수로 선언된 CM_COMMAND에 의해 해당 명령어를 수행한다.
  SHUTDOWN은 공통 명령어임으로 _shutdown 메소드가 호출되게 미리 정의하였다.
  그외의 명령어는 상속받아 _execute 메소드를 구현하게 될 하위클래스에게 전달한다.
  클래스다이어그램을 보면 ThreadJob을 상속받는 클래스는 QueryThreadJob, ConnectionManager가 있다.
  두 클래스의 _execute 구현로직은 다르다.

- 68 Line : _push_command 메소드
해당 메소드는 queue에 해당 명령어(딕셔너리)을 put 해주는 역할을 한다.
이 메소드를 사용하는 메소드는 45줄 처럼 정의된 명령어를 넣어준다.

다음으로 ThreadJob을 상속받아 구현하는 ConnectionManager, QueryThreadJob을 구현해보도록 하겠다.

buycycle.name

[파이썬] eBest Xing api 실시간조회, 스레드 설계 구현 (2)

말춘이 — Sat, 22 Feb 2020 15:25:58 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)

앞서 설계한 큰 그림을 기반으로 병행 실행의 기반이 될 추상화 클래스를 설계, 구현해보겠다.
스레드의 라이프사이클을 설계하고 구현하는 단계이다.

스레드 간의 연결고리로 많이 사용하는 방법이 ‘생산자-소비자 패턴’이라고 이전 포스트에서 언급했었다.
명령어를 제공하는 스레드를 생산자라 하면 이를 받아 수행하고 처리하는 스레드가 소비자이다. 이 소비자(스레드)의 시작은 초기화 메서드로 시작된다. 스레드가 생성되고 본격적으로 Queue에서 명령어를 꺼내기 전, 처리에 필요한 객체 생성, 리소스 생성 등 필요한 작업을 우선 실행한다. 이후 Queue를 지속적으로 열람하여 생산자로부터 들어온 명령어가 있는지 확인한다.

이를 액티비티 다이어그램으로 표현하면 아래와 같다.

1. Job 초기화
Queue에 들어온 명령어를 수행하기 앞서 필요한 명령어 수행에 필요한 객체를 생성하는 등을 할 수 있는 초기화 구문이다. 이 구문에서 win32com.client.DispatchWithEvents 함수를 이용하여 Xing API의 특정 객체를 얻어올 수 있다. 이 작업은 꼭 스레드의 시작 지점에서 이루어져야 한다.

2. 지속적인 Queue 확인
소비자 스레드가 명령어를 처리하기 위해 Queue에 들어온 명령어가 있는지 지속적으로 확인한다. 이때 queue.Queue().get() 함수를 통해 블록을 걸어야 하고 또한 타임아웃을 걸어야 한다. 그 이유는 Xing API 객체를 생성할 때 이벤트 리스너 클래스를 같이 등록하는데, 이 이벤트 리스너가 수행할 시간을 주기 위해서 queue.Queue().get() 함수에 블록만 걸지 말고 특정 시간 타임아웃도 같이 걸어줘야 한다. 만약 타임아웃을 걸지 않았을 경우 이벤트 리스너 클래스가 이벤트 수신 시 수행할 시간이 없긴 때문에 해당 이벤트에 행이 걸려버린다, 혹은 다음 명령어가 들어오기 전까지 수행되지 못할 것이다.

3. 명령어 수행
Queue에 들어온 명령어가 있을 경우 해당 명령어를 분기해서 알맞은 오퍼레이션을 수행한다.

4. SHUTDOWN 명령어 수행
라이프사이클에 중요한 부분 중 하나이다, 해당 스레드의 작업을 마감할 때 올바른 마감을 위해 해당 함수에 정의한다. 예를 들면 DBConnection close 등, 리소스의 올바른 해제 작업이 필요할 것이다.

이렇게 명령어 소비자의 라이프사이클을 설계하고 이를 기반으로 클래스 다이어그램을 그려보겠다.

ThreadJob 추상화 클래스를 기준으로 성격이 다른 ConnectionManager와 QueryJob을 분류하였다. 이베스트에게 요청 및 응답받을 QueryJob은 공통기능만 묶어뒀고 각각의 Query(NWS, S3_)는 QueryJob 추상화 클래스를 상속받아 세부 구현이 가능하게 설계하였다.

1) ThreadJob 주요 메서드
– _init() : 스레드 수행 시 최초 호출
– _execute() : 스레드 수행 메서드
– _shutdown() : 스레드 종료 시 호출
– _waiting_queue() : Queue에 명령어가 꺼내질 때까지 기다리는 메서드
– _push_command() : 명령어를 Queue 넣을 수 있는 메서드
– shutdown_call() : 스레드 종료 명령어를 큐에 담는 메서드

2) QueryThreadJob 주요 메서드
– _operation_init() : 명령어를 수행할 오퍼레이션 초기화
– _operation_call() : 오퍼레이션 호출 시 수행될 로직

3) ConnectionManager 주요 메서드
– _xa_connect() : 서버 연결
– _xa_disconnect() : 서버 연결 끊기
– waiting_login() : 로그인 대기 메서드 (블록)
– waiting_logout() : 로그아웃 대기 메서드 (블록)
– login_call() : 로그인 요청
– disconnect_call() : 서버 연결 끊기 요청

이렇게 설계된 다이어그램을 기반으로 ThreadJob부터 구현을 시작해 보겠다.

buycycle.name

[파이썬] eBest Xing api 실시간조회, 멀티스레드 설계 (1)

말춘이 — Sat, 22 Feb 2020 15:22:39 +0900

GitHub - malchooni/EBestAPI_Python: 파이썬 학습목적의 이베스트 API 구현

파이썬 학습목적의 이베스트 API 구현. Contribute to malchooni/EBestAPI_Python development by creating an account on GitHub.

github.com

[파이썬] eBest Xing api 실시간조회, ConnectionManager 구현 (4)

[파이썬] eBest Xing api 실시간조회, QueryThreadJob 구현 (5)