C# - eFriend Expert OCX 예제를 .NET Core/5+ Console App에서 사용하는 방법
예전에 eBEST나 키움 Open API를 실습해 봤으니,
eBEST XingAPI의 C# 래퍼 버전 - XingAPINet Nuget 패키지
; https://www.sysnet.pe.kr/2/0/12134
C# - 키움 Open API+ 사용 시 Registry 등록 없이 KHOpenAPI.ocx 사용하는 방법
; https://www.sysnet.pe.kr/2/0/12129
이번엔 ^^
한국 투자 증권의 "eFriend Expert"를 실습해 보겠습니다.
(다른 것들도 모두 그랬듯이) 사이트에서 OpenAPI 신청하고 관련 설치 파일을 다운로드한 후 실행하면 되는데, 재미있게도 2가지 방식을 지원합니다.
- OCX를 이용한 방식
- Web API를 이용한 방식
Web API 방식은 보통 우리가 알고 있는 Open API 사용 체계를 따르기 때문에 기존의 ActiveX 문제로부터 완전히 자유로운 방식입니다. 따라서, eBEST보다 훨씬 더 나은 개발 환경을 제공하게 됩니다.
그런데, 일단 오늘은 1번 방식만 ^^ 살펴보겠습니다. 이에 대해서는 배포하는 문서인 expert_manual.pdf 파일을 보면 대충 감을 잡을 수 있는데요, 기존의 다른 OCX 기반의 통신 체계와 유사합니다. eBEST와 약간 다른 점이 있다면, 우리가 만든 프로그램을 단독으로 실행해서는 안 되고, 업체 측에서 제공한 "eFriend Expert" 프로그램을 실행한 후 거기서 뜬 UI 창을 통해 미리 로그인을 해 둬야 한다는 점입니다. (사실, eBEST도 백그라운드에서는 업체 측의 프로그램이 떴던 걸로 기억납니다.)
그다음은 우리가 만든 프로그램을 (관리자 권한으로) 실행해야 하는 식인데요, 그럼 내부의 업체 측에서 제공한 OCX 컨트롤을 통해 "eFriend Expert"와 통신하면서 데이터를 주고받는 듯합니다. 즉, 실제 통신은 "eFriend Expert"가 하고 OCX는 단지 대행만 하는 식입니다. (자세하게 확인은 안 해봤습니다. 그럴 것이다...라는 가정입니다.)
플랫폼도 다른 것과 마찬가지로 x86만 지원합니다.
다양한 언어로 된 예제도 함께 배포하고 있는데요,
C# 예제도 있습니다. ^^ 그래서 Visual Studio에서 로딩해 곧바로 F5 키를 눌러 테스트할 수 있는 상황이어서 금방 분위기를 알 수 있게 됩니다.
자, 그럼 저는 동일한 코드를 만들자니 반복 작업에 불과하므로, 약간 색다르게 Console App으로 한번 ^^ 만들어 보겠습니다. 아마도 OCX의 동작을 보장하기 위해 Message Loop가 있어야 할 테니, 예전에 만들어 둔 코드로,
C# - Console 응용 프로그램에서 UI 스레드 구현 방법
; https://www.sysnet.pe.kr/2/0/12139
콘솔 동작을 테스트해 보겠습니다. 간단하게 Console App을 만들고, expert_CS_Sample.zip의 압축을 풀어 나온 ExpertTest 프로젝트의 빌드 디렉터리로부터 다음의 2개 파일을 복사해 참조를 추가합니다. (혹은, ActiveX OCX 파일을 참조 추가해도 되는데, 결국 그것도 아래의 2개 파일을 참조하는 것과 같습니다.)
- AxInterop.ITGExpertCtlLib.dll
- Interop.ITGExpertCtlLib.dll
코드는, 편의상 NuGet으로부터
CustomMessageLoop 패키지 참조 추가를 한 다음,
Install-Package CustomMessageLoop
프로젝트 설정을 다음과 같이 바꿔줍니다. (아래의 콘솔 프로젝트는 .NET 5를 대상으로 했지만, .NET 8까지 자유롭게 바꾸실 수 있습니다.)
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net5.0-windows</TargetFramework>
<Platform>x86</Platform>
<UseWindowsForms>true</UseWindowsForms>
<DisableWinExeOutputInference>true</DisableWinExeOutputInference>
<Platforms>x86</Platforms>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="CustomMessageLoop" Version="1.0.8" />
</ItemGroup>
<ItemGroup>
<Reference Include="AxInterop.ITGExpertCtlLib">
<HintPath>..\Lib\AxInterop.ITGExpertCtlLib.dll</HintPath>
</Reference>
<Reference Include="Interop.ITGExpertCtlLib">
<HintPath>..\Lib\Interop.ITGExpertCtlLib.dll</HintPath>
</Reference>
</ItemGroup>
</Project>
마지막으로, 계좌 번호만 확인하는 코드를 다음과 같이 테스트할 수 있습니다.
using CustomMessageLoop;
using System;
using System.Diagnostics;
namespace ConsoleApp1
{
class Program
{
private AxITGExpertCtlLib.AxITGExpertCtl axTR1;
[STAThread] // 반드시 Single-threaded apartment로 설정
static void Main(string[] args)
{
Program pg = new Program();
pg.Run();
}
private void Run()
{
using (MessageLoop mml = new MessageLoop())
{
mml.Loaded += Mml_Loaded;
mml.Closed += Mml_Closed;
mml.Run();
while (true)
{
string text = Console.ReadLine();
if (text == "q")
{
return;
}
}
}
}
private void Mml_Loaded(object sender, EventArgs e)
{
this.axTR1 = new AxITGExpertCtlLib.AxITGExpertCtl();
this.axTR1.CreateControl();
// 계좌 번호를 열거
for (short i = 0; i < axTR1.GetAccountCount(); i++)
{
String Account = (String)axTR1.GetAccount(i);
Console.WriteLine(Account);
}
bool isVTS = (bool)axTR1.IsVTS();
if (isVTS == false)
{
Console.WriteLine("*** 주의 사항: 운영 접속입니다. ***");
}
}
private void Mml_Closed(object sender, EventArgs e)
{
}
}
}
끝입니다. ^^ 실행하면
DisableWinExeOutputInference 옵션으로 인해 Windows Forms 설정이지만 콘솔 창이 하나 뜨고, axTR1.GetAccount 메서드 호출로 반환받은 계좌 번호들이 출력되는 것을 확인할 수 있습니다.
특이하게 Login 과정이 없는데요, 앞서 언급한 대로 그것은 업체 측의 프로그램을 실행해 두면서 로그인을 직접 거치기 때문에 생략된 것입니다. 따라서, 코드에서는 로그인이 된 상황을 가정하고 로직을 완성해 나가면 됩니다.
첨부 파일은 위의 예제를 실습한 것으로, 마치 템플릿처럼 사용해도 좋을 것입니다. ^^
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]