Go 언어에서 net.IP의 사용자 정의 JSON 직렬화: IP 주소가 문자열 형식으로 출력되는지 확인

이 튜토리얼에서는 net.IP 유형 필드가 포함된 경우 Go 언어로 json.Marshaler 인터페이스를 구현하여 구조의 JSON 직렬화 동작을 사용자 정의하는 방법을 자세히 설명합니다. net.IP를 기반으로 사용자 정의 유형을 생성하고 이에 대한 MarshalJSON 메서드를 구현하여 net.IP 필드가 JSON 출력에서 ​​표준 점으로 구분된 10진수 문자열로 올바르게 표시되도록 하여 기본 직렬화 동작이 예상과 다른 문제를 해결합니다.

소개

Go 언어의 네트워크 프로그래밍에서 net.IP 유형은 IP 주소를 나타내는 일반적인 데이터 구조입니다. 그러나 개발자가 net.IP 필드가 포함된 구조를 JSON 형식으로 직렬화하려고 시도하는 경우 인코딩/json 패키지의 기본 동작은 net.IP를 일반적인 점으로 구분된 10진수 문자열(예: "192.168.1.1")로 출력하지 않고 대신 바이트 배열이나 기타 예상치 못한 형식으로 출력할 수 있습니다. 이는 일반적으로 API 설계 요구 사항이나 JSON 데이터의 프런트 엔드 소비 요구 사항을 충족하지 않습니다. 이 튜토리얼의 목표는 net.IP 필드가 JSON 출력에서 ​​항상 표준 문자열로 표시되도록 MarshalJSON 메서드를 사용자 정의하여 전문적인 솔루션을 제공하는 것입니다.

Go 언어의 JSON 직렬화 메커니즘 개요

Go의 인코딩/json 패키지는 JSON 데이터 직렬화(Marshal) 및 역직렬화(Unmarshal)를 처리하기 위한 핵심 도구입니다. json.Marshal 함수에는 내장 유형과 대부분의 표준 라이브러리 유형에 대한 사전 정의된 처리 논리가 있습니다. 사용자 정의 구조체의 경우 일반적으로 리플렉션을 통해 필드를 반복하고 이를 JSON 개체로 변환합니다.

그러나 인코딩/json 패키지는 개발자가 특정 유형에 대한 직렬화 및 역직렬화 프로세스를 완전히 제어할 수 있는 인터페이스 세트를 제공합니다. 그 중 json.Marshaler 인터페이스는 MarshalJSON() ([]byte, error) 메소드를 정의합니다. json.Marshal 함수가 이 인터페이스를 구현하는 유형 값을 발견하면 기본 반사 메커니즘을 사용하지 않고 해당 유형의 MarshalJSON 메소드를 직접 호출하여 JSON 바이트 스트림을 얻습니다. 이는 net.IP의 직렬화 동작을 사용자 정의할 수 있는 기반을 제공합니다.

사용자 정의 MarshalJSON 메소드 구현

net.IP 유형 필드를 문자열로 직렬화하기 위한 핵심 아이디어는 net.IP를 기반으로 사용자 정의 유형을 생성하고 이에 대한 MarshalJSON 메서드를 구현하는 것입니다. 구체적인 단계는 다음과 같습니다:

1. net.IP 기반 사용자 정의 유형 정의 : 표준 라이브러리의 net.IP 유형을 직접 수정할 수는 없습니다. Go 언어를 사용하면 기존 유형과 동일한 기본 구조를 갖는 유형 정의를 통해 새로운 유형을 생성할 수 있습니다. 예를 들어, netIP net.IP 유형을 정의할 수 있습니다. 이 netIP 유형은 기본 데이터 측면에서 net.IP와 호환되지만 원래 net.IP에 영향을 주지 않고 메소드를 추가할 수 있는 독립적인 새로운 유형입니다.

2. 사용자 정의 유형에 대한 MarshalJSON 메서드 구현 : 이 메서드에서는 다음 작업을 수행합니다.

   • netIP 유형의 값을 net.IP 유형으로 다시 캐스팅합니다.
   • IP 주소의 표준 문자열 표현을 얻으려면 net.IP와 함께 제공되는 String() 메서드를 호출하십시오.
   • 이 문자열에 대해 다시 json.Marshal을 수행하고 JSON 문자열 형식의 바이트 배열로 변환하여 반환합니다.

샘플 코드

다음은 사용자 지정 MarshalJSON 메서드를 통해 IPFilePair 구조의 net.IP 필드를 문자열로 올바르게 직렬화하는 방법을 보여주는 완전한 Go 언어 예제입니다.

 패키지 메인

수입 (
    "인코딩/json"
    "fmt"
    "그물"
)

// netIP는 MarshalJSON 메소드 유형 netIP net.IP를 구현하는 데 사용되는 사용자 정의 유형의 net.IP입니다.

//IPFilePair 구조에는 netIP 유형의 IP 주소와 IPFilePair 유형의 파일 이름이 포함됩니다. struct {
    IP netIP `json:"IP"` // 사용자 정의 netIP 유형 사용 FileName 문자열 `json:"FileName"`
}

// IPFilePairs는 일괄 처리 유형 IPFilePairs []*IPFilePair를 용이하게 하는 IPFilePair 포인터의 조각입니다.

// MarshalJSON 메서드는 netIP 유형에 대한 사용자 지정 JSON 직렬화를 구현합니다. // netIP를 net.IP로 변환한 다음 해당 String() 메서드를 호출하여 문자열 표현을 얻습니다.
// 마지막으로 문자열을 JSON 바이트 배열로 직렬화합니다.
func (ip netIP) MarshalJSON() ([]바이트, 오류) {
    // 사용자 정의 유형 netIP를 표준 라이브러리의 net.IP 유형으로 다시 변환합니다. // 그런 다음 net.IP의 String() 메서드를 호출하여 IP 주소의 문자열 표현을 얻습니다 ipString := net.IP(ip).String()
    // JSON은 획득된 문자열을 직렬화하여 출력이 JSON 문자열(따옴표 포함)인지 확인합니다.
    json.Marshal(ipString)을 반환합니다.
}

기능 메인() {
    // IPFilePair 인스턴스 pair1 생성 := IPFilePair{IP: netIP{127, 0, 0, 1}, FileName: "file1"}
    pair2 := IPFilePair{IP: netIP{127, 0, 0, 2}, 파일 이름: "file2"}

    // IPFilePairs 슬라이스에 인스턴스를 추가합니다. SampleIPFilePairs := IPFilePairs{&pair1, &pair2}

    // JSON은 슬라이스 b를 직렬화합니다. err := json.Marshal(sampleIPFilePairs)
    오류가 있는 경우 != nil {
        fmt.Printf("JSON 직렬화 실패: %v\n", err)
        반품
    }

    //직렬화된 JSON 문자열을 인쇄합니다. fmt.Println(string(b))
}

코드 설명 :

• type netIP net.IP: 기본 유형이 net.IP인 netIP라는 새 유형을 정의합니다.
• func (ip netIP) MarshalJSON() ([]byte, error): json.Marshaler 인터페이스를 구현하기 위한 netIP 유형의 핵심 메소드입니다.
  • net.IP(ip).String(): netIP 유형의 ip 변수를 net.IP 유형으로 강제 설정한 다음 net.IP와 함께 제공되는 String() 메서드를 호출합니다. 이 메서드는 IP 주소의 표준 문자열 표현(예: "127.0.0.1")을 반환합니다.
  • json.Marshal(ipString): 획득한 IP 문자열을 JSON으로 다시 직렬화합니다. MarshalJSON 메서드가 유효한 JSON 바이트 배열을 반환해야 하기 때문에 이 단계가 필요합니다. Go 문자열에 대해 json.Marshal을 수행하면 따옴표 붙은 JSON 문자열(예: "127.0.0.1")로 변환됩니다.
• IPFilePair 구조에서 IP 필드 유형은 netIP로 선언됩니다. 이러한 방식으로 json.Marshal 함수가 IPFilePair 인스턴스를 처리할 때 IP 필드가 발견되면 netIP의 사용자 정의 MarshalJSON 메서드가 트리거됩니다.
• 기본 함수는 IPFilePair 인스턴스를 생성하고 이를 슬라이스에 넣은 후 직렬화하고 최종 JSON 출력을 인쇄하는 방법을 보여줍니다.

실행 결과 :

위 코드를 실행하면 다음 JSON 문자열이 출력됩니다.

 [{"IP":"127.0.0.1","파일 이름":"file1"},{"IP":"127.0.0.2","파일 이름":"file2"}]

보시다시피 IP 필드가 예상대로 성공적으로 문자열로 출력되었습니다.

메모 및 역직렬화

• 사용자 정의 유형의 중요성 : netIP와 같은 사용자 정의 유형을 생성하면 동작을 수정하지 않고도 표준 라이브러리 유형에 특정 메소드를 추가할 수 있습니다. 이는 기존 유형의 기능을 확장하기 위해 Go 언어에서 일반적이고 권장되는 방법입니다.

• 역직렬화(UnmarshalJSON) : 위에서 생성된 JSON 문자열을 다시 Go의 IPFilePair 구조로 역직렬화해야 하는 경우 netIP 유형에 대한 json.Unmarshaler 인터페이스의 UnmarshalJSON([]byte) 오류 메서드도 구현해야 합니다. 이 방법에서는 일반적으로 먼저 JSON 바이트 배열을 문자열로 구문 분석한 다음 net.ParseIP 함수를 사용하여 문자열을 net.IP 유형으로 구문 분석합니다.

  간단한 UnmarshalJSON 구현은 다음과 같습니다.

   func (ip *netIP) UnmarshalJSON(b []byte) 오류 {
      변수 문자열
      // err인 경우 JSON 바이트 배열을 문자열로 역직렬화하려고 시도합니다. := json.Unmarshal(b, &s); 오류 != 없음 {
          반품 오류
      }
      // net.ParseIP를 사용하여 문자열을 net.IP로 구문 분석합니다.
      parsedIP := net.ParseIP(들)
      구문 분석된 IP == nil인 경우 {
          return fmt.Errorf("잘못된 IP 주소 문자열: %s", s)
      }
      //파싱된 net.IP를 *ip에 할당
      *ip = netIP(파싱된IP) 
      0을 반환
  }

  UnmarshalJSON 메서드는 일반적으로 원래 값을 수정할 수 있도록 자체 형식에 대한 포인터를 받습니다.

요약

이 튜토리얼을 통해 Go 언어의 json.Marshaler 인터페이스를 사용하여 net.IP 유형에 대한 사용자 정의 JSON 직렬화 논리를 구현하는 방법을 자세히 배웠습니다. net.IP를 기반으로 사용자 정의 유형을 정의하고 이에 대한 MarshalJSON 메서드를 구현함으로써 JSON 출력에서 ​​IP 주소 형식을 정확하게 제어하여 사람이 읽을 수 있는 문자열로 표시되도록 할 수 있습니다. 동시에 완전한 솔루션을 제공하기 위해 역직렬화 중에 UnmarshalJSON 메서드 구현에 대해서도 간략하게 논의했습니다. 이 패턴은 net.IP에만 적용되는 것이 아니라 Go에서 사용자 정의된 JSON 동작이 필요한 다른 유형을 처리할 때도 적용 가능합니다. 복잡한 JSON 요구 사항을 처리하는 것은 Go 언어의 중요한 기술입니다.

위 내용은 Go 언어에서 net.IP의 사용자 정의 JSON 직렬화: IP 주소가 문자열 형식으로 출력되는지 확인의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!