틀:DB2

From 백괴게임, game enjoys you
Jump to: navigation, search

Template-info.svg 틀에 대한 설명은 아래 부분을 참조하십시오.[보기] [편집]

게임 등에서 사용할 데이터를 로컬 저장소나 서버 저장소에 저장합니다. IP 사용자는 로컬 저장소를 이용하고, 계정 사용자는 서버 저장소를 이용합니다.

사용법[edit]

기본적인 형식은 다음과 같습니다.

인자가 필요할 때
{{DB2|(명령)|(인자)|(링크)|키=(키)|전역키=(전역키)|갱신=(갱신)}}
인자가 필요하지 않을 때
{{DB2|(명령)|(링크)|키=(키)|전역키=(전역키)|갱신=(갱신)}}

속성 [edit]

이 틀에 전달되는 속성은 다음과 같습니다.

  • 명령: 이 틀이 수행할 명령을 입력합니다. save, load, get, set, del, json 중 하나를 반드시 입력해야 합니다.
  • 인자: 일부 명령에서 필요한 속성으로, 하단의 각 명령 별 설명을 참고하시기 바랍니다.
  • 링크: 여기에 전달되는 내용이 문서에 출력되며, 링크를 전달할 경우 링크를 눌렀을 때 데이터가 처리되고, 일반 텍스트를 전달할 경우 해당 텍스트에 데이터 처리 링크가 걸립니다. 만약 아예 입력하지 않을 경우에는 문서에 들어올 때 바로 처리됩니다.
  • : 데이터가 전달되는 저장소 키를 변경하실 수 있습니다. 여기서 지정되는 키는 최상위 문서가 같은 문서?끼리 공유되며, 그 외의 문서에서는 접근이 불가능합니다. 일반적인 경우 키를 지정하지 않는 것을 권장합니다.
  • 전역키: 기존 DB와 비슷하게, 최상위 문서에 상관없이 모든 문서에서 접근 가능한 저장소 키를 전역키 속성을 통해 지정하실 수 있습니다. 잘 알려진 전역키의 목록은 틀:DB2/전역키에서 확인하실 수 있습니다. 키와 전역키가 함께 지정되었을 경우, 일반 키가 우선적으로 지정됩니다.
  • 갱신: 참과 거짓을 나타내는 부울 값으로 입력하며, 링크형에서 사용될 경우 데이터를 불러올 때 처음 문서를 로드했을 시점의 데이터 대신 링크를 누른 시점의 최신 데이터로 불러옵니다. 다만, 로컬 저장소를 사용하는 IP 사용자의 경우 항상 최신 데이터를 불러오므로 아무런 차이가 없고, 서버에 데이터를 저장하는 계정 사용자의 경우 API 요청을 다시 보내므로 시간이 더 걸릴 수 있습니다. 페이지 로드시 데이터를 처리할 때는 저장된 데이터와 현재 파라미터가 다를 경우 항상 갱신하게 됩니다. 갱신을 사용하지 않는 기본값에서는 urlget 파라미터가 하나라도 존재하면 덮어쓰지 않습니다.

레거시 명령[edit]

DB2는 기존 DB 틀의 명령을 지원합니다. 다음 명령들은 인자가 필요없습니다.

  • save (별칭 저장)
현재 페이지의 모든 파라미터를 저장합니다.
  • load (별칭 로드)
선택된 키에 savejson 등으로 저장된 모든 파라미터를 그대로 불러옵니다.

데이터 수정[edit]

기본적으로 키에 저장된 데이터를 수정할 때는 다음 명령들을 사용합니다.

  • get (별칭 호출): 키에 저장된 데이터를 지정된 파라미터에 그대로 가져옵니다. 인자에는 데이터를 가져올 urlget 파라미터를 입력하세요.
  • set (별칭 수정): 데이터를 키에 저장합니다. 인자에는 저장할 데이터를 입력하세요.
  • del (별칭 삭제: 데이터가 저장된 키를 완전히 삭제합니다. 인자는 입력하지 않습니다.

JSON 수정[edit]

키에 JSON 데이터를 저장할 때, json(JSON) 명령을 통해 JSON을 편리하게 수정하실 수 있습니다. 인자에는 아래의 하위 명령들을 아래와 같이 CGI2 문법으로 입력하세요. 일반적인 경우 JSON을 활용하여 저장할 것을 권장합니다.

{{DB2|json|{{DB2/(명령1)|...}}{{DB2/(명령2)|...}}...|...}}
하위 명령
JSON 객체에 저장된 키의 값을 불러옵니다. 저장된 키와 불러올 urlget 파라미터가 같을 경우 인자에 불러올 키만 입력하고, 다를 경우 불러올 파라미터와 키의 쌍을 입력합니다. 두 종류의 인자는 혼용할 수 없습니다.
키와 파라미터가 같을 경우
{{DB2/get|(키1)|(키2)|...}}
키와 파라미터가 다를 경우
{{DB2/get|(파라미터1)=(키1)|(파라미터2)=(키2)|...}}
JSON 객체에 데이터를 저장합니다. 인자에는 저장할 키와 데이터의 쌍을 입력합니다.
{{DB2/set|(키1)=(값1)|(키2)=(값2)|...}}
JSON 객체의 키를 삭제합니다. 인자에는 삭제할 키를 입력합니다.
{{DB2/del|(키1)|(키2)|...}}
현재 페이지의 urlget 파라미터를 백업합니다. 저장할 파라미터와 키가 같을 경우에는 인자에 파라미터를, 다를 경우에는 저장할 키와 파라미터의 쌍을 입력합니다. 두 종류의 인자는 혼용할 수 없습니다.
파라미터와 키가 같을 경우
{{DB2/sav|(파라미터1)|(파라미터2)|...}}
파라미터와 키가 다를 경우
{{DB2/sav|(키1)=(파라미터1)|(키2)=(파라미터2)|...}}
값이 저장되지 않은 키에 기본값을 저장합니다. 인자에는 저장할 키와 기본값의 쌍을 입력합니다.
{{DB2/def|(키1)=(값1)|(키2)=(값2)|...}}

예시[edit]

DB2는 다음과 같이 활용하실 수 있습니다.

도보시오[edit]