모듈:JSON

JSON 데이터를 읽어들여 값을 반환하거나, 데이터를 수정합니다.

주의사항

이 모듈은 null을 없는 값으로 간주합니다. 따라서 null 값을 보존하려면 이 모듈을 사용하지 말것을 권장합니다.

사용전:
{"var1": true, "var2": null, "var3": false}

사용후:
{"var1": true, "var3": false}

루아에서는 배열의 순서가 1부터 시작합니다. 이 점 유의해 주세요.

["aaa", "bbb", "ccc", "ddd"]

JS	값	Lua
0	aaa	1
1	bbb	2
2	ccc	3
3	ddd	4

객체의 경우 속성이 표시되는 순서가 바뀔 수 있습니다. 단, 배열은 해당되지 않으며 객체의 순서가 바뀌어도 속성명은 변하지 않으므로 변수를 호출할 때에 큰 문제는 없습니다.

사용전:
{"var1": "aaaa", "var2": 1234, "var3": true}
[1, 3, 5, 9]

사용후:
{"var2":1234,"var3":true,"var1":"aaaa"}
[1,3,5,9]

사용법

변수

객체를 사용한다면 속성명을 그대로 입력하시면 됩니다.

JSON에서는 문자열, 숫자, 부울, 배열, 객체, null을 다루며, 이 틀에서 값을 입력할 때 기본적으로는 문자열으로 처리되지만, JSON 값의 형식에 맞춰서 입력한다면 자동으로 타입이 적용됩니다. 만약 강제적으로 문자열을 적용하고 싶다면 ""로 이스케이프하실 수 있습니다. 만약, 이스케이프된 문자열을 ""로 묶고 싶으시다면 그 안에 ""를 더 넣으실 수 있습니다. (예시: "true"→true, ""123""→"123")

칸을 비우시면 없는 값으로 간주되어 내용이 삭제됩니다. 만약, 빈 문자열을 사용하고 싶으시다면 ""을 입력하세요. 칸을 비우기 곤란하시다면 null을 사용하여 내용을 지우실 수 있습니다. null 역시 마찬가지로 "null"과 같이 이스케이프가 가능합니다.

JSON 코드

조작할 JSON 데이터를 특정합니다. 상황에 따라 다음 중 한가지 방법대로 두번째 변수(JSON 코드)에 입력해 주세요.

JSON 코드 직접 입력

JSON 코드가 반환되는 이 모듈도 사용하실 수 있습니다.

JSON 문서 불러오기

JSON 문서를 불러와서 입력하시려면 다음과 같이 틀의 형태로 입력해 주세요.

{{사용자:홍길동/데이터.json}}
{{:한게임/DB}}

빈 JSON 코드

비어있는 JSON 코드를 사용하시려면 {}나 []만 입력해 주세요.

새로 만들기

{{#switch:}}문법과 비슷하게 JSON 데이터를 새로 만들 수 있습니다.

{{#invoke:JSON|new|(값1)|(변수a)=(값a)|...}}

변수를 지정하지 않은 경우 변수는 틀과 같이 순서로 지정이 되며, 배열을 만들고자 할 경우 변수 없이 값만 입력하시면 됩니다.

이 기능은 앞서 말했다시피 #switch 문법과 유사하기 때문에 호환이 될 수 있습니다. 앞부분의 {{#switch:{{{1}}}부분을 한번 {{풀기:#invoke:JSON|new로 변경해 보세요. switch가 JSON으로 마법같이 변신할겁니다.

{{#switch:{{{1}}}
|var1=aaaa
|var2=1234
|var3=true
}}

{{풀기:#invoke:JSON|new
|var1=aaaa
|var2=1234
|var3=true
}}

{
	"var2": 1234,
	"var3": true,
	"var1": "aaaa"
}

어때요, 신기하지 않나요? 이 기능과 함께 switch에서 JSON으로 갈아타세요!

다른 방법으로, 일반 문자열을 콤마(,) 등을 기준으로 나눠서 배열을 만들 수 있습니다.

{{#invoke:JSON|spl|(문자열)|(구분자)}}

구분자를 비우거나 입력하지 않으면 기본적으로 글자 하나하나씩 나눕니다.

여기서 주의할 점은 구분자는 일반 문자열이 아니라 정규 표현식과 비슷한 패턴으로 입력해야 한다는 겁니다. 루아의 패턴 문법(영문)을 참고해서 입력해 주세요.

변수값 얻기

JSON 데이터에 있는 변수의 값을 얻으려면 다음과 같이 입력합니다:

{{#invoke:JSON|get|(JSON 코드)|(변수)}}

위와 같이 입력하시면 해당 변수의 값만 그대로 나오며, 값이 없는 경우 기본값이 나옵니다.

예를 들어, var 변수의 값을 얻는다면 이렇게 입력하세요:

{{#invoke:JSON|get|(JSON 코드)|var}}

{{JSON}}을 이용하면 더 간단히 입력하실 수 있습니다. 자세한 내용은 해당 문서를 확인해 주세요.

변수값 변경

JSON 데이터에 있는 변수의 값을 변경하려면 다음과 같이 입력합니다:

{{#invoke:JSON|set|(JSON 코드)|(변수)|(값)}}

위와 같이 입력하시면 해당 변수의 값이 변경된 JSON 코드가 반환됩니다.

예를 들어, var 변수의 값을 0로 변경할 경우 이렇게 입력하세요:

{{#invoke:JSON|set|(JSON 코드)|var|0}}

JSON 데이터에 없는 변수를 추가할때도 마찬가지로 똑같이 입력하시면 됩니다.

변수의 값을 비워두거나 null로 설정하면 변수가 제거됩니다.

요소 추가

배열에서 요소를 특정 위치에 추가하려면 ins를 사용하세요. 뒤의 요소들은 하나씩 인덱스가 밀려납니다.

{{#invoke:JSON|ins|(JSON 코드)|(인덱스)|(값)}}

코드 합치기

두 JSON 코드를 합칩니다.

객체를 합칠 때는 mer를 사용합니다. new랑 궁합이 매우 좋습니다.

{{#invoke:JSON|mer|(JSON 코드1)|(JSON 코드2)|...}}

만약 중복된 항목이 있으면 뒤에 있는 코드의 값으로 설정됩니다.

이를 응용하여 내용 수정에도 사용하실 수 있습니다. 만약 var1의 값을 0로 바꾸고 var2의 값을 true로 바꾸려는 경우 다음과 같이 입력해 주세요. 다만 new는 값을 제거하는 데에는 이용하실 수 없으며 JSON 코드를 직접 입력하셔야 합니다.

{{#invoke:JSON|mer|(JSON 코드)|{{#invoke:JSON|new|var1=0|var2=true}}}}

변수 제거

여러개의 변수를 일괄적으로 제거합니다. del은 단순히 변수값만 제거하며 rem은 변수값을 제거하고 그 뒤 요소의 순서를 당겨옵니다. del은 객체에, rem은 배열에 사용할 것을 권장합니다.

{{#invoke:JSON|del|(JSON 코드)|(변수1)|(변수2)|...}}
{{#invoke:JSON|rem|(JSON 코드)|(변수)}}

배열 크기

배열의 요소 개수는 len을 통해 확인할 수 있습니다.

{{#invoke:JSON|len|(JSON 코드)}}

타입 확인

미디어위키의 특성 상 get으로 값을 불러올때는 타입을 구분하지 않고 모두 문자열로 간주됩니다. 만약 타입을 구분하는 것이 중요한 경우, typ를 통해 확인할 수 있습니다.

나올 수 있는 타입은 다음과 같습니다: string, number, boolean, table, nil

단독으로 사용할 경우, 객체나 배열에 포함된 요소 하나를 확인할 수 있으며 해당 요소의 키를 지정해야 합니다.

{{#invoke:JSON|typ|(JSON 코드)|(키)}}

cmd를 통해 조합한 경우, 이전 명령을 통해 불러온 값의 타입을 바로 확인할 수 있습니다.

{{#invoke:JSON|cmd|(JSON 코드)|
  {{#invoke:JSON/cmd|get|(키)}}
  {{#invoke:JSON/cmd|typ}}
}}

반복문

객체나 배열의 각 요소를 반복할 수 있습니다. 반복문을 구현하는 세 함수는 결과를 어떻게 활용하는지에 따라서 나뉩니다.

키와 값은 각각 {{{key}}}, {{{value}}} 매개변수를 통해 불러올 수 있으며, 다른 매개변수로 변경할 수 있습니다.

{{#invoke:JSON|(함수)|(JSON 코드)|(nowiki로 감싼 틀 문법)|key=(키를 불러올 변수 이름)|value=(값을 불러올 변수 이름)}}

각 요소마다 반복한 값을 순서대로 나열하려면 for를 사용하세요.

각 요소마다 값을 일괄적으로 변경하려면 map을 이용하세요.

각 요소를 누적해서 하나의 값을 출력하려면 red를 이용하세요. 이전에 출력한 값은 {{{prev}}} 매개변수로 불러올 수 있으며, 마찬가지로 invoke 함수에 prev 매개변수를 지정해 다른 이름으로 바꿀 수 있습니다.

배열을 문자열로 합치기

con을 통해 배열의 각 요소 사이에 특정 구분자로 구분시켜서 하나의 문자열로 만들 수 있습니다. 시작 인덱스와 및 끝 인덱스를 지정해서 일부만 합칠 수 있으며, 시작 인덱스와 끝 인덱스에 해당되는 요소를 포함합니다.

{{#invoke:JSON|con|(JSON 코드)|(구분자)|(시작 인덱스)|(끝 인덱스)}}

포맷팅

JSON 코드를 화면에 표시하려는 경우, JSON 코드를 보기 좋게 포맷팅할 수 있습니다.

{{#invoke:JSON|pty|(JSON 코드)}}

작업 조합

만약 여러 작업을 동시에 하고 싶다면 cmd명령을 사용해 CGI2 방식으로 명령어를 입력하거나, 모듈:JSON/cmd를 사용하실 수 있습니다. 모듈:JSON/cmd는 JSON 코드 부분을 생략합니다.

{{#invoke:JSON|cmd
  |{{#invoke:JSON|new|var=false}}
  |{{#invoke:JSON/cmd|mer|
   {{#invoke:JSON|new
   |var1=8
   |var2={{#invoke:JSON|new|ㅁㄴㅇㄹ}}
   }}
  }}
  {{#invoke:JSON/cmd|del|var}}
  {{#invoke:JSON/cmd|get|var2}}
 }}

도보시오

위 설명은 모듈:JSON/설명문서의 내용을 가져와 보여주고 있습니다. (편집 | 역사)
이 모듈에 대한 수정 연습과 시험은 연습장 (만들기 | 미러)과 시험장 (만들기)에서 할 수 있습니다.
분류는 /설명문서에 넣어주세요. 이 모듈에 딸린 문서.

--[[
	ko:
	JSON 모듈
	JSON 코드에 있는 값의 내용을 반환하거나, 값을 수정한 JSON 코드를 다시 반환합니다.
	이 코드는 일단 CC BY-NC-SA로 배포되나, 추후 CC BY-SA로 변경될 수 있습니다.
	한국어 백괴게임의 Gustmd7410이 만들었습니다.
]]--
--[[
	en:
	JSON Module
	You can get and change JSON code's value with this.
	This code is distributed with CC BY-NC-SA license, but it could be changed into CC BY-SA license later.
	Made by Gustmd7410 in Korean Ungame.
]]--
local a = {}
local b = setmetatable({
	rtyp = a.typ,
	typ = false
}, {
	__index = a
})
local p = setmetatable({}, {
	__index = function(t, key)
		return b[key] and function(frame)
			local args = getRawArgs(frame.args)
			local data = mw.text.jsonDecode(table.remove(args, 1))
			local value = b[key](data, args)
			
			if type(value) == "table"
				then return mw.text.jsonEncode(value)
				else return value
			end
		end or nil
	end
})
function getRawArgs(args)
	local raw = {}
	
	for key, value in pairs(args) do
		raw[key] = value
	end
	
	return raw
end

function settype(value)
	if value:find('^("+)(.*)%1$') and pcall(mw.text.jsonDecode, value:gsub('^("+)(.*)%1$', "%2")) then
		return value:gsub('^"(("+)(.*)%2)"$', "%1")
	elseif pcall(mw.text.jsonDecode, value) then return mw.text.jsonDecode(value)
	elseif value == "" then return nil
	else return value
	end
end

function p.typ(frame)
	local key = frame.args[2]
	key = tonumber(key) or key
	local value = mw.text.jsonDecode(frame.args[1])[key]
	
	if value == null then return "null" end
	
	return type(value)
end

function a.typ(data)
	return type(data)
end

function a.get(data, args)
	for depth, key in pairs(args) do
		key = tonumber(key) or key
		data = data[key]
	end
	
	return data
end

function a.set(data, args)
	local key = args[1]
	local value = mw.text.trim(args[2])
	key = tonumber(key) or key
	
	data[key] = settype(value)
	
	return data
end

function p.new(frame)
	local data = getRawArgs(frame.args)
	
	for key, value in pairs(data) do
		data[key] = settype(mw.text.trim(value))
	end
	
	return mw.text.jsonEncode(data)
end

function a.mer(base, args)
	for seq in pairs(args) do
		local data = mw.text.jsonDecode(args[seq])
		
		for key in pairs(data) do base[key] = data[key] end
	end
	
	return base
end

function a.del(data, args)
	for seq, key in pairs(args) do
		data[tonumber(key) or key] = nil
	end
	
	return data
end

function a.len(data)
	return #data
end

function a.con(data, args)
	return table.concat(data, args[2] or ',', tonumber(args[3]) or 1, tonumber(args[4]) or #data)
end

function a.ins(data, args)
	local index = tonumber(args[3]) or #data + 1
	
	if index < 0 then
		index = #data + index
	end
	
	table.insert(data, index, args[2])
	return data
end

function a.rem(data, args)
	for seq, key in pairs(args) do
		key = tonumber(key)
		
		if key < 0 then
			key = #data + key
		end
		
		table.remove(data, key)
	end
	
	return data
end

function a.srt(data, args)
	table.sort(data)
	return data
end

function p.chk(frame)
	if pcall(mw.text.jsonDecode, frame.args[1])
		then return frame.args[2]
		else return frame.args[3]
	end
end

function p.str(frame)
	return mw.text.jsonDecode('"' .. frame.args[1] .. '"')
end

function p.pty(frame)
	local data = mw.text.jsonDecode(frame.args[1])
	return mw.text.jsonEncode(data, mw.text.JSON_PRETTY)
end

function p.cmd(frame)
	local data = mw.text.jsonDecode(frame.args[1])
	local commands = mw.text.jsonDecode('[' .. frame.args[2]:sub(1, -2) .. ']')
	local pretty = false
	
	for index, command in pairs(commands) do
		for action, args in pairs(command) do
			if action == 'pty' then
				pretty = true
			else
				data = a[action](data, args)
			end
			break
		end
	end
	
	if type(data) == "table" then
		return pretty and mw.text.jsonEncode(data, mw.text.JSON_PRETTY) or mw.text.jsonEncode(data)
	else
		return data
	end
end

function a.has(data, args)
	local valt = {}
	local result = nil
	
	for key, value in pairs(data) do
		valt[value] = true
	end
	
	for index, value in pairs(args) do
		if result == nil then result = true end
		if valt[value] ~= true then result = false end
	end
	
	return result
end

a['for'] = function(data, args)
	local text = ''
	local keyv = args.key or 'key'
	local valv = args.value or 'value'
	local func = require('모듈:TemplateFunction').new(args[1])
	
	for key, value in pairs(data) do
		if type(value) == "table" then
			value = mw.text.jsonEncode(value)
		end
		
		text = text .. func{
			[keyv] = key,
			[valv] = value
		}
	end
	
	return text
end

function a.map(data, args)
	local keyv = args.key or 'key'
	local valv = args.value or 'value'
	local func = require('모듈:TemplateFunction').new(args[1])
	
	for key, value in pairs(data) do
		if type(value) == "table" then
			value = mw.text.jsonEncode(value)
		end
		
		data[key] = settype(func{
			[keyv] = key,
			[valv] = value
		})
	end
	
	return data
end

function a.red(data, args)
	local val = ''
	local keyv = args.key or 'key'
	local valv = args.value or 'value'
	local prev = args.previous or 'previous'
	local func = require('모듈:TemplateFunction').new(args[1])
	
	for key, value in pairs(data) do
		if type(value) == "table" then
			value = mw.text.jsonEncode(value)
		end
		
		val = func{
			[keyv] = key,
			[valv] = value,
			[prev] = val
		}
	end
	
	return val
end

function p.spl(frame)
	local text = frame.args[1]
	local sep = frame.args[2]
	
	return mw.text.jsonEncode(mw.text.split(text, sep))
end

return p