API 그룹 팝업 JSP 파일 추가 - 예제 코드 및 UI 구조 작성

Summernote 에디터 스타일 CSS 추가 - 텍스트 및 컴포넌트 스타일 정의
OpenAPI POC JS 파일 추가 - API 스펙 빌더 및 스텝별 렌더 구현
This commit is contained in:
Rinjae
2026-07-13 14:25:09 +09:00
parent d7dcf9a81c
commit cbf3066a56
27 changed files with 4405 additions and 91 deletions
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,334 @@
/**
* Editor Content Styles (editor-content.css)
*
* Summernote 에디터로 작성된 HTML 콘텐츠의 공통 스타일
* 관리자포탈/개발자포탈 양쪽에서 동일하게 사용
*
* 사용법:
* - 관리자포탈: Summernote .note-editable에 .editor-content 클래스 추가
* - 개발자포탈: 콘텐츠 wrapper에 .editor-content 클래스 추가
*
* @version 1.0.0
* @date 2025-12-30
*/
/* ==========================================================================
CSS Reset + 기본 설정
========================================================================== */
.editor-content {
all: revert;
font-family: 'Noto Sans KR', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif !important;
font-size: 16px !important;
font-weight: 400 !important;
line-height: 1.8 !important;
color: #1A1A2E !important;
word-wrap: break-word;
text-align: left !important;
}
/* ==========================================================================
헤딩 (Headings)
========================================================================== */
.editor-content h1 {
font-size: 20px !important;
font-weight: 700 !important;
margin: 32px 0 16px !important;
line-height: 1.4 !important;
color: #1A1A2E !important;
}
.editor-content h1:first-child {
margin-top: 0 !important;
}
.editor-content h2 {
font-size: 18px !important;
font-weight: 700 !important;
margin: 24px 0 8px !important;
line-height: 1.4 !important;
color: #1A1A2E !important;
}
.editor-content h3 {
font-size: 16px !important;
font-weight: 600 !important;
margin: 16px 0 8px !important;
line-height: 1.4 !important;
color: #1A1A2E !important;
}
.editor-content h4,
.editor-content h5,
.editor-content h6 {
font-size: 16px !important;
font-weight: 600 !important;
margin: 16px 0 8px !important;
line-height: 1.4 !important;
color: #1A1A2E !important;
}
/* ==========================================================================
단락 (Paragraphs)
========================================================================== */
.editor-content p {
margin-bottom: 16px !important;
line-height: 1.8 !important;
font-size: 16px !important;
}
.editor-content p:last-child {
margin-bottom: 0 !important;
}
/* ==========================================================================
리스트 (Lists) - 글로벌 reset 대응
========================================================================== */
.editor-content ul {
list-style-type: disc !important;
padding-left: 32px !important;
margin: 16px 0 !important;
}
.editor-content ol {
list-style-type: decimal !important;
padding-left: 32px !important;
margin: 16px 0 !important;
}
.editor-content li {
margin-bottom: 8px !important;
line-height: 1.8 !important;
font-size: 16px !important;
}
.editor-content li:last-child {
margin-bottom: 0 !important;
}
/* 중첩 리스트 */
.editor-content ul ul {
list-style-type: circle !important;
margin: 8px 0 !important;
}
.editor-content ul ul ul {
list-style-type: square !important;
}
.editor-content ol ol {
list-style-type: lower-alpha !important;
margin: 8px 0 !important;
}
.editor-content ol ol ol {
list-style-type: lower-roman !important;
}
/* ==========================================================================
테이블 (Tables)
========================================================================== */
.editor-content table {
width: 100% !important;
border-collapse: collapse !important;
margin: 24px 0 !important;
border: 1px solid #E2E8F0 !important;
border-radius: 8px !important;
overflow: hidden !important;
font-size: 14px !important;
}
.editor-content th,
.editor-content td {
border: 1px solid #E2E8F0 !important;
padding: 8px 16px !important;
text-align: left !important;
vertical-align: top !important;
}
.editor-content th {
background: #EFF6FF !important;
font-weight: 600 !important;
color: #1A1A2E !important;
}
.editor-content tr:hover {
background: #F8FAFC !important;
}
/* ==========================================================================
링크 (Links)
========================================================================== */
.editor-content a {
color: #0049b4 !important;
text-decoration: underline !important;
transition: color 0.3s ease !important;
}
.editor-content a:hover {
color: #003080 !important;
}
/* ==========================================================================
인용문 (Blockquote)
========================================================================== */
.editor-content blockquote {
border-left: 4px solid #0049b4 !important;
padding: 16px 24px !important;
margin: 24px 0 !important;
background: #F8FAFC !important;
font-style: italic !important;
color: #64748B !important;
border-radius: 0 8px 8px 0 !important;
}
.editor-content blockquote p {
margin-bottom: 0 !important;
}
/* ==========================================================================
이미지 (Images)
========================================================================== */
.editor-content img {
max-width: 100% !important;
height: auto !important;
border-radius: 8px !important;
margin: 16px 0 !important;
display: block !important;
}
/* ==========================================================================
코드 (Code)
========================================================================== */
.editor-content code {
background: #F8FAFC !important;
padding: 2px 6px !important;
border-radius: 4px !important;
font-family: 'Fira Code', 'Courier New', monospace !important;
font-size: 0.9em !important;
color: #0049b4 !important;
}
.editor-content pre {
background: #F8FAFC !important;
border: 1px solid #E2E8F0 !important;
border-radius: 8px !important;
padding: 16px !important;
overflow-x: auto !important;
margin: 16px 0 !important;
}
.editor-content pre code {
background: transparent !important;
padding: 0 !important;
color: #1A1A2E !important;
}
/* ==========================================================================
구분선 (Horizontal Rule)
========================================================================== */
.editor-content hr {
border: none !important;
border-top: 1px solid #E2E8F0 !important;
margin: 32px 0 !important;
}
/* ==========================================================================
텍스트 강조 (Text Emphasis)
========================================================================== */
.editor-content strong,
.editor-content b {
font-weight: 700 !important;
}
.editor-content em,
.editor-content i {
font-style: italic !important;
}
.editor-content u {
text-decoration: underline !important;
}
.editor-content s,
.editor-content strike,
.editor-content del {
text-decoration: line-through !important;
}
.editor-content mark {
background-color: #FEF3C7 !important;
padding: 0 2px !important;
}
.editor-content sub {
vertical-align: sub !important;
font-size: 0.8em !important;
}
.editor-content sup {
vertical-align: super !important;
font-size: 0.8em !important;
}
/* ==========================================================================
반응형 (Responsive)
========================================================================== */
@media (max-width: 768px) {
.editor-content {
font-size: 14px !important;
}
.editor-content h1 {
font-size: 18px !important;
}
.editor-content h2 {
font-size: 16px !important;
}
.editor-content h3,
.editor-content h4,
.editor-content h5,
.editor-content h6 {
font-size: 14px !important;
}
.editor-content p,
.editor-content li {
font-size: 14px !important;
}
.editor-content table {
font-size: 12px !important;
}
.editor-content th,
.editor-content td {
padding: 4px 8px !important;
}
.editor-content ul,
.editor-content ol {
padding-left: 24px !important;
}
.editor-content blockquote {
padding: 8px 16px !important;
}
.editor-content pre {
padding: 8px !important;
}
}
+310
View File
@@ -0,0 +1,310 @@
// 계좌이체 API 모의 데이터
// locked: true 인 필드는 게이트웨이가 자동 주입한 값(회색 + 자물쇠)
// locked: false / 미지정 인 필드는 사용자가 자유롭게 편집
window.SAMPLE_DATA = (function () {
return {
info: {
title: { value: '계좌이체 API', locked: false },
version: { value: '1.0.0', locked: false },
summary: { value: '', locked: false },
description: { value: '', locked: false },
termsOfService: { value: '', locked: false },
contact: {
name: { value: 'DJB API Team', locked: false },
email: { value: 'api@djb.co.kr', locked: false },
url: { value: '', locked: false }
},
license: {
name: { value: '', locked: false },
url: { value: '', locked: false }
}
},
tags: [
{ name: 'transfer', description: '계좌이체 관련 API' }
],
externalDocs: {
description: { value: '', locked: false },
url: { value: '', locked: false }
},
servers: [
{
url: { value: 'https://api-dev.djb.co.kr', locked: true },
env: 'development',
description: { value: '개발 환경', locked: false }
},
{
url: { value: 'https://api-stg.djb.co.kr', locked: true },
env: 'staging',
description: { value: '스테이징 환경', locked: false }
},
{
url: { value: 'https://api.djb.co.kr', locked: true },
env: 'production',
description: { value: '운영 환경', locked: false }
}
],
serverVariables: [
{
name: { value: 'basePath', locked: true },
default: { value: '/v1', locked: false },
enumStr: { value: '/v1,/v2', locked: false },
description: { value: 'API 버전 경로', locked: false }
}
],
operation: {
method: { value: 'POST', locked: true },
path: { value: '/v1/accounts/transfer', locked: true },
operationId: { value: 'transferAccount', locked: false },
summary: { value: '', locked: false },
description: { value: '', locked: false },
tags: { value: ['transfer'], locked: false },
deprecated: { value: false, locked: false }
},
// 파라미터 (Path/Query/Header/Cookie)
parameters: [
{
in: 'header',
name: { value: 'X-Request-Id', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: 'uuid', locked: false },
maxLength: { value: '', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '', locked: false }
}
],
// Request Body 스키마 (중첩 3단)
requestBody: {
mediaType: 'application/json',
required: { value: true, locked: true },
schema: [
{
name: { value: 'transactionId', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '40', locked: false },
pattern: { value: '^tx-[0-9a-zA-Z-]+$', locked: false },
description: { value: '', locked: false },
example: { value: 'tx-20260522-001', locked: false },
children: null
},
{
name: { value: 'sender', locked: true },
type: { value: 'object', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '', locked: false },
pattern: { value: '', locked: false },
description: { value: '송금인 정보', locked: false },
example: { value: '', locked: false },
children: [
{
name: { value: 'accountNumber', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '20', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '110-1234-567890', locked: false },
children: null
},
{
name: { value: 'bankCode', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '3', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '088', locked: false },
children: null
},
{
name: { value: 'holderName', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '60', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '김철수', locked: false },
children: null
}
]
},
{
name: { value: 'receiver', locked: true },
type: { value: 'object', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '', locked: false },
pattern: { value: '', locked: false },
description: { value: '수취인 정보', locked: false },
example: { value: '', locked: false },
children: [
{
name: { value: 'accountNumber', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '20', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '111-2345-678901', locked: false },
children: null
},
{
name: { value: 'bankCode', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '3', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '020', locked: false },
children: null
},
{
name: { value: 'holderName', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '60', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '이영희', locked: false },
children: null
}
]
},
{
name: { value: 'amount', locked: true },
type: { value: 'object', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '', locked: false },
pattern: { value: '', locked: false },
description: { value: '이체 금액', locked: false },
example: { value: '', locked: false },
children: [
{
name: { value: 'value', locked: true },
type: { value: 'integer', locked: true },
required: { value: true, locked: true },
format: { value: 'int64', locked: false },
maxLength: { value: '', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '50000', locked: false },
children: null
},
{
name: { value: 'currency', locked: true },
type: { value: 'string', locked: true },
required: { value: true, locked: true },
format: { value: '', locked: false },
maxLength: { value: '3', locked: false },
pattern: { value: '^[A-Z]{3}$', locked: false },
description: { value: 'ISO 4217 통화코드', locked: false },
example: { value: 'KRW', locked: false },
children: null
}
]
},
{
name: { value: 'memo', locked: true },
type: { value: 'string', locked: true },
required: { value: false, locked: true },
format: { value: '', locked: false },
maxLength: { value: '100', locked: false },
pattern: { value: '', locked: false },
description: { value: '', locked: false },
example: { value: '5월 회비', locked: false },
children: null
}
]
},
// 응답 스키마 (상태코드 별)
responses: {
'200': {
description: { value: '이체 성공', locked: false },
schema: [
{ name: { value: 'transactionId', locked: true }, type: { value: 'string', locked: true }, required: { value: true, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: 'tx-20260522-001', locked: false }, children: null },
{ name: { value: 'status', locked: true }, type: { value: 'string', locked: true }, required: { value: true, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: 'COMPLETED', locked: false }, children: null },
{ name: { value: 'completedAt', locked: true }, type: { value: 'string', locked: true }, required: { value: true, locked: true }, format: { value: 'date-time', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: '2026-05-22T10:00:00Z', locked: false }, children: null },
{
name: { value: 'balance', locked: true }, type: { value: 'object', locked: true }, required: { value: true, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '잔액 정보', locked: false }, example: { value: '', locked: false },
children: [
{ name: { value: 'before', locked: true }, type: { value: 'integer', locked: true }, required: { value: true, locked: true }, format: { value: 'int64', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: '1000000', locked: false }, children: null },
{ name: { value: 'after', locked: true }, type: { value: 'integer', locked: true }, required: { value: true, locked: true }, format: { value: 'int64', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: '950000', locked: false }, children: null }
]
}
]
},
'400': {
description: { value: '잘못된 요청', locked: false },
schema: [
{
name: { value: 'error', locked: true }, type: { value: 'object', locked: true }, required: { value: true, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: '', locked: false },
children: [
{ name: { value: 'code', locked: true }, type: { value: 'string', locked: true }, required: { value: true, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: 'INVALID_AMOUNT', locked: false }, children: null },
{ name: { value: 'message', locked: true }, type: { value: 'string', locked: true }, required: { value: true, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: '금액이 올바르지 않습니다', locked: false }, children: null },
{ name: { value: 'details', locked: true }, type: { value: 'array', locked: true }, required: { value: false, locked: true }, format: { value: '', locked: false }, maxLength: { value: '', locked: false }, pattern: { value: '', locked: false }, description: { value: '', locked: false }, example: { value: '', locked: false }, itemsType: { value: 'string', locked: false }, children: null }
]
}
]
},
'401': { description: { value: '인증 실패', locked: false }, schema: [] },
'500': { description: { value: '서버 오류', locked: false }, schema: [] }
},
// 보안 스킴
securitySchemes: [
{
key: 'ApiKeyAuth',
type: 'apiKey',
locked: true,
name: { value: 'X-API-Key', locked: true },
in: { value: 'header', locked: true },
description: { value: '', locked: false }
}
],
globalSecurity: ['ApiKeyAuth'],
// 예제
examples: {
request: {
'application/json': {
default: '{\n "transactionId": "tx-20260522-001",\n "sender": {\n "accountNumber": "110-1234-567890",\n "bankCode": "088",\n "holderName": "김철수"\n },\n "receiver": {\n "accountNumber": "111-2345-678901",\n "bankCode": "020",\n "holderName": "이영희"\n },\n "amount": {\n "value": 50000,\n "currency": "KRW"\n },\n "memo": "5월 회비"\n}'
}
},
response: {
'200': { body: '{\n "transactionId": "tx-20260522-001",\n "status": "COMPLETED"\n}', headers: [ { name: 'X-RateLimit-Remaining', type: 'integer', description: '남은 요청 횟수', example: '99' } ] }
}
},
// 문서 옵션
docOptions: {
theme: 'light',
lang: 'ko',
includeExamples: true,
tryItOut: true,
defaultExpandDepth: -1,
layout: 'BaseLayout',
tagFilter: [],
sideToc: true
}
};
})();
+103
View File
@@ -0,0 +1,103 @@
/* DJB OpenAPI Editor POC — Tailwind 보강 커스텀 */
html, body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Apple SD Gothic Neo",
"Malgun Gothic", "Noto Sans KR", system-ui, sans-serif;
}
/* === 잠금 행/카드 좌측 띠 === */
.locked-row td:first-child {
position: relative;
}
.locked-row td:first-child::before {
content: '';
position: absolute;
left: 0;
top: 6px;
bottom: 6px;
width: 3px;
background: #cbd5e1;
border-radius: 2px;
}
.locked-card {
position: relative;
background: linear-gradient(to right, #f8fafc 0%, #ffffff 4px) #ffffff;
}
.locked-card::before {
content: '';
position: absolute;
left: 0; top: 8px; bottom: 8px;
width: 3px;
background: #cbd5e1;
border-radius: 0 2px 2px 0;
}
/* === 스키마 테이블 — 가독성 보조 === */
.schema-table th { white-space: nowrap; }
.schema-table tbody tr:hover { background: #fafbfc; }
.schema-table input,
.schema-table select {
font-size: 12.5px;
}
.schema-table input[type="text"] {
padding-top: 4px;
padding-bottom: 4px;
}
/* === 스텝퍼 항목 hover === */
.step-item:hover { background: #f8fafc; }
/* === 미리보기 패널: Swagger UI 크기 미세조정 === */
#preview-swagger .swagger-ui {
font-size: 13px;
}
#preview-swagger .swagger-ui .info { margin: 18px 0; }
#preview-swagger .swagger-ui .info .title { font-size: 22px; }
#preview-swagger .swagger-ui .scheme-container { padding: 12px 0; box-shadow: none; }
#preview-swagger .swagger-ui .opblock { margin: 0 0 12px 0; }
/* === 다크 테마 (POC 시뮬레이션 — Swagger 자체 다크는 미지원이라 컨테이너만) === */
body.theme-dark #preview-swagger { background: #1e293b; }
/* === 토스트 애니메이션 === */
#toast { transition: opacity 0.2s; }
/* === Monaco 컨테이너가 hidden 일 때 layout 깨짐 방지 === */
#preview-monaco {
overflow: hidden;
}
/* === Stepper 6단 grid 셀 좌우 라인 (마지막 셀 제외) === */
#stepper li {
position: relative;
}
#stepper li:not(:last-child)::after {
content: '';
position: absolute;
top: 50%;
right: -8px;
width: 16px;
height: 1px;
background: #e2e8f0;
}
/* === 보안 스킴 카드 — 잠금 표시 === */
.locked-card {
background: #fafbfc;
}
/* === 칩(태그) 미세 조정 === */
.tag-chip { transition: background 0.15s; }
/* === Export menu fade === */
#export-menu { animation: fadeIn 0.12s ease-out; }
@keyframes fadeIn {
from { opacity: 0; transform: translateY(-4px); }
to { opacity: 1; transform: translateY(0); }
}
/* === 1600px 기준 폼 패널 내부 가로 여유 확보 === */
#form-content { max-width: 100%; }
/* === readonly input 위에서 텍스트 커서 안 보이게 === */
input[readonly] { user-select: text; }
@@ -23,7 +23,7 @@
<script language="javascript" >
var url = '<c:url value="/onl/apim/apigroup/apiGroupMan.json"/>';
var url_view = '<c:url value="/onl/apim/apigroup/apiGroupMan.view"/>';
var url_popup_view = '<c:url value="/onl/transaction/apim/apiSpecManPopup.view"/>';
var url_popup_view = '<c:url value="/onl/transaction/apim/apiSpecMan.view"/>';
var isDetail = false;
let dialog;
@@ -86,9 +86,11 @@
editurl: "clientArray",
colNames: ['<%= localeMessage.getString("propertyDetail.propertyKey") %>',
'<%= localeMessage.getString("propertyDetail.propertyValue") %>',
'설명',
'<%= localeMessage.getString("propertyDetail.delYn") %>'],
colModel: [{name: 'PRPTYNAME', width: 50, align: 'left', editable: true},
{name: 'PRPTY2VAL', width: 200, align: 'left', editable: true},
{name: 'PRPTY2VAL', width: 150, align: 'left', editable: true},
{name: 'PRPTYDESC', width: 200, align: 'left', editable: true, edittype: 'textarea', editoptions: {rows: 2}},
{
name: 'DELETEYN',
width: 20,
@@ -258,6 +260,7 @@
var data = new Object();
data["PRPTYNAME"] = $("input[name=prptyName]").val();
data["PRPTY2VAL"] = $("input[name=prpty2Val]").val();
data["PRPTYDESC"] = $("input[name=prptyDesc]").val();
var rows = $("#grid")[0].rows;
var index = Number($(rows[rows.length - 1]).attr("id"));
@@ -340,6 +343,11 @@
<td colspan="3"><input type="text" name="prpty2Val"/>
</td>
</tr>
<tr>
<th>설명</th>
<td colspan="3"><input type="text" name="prptyDesc"/>
</td>
</tr>
</table>
<!-- grid -->
<table id="grid"></table>
@@ -84,6 +84,7 @@
var url ='<c:url value="/onl/transaction/apim/apiInterfaceMan.json" />';
const url_excel ='<c:url value="/onl/transaction/apim/apiInterfaceMan.excel" />';
var url_spec = '<c:url value="/onl/transaction/apim/apiSpecMan.view"/>';
var url_openapi_spec = '<c:url value="/onl/transaction/apim/djbApiSpecMan.view"/>';
var returnUrl ;
let headerValues = [];
let headerNames = [];
@@ -993,6 +994,28 @@
showModal(popupUrl, args, 1200, 800);
}
// v2: OpenAPI Spec — 기본은 모달(iframe), Shift+클릭은 새 창.
// 컨텍스트는 전부 query string 으로 전달(dialogArguments 미사용).
function showOpenApiSpecPopup(e) {
var eaiSvcName = getFullSvcName();
var eaiSvcDesc = $('#eaiSvcDesc').val();
var apipath = $('#apiFullPath').val(); // METHOD|URL ('|' 포함 → 인코딩 필수)
var contentType = $('#contentType').val();
var baseUrl = url_openapi_spec
+ '?cmd=DETAIL'
+ '&eaiSvcName=' + encodeURIComponent(eaiSvcName)
+ '&apipath=' + encodeURIComponent(apipath)
+ '&eaiSvcDesc=' + encodeURIComponent(eaiSvcDesc)
+ '&contentType=' + encodeURIComponent(contentType);
if (e && e.shiftKey) {
// Shift+클릭: 새 창. window.open 은 serviceType/menuId 자동 부착 안 되므로 직접 붙임.
window.open(urlAddServiceType(baseUrl + '&menuId=' + encodeURIComponent(getMenuId())), '_blank');
} else {
// 기본: 모달 + iframe. showModal 이 serviceType/menuId/pop 을 자동 부착.
showModal(baseUrl, { title: 'OpenAPI Spec' }, 1600, 880);
}
}
$(document).ready(function() {
makeValidate();
// var bootstrapButton = $.fn.button.noConflict()
@@ -1007,9 +1030,14 @@
}
init(url,key,detail);
// v1: 기존 API 스펙 (모달) — 기능 비교용 복원
$("#btn_api_spec").click(function() {
showApiSpecPopup();
});
// v2: 신규 OpenAPI Spec (새 탭)
$("#btn_openapi_spec").click(function(e) {
showOpenApiSpecPopup(e);
});
$("#btn_modify").click(modifyApi);
$("#btn_delete").click(function(){
@@ -1508,7 +1536,10 @@
<button type="button" class="cssbtn" id="btn_json_export" level="R" status="DETAIL,NEW"><i class="material-icons">download</i> <%=localeMessage.getString("button.exportJson")%></button></button>
<button type="button" class="cssbtn" id="btn_delete" level="W" status="DETAIL"><i class="material-icons">delete</i> <%= localeMessage.getString("button.delete") %></button>
<button type="button" class="cssbtn" id="btn_modify" level="R" status="DETAIL,NEW"><i class="material-icons">save</i> <%= localeMessage.getString("button.modify") %></button>
<!-- v1: 기존 API 스펙 (모달) — 기능 비교용 복원 -->
<button type="button" class="cssbtn" id="btn_api_spec" level="R" status="DETAIL,NEW"><i class="material-icons">description</i> API 스펙</button>
<!-- v2: 신규 OpenAPI Spec (새 탭) -->
<button type="button" class="cssbtn" id="btn_openapi_spec" level="R" status="DETAIL,NEW"><i class="material-icons">api</i> OpenAPI Spec</button>
<button type="button" class="cssbtn" id="btn_previous" level="R" status="DETAIL,NEW"><i class="material-icons">arrow_back</i> <%= localeMessage.getString("button.previous") %></button>
</div>
<div class="title" id="title" style="font-size:1.4em">${rmsMenuName}</div>
@@ -23,7 +23,7 @@
</style>
<script language="javascript">
var url = '<c:url value="/onl/transaction/apim/apiSpecMan.json" />';
var url_org ='<c:url value="/onl/transaction/apim/apiSpecManPopup.view" />';
var url_org ='<c:url value="/onl/transaction/apim/apiSpecMan.view" />';
var isDetail = false;
var sampleRequestEditor, sampleResponseEditor, testbedSpecEditor;
@@ -0,0 +1,132 @@
<%@ page language="java" contentType="text/html; charset=utf-8"%>
<%@ page import="java.io.*"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@ include file="/jsp/common/include/localemessage.jsp" %>
<%
response.setHeader("Pragma", "No-cache");
response.setHeader("Cache-Control", "no-cache");
response.setHeader("Expires", "0");
%>
<html>
<head>
<title>API 그룹 선택</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<jsp:include page="/jsp/common/include/css_custom.jsp"/>
<jsp:include page="/jsp/common/include/css.jsp"/>
<jsp:include page="/jsp/common/include/script.jsp"/>
<script language="javascript">
var url = '<c:url value="/onl/apim/apigroup/apiGroupMan.json" />';
function search() {
var postData = getSearchForJqgrid("cmd", "LIST");
$("#grid").setGridParam({url: url, postData: postData, page: 1}).trigger("reloadGrid");
}
$(document).ready(function() {
var urlParams = new URLSearchParams(window.location.search);
var selectedGroupIds = urlParams.get("selectedGroupIds");
if (selectedGroupIds) {
selectedGroupIds = selectedGroupIds.split(','); // 콤마로 구분된 ID들을 배열로 변환
} else {
selectedGroupIds = [];
}
$('#grid').jqGrid({
datatype: "json",
mtype: 'POST',
url: url,
postData: getSearchForJqgrid("cmd", "LIST"),
colNames: ['API 그룹 ID', 'API 그룹 명', '설명'],
colModel: [
{name: 'id', hidden: true},
{name: 'groupName', align: 'center', width: "180"},
{name: 'groupDesc', align: 'left', width: "200"}
],
jsonReader: {
repeatitems: false
},
pager: $('#pager'),
page: '${param.page}',
rowNum: '${rmsDefaultRowNum}',
autoheight: true,
height: 'auto',
width: 410,
autowidth: false,
viewrecords: true,
shrinkToFit: false,
multiselect: true,
multiboxonly: false,
loadComplete: function(data) {
var $grid = $(this);
$.each($grid.getDataIDs(), function(_, id) {
var rowData = $grid.getRowData(id);
if ($.inArray(rowData.id, selectedGroupIds) !== -1) {
$grid.jqGrid('setSelection', id, true);
}
});
}
});
$("#btn_search").click(search);
$("#btn_save").click(function() {
var selectedRows = $('#grid').getGridParam('selarrrow');
var selectedGroups = [];
if (selectedRows.length > 0) {
selectedGroups = selectedRows.map(function(rowid) {
var rowData = $('#grid').getRowData(rowid);
return {
id: rowData.id,
groupName: rowData.groupName
};
});
}
// 부모 창의 selectApiGroup 함수 호출
if (window.parent && typeof window.parent.selectApiGroup === "function") {
window.parent.selectApiGroup(selectedGroups);
window.close();
}
});
$("#btn_close").click(function () {
window.close();
});
// 검색어 입력 후 엔터 키 처리
$("input[name=searchGroupName]").keydown(function(key) {
if (key.keyCode == 13) {
search();
}
});
});
</script>
</head>
<body>
<div class="popup_box">
<div class="search_wrap">
<button type="button" class="cssbtn" id="btn_save" level="W">
<i class="material-icons">save</i> <%= localeMessage.getString("button.save") %>
</button>
<button type="button" class="cssbtn" id="btn_search" level="R">
<i class="material-icons">search</i> <%= localeMessage.getString("button.search") %>
</button>
<button type="button" class="cssbtn" id="btn_close" level="R" status="DETAIL"><i
class="material-icons">close</i> <%= localeMessage.getString("button.close") %>
</button>
</div>
<div class="title"></div>
<table class="search_condition" cellspacing="0">
<tr>
<th style="width:80px;">API 그룹 명</th>
<td>
<input type="text" name="searchGroupName" value="${param.searchGroupName}">
</td>
</tr>
</table>
<table id="grid"></table>
<div id="pager"></div>
</div>
</body>
</html>
@@ -0,0 +1,173 @@
<%@ page language="java" contentType="text/html; charset=utf-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%
response.setHeader("Pragma", "No-cache");
response.setHeader("Cache-Control", "no-cache");
response.setHeader("Expires", "0");
%>
<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=1600" />
<title>OpenAPI Spec 에디터</title>
<%-- Tailwind (벤더된 Play CDN JS, 오프라인) --%>
<script src="<c:url value='/plugins/openapi/tailwind.js'/>"></script>
<script>
tailwind.config = { theme: { extend: { colors: { brand: {
50:'#eff6ff', 100:'#dbeafe', 500:'#3b82f6', 600:'#2563eb', 700:'#1d4ed8'
} } } } };
</script>
<%-- Swagger UI 5 (벤더) --%>
<link rel="stylesheet" href="<c:url value='/plugins/swaggerUI/swagger-ui.css'/>" />
<script src="<c:url value='/plugins/swaggerUI/swagger-ui-bundle.js'/>"></script>
<script src="<c:url value='/plugins/swaggerUI/swagger-ui-standalone-preset.js'/>"></script>
<script src="<c:url value='/plugins/swaggerUI/djb-swagger-i18n.js'/>" charset="UTF-8"></script>
<%-- js-yaml (벤더) --%>
<script src="<c:url value='/plugins/openapi/js-yaml.min.js'/>"></script>
<%-- CodeMirror (YAML 편집기 — Monaco 대체, admin addon) --%>
<link rel="stylesheet" href="<c:url value='/addon/codemirror/lib/codemirror.css'/>" />
<script src="<c:url value='/addon/codemirror/lib/codemirror.js'/>"></script>
<script src="<c:url value='/addon/codemirror/mode/yaml/yaml.js'/>"></script>
<script src="<c:url value='/addon/codemirror/mode/javascript/javascript.js'/>"></script>
<%-- jQuery + Summernote(lite, 무-Bootstrap) — 설명 리치 에디터 --%>
<link rel="stylesheet" href="<c:url value='/addon/summernote/summernote-lite.css'/>" />
<%-- 개발자포탈과 동일한 에디터 콘텐츠 스타일(.editor-content, Noto Sans KR 16px) --%>
<link rel="stylesheet" href="<c:url value='/js/djb/apispec/editor-content.css'/>" />
<script src="<c:url value='/js/jquery-1.12.1.min.js'/>"></script>
<script src="<c:url value='/addon/summernote/summernote-lite.min.js'/>"></script>
<script src="<c:url value='/addon/summernote/lang/summernote-ko-KR.js'/>"></script>
<link rel="stylesheet" href="<c:url value='/js/djb/apispec/styles.css'/>" />
<style>
/* 페이지 자체 세로 스크롤 제거 — 뷰포트 고정, 내부 패널만 스크롤 */
html, body { height: 100%; margin: 0; overflow-x: auto; overflow-y: hidden; }
#djb-wrap { height: 100vh; display: flex; flex-direction: column; }
#djb-wrap > header, #djb-wrap > nav { flex: 0 0 auto; }
#body { flex: 1 1 auto; min-height: 0 !important; overflow: hidden; }
#form-panel { display: flex; flex-direction: column; min-height: 0; overflow: hidden; }
#form-content { flex: 1 1 auto; min-height: 0; overflow-y: auto; }
#preview-panel { display: flex; flex-direction: column; min-height: 0; overflow: hidden; }
#preview-swagger, #preview-monaco { flex: 1 1 auto; min-height: 0; height: auto !important; overflow: auto; }
#preview-monaco .CodeMirror { height: 100%; }
/* 패널 내부 sticky 는 flex 행으로 (스크롤 컨테이너는 form-content / preview) */
#form-panel > .sticky, #preview-panel > .sticky { position: static !important; }
</style>
<script>
window.DJB_CTX = {
eaiSvcName: "${param.eaiSvcName}",
apiName: "${param.eaiSvcDesc}",
detailUrl: "<c:url value='/onl/transaction/apim/djbApiSpecMan.json'/>?cmd=DETAIL_SPEC&serviceType=APIGW",
saveUrl: "<c:url value='/onl/transaction/apim/djbApiSpecMan.json'/>?cmd=SAVE&serviceType=APIGW",
swaggerBase: "<c:url value='/plugins/swaggerUI/'/>",
gwAddress: "${gwAddress}",
orgPopupUrl: "<c:url value='/onl/transaction/apim/apiSpecMan.view'/>",
groupPopupUrl: "<c:url value='/onl/transaction/apim/djbApiSpecMan.view'/>?cmd=GROUP_POPUP",
jsonUrl: "<c:url value='/onl/transaction/apim/djbApiSpecMan.json'/>"
};
</script>
</head>
<body class="bg-slate-50 text-slate-800 antialiased" style="min-width:1600px;">
<div id="djb-wrap" class="mx-auto" style="width:1600px;">
<!-- ===== Header ===== -->
<header class="h-14 flex items-center justify-between px-6 bg-white border-b border-slate-200 sticky top-0 z-30">
<div class="flex items-center gap-3">
<div class="font-semibold text-slate-900">OpenAPI Spec 에디터</div>
<span class="text-slate-300">|</span>
<span class="text-sm text-slate-500">인터페이스:</span>
<span class="text-sm font-medium text-slate-800" id="hdr-project-name">${param.eaiSvcName}</span>
<span class="ml-2 px-2 py-0.5 text-[11px] rounded-full bg-slate-100 text-slate-600 border border-slate-200" id="hdr-version">v1.0.0</span>
<span id="hdr-source" class="hidden ml-1 px-2 py-0.5 text-[11px] rounded-full bg-emerald-50 text-emerald-700 border border-emerald-200"></span>
</div>
<div class="flex items-center gap-2">
<button id="btn-newwin" class="hidden px-3 py-1.5 text-sm rounded border border-slate-300 bg-white hover:bg-slate-50">새창으로 띄우기</button>
<button id="btn-regen" class="px-3 py-1.5 text-sm rounded border border-slate-300 bg-white hover:bg-slate-50">자동 생성(초기화)</button>
<button id="btn-save" class="px-3 py-1.5 text-sm rounded bg-emerald-600 text-white hover:bg-emerald-700">저장</button>
<div class="relative">
<button id="btn-export" class="px-3 py-1.5 text-sm rounded bg-brand-600 text-white hover:bg-brand-700">내보내기 ▾</button>
<div id="export-menu" class="hidden absolute right-0 mt-1 w-44 bg-white border border-slate-200 rounded shadow-lg z-40">
<button data-export="yaml" class="block w-full text-left px-3 py-2 text-sm hover:bg-slate-50">YAML 다운로드</button>
<button data-export="json" class="block w-full text-left px-3 py-2 text-sm hover:bg-slate-50">JSON 다운로드</button>
</div>
</div>
<button id="btn-close" class="px-3 py-1.5 text-sm rounded border border-slate-300 bg-white hover:bg-slate-50">닫기</button>
</div>
</header>
<!-- ===== Stepper ===== -->
<nav class="bg-white border-b border-slate-200 sticky z-20" style="top:56px;">
<div class="h-1 bg-slate-100">
<div id="stepper-progress" class="h-1 bg-brand-500 transition-all duration-300" style="width:16.66%"></div>
</div>
<ol id="stepper" class="grid grid-cols-5 px-2"></ol>
</nav>
<!-- ===== Body ===== -->
<main id="body" class="flex" style="min-height: calc(100vh - 56px - 72px);">
<section id="form-panel" class="bg-white border-r border-slate-200 transition-all duration-300" style="width:960px;">
<div class="flex items-center justify-between px-6 py-3 border-b border-slate-100 sticky bg-white z-10" style="top:128px;">
<div class="flex items-baseline gap-3">
<span class="text-xs uppercase tracking-wide text-slate-400">Step <span id="form-step-num">1</span> / 5</span>
<h2 class="text-base font-semibold text-slate-800" id="form-step-title">기본정보</h2>
</div>
<button id="btn-toggle-preview-from-form" class="hidden text-xs px-2 py-1 rounded border border-slate-200 text-slate-600 hover:bg-slate-50">▶ 미리보기 다시 열기</button>
</div>
<div id="form-content" class="px-6 py-5"></div>
<div class="sticky bottom-0 bg-white border-t border-slate-200 px-6 py-3 flex items-center justify-between">
<button id="btn-prev" class="px-4 py-2 text-sm rounded border border-slate-300 bg-white hover:bg-slate-50 disabled:opacity-40 disabled:cursor-not-allowed">◀ 이전</button>
<div class="text-xs text-slate-500" id="footer-hint">필수 항목을 채우고 다음 단계로 이동하세요</div>
<button id="btn-next" class="px-4 py-2 text-sm rounded bg-brand-600 text-white hover:bg-brand-700">다음 ▶</button>
</div>
</section>
<aside id="preview-panel" class="bg-slate-50 transition-all duration-300" style="width:640px;">
<div class="flex items-center justify-between px-4 py-2 border-b border-slate-200 bg-white sticky z-10" style="top:128px;">
<div class="flex items-center gap-1">
<button data-ptab="swagger" class="preview-tab px-3 py-1.5 text-sm rounded-t border-b-2 border-brand-600 text-brand-700 font-medium">Swagger UI</button>
<button data-ptab="yaml-ro" class="preview-tab px-3 py-1.5 text-sm rounded-t border-b-2 border-transparent text-slate-600 hover:text-slate-800">YAML 보기</button>
<button data-ptab="yaml-edit" class="preview-tab px-3 py-1.5 text-sm rounded-t border-b-2 border-transparent text-slate-600 hover:text-slate-800">스펙 편집</button>
</div>
<button id="btn-toggle-preview" class="text-xs px-2 py-1 rounded border border-slate-200 text-slate-600 hover:bg-slate-100">패널 숨기기 ▶</button>
</div>
<div id="yaml-edit-bar" class="hidden flex items-center justify-between bg-amber-50 border-b border-amber-200 px-4 py-2 text-xs">
<span class="text-amber-800">YAML 을 직접 편집한 뒤 [Form 에 적용] 을 눌러 양식에 동기화하세요.</span>
<div class="flex items-center gap-2">
<button id="btn-yaml-revert" class="px-2 py-1 rounded border border-amber-300 bg-white hover:bg-amber-100">변경 취소</button>
<button id="btn-yaml-apply" class="px-2 py-1 rounded bg-amber-600 text-white hover:bg-amber-700">Form 에 적용</button>
</div>
</div>
<div id="preview-swagger" class="overflow-auto" style="height: calc(100vh - 56px - 72px - 41px);"></div>
<div id="preview-monaco" class="hidden" style="height: calc(100vh - 56px - 72px - 41px);"></div>
</aside>
</main>
</div>
<div id="toast" class="fixed bottom-5 left-1/2 -translate-x-1/2 hidden px-4 py-2 rounded bg-slate-900 text-white text-sm shadow-lg z-50"></div>
<!-- Security scheme modal -->
<div id="sec-modal" class="hidden fixed inset-0 z-50 bg-slate-900/40 flex items-center justify-center">
<div class="bg-white rounded-lg shadow-xl w-[640px] max-h-[80vh] overflow-auto">
<div class="flex items-center justify-between px-5 py-3 border-b border-slate-200">
<h3 class="font-semibold text-slate-800">보안 스킴 추가</h3>
<button class="text-slate-400 hover:text-slate-700" data-sec-close>✕</button>
</div>
<div class="p-5" id="sec-modal-body"></div>
<div class="px-5 py-3 border-t border-slate-200 flex justify-end gap-2 bg-slate-50">
<button class="px-3 py-1.5 text-sm rounded border border-slate-300 bg-white" data-sec-close>취소</button>
<button id="btn-sec-save" class="px-3 py-1.5 text-sm rounded bg-brand-600 text-white">추가</button>
</div>
</div>
</div>
<script src="<c:url value='/js/djb/apispec/sample-data.js'/>"></script>
<script src="<c:url value='/js/djb/apispec/app.js'/>"></script>
</body>
</html>
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -0,0 +1,122 @@
/*!
* djb-swagger-i18n.js
* Swagger UI 영문 라벨을 한글로 치환하는 i18n 패치 (방법 B - DOM patch)
* 배포 경로 권장: static/plugins/swaggerUI/djb-swagger-i18n.js
* index.html 의 swagger-initializer.js 직전 또는 직후에 <script> 로 로드
*
* ?lang=en 쿼리스트링이 있으면 패치 비활성화 (원문 보기)
* 매핑 카탈로그는 01-i18n-mapping/i18n-strings.csv 와 동기 유지
*/
(function (window) {
'use strict';
// ── 비활성화 옵션 ──
if (/[?&]lang=en\b/.test(window.location.search)) return;
// ── 매핑 (key 는 디버깅용, 실제 비교는 EN 문자열 일치) ──
var I18N_MAP = {
// P0 — OAuth2 모달 본문
'auth.modal.title': { en: 'Available authorizations', ko: '사용 가능한 인증' },
'auth.scopes.description': {
en: 'Scopes are used to grant an application different levels of access to data on behalf of the end user. Each API may declare one or more scopes.',
ko: '스코프는 최종 사용자를 대신하여 애플리케이션이 데이터에 접근할 수 있는 권한 수준을 부여합니다. 각 API는 하나 이상의 스코프를 선언할 수 있습니다.'
},
'auth.scopes.swagger_grant': {
en: 'API requires the following scopes. Select which ones you want to grant to Swagger UI.',
ko: '이 API 는 아래 스코프가 필요합니다. Swagger UI 에 부여할 스코프를 선택하세요.'
},
'auth.flow.clientCredentials': { en: 'OAuth2 client credentials flow', ko: 'OAuth2 클라이언트 자격증명 흐름' },
'auth.flow.implicit': { en: 'OAuth2 implicit flow', ko: 'OAuth2 암묵적 흐름' },
'auth.flow.password': { en: 'OAuth2 password flow', ko: 'OAuth2 비밀번호 흐름' },
'auth.flow.authorizationCode': { en: 'OAuth2 authorization code flow', ko: 'OAuth2 인가 코드 흐름' },
'auth.field.tokenUrl': { en: 'Token URL:', ko: '토큰 URL:' },
'auth.field.flow': { en: 'Flow:', ko: '흐름:' },
'auth.field.clientId': { en: 'client_id:', ko: '클라이언트 ID (client_id):' },
'auth.field.clientSecret': { en: 'client_secret:',ko: '클라이언트 시크릿 (client_secret):' },
'auth.field.scopes': { en: 'Scopes:', ko: '스코프:' },
'auth.action.selectAll': { en: 'select all', ko: '모두 선택' },
'auth.action.selectNone': { en: 'select none', ko: '선택 해제' },
'auth.action.authorize': { en: 'Authorize', ko: '인증' },
'auth.action.close': { en: 'Close', ko: '닫기' },
'auth.action.logout': { en: 'Logout', ko: '로그아웃' },
'auth.modal.authorized': { en: 'authorized', ko: '인증됨' },
// P1 — 기타 인증 흐름
'auth.scheme.apiKey': { en: 'API key', ko: 'API 키' },
'auth.field.name': { en: 'name:', ko: '이름:' },
'auth.field.in': { en: 'in:', ko: '위치:' },
'auth.field.value': { en: 'Value:', ko: '값:' },
'basic.field.username': { en: 'Username:',ko: '사용자 ID:' },
'basic.field.password': { en: 'Password:',ko: '비밀번호:' }
// P2 (오퍼레이션/응답) 는 필요 시 추가
};
// 빠른 lookup 을 위해 EN → KO 인덱스 사전 생성
var EN_TO_KO = Object.create(null);
Object.keys(I18N_MAP).forEach(function (k) {
var e = I18N_MAP[k];
EN_TO_KO[e.en] = e.ko;
});
// ── 치환 대상 노드 식별 + 치환 ──
function translateNode(node) {
if (!node) return;
if (node.nodeType === Node.TEXT_NODE) {
var raw = node.nodeValue;
if (!raw) return;
var trimmed = raw.trim();
if (!trimmed) return;
// 1) 완전 일치 (가장 안전)
if (EN_TO_KO[trimmed]) {
node.nodeValue = raw.replace(trimmed, EN_TO_KO[trimmed]);
return;
}
// 2) 라벨 colon 패턴: "Token URL:" 같이 끝이 ":" 인 짧은 라벨
// (불필요 — 1번 완전 일치로 대부분 커버)
return;
}
if (node.nodeType !== Node.ELEMENT_NODE) return;
if (node.tagName === 'SCRIPT' || node.tagName === 'STYLE') return;
// input placeholder / button title 도 일부 케이스에 대비
if (node.tagName === 'INPUT' && node.placeholder && EN_TO_KO[node.placeholder.trim()]) {
node.placeholder = EN_TO_KO[node.placeholder.trim()];
}
var i, child = node.childNodes, len = child.length;
for (i = 0; i < len; i++) translateNode(child[i]);
}
function translateAll() {
var root = document.getElementById('swagger-ui') || document.body;
translateNode(root);
}
// ── MutationObserver — SwaggerUI 가 동적으로 DOM 을 다시 그릴 때마다 재적용 ──
var observer = new MutationObserver(function (mutations) {
for (var i = 0; i < mutations.length; i++) {
var m = mutations[i];
if (m.addedNodes && m.addedNodes.length) {
for (var j = 0; j < m.addedNodes.length; j++) translateNode(m.addedNodes[j]);
}
if (m.type === 'characterData') {
translateNode(m.target);
}
}
});
function start() {
translateAll();
observer.observe(document.body, {
childList: true,
subtree: true,
characterData: true
});
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', start);
} else {
start();
}
})(window);
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+8 -13
View File
@@ -4,7 +4,6 @@ plugins {
id 'eclipse-wtp'
id 'idea'
id 'war'
id 'com.diffplug.eclipse.apt' version '3.41.1'
}
group 'com.eactive'
@@ -49,17 +48,13 @@ compileJava {
options.encoding = 'UTF-8'
options.compilerArgs = ['-parameters']
options.generatedSourceOutputDirectory = project.file(generatedJavaDir)
aptOptions {
processorArgs = [ 'querydsl.generatedAnnotationClass' : 'com.querydsl.core.annotations.Generated' ]
}
}
war {
def profile = project.findProperty("profile") ?: "tomcat"
if (profile == "weblogic") {
webXml = file("WebContent/WEB-INF/weblogic-web.xml")
webXml = file("WebContent/WEB-INF/weblogic-web.xml")
exclude 'WEB-INF/web.xml'
}
@@ -80,8 +75,12 @@ tasks.withType(JavaCompile) {
dependencies {
annotationProcessor "org.projectlombok:lombok:1.18.28", "org.projectlombok:lombok-mapstruct-binding:0.2.0", "org.mapstruct:mapstruct-processor:1.5.5.Final"
annotationProcessor "com.querydsl:querydsl-apt:${queryDslVersion}:jpa", "jakarta.persistence:jakarta.persistence-api:2.2.3", "jakarta.annotation:jakarta.annotation-api:1.3.5"
annotationProcessor "org.projectlombok:lombok:1.18.28",
"org.projectlombok:lombok-mapstruct-binding:0.2.0",
"org.mapstruct:mapstruct-processor:1.5.5.Final"
annotationProcessor "com.querydsl:querydsl-apt:${queryDslVersion}:jpa",
"jakarta.persistence:jakarta.persistence-api:2.2.3",
"jakarta.annotation:jakarta.annotation-api:1.3.5"
implementation project(':elink-online-core')
implementation project(':elink-online-transformer')
@@ -257,11 +256,7 @@ eclipse {
}
synchronizationTasks settingEclipseEncoding, initDirs
jdt {
apt {
// generated .setting/org.eclipse.jdt.apt.core.prefs org.eclipse.jdt.apt.genSrcDir에 .
// project > properties > Java Compiler > Annoation Processing .
genSrcDir = file(generatedJavaDir)
}
}
project {
if (!natures.contains('org.eclipse.buildship.core.gradleprojectnature')) {
@@ -2,6 +2,7 @@ package com.eactive.eai.rms.data.entity.onl.apim.apigroup;
import com.eactive.eai.data.entity.onl.apim.apigroup.ApiGroup;
import com.eactive.eai.data.entity.onl.apim.apigroup.ApiGroupApi;
import com.eactive.eai.data.entity.onl.apim.apigroup.ApiGroupApiId;
import com.eactive.eai.data.entity.onl.apim.apigroup.QApiGroup;
import com.eactive.eai.data.entity.onl.apim.apigroup.QApiGroupApi;
import com.eactive.eai.data.jpa.AbstractDataService;
@@ -75,4 +76,37 @@ public class ApiGroupService extends AbstractDataService<ApiGroup, String, ApiGr
.where(qApiGroup.id.in(apiGroupIds))
.fetch();
}
/** API 를 지정한 그룹 목록에만 소속시킨다(기존 소속 제거 후 재설정). */
public void setApiGroupsForApi(String apiId, List<String> groupIds) {
deleteApiGroupApiByApiId(apiId);
if (groupIds == null) {
return;
}
for (String gid : groupIds) {
if (StringUtils.isBlank(gid)) {
continue;
}
ApiGroup group = repository.findById(gid).orElse(null);
if (group == null) {
continue;
}
Hibernate.initialize(group.getApiGroupApiList());
List<ApiGroupApi> list = group.getApiGroupApiList();
boolean exists = false;
for (ApiGroupApi a : list) {
if (a.getId() != null && apiId.equals(a.getId().getApiId())) {
exists = true;
break;
}
}
if (!exists) {
ApiGroupApi a = new ApiGroupApi();
a.setId(new ApiGroupApiId(gid, apiId));
a.setDisplayOrder(list.size() + 1);
list.add(a);
repository.save(group);
}
}
}
}
@@ -14,6 +14,7 @@ public interface PortalPropertyMapper extends GenericMapper<PropertyUI, PortalPr
@Mapping(source = "prptyGroupName", target = "id.propertyGroupName")
@Mapping(source = "prptyName", target = "id.propertyName")
@Mapping(source = "prpty2Val", target = "propertyValue")
@Mapping(source = "prptyDesc", target = "propertyDesc")
@Override
PortalProperty toEntity(PropertyUI vo);
@@ -21,6 +22,7 @@ public interface PortalPropertyMapper extends GenericMapper<PropertyUI, PortalPr
@Mapping(source ="id.propertyGroupName", target = "prptyGroupName")
@Mapping(source ="id.propertyName", target = "prptyName")
@Mapping(source ="propertyValue", target = "prpty2Val")
@Mapping(source ="propertyDesc", target = "prptyDesc")
@InheritInverseConfiguration
@Override
PropertyUI toVo(PortalProperty entity);
@@ -15,4 +15,7 @@ public class PropertyUI {
@JsonProperty("PRPTY2VAL")
private String prpty2Val;
@JsonProperty("PRPTYDESC")
private String prptyDesc;
}
@@ -50,7 +50,7 @@ public class ApiSpecController extends OnlBaseAnnotationController {
return "/onl/transaction/apim/apiSpecManPopup";
}
@GetMapping(value = "/onl/transaction/apim/apiSpecManPopup.view", params = "cmd=POPUP_LIST")
@GetMapping(value = "/onl/transaction/apim/apiSpecMan.view", params = "cmd=POPUP_LIST")
public String detailOrgPopupView() {
return "/onl/transaction/apim/apiSpecManDisplayOrgPopup";
}
@@ -0,0 +1,541 @@
package com.eactive.eai.rms.onl.transaction.apim;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;
import com.fasterxml.jackson.databind.node.TextNode;
import org.apache.commons.lang.StringEscapeUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import com.eactive.eai.data.entity.onl.message.EAIMessageEntity;
import com.eactive.eai.rms.common.base.OnlBaseAnnotationController;
import com.eactive.eai.rms.data.entity.onl.eaimsg.EAIMessageService;
import com.eactive.eai.rms.onl.manage.rule.layout.ui.LayoutUI;
import com.eactive.eai.rms.onl.transaction.apim.ui.ApiInterfaceUI;
import com.eactive.eai.rms.onl.transaction.apim.ui.ApiSpecInfoUI;
import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
import com.eactive.eai.rms.data.entity.onl.apim.apigroup.ApiGroupService;
import com.eactive.eai.data.entity.onl.apim.apigroup.ApiGroup;
import org.springframework.ui.Model;
/**
* 신규 OpenAPI Spec 6단계 편집 마법사 컨트롤러.
*
* apiInterfaceMan 상세의 "OpenAPI Spec" 버튼이 (_blank)으로 여는 페이지 마법사가 호출하는
* cmd API 제공한다. 저장은 기존 컬럼 + testbedSpec(OpenAPI JSON) 매핑(스키마 무변경, 경량).
*
* (MVC 컨트롤러는 springapp-servlet.xml com.eactive.eai.rms 스캔 범위에서만 등록되므로 컨트롤러는
* 해당 패키지에 둔다. 기존 apiSpecMan.view(v1) URL 분리해 공존한다.)
*/
@Controller
public class DjbApiSpecController extends OnlBaseAnnotationController {
@Autowired
private ApiSpecManService apiSpecManService;
@Autowired
private ApiInterfaceService apiInterfaceService;
@Autowired
private EAIMessageService eaiMessageService;
@Autowired
private DjbApiSpecSwaggerEnricher swaggerEnricher;
@Autowired
private DjbApiSpecLayoutMergeService layoutMergeService;
@Autowired
private PortalPropertyService portalPropertyService;
@Autowired
private ApiGroupService apiGroupService;
private final ObjectMapper objectMapper = new ObjectMapper();
// GW base URL 단일 기준 = 포탈 DjbTestbedGatewayProperty djb.gateway.base-url (PTL_PROPERTY 그룹 'Portal').
// 별도 swagger.gw.address 프로퍼티는 두지 않는다.
private static final String GW_BASE_URL_KEY = "djb.gateway.base-url";
private static final String GW_BASE_URL_DEFAULT = "PortalMock";
// "PortalMock" 포탈이 요청 origin 으로 치환하는 sentinel 이라 admin 미리보기용 서버 주소로는 부적합 대체값 사용.
private static final String GW_PREVIEW_FALLBACK = "http://127.0.0.1:39310";
// 진입
@GetMapping(value = "/onl/transaction/apim/djbApiSpecMan.view", params = "cmd=DETAIL")
public String viewDetail(Model model) {
// GW base URL (djb.gateway.base-url, 그룹 'Portal') 없으면 기본값으로 생성. DjbTestbedGatewayProperty 동일 .
String gw = portalPropertyService.getOrCreateProperty(
"Portal", GW_BASE_URL_KEY, GW_BASE_URL_DEFAULT, "GW base URL (테스트베드 공통)");
if (StringUtils.isBlank(gw) || GW_BASE_URL_DEFAULT.equalsIgnoreCase(gw.trim())) {
gw = GW_PREVIEW_FALLBACK; // PortalMock admin 미리보기용 구체 주소로 대체
}
model.addAttribute("gwAddress", gw.trim());
return "/onl/transaction/apim/djbApiSpecManPopup";
}
// API 그룹 선택 팝업(iframe 모달 대상). 그룹 목록 그리드는 apiGroupMan.json?cmd=LIST 재사용.
@GetMapping(value = "/onl/transaction/apim/djbApiSpecMan.view", params = "cmd=GROUP_POPUP")
public String viewGroupPopup() {
return "/onl/transaction/apim/djbApiGroupPopup";
}
// 조회: 저장 spec 우선 + authtype securityScheme 주입
@PostMapping(value = "/onl/transaction/apim/djbApiSpecMan.json", params = "cmd=DETAIL_SPEC")
@ResponseBody
public ResponseEntity<Map<String, String>> detailSpec(String eaiSvcName, String regen) throws Exception {
Map<String, String> result = new HashMap<>();
if (StringUtils.isBlank(eaiSvcName)) {
result.put("status", "fail");
result.put("errorMsg", "eaiSvcName 이 없습니다.");
return ResponseEntity.badRequest().body(result);
}
// regen=true 이면 저장본 무시하고 레이아웃 기반으로 강제 재생성 (자동 생성/초기화)
boolean force = "true".equalsIgnoreCase(regen);
String spec;
String source;
ApiSpecInfoUI saved = force ? null : apiSpecManService.selectDetail(eaiSvcName);
if (!force && saved != null && StringUtils.isNotBlank(saved.getTestbedSpec())) {
spec = saved.getTestbedSpec();
source = "saved";
} else {
spec = generateSpec(eaiSvcName);
source = force ? "regenerated" : "generated";
}
String authtype = eaiMessageService.findById(eaiSvcName)
.map(EAIMessageEntity::getAuthtype)
.orElse(null);
String enriched = swaggerEnricher.enrich(spec, authtype);
result.put("testbedSpec", enriched);
result.put("source", source);
result.put("authType", authtype == null ? "" : authtype);
// API 그룹 소속(조인테이블 ApiGroupApi) 저장 여부와 무관하게 현재 소속 반환
try {
ArrayNode groups = objectMapper.createArrayNode();
for (ApiGroup g : apiGroupService.findByApiId(eaiSvcName)) {
ObjectNode gn = objectMapper.createObjectNode();
gn.put("id", g.getId());
gn.put("groupName", g.getGroupName());
groups.add(gn);
}
result.put("apiGroups", objectMapper.writeValueAsString(groups));
} catch (Exception e) {
logger.warn("API 그룹 조회 실패: " + eaiSvcName, e);
}
// 저장본이면 복원용 기본정보/공개설정도 함께 반환
if (saved != null) {
putIfNotNull(result, "apiName", saved.getApiName());
putIfNotNull(result, "apiSimpleDescription", saved.getApiSimpleDescription());
putIfNotNull(result, "apiUrl", saved.getApiUrl());
putIfNotNull(result, "apiMethod", saved.getApiMethod());
putIfNotNull(result, "apiContentType", saved.getApiContentType());
putIfNotNull(result, "description", saved.getDescription());
putIfNotNull(result, "apiRequestSpec", saved.getApiRequestSpec());
putIfNotNull(result, "apiResponseSpec", saved.getApiResponseSpec());
putIfNotNull(result, "sampleRequest", saved.getSampleRequest());
putIfNotNull(result, "sampleResponse", saved.getSampleResponse());
putIfNotNull(result, "responseType", saved.getResponseType());
putIfNotNull(result, "mockUrl", saved.getMockUrl());
putIfNotNull(result, "displayYn", saved.getDisplayYn());
putIfNotNull(result, "displayRoleCode", saved.getDisplayRoleCode());
putIfNotNull(result, "displayOrg", saved.getDisplayOrg());
}
// 예제/설명자료(요청·응답 메시지 스펙 HTML) 프론트에서 스키마 기준으로 생성 자동생성/재생성 결과 일치.
// 저장본이면 saved 블록에서 저장값을 이미 반환.
return ResponseEntity.ok(result);
}
// 저장: 마법사 ApiSpecInfoUI apiSpecManService.save (기존 재사용)
@PostMapping(value = "/onl/transaction/apim/djbApiSpecMan.json", params = "cmd=SAVE")
@ResponseBody
public ResponseEntity<Map<String, String>> save(ApiSpecInfoUI apiSpecInfoUI, String apiGroupIds) {
Map<String, String> result = new HashMap<>();
if (apiSpecInfoUI == null || StringUtils.isBlank(apiSpecInfoUI.getApiId())) {
result.put("status", "fail");
result.put("errorMsg", "API ID 가 없습니다.");
return ResponseEntity.badRequest().body(result);
}
// CrossScriptingFilter(RequestWrapper.cleanXSS) 요청 파라미터의 특수문자를 엔티티로 치환
// ('('&#40; ')'&#41; '"'&quot; )하므로, 저장 모든 자유텍스트/JSON 필드를 언이스케이프해 원복한다.
// (JSON 필드는 특히 '"'&quot; 깨지므로 필수)
apiSpecInfoUI.setApiName(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getApiName()));
apiSpecInfoUI.setApiSimpleDescription(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getApiSimpleDescription()));
apiSpecInfoUI.setApiUrl(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getApiUrl()));
apiSpecInfoUI.setMockUrl(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getMockUrl()));
apiSpecInfoUI.setApiRequestSpec(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getApiRequestSpec()));
apiSpecInfoUI.setApiResponseSpec(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getApiResponseSpec()));
apiSpecInfoUI.setSampleRequest(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getSampleRequest()));
apiSpecInfoUI.setSampleResponse(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getSampleResponse()));
apiSpecInfoUI.setDescription(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getDescription()));
apiSpecInfoUI.setTestbedSpec(StringEscapeUtils.unescapeHtml(apiSpecInfoUI.getTestbedSpec()));
apiSpecManService.save(apiSpecInfoUI);
// API 그룹 소속(조인테이블) 동기화 apiGroupIds(CSV) 재설정
try {
java.util.List<String> gids = new ArrayList<>();
if (StringUtils.isNotBlank(apiGroupIds)) {
for (String g : apiGroupIds.split(",")) {
if (StringUtils.isNotBlank(g)) {
gids.add(g.trim());
}
}
}
apiGroupService.setApiGroupsForApi(apiSpecInfoUI.getApiId(), gids);
} catch (Exception e) {
logger.warn("API 그룹 동기화 실패: " + apiSpecInfoUI.getApiId(), e);
}
result.put("status", "success");
result.put("apiId", apiSpecInfoUI.getApiId());
return ResponseEntity.ok(result);
}
// 레이아웃 불러오기 (GW)
@PostMapping(value = "/onl/transaction/apim/djbApiSpecMan.json", params = "cmd=LOAD_REQUEST_LAYOUT")
@ResponseBody
public ResponseEntity<Map<String, Object>> loadRequestLayout(String eaiSvcName) throws Exception {
return loadLayout(eaiSvcName, true);
}
@PostMapping(value = "/onl/transaction/apim/djbApiSpecMan.json", params = "cmd=LOAD_RESPONSE_LAYOUT")
@ResponseBody
public ResponseEntity<Map<String, Object>> loadResponseLayout(String eaiSvcName) throws Exception {
return loadLayout(eaiSvcName, false);
}
// HTML 테이블 생성 (기존 generateSpecTableFromLayout 재사용)
@PostMapping(value = "/onl/transaction/apim/djbApiSpecMan.json", params = "cmd=GENERATE_HTML")
@ResponseBody
public ResponseEntity<Map<String, String>> generateHtml(String eaiSvcName, String layoutType) throws Exception {
LayoutUI layout = resolveLayout(eaiSvcName, !"RESPONSE".equalsIgnoreCase(layoutType));
Map<String, String> result = new HashMap<>();
result.put("html", apiSpecManService.generateSpecTableFromLayout(layout));
return ResponseEntity.ok(result);
}
// 메시지 예제 생성 (기존 generateSampleDataFromLayout 재사용)
@PostMapping(value = "/onl/transaction/apim/djbApiSpecMan.json", params = "cmd=GENERATE_SAMPLE")
@ResponseBody
public ResponseEntity<Map<String, String>> generateSample(String eaiSvcName, String layoutType) throws Exception {
LayoutUI layout = resolveLayout(eaiSvcName, !"RESPONSE".equalsIgnoreCase(layoutType));
Map<String, String> result = new HashMap<>();
result.put("json", apiSpecManService.generateSampleDataFromLayout(layout));
return ResponseEntity.ok(result);
}
// 내부 헬퍼
private ResponseEntity<Map<String, Object>> loadLayout(String eaiSvcName, boolean request) throws Exception {
Map<String, Object> res = new LinkedHashMap<>();
List<String> warnings = new ArrayList<>();
if (StringUtils.isBlank(eaiSvcName)) {
res.put("layoutType", request ? "REQUEST" : "RESPONSE");
res.put("fields", new ArrayList<>());
warnings.add("eaiSvcName 이 없습니다.");
res.put("warnings", warnings);
return ResponseEntity.ok(res);
}
LayoutUI layout = resolveLayout(eaiSvcName, request);
if (layout == null || layout.getLayoutItems() == null || layout.getLayoutItems().isEmpty()) {
warnings.add((request ? "요청" : "응답") + " 레이아웃이 없습니다.");
}
res.put("layoutType", request ? "REQUEST" : "RESPONSE");
res.put("fields", layoutMergeService.toFields(layout, request ? "REQUEST" : "RESPONSE"));
res.put("warnings", warnings);
return ResponseEntity.ok(res);
}
private LayoutUI resolveLayout(String eaiSvcName, boolean request) throws Exception {
ApiInterfaceUI apiInterfaceUI = apiInterfaceService.selectDetail(eaiSvcName);
if (apiInterfaceUI == null) {
return null;
}
String layoutName = request ? apiInterfaceUI.getInboundRequestLayout() : apiInterfaceUI.getInboundResponseLayout();
return StringUtils.isNotEmpty(layoutName) ? apiSpecManService.selectLayoutUI(layoutName) : null;
}
/**
* 레이아웃 기반 자동 생성 + 자동생성 규칙(백엔드 단일 소스).
* 규칙: title/tag/summary = API명(eaiSvcDesc), operationId = 인터페이스ID,
* servers[0].url path 앞에 붙이고 servers 제거(서버 선택 제거),
* 요청/200 응답 예제를 레이아웃 샘플로 임베드.
*/
private String generateSpec(String eaiSvcName) throws Exception {
ApiInterfaceUI apiInterfaceUI = apiInterfaceService.selectDetail(eaiSvcName);
if (apiInterfaceUI == null) {
throw new IllegalStateException("API 인터페이스 정보를 찾을 수 없습니다: " + eaiSvcName);
}
Map<String, String> inboundAdapterSpec = apiInterfaceService.getHttpAdapterInfo(apiInterfaceUI.getFromAdapter());
if (inboundAdapterSpec == null) {
inboundAdapterSpec = new HashMap<>();
}
String requestLayoutName = apiInterfaceUI.getInboundRequestLayout();
String responseLayoutName = apiInterfaceUI.getInboundResponseLayout();
LayoutUI requestLayoutUI = StringUtils.isNotEmpty(requestLayoutName)
? apiSpecManService.selectLayoutUI(requestLayoutName) : null;
LayoutUI responseLayoutUI = StringUtils.isNotEmpty(responseLayoutName)
? apiSpecManService.selectLayoutUI(responseLayoutName) : null;
String baseSpec = apiSpecManService.generateSwaggerSpec(requestLayoutUI, responseLayoutUI, inboundAdapterSpec, apiInterfaceUI);
String apiName = StringUtils.isNotBlank(apiInterfaceUI.getEaiSvcDesc()) ? apiInterfaceUI.getEaiSvcDesc() : eaiSvcName;
String reqSample = apiSpecManService.generateSampleDataFromLayout(requestLayoutUI);
String resSample = apiSpecManService.generateSampleDataFromLayout(responseLayoutUI);
String contentType = StringUtils.isNotBlank(apiInterfaceUI.getRestContentType()) ? apiInterfaceUI.getRestContentType() : "application/json";
return applyAutoRules(baseSpec, apiName, eaiSvcName, reqSample, resSample, contentType);
}
/** 자동생성 규칙 후처리(Jackson 트리 조작). 실패 시 원본 유지. */
private String applyAutoRules(String specJson, String apiName, String eaiSvcName, String reqSample, String resSample, String contentType) {
try {
JsonNode parsed = objectMapper.readTree(specJson);
if (!parsed.isObject()) {
return specJson;
}
ObjectNode root = (ObjectNode) parsed;
root.put("openapi", "3.1.0"); // OpenAPI 3.1 방출(Swagger UI 5.x oas31 렌더 지원)
getOrCreateObject(root, "info").put("title", apiName);
String tagName = "DJBank"; // 자동생성 태그명 고정
ArrayNode tags = objectMapper.createArrayNode();
ObjectNode tag = objectMapper.createObjectNode();
tag.put("name", tagName);
tag.put("description", apiName); // 태그 설명 = 간단설명(API명)
tags.add(tag);
root.set("tags", tags);
// 어댑터경로(servers[0].url = getHttpAdapterInfo urlPath) path 앞에 baking 하고 servers 제거.
// 호스트(gw=djb.gateway.base-url / mock=Mock URL / sample=없음) 프론트가 응답유형에 따라 서버로 붙인다.
String adapterPath = "";
JsonNode serversNode = root.get("servers");
if (serversNode != null && serversNode.isArray() && serversNode.size() > 0 && serversNode.get(0).get("url") != null) {
adapterPath = serversNode.get(0).get("url").asText("");
}
root.remove("servers");
JsonNode pathsNode = root.get("paths");
if (pathsNode != null && pathsNode.isObject()) {
ObjectNode paths = (ObjectNode) pathsNode;
List<String> pathKeys = new ArrayList<>();
Iterator<String> pit = paths.fieldNames();
while (pit.hasNext()) {
pathKeys.add(pit.next());
}
for (String pk : pathKeys) {
JsonNode pathItem = paths.get(pk);
if (pathItem != null && pathItem.isObject()) {
List<String> methods = new ArrayList<>();
Iterator<String> mit = pathItem.fieldNames();
while (mit.hasNext()) {
methods.add(mit.next());
}
for (String mk : methods) {
JsonNode opNode = pathItem.get(mk);
if (opNode != null && opNode.isObject()) {
ObjectNode op = (ObjectNode) opNode;
op.put("operationId", eaiSvcName);
op.put("summary", apiName);
ArrayNode opTags = objectMapper.createArrayNode();
opTags.add(tagName);
op.set("tags", opTags);
// 예제(요청/응답 본문) 프론트에서 스키마 기준으로 생성 자동생성/재생성 결과 일치. 여기선 임베드하지 않음.
markGwOnOperation(op);
addResponseHeader(op, "200", "Content-Type", contentType);
}
}
}
String newKey = adapterPath.isEmpty() ? pk
: (adapterPath.replaceAll("/+$", "") + (pk.startsWith("/") ? "" : "/") + pk);
if (!newKey.equals(pk)) {
paths.set(newKey, pathItem);
paths.remove(pk);
}
}
}
return objectMapper.writeValueAsString(root);
} catch (Exception e) {
logger.error("applyAutoRules 실패, 원본 spec 유지", e);
return specJson;
}
}
private void setContentExample(ObjectNode op, String sampleJson) {
if (StringUtils.isBlank(sampleJson)) {
return;
}
JsonNode body = op.get("requestBody");
if (body == null || !body.isObject()) {
return;
}
JsonNode content = body.get("content");
if (content == null || !content.isObject()) {
return;
}
Iterator<String> mts = content.fieldNames();
if (!mts.hasNext()) {
return;
}
JsonNode mtNode = content.get(mts.next());
if (mtNode != null && mtNode.isObject()) {
((ObjectNode) mtNode).set("example", parseJsonOrText(sampleJson));
}
}
private void setResponseExample(ObjectNode op, String code, String sampleJson) {
if (StringUtils.isBlank(sampleJson)) {
return;
}
JsonNode resps = op.get("responses");
if (resps == null || !resps.isObject()) {
return;
}
JsonNode r = resps.get(code);
if (r == null || !r.isObject()) {
return;
}
ObjectNode content = getOrCreateObject((ObjectNode) r, "content");
ObjectNode appjson = getOrCreateObject(content, "application/json");
appjson.set("example", parseJsonOrText(sampleJson));
}
/** GW 유래 스키마 필드에 x-djb-gw 마커 부여(프론트에서 잠금 표시). */
private void markGwOnOperation(ObjectNode op) {
JsonNode body = op.get("requestBody");
if (body != null && body.isObject()) {
markGwInContent(body.get("content"));
}
JsonNode resps = op.get("responses");
if (resps != null && resps.isObject()) {
List<String> codes = new ArrayList<>();
Iterator<String> it = resps.fieldNames();
while (it.hasNext()) {
codes.add(it.next());
}
for (String c : codes) {
JsonNode r = resps.get(c);
if (r != null && r.isObject()) {
markGwInContent(r.get("content"));
}
}
}
}
private void markGwInContent(JsonNode content) {
if (content == null || !content.isObject()) {
return;
}
List<String> mts = new ArrayList<>();
Iterator<String> it = content.fieldNames();
while (it.hasNext()) {
mts.add(it.next());
}
for (String mt : mts) {
JsonNode m = content.get(mt);
if (m != null && m.isObject()) {
markGwSchema(m.get("schema"));
}
}
}
private void markGwSchema(JsonNode schema) {
if (schema == null || !schema.isObject()) {
return;
}
ObjectNode s = (ObjectNode) schema;
JsonNode props = s.get("properties");
if (props != null && props.isObject()) {
ArrayNode required = (s.get("required") != null && s.get("required").isArray())
? (ArrayNode) s.get("required") : objectMapper.createArrayNode();
java.util.Set<String> existing = new java.util.HashSet<>();
required.forEach(n -> existing.add(n.asText()));
List<String> keys = new ArrayList<>();
Iterator<String> it = props.fieldNames();
while (it.hasNext()) {
keys.add(it.next());
}
for (String k : keys) {
JsonNode p = props.get(k);
if (p != null && p.isObject()) {
((ObjectNode) p).put("x-djb-gw", true);
if (!existing.contains(k)) { // GW 필드는 기본 '필수'
required.add(k);
existing.add(k);
}
markGwSchema(p);
}
}
if (required.size() > 0) {
s.set("required", required);
}
}
JsonNode items = s.get("items");
if (items != null && items.isObject()) {
markGwSchema(items);
}
}
/** 응답 헤더 미리 등록(중복 시 스킵). */
private void addResponseHeader(ObjectNode op, String code, String headerName, String example) {
JsonNode resps = op.get("responses");
if (resps == null || !resps.isObject()) {
return;
}
JsonNode r = resps.get(code);
if (r == null || !r.isObject()) {
return;
}
ObjectNode headers = getOrCreateObject((ObjectNode) r, "headers");
if (headers.has(headerName)) {
return;
}
ObjectNode h = objectMapper.createObjectNode();
h.put("description", headerName);
ObjectNode sc = objectMapper.createObjectNode();
sc.put("type", "string");
h.set("schema", sc);
h.put("example", example);
headers.set(headerName, h);
}
private JsonNode parseJsonOrText(String s) {
try {
return objectMapper.readTree(s);
} catch (Exception e) {
return TextNode.valueOf(s);
}
}
private ObjectNode getOrCreateObject(ObjectNode parent, String field) {
JsonNode node = parent.get(field);
if (node != null && node.isObject()) {
return (ObjectNode) node;
}
ObjectNode created = objectMapper.createObjectNode();
parent.set(field, created);
return created;
}
private void putIfNotNull(Map<String, String> map, String key, String value) {
if (value != null) {
map.put(key, value);
}
}
}
@@ -0,0 +1,60 @@
package com.eactive.eai.rms.onl.transaction.apim;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.eactive.eai.rms.onl.manage.rule.layout.ui.LayoutItemUI;
import com.eactive.eai.rms.onl.manage.rule.layout.ui.LayoutUI;
/**
* D9 레이아웃 머지: GW LayoutUI 마법사 그리드용 필드 목록으로 변환한다.
*
* <p>GW 에서 필드는 {@code sourceType=GW}(항목명/데이터타입 잠금) 표기하고, 예제값은
* {@link DjbApiSpecSampleGenerator} 규칙으로 자동 채운다. 저장된 spec 부가정보(설명/예제/제약)
* 병합은 클라이언트(그리드)에서 사용자 편집분과 합치므로, 서버는 GW 원본 필드 + 자동 예제까지 제공한다.
*/
@Service
public class DjbApiSpecLayoutMergeService {
@Autowired
private DjbApiSpecSampleGenerator sampleGenerator;
/** LayoutUI → 그리드 필드 행 목록(flat, depth/parentIndex 로 트리 복원 가능). */
public List<Map<String, Object>> toFields(LayoutUI layout, String layoutType) {
List<Map<String, Object>> rows = new ArrayList<>();
if (layout == null || layout.getLayoutItems() == null) {
return rows;
}
for (LayoutItemUI it : layout.getLayoutItems()) {
// serno 0 root 컨테이너 스킵 (ApiSpecManService.generateSpecTableRows 규칙과 동일)
if (it.getLoutItemSerno() != null && it.getLoutItemSerno() == 0) {
continue;
}
String dataType = it.getLoutItemDataType();
int len = it.getLoutItemLength();
int dec = it.getLoutItemDecimal();
Map<String, Object> r = new LinkedHashMap<>();
r.put("serno", it.getLoutItemSerno());
r.put("name", it.getLoutItemName());
r.put("desc", it.getLoutItemDesc());
r.put("itemType", it.getLoutItemType()); // FIELD / GROUP / GRID
r.put("dataType", dataType);
r.put("category", sampleGenerator.categoryOf(dataType));
r.put("length", len);
r.put("decimal", dec);
r.put("depth", it.getLoutItemDepth());
r.put("parentIndex", it.getParentLoutItemIndex());
r.put("required", false);
r.put("sourceType", "GW");
r.put("example", sampleGenerator.exampleFor(dataType, it.getLoutItemName(), len, dec));
rows.add(r);
}
return rows;
}
}
@@ -0,0 +1,75 @@
package com.eactive.eai.rms.onl.transaction.apim;
import org.apache.commons.lang3.StringUtils;
import org.springframework.stereotype.Service;
/**
* D10 예제값 자동 생성 규칙.
* <ul>
* <li>string {@code sample_} + 항목명. 최대길이 초과 left-cut(앞에서 자름).</li>
* <li>integer {@code 1}</li>
* <li>number {@code 1.1} (소수 자릿수 지정 {@code 1.1000} 형태)</li>
* <li>boolean {@code false}</li>
* </ul>
*/
@Service
public class DjbApiSpecSampleGenerator {
/** 원시 데이터타입(레이아웃 값)을 OpenAPI 계열 카테고리로 분류. */
public String categoryOf(String rawDataType) {
if (rawDataType == null) {
return "string";
}
String t = rawDataType.trim().toLowerCase();
if (t.contains("bool")) {
return "boolean";
}
if (t.contains("decimal") || t.contains("double") || t.contains("float") || t.contains("number")) {
return "number";
}
if (t.contains("int") || t.contains("long")) {
return "integer";
}
if (t.contains("object") || t.contains("group")) {
return "object";
}
if (t.contains("array") || t.contains("grid") || t.contains("list")) {
return "array";
}
return "string";
}
/**
* 예제값 생성.
* @param rawDataType 레이아웃 데이터타입(원시)
* @param fieldName 항목명
* @param maxLen 최대 길이(0/음수면 무제한)
* @param decimalLen 소수 자릿수(0이면 미적용)
*/
public String exampleFor(String rawDataType, String fieldName, int maxLen, int decimalLen) {
switch (categoryOf(rawDataType)) {
case "integer":
return "1";
case "number":
if (decimalLen > 0) {
StringBuilder sb = new StringBuilder("1.");
for (int i = 0; i < decimalLen; i++) {
sb.append(i == 0 ? '1' : '0');
}
return sb.toString();
}
return "1.1";
case "boolean":
return "false";
case "object":
case "array":
return ""; // 컨테이너는 예제값 없음(자식으로 표현)
default:
String v = "sample_" + StringUtils.defaultString(fieldName);
if (maxLen > 0 && v.length() > maxLen) {
v = v.substring(0, maxLen); // left-cut
}
return v;
}
}
}
@@ -0,0 +1,101 @@
package com.eactive.eai.rms.onl.transaction.apim;
import org.apache.commons.lang3.StringUtils;
import org.springframework.stereotype.Service;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;
/**
* 생성/저장된 OpenAPI(3.0) spec JSON 인증 체계(components.securitySchemes + 글로벌 security) 주입한다.
*
* <p>포털 {@code DjbSwaggerSpecEnricher} 동일 모델링:
* 게이트웨이가 토큰/키를 표준 Authorization 아니라 커스텀 헤더로 받으므로 OAuth·API_KEY 모두
* <b>apiKey-in-header</b> 스킴으로 표현(헤더명만 상이).
*
* <p>authtype(TSEAIHE01.AUTHTYPE, 소문자 저장) 매핑:
* {@code oauth/oauth2/ca OAUTH}, {@code api_key/apikey API_KEY}, 주입 없음.
* 원본 트리를 보존하며 조작한다(문자열 치환 금지). 매핑 불가/ 스펙/파싱 실패 원본 유지(멱등).
*/
@Service
public class DjbApiSpecSwaggerEnricher {
private final ObjectMapper objectMapper = new ObjectMapper();
public static final String OAUTH_SCHEME = "djbOAuth";
public static final String API_KEY_SCHEME = "djbApiKey";
// 게이트웨이 헤더명 (포털 DjbTestbedGatewayProperty 기본값과 동일)
public static final String OAUTH_HEADER = "X-AUTH-TOKEN";
public static final String API_KEY_HEADER = "X-DJB-API-Key";
/** authtype → 스킴명. 매핑 불가면 null. */
public String schemeNameOf(String authtype) {
if (authtype == null) {
return null;
}
switch (authtype.trim().toLowerCase()) {
case "oauth":
case "oauth2":
case "ca":
return OAUTH_SCHEME;
case "api_key":
case "apikey":
return API_KEY_SCHEME;
default:
return null;
}
}
/**
* spec JSON authtype 기반 securityScheme 주입. 매핑 불가/ 스펙/파싱 실패 원본 그대로 반환.
*/
public String enrich(String specJson, String authtype) {
String schemeName = schemeNameOf(authtype);
if (StringUtils.isBlank(specJson) || schemeName == null) {
return specJson;
}
try {
JsonNode parsed = objectMapper.readTree(specJson);
if (!parsed.isObject()) {
return specJson;
}
ObjectNode root = (ObjectNode) parsed;
ObjectNode scheme = objectMapper.createObjectNode();
scheme.put("type", "apiKey");
scheme.put("in", "header");
scheme.put("name", OAUTH_SCHEME.equals(schemeName) ? OAUTH_HEADER : API_KEY_HEADER);
boolean swagger2 = root.has("swagger") && !root.has("openapi");
if (swagger2) {
getOrCreateObject(root, "securityDefinitions").set(schemeName, scheme);
} else {
ObjectNode components = getOrCreateObject(root, "components");
getOrCreateObject(components, "securitySchemes").set(schemeName, scheme);
}
// 글로벌 security 요구사항 (apiKey 스킴은 스코프 배열)
ArrayNode security = objectMapper.createArrayNode();
ObjectNode requirement = objectMapper.createObjectNode();
requirement.set(schemeName, objectMapper.createArrayNode());
security.add(requirement);
root.set("security", security);
return objectMapper.writeValueAsString(root);
} catch (Exception e) {
return specJson; // 파싱/직렬화 실패 원본 유지(멱등)
}
}
private ObjectNode getOrCreateObject(ObjectNode parent, String field) {
JsonNode node = parent.get(field);
if (node != null && node.isObject()) {
return (ObjectNode) node;
}
ObjectNode created = objectMapper.createObjectNode();
parent.set(field, created);
return created;
}
}
+183
View File
@@ -0,0 +1,183 @@
<?xml version="1.0" encoding="UTF-8" ?>
<configuration scan="true" scanPeriod="10 seconds">
<statusListener class="ch.qos.logback.core.status.OnConsoleStatusListener" />
<property name="LOG_PATTERN" value="[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%-5level] \\(%F:%L\\) %-20M -%msg%n" />
<property name="PREFIX" value="${inst.Type:-ems}" />
<property name="LOG_HOME" value="/Users/rinjae/eactive/djb-eapim/djb-eapim/eapim-admin/logs" />
<property name="BACKUP_HOME" value="${LOG_HOME}/backup/" />
<property name="LOG_LEVEL" value="${LOGBACK_LOG_LEVEL:-DEBUG}" />
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<charset>utf-8</charset>
<pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<appender name="STDOUT"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/${PREFIX}_stdout.log</file>
<rollingPolicy
class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>
${LOG_HOME}/${PREFIX}_stdout.log-%d{yyyy-MM-dd}.%i
</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
<maxHistory>10</maxHistory>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<appender name="ACCESS_APPENDER"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/${PREFIX}_access.log</file>
<rollingPolicy
class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>
${LOG_HOME}/${PREFIX}_access.log-%d{yyyy-MM-dd}.%i
</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<appender name="SMS_APPENDER"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/sms.log</file>
<rollingPolicy
class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>
${LOG_HOME}/sms.log-%d{yyyy-MM-dd}.%i
</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
<maxHistory>10</maxHistory>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<appender name="QUERY_APPENDER"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/${PREFIX}_query.log</file>
<rollingPolicy
class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>
${LOG_HOME}/${PREFIX}_query.log-%d{yyyy-MM-dd}.%i
</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
<maxHistory>10</maxHistory>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<appender name="DYNAMIC_APPENDER"
class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/${PREFIX}_dynamic.log</file>
<rollingPolicy
class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>
${LOG_HOME}/${PREFIX}_dynamic.log-%d{yyyy-MM-dd}.%i
</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
<maxHistory>10</maxHistory>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<appender name="HIBERNATE_APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/${PREFIX}_hibernate.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${LOG_HOME}/${PREFIX}_hibernate.log-%d{yyyy-MM-dd}.%i</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
<maxHistory>10</maxHistory>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<appender name="HOTSWAP_APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_HOME}/${PREFIX}_hotswap.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${LOG_HOME}/${PREFIX}_hotswap.log-%d{yyyy-MM-dd}.%i</fileNamePattern>
<maxFileSize>500MB</maxFileSize>
<maxHistory>10</maxHistory>
</rollingPolicy>
<encoder>
<charset>utf-8</charset>
<pattern>${LOG_PATTERN}</pattern>
</encoder>
</appender>
<logger name="com.eactive.eai.rms.onl.server" level="ERROR" />
<logger name="com.eactive.eai.rms.onl.dashboard" level="ERROR" />
<logger name="com.eactive.eai.rms.common.acl.user.BizDao" level="ERROR" />
<logger name="com.eactive.eai.rms.common.acl.user.BizDao" level="ERROR" />
<logger name="com.eactive.eai.rms.ext.djb.job.ApiStatusMonitorJob" level="ERROR" />
<logger name="org.springframework.orm.jpa.JpaTransactionManager" level="ERROR" additivity="false" />
<logger name="org.springframework" level="INFO" />
<logger name="net.sf.ehcache" level="INFO" />
<logger name="ACCESS_LOGGER" level="DEBUG" >
<appender-ref ref="ACCESS_APPENDER" />
</logger>
<logger name="SMS_LOGGER" level="DEBUG" >
<appender-ref ref="SMS_APPENDER" />
</logger>
<logger name="DYNAMIC_LOGGER" level="DEBUG" >
<appender-ref ref="DYNAMIC_APPENDER" />
</logger>
<!-- QUERY_APPENDER start -->
<!-- Hibernate SQL & 파라미터 바인딩 -->
<logger name="org.hibernate.SQL" level="DEBUG" additivity="false">
<appender-ref ref="QUERY_APPENDER" />
<appender-ref ref="HIBERNATE_APPENDER" />
</logger>
<logger name="org.hibernate.type.descriptor.sql.BasicBinder" level="TRACE" additivity="false">
<appender-ref ref="QUERY_APPENDER" />
<appender-ref ref="HIBERNATE_APPENDER" />
</logger>
<logger name="org.hibernate.type.descriptor.sql.BasicExtractor" level="TRACE" additivity="false">
<appender-ref ref="QUERY_APPENDER" />
<appender-ref ref="HIBERNATE_APPENDER" />
</logger>
<!-- Hibernate 일반 로그 (DDL/init/connection 등) -->
<logger name="org.hibernate" level="INFO" additivity="false">
<appender-ref ref="HIBERNATE_APPENDER" />
<appender-ref ref="STDOUT" />
</logger>
<!-- iBATIS 2.3.4 (commons-logging 또는 log4j-over-slf4j 통해 SLF4J 도달) -->
<logger name="com.ibatis" level="DEBUG" additivity="false">
<appender-ref ref="QUERY_APPENDER" />
</logger>
<logger name="com.eactive.eai.rms.common.base.SchemaIdConfiguredSqlMapTemplate" level="DEBUG" additivity="false">
<appender-ref ref="QUERY_APPENDER" />
</logger>
<!-- QUERY_APPENDER end -->
<!-- HotswapAgent는 자체 logger를 사용하므로 logback에 안 잡힘. hotswap-agent.properties의 LOGFILE로 직접 파일 출력 -->
<root>
<level value="INFO" />
<appender-ref ref="STDOUT" />
<appender-ref ref="CONSOLE" />
</root>
</configuration>