tomcat 을 활용하는 방법

Tomcat 서버 요청 로그와 디버깅 방법

1. 기본 로그 확인

Tomcat은 logs 디렉터리에 다양한 로그를 남깁니다. 요청 내역은 보통 Access Log에 기록됩니다.

  • Access 로그: localhost_access_log.YYYY-MM-DD.txt
  • Catalina 로그: 서버 동작 및 에러 관련 메시지
  • 실시간 모니터링: tail -f logs/localhost_access_log.*

2. 헤더와 바디까지 확인하기

Access Log만으로는 부족합니다. 요청의 HTTP Header와 Body Payload를 확인하려면 다음 방법을 사용합니다.

  • RequestDumperValve 설정
  • Filter 구현하여 HttpServletRequest에서 직접 읽기
  • 프록시 서버(Nginx, Apache)에서 로깅
  • 디버깅 툴 (Wireshark, Fiddler, Postman)

3. RequestDumperValve가 없을 때

대안으로는 Custom Filter와 RequestWrapper를 활용합니다.

Map<String, String[]> params = request.getParameterMap();
for (String key : params.keySet()) {
    System.out.println(key + " = " + Arrays.toString(params.get(key)));
}

4. HttpServletRequestWrapper 사용법

요청 바디를 캐싱하여 여러 번 읽을 수 있도록 만드는 클래스입니다.

public class CachedBodyHttpServletRequest extends HttpServletRequestWrapper {
    private byte[] cachedBody;

    public CachedBodyHttpServletRequest(HttpServletRequest request) throws IOException {
        super(request);
        InputStream requestInputStream = request.getInputStream();
        this.cachedBody = requestInputStream.readAllBytes(); // Java 9 이상
    }

    @Override
    public ServletInputStream getInputStream() {
        ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(this.cachedBody);
        return new ServletInputStream() {
            @Override
            public int read() {
                return byteArrayInputStream.read();
            }
            @Override
            public boolean isFinished() {
                return byteArrayInputStream.available() == 0;
            }
            @Override
            public boolean isReady() { return true; }
            @Override
            public void setReadListener(ReadListener readListener) {}
        };
    }

    @Override
    public BufferedReader getReader() {
        return new BufferedReader(new InputStreamReader(this.getInputStream()));
    }
}

5. JSON 요청 로깅 필터 예시

public class LoggingFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {

        HttpServletRequest httpRequest = (HttpServletRequest) request;
        CachedBodyHttpServletRequest wrappedRequest = new CachedBodyHttpServletRequest(httpRequest);

        // Content-Type 확인
        System.out.println("Content-Type: " + httpRequest.getContentType());

        // 요청 바디 출력
        String body = wrappedRequest.getReader().lines().collect(Collectors.joining("\n"));
        System.out.println("Request Body: " + body);

        // 파라미터 출력
        Map<String, String[]> params = wrappedRequest.getParameterMap();
        params.forEach((key, value) -> System.out.println(key + " = " + Arrays.toString(value)));

        chain.doFilter(wrappedRequest, response);
    }
}

6. 버전 관련 참고

  • InputStream.readAllBytes(): Java 9 이상에서 사용 가능
  • ReadListener: Servlet 3.1 (Java EE 7, Tomcat 8.0 이상)부터 지원

7. 필터 적용 문제 해결

필터가 적용되지 않는 경우는 보통 등록 문제입니다.

  • web.xml에 <filter>와 <filter-mapping> 확인
  • Spring Boot에서는 FilterRegistrationBean으로 등록
  • URL 매핑: /*로 지정해야 전체 요청에 적용
  • chain.doFilter() 호출 누락 여부 확인

마무리

Tomcat에서 요청 파라미터와 바디를 디버깅하려면 RequestWrapper + LoggingFilter 조합이 가장 일반적입니다. 운영 환경에서는 보안과 성능을 고려해 제한적으로 사용하는 것이 좋습니다.

반응형
============================================================
     Lotto AI - New Recommendations for Round #1236
============================================================

[ 추천 1 ] (신뢰도: 98.0%)
 > 추천 번호: (6, 7, 13, 15, 28, 38)
 > 주요 근거:
   - gap: 14.2%
   - moving_average: 12.2%
   - transition_score: 10.0%
 > 조합 특징: odd/even=3/3, sum=107, sum-profile=historical-edge, low-high-balance, overlap-minimized, collective-coverage-maximized
------------------------------------------------------------

[ 추천 2 ] (신뢰도: 55.5%)
 > 추천 번호: (3, 6, 19, 30, 31, 35)
 > 주요 근거:
   - gap: 14.1%
   - moving_average: 12.4%
   - transition_score: 10.5%
 > 조합 특징: odd/even=4/2, sum=124, sum-profile=historical-center, low-high-balance, overlap-minimized, collective-coverage-maximized
------------------------------------------------------------

[ 추천 3 ] (신뢰도: 50.0%)
 > 추천 번호: (3, 7, 15, 20, 35, 42)
 > 주요 근거:
   - gap: 14.3%
   - moving_average: 12.4%
   - transition_score: 10.2%
 > 조합 특징: odd/even=4/2, sum=122, sum-profile=historical-center, low-high-balance, overlap-minimized, collective-coverage-maximized
------------------------------------------------------------

[ 추천 4 ] (신뢰도: 50.0%)
 > 추천 번호: (1, 7, 24, 31, 35, 38)
 > 주요 근거:
   - gap: 14.9%
   - moving_average: 12.5%
   - recent_score: 9.9%
 > 조합 특징: odd/even=4/2, sum=136, sum-profile=historical-center, low-high-balance, overlap-minimized, collective-coverage-maximized
------------------------------------------------------------

[ 추천 5 ] (신뢰도: 50.0%)
 > 추천 번호: (1, 6, 15, 35, 37, 40)
 > 주요 근거:
   - gap: 15.4%
   - moving_average: 12.5%
   - recent_score: 10.2%
 > 조합 특징: odd/even=4/2, sum=134, sum-profile=historical-center, low-high-balance, overlap-minimized, collective-coverage-maximized
------------------------------------------------------------
반응형

<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8">
  <title>Oracle 유사도 검색 방법 정리</title>
  <style>
    body { font-family: Arial, sans-serif; line-height: 1.6; margin: 20px; }
    h1, h2, h3 { color: #2c3e50; }
    code { background: #f4f4f4; padding: 2px 4px; border-radius: 4px; }
    table { border-collapse: collapse; width: 100%; margin-top: 10px; }
    table, th, td { border: 1px solid #ccc; }
    th, td { padding: 8px; text-align: left; }
    th { background: #f9f9f9; }
  </style>
</head>
<body>

<h1>Oracle에서 유사도 검색 방법 정리</h1>

<h2>1. 문자열 기반 검색</h2>

<h3>LIKE 연산자</h3>
<ul>
  <li>패턴 매칭에 사용</li>
  <li><code>%</code> : 0개 이상의 문자 대체</li>
  <li><code>_</code> : 정확히 1개의 문자 대체</li>
</ul>
<pre><code>SELECT * FROM employees WHERE first_name LIKE '%ohn%';
</code></pre>
<p>→ "John", "Johnson" 등 포함된 결과 반환</p>

<h3>INSTR 함수</h3>
<ul>
  <li>특정 문자열 내에서 부분 문자열의 위치를 반환</li>
</ul>
<pre><code>SELECT INSTR('CORPORATE FLOOR', 'OR', 3) FROM dual;
</code></pre>

<hr>

<h2>2. PURGE 명령어</h2>

<h3>DROP TABLE ... PURGE</h3>
<p>테이블을 <strong>Recycle Bin</strong>에 남기지 않고 즉시 삭제</p>
<pre><code>DROP TABLE employees PURGE;
</code></pre>

<h3>PURGE RECYCLEBIN</h3>
<p>현재 사용자 스키마의 Recycle Bin 전체 비움</p>
<pre><code>PURGE RECYCLEBIN;
</code></pre>

<h3>PURGE DBA_RECYCLEBIN</h3>
<p>DBA 권한으로 데이터베이스 전체 Recycle Bin 비움</p>

<hr>

<h2>3. 글자 유사도 검색</h2>

<h3>기본 검색</h3>
<ul>
  <li>LIKE: 단순 패턴 매칭</li>
  <li>INSTR: 문자열 내 위치 반환</li>
</ul>

<h3>고급 검색 (문자열 유사도)</h3>
<p>Oracle 표준 DB에는 <code>FUZZY_MATCH</code> 함수가 없으며, 대신 <strong>UTL_MATCH 패키지</strong>를 사용해야 함.</p>

<h4>주요 함수</h4>
<ul>
  <li><strong>EDIT_DISTANCE</strong> (Levenshtein 거리 기반)</li>
</ul>
<pre><code>SELECT UTL_MATCH.EDIT_DISTANCE('Chris', 'Kris') FROM dual;
-- 결과: 2
</code></pre>

<ul>
  <li><strong>EDIT_SIMILARITY</strong> (0~100 점수 반환)</li>
</ul>
<pre><code>SELECT UTL_MATCH.EDIT_SIMILARITY('Chris', 'Kris') FROM dual;
-- 결과: 80
</code></pre>

<ul>
  <li><strong>JARO_WINKLER</strong> (발음/철자 유사성 기반)</li>
  <li><strong>JARO_WINKLER_SIMILARITY</strong> (유사도 점수 반환)</li>
</ul>

<hr>

<h2>4. 요약 비교</h2>

<table>
  <tr>
    <th>방법</th>
    <th>특징</th>
    <th>적합한 상황</th>
  </tr>
  <tr>
    <td>LIKE</td>
    <td>단순 패턴 매칭</td>
    <td>특정 문자열 포함 여부 확인</td>
  </tr>
  <tr>
    <td>INSTR</td>
    <td>문자열 내 위치 반환</td>
    <td>텍스트 분석, 위치 기반 검색</td>
  </tr>
  <tr>
    <td>UTL_MATCH</td>
    <td>Levenshtein, Jaro-Winkler 지원</td>
    <td>오타 교정, 고객 데이터 중복 제거</td>
  </tr>
  <tr>
    <td>PURGE</td>
    <td>Recycle Bin 비우기/즉시 삭제</td>
    <td>공간 확보, 불필요한 객체 제거</td>
  </tr>
</table>

<hr>

<h2>5. 결론</h2>
<ul>
  <li>단순 검색에는 <strong>LIKE/INSTR</strong> 활용</li>
  <li>철자 오류나 발음 유사성을 고려한 검색에는 <strong>UTL_MATCH 패키지</strong> 사용</li>
  <li><code>FUZZY_MATCH</code>는 표준 Oracle DB에는 없음 → 혼동 주의</li>
  <li>데이터 정제 및 중복 제거 작업에 유용</li>
</ul>

</body>
</html>

반응형

네이버 맛집 정보 수집 + 소형 AI JSON 변환 기획서

1. 목표

  • 키워드 성시경 맛집으로 네이버 검색을 수행한다.
  • 검색 결과 목록의 요약문이 아닌, 각 결과의 상세 링크 페이지를 순회한다.
  • 상세 페이지에서 맛집 관련 텍스트를 추출/정제한다.
  • 라즈베리파이에서 구동 가능한 소형 모델(Qwen GGUF)을 사용해 정보를 구조화하고, 최종적으로 JSON 스키마로 출력한다.

2. 현재 문제와 개선 방향

  • 현재 구현은 검색 결과 페이지의 snippet만 읽어서 정보 밀도가 낮다.
  • 개선안은 다음 2단계 수집으로 전환한다.
  1. 검색 결과 페이지에서 상세 링크 목록 수집
  2. 각 상세 링크 페이지 본문에서 텍스트 수집 후 AI 분석

3. 전체 처리 파이프라인

  1. 검색 요청
    • Query: 성시경 맛집
    • User-Agent 포함
  2. 상세 링크 추출
    • 네이버 검색 결과 DOM에서 외부/내부 상세 링크 URL 수집
    • 광고/쇼핑/중복 링크 제거
  3. 상세 페이지 크롤링
    • 링크별 HTML 요청
    • title, 본문 후보(article, main, 블로그 본문 영역 등) 추출
  4. 텍스트 정제
    • 공백/줄바꿈 정규화
    • 메뉴판/가격/주소/전화 패턴 우선 보존
    • 페이지별 길이 제한 (메모리 보호)
  5. AI 구조화
    • 소형 Qwen 모델로 스키마 기반 정보 추출
    • page 단위 1차 JSON 생성
  6. 통합/중복 제거
    • 상호명+주소 기준 유사 항목 병합
  7. 최종 출력
    • restaurants 배열 JSON으로 저장/출력

4. 권장 JSON 스키마

{
  "query": "성시경 맛집",
  "generated_at": "ISO-8601 datetime",
  "restaurants": [
    {
      "name": "상호명",
      "address": "주소",
      "contact": "연락처",
      "menus": ["메뉴1", "메뉴2"],
      "review_summary": "리뷰 요약",
      "source_url": "정보를 추출한 상세 페이지 URL"
    }
  ]
}

5. 라즈베리파이 소형 모델 전략

  • 우선 모델: Qwen/Qwen2.5-0.5B-Instruct-GGUF
  • 권장 파일: qwen2.5-0.5b-instruct-q4_k_m.gguf
  • 이유: 낮은 메모리 사용량, 구조화 추출 작업에 충분한 품질

추론 권장 설정(초안)

  • n_ctx: 1024~2048
  • n_threads: 라즈베리파이 CPU 코어 수 기반(예: 4)
  • temperature: 0.0 (형식 안정성 우선)
  • 출력 실패 시 재시도: 프롬프트에 “JSON만 출력” 강제 후 1회 재시도

6. Hugging Face에서 Qwen 모델 설치/다운로드

6.1 Python 패키지 설치

pip install --upgrade huggingface_hub llama-cpp-python requests beautifulsoup4

6.2 모델 다운로드 코드

from huggingface_hub import hf_hub_download

model_path = hf_hub_download(
    repo_id="Qwen/Qwen2.5-0.5B-Instruct-GGUF",
    filename="qwen2.5-0.5b-instruct-q4_k_m.gguf"
)
print(model_path)

6.3 모델 로드 예시

from llama_cpp import Llama

llm = Llama(
    model_path=model_path,
    n_ctx=1024,
    n_threads=4,
    verbose=False
)

7. 크롤링/분석 구현 포인트

  • 링크 수집 개수 제한: 예) 상위 10~20개 상세 링크
  • 요청 간 지연: 예) 0.5~1.0초(과도 요청 방지)
  • 타임아웃/실패 처리: 실패 링크는 스킵하고 로그 기록
  • 본문 선택자 다중 전략:
    • article, main, .se-main-container, #postViewArea 등 순차 시도
  • 페이지별 추출 결과를 먼저 JSON으로 저장(디버깅 용이)

8. 프롬프트 설계 방향

  • System Prompt:
    • “맛집 정보 추출기”
    • “설명문 금지, JSON만 출력”
    • “스키마 외 키 금지”
  • User Prompt:
    • 페이지 URL + 정제 텍스트 전달
    • 필드별 누락 허용 규칙(null 또는 "") 명시

9. 품질 기준(Definition of Done)

  • 상세 링크 기반으로 최소 N개(예: 5개 이상) 식당 후보가 JSON에 채워짐
  • JSON 파싱 100% 성공(실패 시 재시도 로직으로 보완)
  • 각 항목에 name 또는 address 중 최소 1개 이상 유효값 존재
  • source_url 추적 가능

10. 개발 단계 제안

  1. 링크 수집기 구현/검증
  2. 상세 페이지 본문 추출기 구현/검증
  3. Qwen JSON 추출 파이프라인 연결
  4. 병합/중복 제거 및 최종 JSON 생성
  5. 오류 처리/재시도/로그 보강

11. 주의사항

  • 사이트 이용정책/robots.txt/요청 빈도 제한을 준수한다.
  • 개인 정보 또는 민감 정보는 저장/출력하지 않는다.
  • 모델 출력은 신뢰도 한계가 있으므로 원문 URL 추적 필드를 유지한다.
반응형

Apps in Toss에서 사업자번호 조회 미니앱 만들기

미니앱

billcorea-saupja는 토스 앱 안에서 사업자등록번호의 상태와 진위 여부를 빠르게 확인할 수 있도록 만든 WebView 기반 미니앱입니다. 국세청 공공데이터포털의 사업자등록정보 진위확인 및 상태조회 서비스를 호출하고, 결과를 모바일 화면에 맞게 정리해서 보여주는 것이 핵심입니다.

이 글에서는 앱을 어떤 기준으로 기획했고, 어떤 단계로 개발했으며, 실제 구현에서 주의해야 할 점과 중요한 샘플 코드를 정리합니다.

개발 기획

문제 정의

사업자등록번호는 거래 전 확인, 세금계산서 발행 전 검증, 신규 거래처 등록 같은 업무에서 자주 필요합니다. 하지만 사용자가 별도 웹사이트를 열고 번호를 입력해 확인하는 과정은 모바일 환경에서 번거롭습니다.

이 앱의 목표는 다음과 같습니다.

  • 사업자등록번호 10자리만 입력하면 사업자 상태를 조회한다.
  • 사업자등록번호, 대표자명, 개업일자를 입력하면 진위 여부를 확인한다.
  • 토스 앱 안의 모바일 화면에서 입력, 조회, 결과 확인이 끊기지 않도록 구성한다.
  • 비게임 미니앱이므로 TDS Mobile 컴포넌트를 사용해 토스 UX와 맞춘다.

주요 기능

  1. 사업자등록 상태조회
    • 입력값: 사업자등록번호
    • 호출 API: POST /status
    • 결과: 사업자 상태, 과세 유형, 폐업일, 세금계산서 적용일 등
  2. 사업자등록정보 진위확인
    • 입력값: 사업자등록번호, 대표자 성명, 개업일자, 선택 상호
    • 호출 API: POST /validate
    • 결과: 일치/불일치 여부, 확인 메시지, 상태 정보
  3. 선택적 인앱 광고
    • VITE_AD_BANNER_ID가 있을 때만 토스 배너 광고를 표시한다.

기술 스택

프로젝트는 Apps in Toss WebView 기반으로 구성했습니다.

{
  "dependencies": {
    "@apps-in-toss/web-framework": "^2.10.4",
    "@toss/tds-mobile": "latest",
    "@toss/tds-mobile-ait": "latest",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }
}

개발과 빌드 명령은 다음과 같습니다.

npm run dev
npm run build
npm run deploy

단, 이 프로젝트의 개발 메모에는 "빌드 후 로컬 테스트는 진행하지 않기"라는 요청 사항이 있으므로, 실제 검증 방식은 배포/샌드박스 테스트 정책에 맞춰 조정해야 합니다.

개발 단계

1. Granite 설정

granite.config.ts에서 앱 이름, 브랜드 컬러, 아이콘, 개발 서버 설정을 정의합니다.

import { defineConfig } from "@apps-in-toss/web-framework/config";

export default defineConfig({
  appName: "billcorea-saupja",
  brand: {
    displayName: "사업자번호 조회",
    primaryColor: "#5e82fc",
    icon: "https://static.toss.im/appsintoss/42541/b8f231ae-24c9-4fff-8666-83227ae2a66e.png",
  },
  web: {
    host: "10.0.2.2",
    port: 5173,
    commands: {
      dev: "vite dev --host 0.0.0.0",
      build: "vite build",
    },
  },
  webViewProps: {
    type: "partner",
  },
  permissions: [],
  outdir: "dist",
});

현재 앱은 카메라, 위치, 앨범 같은 디바이스 권한을 쓰지 않으므로 permissions를 빈 배열로 둡니다. 권한은 필요할 때만 선언하는 것이 검수와 사용자 신뢰 측면에서 유리합니다.

2. TDS Provider 적용

TDS Mobile 컴포넌트가 앱 전체에서 동작하도록 최상위에 TDSMobileAITProvider를 적용합니다.

import { TDSMobileAITProvider } from "@toss/tds-mobile-ait";
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";

import config from "../granite.config.ts";
import App from "./App.tsx";
import "./index.css";

createRoot(document.getElementById("root")!).render(
  <StrictMode>
    <TDSMobileAITProvider brandPrimaryColor={config.brand.primaryColor}>
      <App />
    </TDSMobileAITProvider>
  </StrictMode>,
);

브랜드 기본 색상을 granite.config.ts의 primaryColor와 연결하면, 앱 설정과 UI 스타일의 기준을 한 곳에서 관리할 수 있습니다.

3. 입력값 정규화

국세청 API는 사업자등록번호와 날짜에 하이픈 같은 기호가 들어가면 실패할 수 있습니다. 그래서 입력 단계에서 숫자만 남기고 길이를 제한합니다.

function normalizeBusinessNumber(value: string) {
  return value.replace(/\D/g, "").slice(0, 10);
}

function normalizeDate(value: string) {
  return value.replace(/\D/g, "").slice(0, 8);
}

이 로직 덕분에 사용자는 123-45-67890처럼 입력해도 내부적으로는 1234567890만 API에 전달됩니다.

4. API 호출 공통화

/status와 /validate는 모두 같은 Base URL, 같은 인증키, 같은 POST JSON 호출 방식을 사용합니다. 따라서 공통 함수로 분리했습니다.

const API_BASE_URL = "https://api.odcloud.kr/api/nts-businessman/v1";
const SERVICE_KEY = import.meta.env.VITE_ENCRIPT_API_KEY;

async function requestPublicData<TResponse>(
  path: "/status" | "/validate",
  body: unknown,
) {
  if (SERVICE_KEY == null || SERVICE_KEY === "") {
    throw new Error(".env에 VITE_ENCRIPT_API_KEY를 설정해 주세요.");
  }

  const url = new URL(`${API_BASE_URL}${path}`);
  url.searchParams.set("serviceKey", SERVICE_KEY);
  url.searchParams.set("returnType", "JSON");

  const response = await fetch(url.toString(), {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Accept: "application/json",
    },
    body: JSON.stringify(body),
  });

  const data = await response.json().catch(() => null);

  if (!response.ok) {
    throw new Error("조회 중 오류가 발생했어요.");
  }

  if (data == null) {
    throw new Error("응답을 확인할 수 없어요.");
  }

  return data as TResponse;
}

중요한 점은 serviceKey와 returnType은 쿼리스트링으로 전달하고, b_no나 businesses 같은 요청 데이터는 JSON body로 전달해야 한다는 것입니다.

5. 상태조회 구현

상태조회는 사업자등록번호만 있으면 호출할 수 있습니다.

const result = await requestPublicData<StatusResponse>("/status", {
  b_no: [normalizedBusinessNumber],
});

setStatusResult(result);

응답의 대표적인 필드는 다음과 같습니다.

type BusinessStatus = {
  b_no: string;
  b_stt?: string;
  b_stt_cd?: string;
  tax_type?: string;
  tax_type_cd?: string;
  end_dt?: string;
  utcc_yn?: string;
  tax_type_change_dt?: string;
  invoice_apply_dt?: string;
  rbf_tax_type?: string;
  rbf_tax_type_cd?: string;
};

화면에서는 빈 값이 들어올 수 있으므로 -로 대체해 보여주는 처리를 넣었습니다.

function ResultItem({
  label,
  value,
}: {
  label: string;
  value?: string | null;
}) {
  return (
    <div className="result-item">
      <dt>{label}</dt>
      <dd>{value != null && value !== "" ? value : "-"}</dd>
    </div>
  );
}

6. 진위확인 구현

진위확인은 사업자등록번호 외에도 대표자명과 개업일자가 필요합니다.

const result = await requestPublicData<ValidateResponse>("/validate", {
  businesses: [
    {
      b_no: normalizedBusinessNumber,
      start_dt: normalizedStartDate,
      p_nm: ownerName.trim(),
      b_nm: businessName.trim(),
    },
  ],
});

setValidateResult(result);

진위확인 응답의 valid 값은 코드로 오기 때문에 화면에서는 사람이 읽을 수 있는 문구로 변환합니다.

function formatValidity(result: ValidationResult) {
  if (result.valid === "01") {
    return "일치";
  }

  if (result.valid === "02") {
    return "불일치";
  }

  return result.valid;
}

7. 제출 가능 조건 제어

불완전한 값으로 API를 호출하지 않도록 조회 버튼의 활성 조건을 명확히 나눴습니다.

const isStatusReady = normalizedBusinessNumber.length === 10;
const isValidateReady =
  normalizedBusinessNumber.length === 10 &&
  ownerName.trim().length > 0 &&
  normalizedStartDate.length === 8;

const canSubmit = menu === "status" ? isStatusReady : isValidateReady;

이렇게 하면 사용자가 필수값을 입력하기 전에는 버튼이 비활성화되고, API 오류도 줄어듭니다.

8. 토스 배너 광고 연동

광고 ID가 설정되어 있을 때만 배너를 붙이도록 만들었습니다.

const AD_BANNER_ID =
  (import.meta.env.VITE_AD_BANNER_ID as string | undefined)?.trim() ?? "";

{AD_BANNER_ID !== "" ? (
  <div className="lookup-ad-banner">
    <TossBannerAd adGroupId={AD_BANNER_ID} />
  </div>
) : null}

TossBannerAd 컴포넌트는 SDK가 제공하는 TossAds 객체가 있을 때만 초기화하고, 지원하지 않는 환경에서는 아무것도 렌더링하지 않습니다. 이 방식은 브라우저 개발 환경과 토스 앱 실행 환경의 차이를 흡수하는 데 도움이 됩니다.

참고 사항

공공데이터 API 호출 규칙

국세청 사업자등록정보 API는 다음 규칙을 지켜야 합니다.

  • GET이 아니라 POST로 호출한다.
  • serviceKey와 returnType은 URL querystring에 넣는다.
  • b_no, businesses 같은 조회 데이터는 JSON body에 넣는다.
  • 1회 호출당 최대 100개까지 조회할 수 있다.
  • 사업자등록번호는 숫자 10자리만 전달해야 한다.
  • 개업일자는 YYYYMMDD 형식으로 전달해야 한다.

현재 앱은 단건 조회 중심 UI이므로 100건 제한에는 걸리지 않지만, 추후 대량 조회 기능을 추가한다면 요청을 100건 단위로 나누는 처리가 필요합니다.

환경 변수

현재 구현은 다음 환경 변수를 사용합니다.

VITE_ENCRIPT_API_KEY=공공데이터포털_서비스키
VITE_AD_BANNER_ID=토스_배너_광고_ID

주의할 점은 코드에서 사용하는 이름이 VITE_ENCRIPT_API_KEY라는 것입니다. 문서나 메모에 VITE_ECNCRIPT_API_KEY처럼 다른 철자로 적혀 있으면 앱에서 값을 읽지 못합니다. .env.example, 배포 설정, 실제 코드의 변수명을 반드시 맞춰야 합니다.

TDS 사용

비게임 Apps in Toss 미니앱은 TDS를 사용하는 것이 중요합니다. 이 프로젝트는 @toss/tds-mobile의 Top, Button을 사용하고, 나머지 폼/결과 UI는 CSS로 모바일 화면에 맞게 정리했습니다.

주의 사항

1. API 키 노출 문제

Vite의 VITE_ 환경 변수는 프론트엔드 번들에 포함됩니다. 즉, 브라우저에서 확인 가능한 값입니다. 공공데이터포털 서비스키를 클라이언트에서 직접 호출하는 구조가 정책상 허용되는지 확인해야 합니다.

운영 보안 기준이 높거나 키 보호가 필요하다면 다음 구조가 더 적절합니다.

토스 미니앱 WebView
  -> 자체 백엔드 API
    -> 공공데이터포털 API

이렇게 하면 서비스키를 서버에만 보관할 수 있고, 호출량 제한, 로깅, 악용 방지, 장애 대응도 더 쉽게 할 수 있습니다.

2. 개인정보와 민감 정보 저장 금지

대표자명, 사업자등록번호, 개업일자는 업무상 중요한 정보입니다. 현재 앱은 입력값을 로컬 저장소에 저장하지 않는 구조라 단순 조회 도구로 적합합니다. 추후 조회 이력 기능을 추가한다면 저장 목적, 보관 기간, 삭제 방식, 개인정보 처리 기준을 먼저 정해야 합니다.

3. 진위확인의 입력값 정확도

진위확인은 입력값이 사업자등록증 정보와 정확히 맞아야 합니다. 특히 다음 항목은 사용자 안내가 필요합니다.

  • 대표자명은 사업자등록증의 표기와 같아야 한다.
  • 개업일자는 YYYYMMDD 형식이어야 한다.
  • 외국인 사업자, 공동대표, 상호 표기 등은 API 규칙의 영향을 받을 수 있다.

4. 결과 없음과 오류는 다르게 보여주기

사업자등록번호가 없거나 삭제된 정보인 경우, 네트워크 오류와는 다른 사용자 경험이 필요합니다. 현재 구현은 API 오류 메시지와 빈 결과 메시지를 구분합니다.

function EmptyResult() {
  return <p className="message">조회 결과가 없어요.</p>;
}

운영 단계에서는 "등록되지 않은 번호", "필수 항목 누락", "일시적인 조회 실패"를 더 세분화하면 문의를 줄일 수 있습니다.

5. 토스 앱 환경과 일반 브라우저 환경 차이

토스 SDK 기능은 일반 브라우저에서 항상 동작하지 않을 수 있습니다. 광고처럼 SDK 의존 기능은 isSupported와 객체 존재 여부를 확인한 뒤 실행하는 패턴이 좋습니다.

if (tossAds == null || tossAds.initialize.isSupported?.() === false) {
  return undefined;
}

중요 샘플 예제 코드

전체 조회 흐름 요약

async function handleSubmit(event: FormEvent<HTMLFormElement>) {
  event.preventDefault();

  if (!canSubmit) {
    setErrorMessage("필수 항목을 정확히 입력해 주세요.");
    return;
  }

  setLoading(true);
  setErrorMessage("");
  setStatusResult(null);
  setValidateResult(null);

  try {
    if (menu === "status") {
      const result = await requestPublicData<StatusResponse>("/status", {
        b_no: [normalizedBusinessNumber],
      });
      setStatusResult(result);
    } else {
      const result = await requestPublicData<ValidateResponse>("/validate", {
        businesses: [
          {
            b_no: normalizedBusinessNumber,
            start_dt: normalizedStartDate,
            p_nm: ownerName.trim(),
            b_nm: businessName.trim(),
          },
        ],
      });
      setValidateResult(result);
    }
  } catch (error) {
    setErrorMessage(
      error instanceof Error ? error.message : "조회 중 오류가 발생했어요.",
    );
  } finally {
    setLoading(false);
  }
}

상태 결과 렌더링

function BusinessStatusView({ status }: { status: BusinessStatus }) {
  return (
    <dl className="result-list">
      <ResultItem label="사업자등록번호" value={status.b_no} />
      <ResultItem label="사업자 상태" value={status.b_stt} />
      <ResultItem label="사업자 상태 코드" value={status.b_stt_cd} />
      <ResultItem label="과세 유형" value={status.tax_type} />
      <ResultItem label="과세 유형 코드" value={status.tax_type_cd} />
      <ResultItem label="폐업일" value={formatDate(status.end_dt)} />
      <ResultItem label="단위과세 전환 여부" value={status.utcc_yn} />
      <ResultItem
        label="과세 유형 전환일"
        value={formatDate(status.tax_type_change_dt)}
      />
      <ResultItem
        label="세금계산서 적용일"
        value={formatDate(status.invoice_apply_dt)}
      />
      <ResultItem label="직전 과세 유형" value={status.rbf_tax_type} />
    </dl>
  );
}

날짜 표시 변환

function formatDate(value?: string) {
  if (value == null || value.length !== 8) {
    return value;
  }

  return `${value.slice(0, 4)}.${value.slice(4, 6)}.${value.slice(6, 8)}`;
}

마무리

billcorea-saupja는 기능 범위가 크지는 않지만, Apps in Toss 미니앱 개발에서 자주 마주치는 요소를 잘 담고 있습니다. Granite 설정, TDS 적용, 공공 API 연동, 입력값 정규화, 환경 변수 관리, SDK 지원 여부 확인 같은 기본기가 모두 들어갑니다.

운영 수준으로 끌어올릴 때는 API 키 보호를 위한 백엔드 프록시, 오류 메시지 세분화, 접근성 점검, 샌드박스 테스트, 콘솔 검수 항목 확인을 추가하면 됩니다.

 

사용해보기

https://minion.toss.im/LPq8UT9n

 

토스 사업자안심

앱 설치 없이 쓰는 토스 미니앱

og.toss.im

 

반응형

 

Python으로 파일에서 특정 단어 찾기와 치환하기

텍스트 파일을 다루다 보면 특정 단어를 찾아서 바꾸거나, 몇 번 등장했는지 세거나, 위치까지 확인해야 할 때가 있습니다. 이 글에서는 Python의 re 모듈과 문자열 메서드를 활용해 그 방법을 정리합니다.

1. 특정 단어 치환하기

import re

replace_dict = {
    "dog": "cat",
    "hello": "hi"
}

with open("input.txt", "r", encoding="utf-8") as f:
    content = f.read()

for old, new in replace_dict.items():
    pattern = r"\b" + re.escape(old) + r"\b"
    content = re.sub(pattern, new, content)

with open("output.txt", "w", encoding="utf-8") as f:
    f.write(content)

\b는 단어 경계를 의미하므로 정확히 일치하는 단어만 치환됩니다.

2. 특정 단어 개수 세기

text = "hello world, hello python, hello AI"
word = "hello"

count = text.count(word)  # 부분 문자열 기준
print(count)  # 3

# 단어 단위로 정확히 세기
pattern = r"\b" + re.escape(word) + r"\b"
matches = re.findall(pattern, text)
print(len(matches))  # 3

3. 접두어가 포함된 단어 추출하기

text = "aaa.ccdh bbb.tttjj ccc.kkk aaa.zzz bbb.123"
prefixes = ["aaa.", "bbb."]

pattern = r"(?:aaa\.|bbb\.)\w+"
matches = re.findall(pattern, text)

print(matches)
# ['aaa.ccdh', 'bbb.tttjj', 'aaa.zzz', 'bbb.123']

4. 파일에서 찾기

with open("input.txt", "r", encoding="utf-8") as f:
    content = f.read()

pattern = r"(?:aaa\.|bbb\.)\w+"
matches = re.findall(pattern, content)

if matches:
    print("찾은 단어들:", matches)
else:
    print("패턴에 맞는 단어가 없습니다.")

5. 위치까지 확인하기

for match in re.finditer(pattern, content):
    print("찾은 단어:", match.group())
    print("시작 위치:", match.start())
    print("끝 위치:", match.end())

이렇게 하면 단어가 어디서 발견되었는지 인덱스까지 알 수 있습니다.

마무리

Python의 re 모듈을 활용하면 단순 치환부터 단어 개수 세기, 위치 추적까지 다양하게 처리할 수 있습니다. 텍스트 데이터 전처리나 로그 분석에 매우 유용하게 활용할 수 있으니 꼭 익혀두세요!

반응형

공공데이터포털의 개발계정 상세보기 화면으로, 국세청 사업자등록정보 진위확인 및 상태조회 API에 대한 설명이 담겨 있습니다. 핵심 내용을 요약하면 다음과 같습니다:

📌 기본 정보

  • 데이터명: 국세청 사업자등록정보 진위확인 및 상태조회 서비스
  • 서비스 유형: REST API
  • 호출 제한: 하루 1,000,000회
  • 데이터 포맷: JSON, XML 지원
  • Base URL: https://api.odcloud.kr/api/nts-businessman/v1
  • Swagger 문서: 제공됨 (API 명세 확인 가능)

⚙️ 주요 기능

  1. 사업자등록정보 진위확인 API (POST /validate)
    • 사업자등록번호, 대표자 성명, 개업일자 등 필수 항목 입력 필요
    • 외국인 사업자의 경우 영문명/한글명 입력 규칙 존재
    • 응답: 사업자등록정보의 진위 여부 반환
  2. 사업자등록 상태조회 API (POST /status)
    • 사업자등록번호(10자리 숫자) 필수
    • 응답: 등록 상태(정상, 말소, 미등록 등) 반환

📑 요청/응답 규칙

  • Request:
    • serviceKey와 returnType은 URL querystring에 포함
    • 사업자번호(b_no) 등은 JSON body에 포함
    • 최대 100개 사업자번호까지 한 번에 조회 가능
  • Response:
    • JSON 또는 XML 형식
    • 오류 발생 시 status code (400, 411, 413, 500)와 에러 메시지 반환

🚨 주의사항

  • POST 방식만 지원 (GET 불가)
  • 사업자등록번호는 반드시 숫자 10자리, - 제거 후 입력
  • 개업일자는 YYYYMMDD 형식으로 입력
  • 삭제된 사업자등록정보는 조회 불가
  • 100개 초과 요청 시 Too Large Request Error 발생

📖 활용 목적

  • 앱 개발 (모바일, 솔루션 등)
  • Toss 미니앱에서 사업자번호 조회 서비스 제공 가능

즉, 이 API는 사업자등록번호의 진위 여부와 상태를 확인하는 서비스로, Toss 미니앱에서 사업자번호 검증 기능을 구현할 때 바로 활용할 수 있습니다.

반응형

SQLite 튜토리얼: Oracle 개발자를 위한 핵심 차이점 정리

sqlite

 

SQLite는 가볍고 단순한 구조 덕분에 다양한 환경에서 널리 쓰입니다. 하지만 Oracle SQL에 익숙한 개발자라면 몇 가지 문법 차이 때문에 혼란스러울 수 있습니다. 이번 튜토리얼에서는 WITH 절, DECODE 함수, ROWNUM, 버전 확인, OUTER JOIN을 중심으로 살펴봅니다.

1. WITH 절 (CTE)

SQLite에서도 공통 테이블 표현식(CTE)를 지원합니다.

sql
WITH recent_orders AS (
  SELECT *
  FROM orders
  WHERE order_date > '2026-01-01'
)
SELECT customer_id, COUNT(*)
FROM recent_orders
GROUP BY customer_id;

👉 Oracle과 거의 동일하게 사용할 수 있습니다.

2. DECODE 함수 대체

Oracle의 DECODE는 SQLite에 없습니다. 대신 CASE 문을 사용하세요.

sql
SELECT 
  CASE status
    WHEN 'A' THEN 'Active'
    WHEN 'I' THEN 'Inactive'
    ELSE 'Unknown'
  END AS status_text
FROM users;

👉 CASE 문이 더 범용적이고 가독성도 좋습니다.

3. ROWNUM 대신 쓰는 방법

SQLite에는 ROWNUM이 없습니다. 대신 두 가지 방법을 씁니다.

(1) LIMIT / OFFSET

sql
SELECT *
FROM users
LIMIT 10 OFFSET 20;  -- 21번째 행부터 10개

(2) ROW_NUMBER() 윈도우 함수

sql
SELECT ROW_NUMBER() OVER (ORDER BY id) AS rn, name
FROM users;

👉 SQLite 3.25.0 이상에서 지원됩니다.

4. SQLite 버전 확인

버전 확인은 간단합니다.

  • SQL 쿼리:
  • sql
    SELECT sqlite_version();
    
  • CLI:
  • bash
    sqlite3 --version
    
  • Python:
  • python
    import sqlite3
    print(sqlite3.sqlite_version)
    

5. OUTER JOIN

SQLite는 LEFT OUTER JOIN만 지원합니다.

sql
SELECT u.id, u.name, o.order_date
FROM users u
LEFT OUTER JOIN orders o
  ON u.id = o.user_id;
  • RIGHT OUTER JOIN → 테이블 순서를 바꿔서 LEFT JOIN으로 대체
  • FULL OUTER JOIN → LEFT JOIN과 RIGHT JOIN을 UNION으로 합쳐서 구현

마무리

Oracle에서 SQLite로 넘어올 때 가장 많이 부딪히는 차이점들을 정리했습니다.

  • WITH 절은 그대로 사용 가능
  • DECODE는 CASE로 대체
  • ROWNUM은 LIMIT/OFFSET 또는 ROW_NUMBER()
  • 버전 확인은 sqlite_version()
  • OUTER JOIN은 LEFT만 지원, FULL은 UNION으로 구현

👉 이 튜토리얼을 따라가면 Oracle 개발자도 SQLite 환경에서 빠르게 적응할 수 있습니다.

반응형

오늘은

우편번호 검색 페이지 무한정 호출해 보기 예제 수정편 입니다. 

 

주소검색 페이지 예제

 

일상적인 업무에서 주소 검색은 언제든 진행 되어야 합니다.  다만, API 을 사용하게 되면 역시나, 비용 발생이 되는 관계로

다가 무한정 호출 가능한 우편번호/주소 검색 기능을 구현하기 위해... 카카오가 제공하는 주소 검색 스크립트을 이용하는 방법을 

정리해 보려고 합니다. 

 

예전 버전을 적용해 사용했던 기억이 있지만, 현재는 해당 기능도 업데이트 되어 수정이 필요 했습니다.   

https://postcode.map.kakao.com/guide

 

Kakao 우편번호 서비스

우편번호 검색과 도로명 주소 입력 기능을 너무 간단하게 적용할 수 있는 방법. Kakao 우편번호 서비스를 이용해보세요. 어느 사이트에서나 무료로 제약없이 사용 가능하답니다.

postcode.map.kakao.com

위 페이지에 기술된 내용을 참고 했습니다. 

 

 

아래 스크립트 부분은 blogger.com 의 페이지에서 사용할 수 있게 추가한 부분 입니다. html 코드을 지원하는 블로그 페이지는 어디든 지원이 될 것으로 판단 됩니다.

<!--카카오 우편번호 서비스 불러오기-->
<script src="//t1.kakaocdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>

<!--주소검색 버튼과 결과 표시 영역-->
<button onclick="execDaumPostcode()">주소 검색</button>
<div id="result"></div>

<script>
  function execDaumPostcode() {
    new kakao.Postcode({
      oncomplete: function(data) {
        // 선택된 주소 정보 표시
        const roadAddr = data.roadAddress;   // 도로명 주소
        const jibunAddr = data.jibunAddress; // 지번 주소
        const zonecode = data.zonecode;      // 우편번호
        const address = data.roadAddress || data.address ;

        document.getElementById("result").innerHTML =
          "<p><b>도로명 주소:</b> " + roadAddr + "</p>" +
          "<p><b>지번 주소:</b> " + jibunAddr + "</p>" +
          "<p><b>우편번호:</b> " + zonecode + "</p>";
       // 이 부분은 안드로이드 에서 참조 하도록 하기 위함이라 web 에서는 에러 발생됨
        window.Android.processDATA(address)
      }
    }).open();
  }
</script>

 

 

아래 코드는 kotlin 코드로 작성된 주소 검색 페이지 activity 입니다.  이 페이지의 기능은 주소검색 script 을 androidview 로 호출하고, 결과을 받아 원래 호출 했던 위치로 return 해 주는 기능만 존재 합니다.

import android.annotation.SuppressLint
import android.content.Intent
import android.os.Bundle
import android.util.Log
import android.os.Message
import android.net.Uri
import android.webkit.JavascriptInterface
import android.webkit.WebChromeClient
import android.webkit.WebResourceRequest
import android.webkit.WebView
import android.webkit.WebViewClient
import android.widget.FrameLayout
import androidx.activity.ComponentActivity
import androidx.activity.compose.BackHandler
import androidx.activity.compose.setContent
import androidx.appcompat.app.AppCompatActivity
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.wrapContentHeight
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Close
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.Scaffold
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.em
import androidx.compose.ui.viewinterop.AndroidView
import com.billcoreatech.multichat416.R
import com.billcoreatech.multichat416.ui.theme.Multichat416Theme
import com.billcoreatech.multichat416.ui.theme.appColorScheme
import com.billcoreatech.multichat416.ui.theme.appTypography

class AddressFindActivity : ComponentActivity() {

    inner class MyJavaScriptInterface {

        @JavascriptInterface
        fun processDATA(data: String?) {
            returnAddress(data)
        }

        @JavascriptInterface
        fun postMessage(data: String?) {
            returnAddress(data)
        }
    }

    fun returnAddress(data: String?) {
        Log.e("TAG", "returnAddress ${data}")

        val intent = Intent()
        intent.putExtra("data", data)
        setResult(AppCompatActivity.RESULT_OK, intent)
        finish()
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            Multichat416Theme(dynamicColor = true) {
                // A surface container using the 'background' color from the theme
                Surface(
                    modifier = Modifier.fillMaxSize(),
                ) {
                    Scaffold(
                        modifier = Modifier
                            .fillMaxSize()
                            .padding(top = 20.dp), topBar = {
                            Row(
                                modifier = Modifier
                                    .fillMaxWidth()
                                    .padding(5.dp),
                                horizontalArrangement = Arrangement.Start,
                                verticalAlignment = Alignment.CenterVertically
                            ) {
                                IconButton(onClick = {
                                    Log.e("", "backArrow")
                                    finish()
                                }) {
                                    Icon(
                                        imageVector = Icons.Default.Close,
                                        contentDescription = "Close"
                                    )
                                }
                                Spacer(modifier = Modifier.padding(5.dp))
                                Text(
                                    text = stringResource(R.string.foundAddress),
                                    color = appColorScheme.primary,
                                    lineHeight = 1.33.em,
                                    style = appTypography.titleLarge,
                                    modifier = Modifier
                                        .fillMaxWidth()
                                        .wrapContentHeight(align = Alignment.CenterVertically)
                                )
                            }
                        }, bottomBar = {

                        }
                    ) { innerPadding ->
                        Column(modifier = Modifier.padding(innerPadding).fillMaxSize()) {

                            WebViewForAddress(this@AddressFindActivity,
                                doFinish = {
                                    val intent = Intent()
                                    setResult(AppCompatActivity.RESULT_CANCELED, intent)
                                    finish()
                                },
                            )
                        }
                    }
                }
            }
        }
    }
}

@SuppressLint("JavascriptInterface", "SetJavaScriptEnabled")
@Composable
fun WebViewForAddress(addressFindActivity: AddressFindActivity, doFinish:() -> Unit) {

    val blogspot = "https://billcoreatech.blogspot.com/2026/06/blog-post_480.html"; // "https://billcoreatech.blogspot.com/2022/06/blog-post.html"

    var webViewContainer by remember { mutableStateOf<FrameLayout?>(null) }
    var mainWebView by remember { mutableStateOf<WebView?>(null) }
    var webView by remember { mutableStateOf<WebView?>(null) }
    var canGoBack by remember { mutableStateOf(false) }
    var isPostcodeRequested by remember { mutableStateOf(false) }

    AndroidView(
        modifier = Modifier.fillMaxSize(),
        factory = { context ->
            val container = FrameLayout(context)
            webViewContainer = container

            fun WebView.configureForAddressSearch() {
                settings.run {
                    javaScriptEnabled = true
                    domStorageEnabled = true
                    javaScriptCanOpenWindowsAutomatically = true
                    setSupportMultipleWindows(true)
                }
                val javascriptInterface = addressFindActivity.MyJavaScriptInterface()
                addJavascriptInterface(javascriptInterface, "Android")
                addJavascriptInterface(javascriptInterface, "android")
                addJavascriptInterface(javascriptInterface, "ReactNativeWebView")
                webViewClient = object : WebViewClient() {
                    override fun shouldOverrideUrlLoading(
                        view: WebView,
                        request: WebResourceRequest
                    ): Boolean {
                        return handleAddressCallbackUrl(
                            url = request.url,
                            addressFindActivity = addressFindActivity
                        )
                    }

                    override fun onPageFinished(view: WebView, url: String?) {
                        canGoBack = view.canGoBack()
                        if (!isPostcodeRequested) {
                            isPostcodeRequested = true
                            view.evaluateJavascript("execDaumPostcode();", null)
                        }
                    }
                }
                webChromeClient = object : WebChromeClient() {
                    override fun onCreateWindow(
                        view: WebView,
                        isDialog: Boolean,
                        isUserGesture: Boolean,
                        resultMsg: Message
                    ): Boolean {
                        val popupWebView = WebView(view.context).apply {
                            configureForAddressSearch()
                            webChromeClient = object : WebChromeClient() {
                                override fun onCloseWindow(window: WebView) {
                                    container.removeView(window)
                                    window.destroy()
                                    webView = view
                                    canGoBack = view.canGoBack()
                                }
                            }
                        }

                        container.addView(
                            popupWebView,
                            FrameLayout.LayoutParams(
                                FrameLayout.LayoutParams.MATCH_PARENT,
                                FrameLayout.LayoutParams.MATCH_PARENT
                            )
                        )

                        webView = popupWebView
                        val transport = resultMsg.obj as WebView.WebViewTransport
                        transport.webView = popupWebView
                        resultMsg.sendToTarget()
                        return true
                    }
                }
            }

            WebView(context).apply {
                configureForAddressSearch()
                loadUrl(blogspot, emptyMap())
                mainWebView = this
                webView = this
                container.addView(
                    this,
                    FrameLayout.LayoutParams(
                        FrameLayout.LayoutParams.MATCH_PARENT,
                        FrameLayout.LayoutParams.MATCH_PARENT
                    )
                )
            }
            container
        },
        update = {
            canGoBack = webView?.canGoBack() == true
        },
    )

    BackHandler(enabled = true) {
        val view = webView
        if (view != null && canGoBack) {
            view.goBack()
        } else if (view != null && view !== mainWebView) {
            webViewContainer?.removeView(view)
            view.destroy()
            webView = mainWebView
            canGoBack = mainWebView?.canGoBack() == true
        } else {
            doFinish()
        }
    }

    DisposableEffect(Unit) {
        onDispose {
            webViewContainer?.let { container ->
                for (index in container.childCount - 1 downTo 0) {
                    (container.getChildAt(index) as? WebView)?.destroy()
                }
                container.removeAllViews()
            }
            mainWebView = null
            webView = null
            webViewContainer = null
        }
    }
}

private fun handleAddressCallbackUrl(
    url: Uri,
    addressFindActivity: AddressFindActivity
): Boolean {
    if (url.scheme != "multichat416" || url.host != "address") {
        return false
    }

    val data = url.getQueryParameter("data").orEmpty()
    addressFindActivity.returnAddress(data)
    return true
}​

 

코드 사용 예제는 훗날 추가해 보겠습니다.  개발을 마무리 하고 나서.

반응형

Android · Firebase Auth · Naver Login

NaverIdLoginSDK에서 NidOAuth로 네이버 로그인 연동 수정하기

네이버 OAuth SDK 5.11.2 기준으로 deprecated 된 NaverIdLoginSDK 사용 코드를 NidOAuth 기반 호출로 교체하고, access token 검증 로직을 추가한 작업 내용을 정리한다.

수정 파일: MainActivity.kt SDK: com.navercorp.nid:oauth 5.11.2 빌드 검증: assembleDebug 성공

수정 배경

프로젝트 빌드 과정에서 네이버 로그인 연동부에 대해 다음과 같은 deprecation warning이 발생했다. 핵심은 NaverIdLoginSDK 클래스와 그 하위 메서드들이 이후 버전에서 제거될 예정이며, 새 API인 NidOAuth를 사용해야 한다는 점이다.

w: 'object NaverIdLoginSDK : Any' is deprecated.
This class will be removed from v6.1.0. Use NidOAuth instead.

w: 'fun getAccessToken(): String?' is deprecated.
Use NidOAuth.getAccessToken instead.

w: 'fun initialize(...)' is deprecated.
Use NidOAuth.initialize(...) instead.

w: 'fun authenticate(...)' is deprecated.
Use NidOAuth.requestLogin(...) instead.

기존 코드는 동작은 가능하지만, SDK 6.1.0 이후에는 제거될 수 있는 wrapper API에 의존하고 있었다. 따라서 네이버 SDK가 안내하는 대체 객체인 NidOAuth로 직접 호출하도록 변경했다.

Import 교체

가장 먼저 import 대상을 교체했다. 기존에는 deprecated wrapper인 com.navercorp.nid.NaverIdLoginSDK를 import하고 있었다.

변경 전

import com.navercorp.nid.NaverIdLoginSDK

변경 후

import com.navercorp.nid.NidOAuth
핵심: NaverIdLoginSDK는 내부적으로 NidOAuth를 감싼 deprecated wrapper다. 따라서 기능을 새로 구현한 것이 아니라, 같은 SDK의 최신 권장 진입점으로 호출 대상을 옮긴 것이다.

API 교체 매핑

이번 수정에서 바뀐 네이버 로그인 API 호출은 다음과 같다.

구분 변경 전 변경 후
SDK 초기화 NaverIdLoginSDK.initialize(...) NidOAuth.initialize(...)
로그인 요청 NaverIdLoginSDK.authenticate(...) NidOAuth.requestLogin(...)
access token 조회 NaverIdLoginSDK.getAccessToken() NidOAuth.getAccessToken()
마지막 오류 코드 조회 NaverIdLoginSDK.getLastErrorCode() NidOAuth.getLastErrorCode()
마지막 오류 설명 조회 NaverIdLoginSDK.getLastErrorDescription() NidOAuth.getLastErrorDescription()

로그인 요청 코드 비교

네이버 로그인 시작 함수인 doNaverLogin()은 초기화와 로그인 요청을 순서대로 수행한다. 기존 코드에서는 두 단계 모두 NaverIdLoginSDK를 통해 호출했다.

변경 전

private fun doNaverLogin() {
    NaverIdLoginSDK.initialize(
        this@MainActivity,
        BuildConfig.NAVER_CLIENT,
        BuildConfig.NAVER_CLIENT_SECRET,
        BuildConfig.APPLICATION_ID
    )
    NaverIdLoginSDK.authenticate(this@MainActivity, naverLauncher)
}

변경 후

private fun doNaverLogin() {
    NidOAuth.initialize(
        this@MainActivity,
        BuildConfig.NAVER_CLIENT,
        BuildConfig.NAVER_CLIENT_SECRET,
        BuildConfig.APPLICATION_ID
    )
    NidOAuth.requestLogin(this@MainActivity, naverLauncher)
}

인자로 전달하는 값은 그대로 유지했다. 네이버 클라이언트 ID, 클라이언트 시크릿, 앱 이름 값은 기존과 동일하게 BuildConfig에서 가져온다. 변경된 부분은 호출 객체와 메서드명이다.

로그인 결과 처리 코드 비교

로그인 화면에서 돌아온 뒤, 성공 시 access token을 가져와 Cloud Functions로 전달하고 Firebase custom token을 발급받는 구조는 그대로 유지했다. 다만 token이 비어 있는 경우를 명확히 막았다.

변경 전

private val naverLauncher = registerForActivityResult<Intent, ActivityResult>(
    ActivityResultContracts.StartActivityForResult()
) { result ->
    when (result.resultCode) {
        RESULT_OK -> {
            viewModel.isProgressBar.value = true
            Log.e("", "accessToken=${NaverIdLoginSDK.getAccessToken()}")
            doSigninNaverToken(NaverIdLoginSDK.getAccessToken().toString())
        }
        RESULT_CANCELED -> {
            val errorCode = NaverIdLoginSDK.getLastErrorCode().code
            val errorDescription = NaverIdLoginSDK.getLastErrorDescription()
            doToastMakeAppend(R.string.titleFailure, "$errorDescription")
        }
    }
}

변경 후

private val naverLauncher = registerForActivityResult<Intent, ActivityResult>(
    ActivityResultContracts.StartActivityForResult()
) { result ->
    when (result.resultCode) {
        RESULT_OK -> {
            viewModel.isProgressBar.value = true
            val accessToken = NidOAuth.getAccessToken()
            Log.e("", "accessToken=$accessToken")
            if (accessToken.isNullOrEmpty()) {
                viewModel.isProgressBar.value = false
                doToastMakeAppend(R.string.titleFailure, "Naver access token is empty.")
                return@registerForActivityResult
            }
            doSigninNaverToken(accessToken)
        }
        RESULT_CANCELED -> {
            val errorCode = NidOAuth.getLastErrorCode().code
            val errorDescription = NidOAuth.getLastErrorDescription()
            viewModel.isProgressBar.value = false
            doToastMakeAppend(R.string.titleFailure, "$errorCode $errorDescription")
        }
    }
}
주의할 점: 변경 전 코드는 getAccessToken().toString()을 바로 호출했다. access token이 null이면 문자열 "null"이 서버로 전달될 수 있다. 변경 후에는 isNullOrEmpty()로 검증한 뒤에만 doSigninNaverToken(accessToken)을 호출한다.

Firebase 로그인 흐름은 유지

이번 수정은 네이버 SDK 호출부를 최신 API로 교체한 작업이다. Firebase Auth와 연동되는 큰 흐름은 바꾸지 않았다.

  • 네이버 OAuth 로그인 요청
  • 네이버 access token 획득
  • Cloud Functions에 access token 전달
  • 서버에서 Firebase custom token 발급
  • auth.signInWithCustomToken(...)으로 Firebase 로그인

즉, 인증 서버 연동 방식이나 Firebase custom token 처리 방식은 그대로 두고, Android 클라이언트의 네이버 SDK 진입점만 교체했다.

최종 적용 코드

현재 적용된 네이버 로그인 관련 핵심 코드는 다음과 같다.

import com.navercorp.nid.NidOAuth

private val naverLauncher = registerForActivityResult<Intent, ActivityResult>(
    ActivityResultContracts.StartActivityForResult()
) { result ->
    when (result.resultCode) {
        RESULT_OK -> {
            viewModel.isProgressBar.value = true
            val accessToken = NidOAuth.getAccessToken()
            Log.e("", "accessToken=$accessToken")
            if (accessToken.isNullOrEmpty()) {
                viewModel.isProgressBar.value = false
                doToastMakeAppend(R.string.titleFailure, "Naver access token is empty.")
                return@registerForActivityResult
            }
            doSigninNaverToken(accessToken)
        }
        RESULT_CANCELED -> {
            val errorCode = NidOAuth.getLastErrorCode().code
            val errorDescription = NidOAuth.getLastErrorDescription()
            viewModel.isProgressBar.value = false
            doToastMakeAppend(R.string.titleFailure, "$errorCode $errorDescription")
        }
    }
}

private fun doNaverLogin() {
    NidOAuth.initialize(
        this@MainActivity,
        BuildConfig.NAVER_CLIENT,
        BuildConfig.NAVER_CLIENT_SECRET,
        BuildConfig.APPLICATION_ID
    )
    NidOAuth.requestLogin(this@MainActivity, naverLauncher)
}

빌드 검증 결과

수정 후 assembleDebug 빌드를 실행해 컴파일을 확인했다.

.\gradlew.bat assembleDebug

BUILD SUCCESSFUL

기존에 발생하던 NaverIdLoginSDK 관련 deprecation warning은 제거됐다. 남아 있는 warning은 Locale, updateConfiguration, GsonBuilder.setLenient, AGP/Gradle 설정 관련 기존 경고로 이번 네이버 로그인 수정 범위와는 별개다.

정리

이번 변경의 핵심은 deprecated wrapper인 NaverIdLoginSDK를 제거하고, SDK가 권장하는 NidOAuth를 직접 사용하도록 바꾼 것이다. 기능 흐름은 유지하면서 향후 SDK 6.1.0 이후 제거될 API에 대한 의존성을 줄였고, access token이 비어 있을 때 서버 요청이 발생하지 않도록 방어 로직도 추가했다.

반응형

+ Recent posts