WHITEPAEK Tech Docs

스프링 프로젝트에 애플 인 앱 결제(IAP, In-App Purchase) 서버 개발

WHITEPAEK — Tue, 1 Dec 2020 01:13:25 +0900

애플(Apple)의 인 앱 결제(In-App Purchase)를 통해 구입한 상품 데이터를
스프링(Spring) 프로젝트로 구현한 서버(Server)에서 검증을 하고 데이터베이스에 저장하여 구입이 완료된 상품을 관리할 수 있도록 프로세스를 확인해보도록 하겠습니다.

상품 구매에 대한 인 앱 결제 프로세스를 확인해보도록 하겠습니다.

[그림 1] 인 앱 결제 프로세스(In-App Purchase Process)

1. App은 Server에서 상품 목록 API를 호출합니다.
- Server는 관리자가 실제로 App Store Connect에서 등록한 상품을 DB에서 관리하며, 목록을 App에게 제공합니다.
2. App은 선택한 상품의 구매 가능 여부를 Server에 요청합니다.
- Server는 유저가 선택한 상품이 구매한 적이 있는 상품인지 확인하여 App에게 제공합니다.
(상품 구매가 가능한 경우, Server에서 고유한 ID를 생성해서 [3 ~ 5-2] 과정을 Server 입장에서 하나의 트랜잭션으로 관리하여 데이터 안정성을 관리할 수 있지 않을까..? 고유한 ID가 생성되면 DB에 저장 - 서버 입장에서의 구매 트랜잭션 시작)
3. App은 구매 가능한 상품인 경우에 App Store에 결제를 진행합니다.
- 결제가 완료되면 App은 receipt-data를 생성합니다. (트랜잭션 시작)
4. App은 생성한 receipt-data로 Server에 상품 결제 검증 요청 API를 호출합니다.
4-1. Server는 App에서 전달받은 receipt-data로 App Store에게 영수증 검증(/verifyReceipt) API를 호출합니다.
4-2. Server는 App Store에게 JSON 형태의 영수증 데이터를 응답받습니다.
4-3. Server는 응답받은 영수증 데이터에서 필요한 값을 파싱 하여 DB에 저장하도록 합니다. (유저가 구입한 상품을 DB에 저장)
4-4. 유저가 구입한 상품을 DB에 저장 완료했다면 Server는 성공 응답 값을 App에게 전달합니다.
5. App은 Server에게 성공 응답 값을 받으면 트랜잭션을 종료시키고 Server에게 구매 완료 API를 호출합니다.
5-1. Server는 App에게 구매 완료 요청을 받으면 [4-3]과정에서 DB에 저장한 영수증 데이터에 완료에 대한 업데이트를 합니다.
([2-2] 과정에서 Server가 생성한 고유한 ID로 구매 완료된 상품에 대한 데이터를 찾아서 업데이트 - 서버 입장에서의 구매 트랜잭션 종료)
5-2. App은 인 앱 결제에 대한 프로세스가 최종적으로 종료됩니다.

서버(Server)는 인 앱 결제 프로세스에서 "상품 목록, 상품 구매 가능 여부, 상품 결제 검증, 상품 구매 완료" 4개의 API를 App에게 제공해주면 됩니다. "상품 목록, 상품 구매 가능 여부, 상품 구매 완료" API는 해당 서비스 정책에 따라서 다르기 때문에 플로우(Flow)에서만 설명하도록 하고, 해당 글에서는 [Step 03 ~ Step 04] 과정에 대한 코드를 확인하고 발생할 수 있는 이슈 사항에 대해 체크해보도록 하겠습니다.

인 앱 결제에 대한 서버 코드에 대해 확인하기 전, 애플에서 제공하는 상품 종류에 따른 몇 가지 특징에 대해서는 확인해보도록 하겠습니다.

애플에서 제공하는 인 앱 결제에 대한 상품 종류는 총 4가지입니다.
Apple Document ‣ help.apple.com/app-store-connect/#/dev3cd978dbd

상품명	설명	특징
소모품(Consumable)	앱 내에서 사용하면 소모되는 일회성 상품입니다.	정상적으로 구매가 완료(App에서 트랜잭션을 종료) 되었다면 "/verifyReceipt"를 호출하였을 때 소모품에 대한 응답 값은 확인할 수 없습니다.
비소모품(Non-Consumable)	한 번 구매하면 기간 제한없이 계속 사용할 수 있는 상품입니다.	- "/verifyReceipt"를 호출하면 비소모품에 대한 데이터를 포함한 응답 값을 반환합니다. - 복원(Restore)되면 transaction_id는 변경됩니다.
자동 갱신 구독(Auto-Renewable Subscription)	구매 후 고객이 취소하기 전까지 자동으로 결제가 이루어지는 상품입니다.	- "/verifyReceipt"를 호출할 때 "receipt-data, password" 2개의 값이 필요합니다. - "/verifyReceipt"를 호출하면 자동 갱신 구독에 대한 데이터를 포함한 응답 값을 반환합니다. - 갱신되면 transaction_id는 변경되며 상품에 대한 receipt 데이터는 응답 값에 추가됩니다.
비자동 갱신 구독(Non-Renewable Subscription)	구매 후 특정 기간동안 사용할 수 있으며, 자동으로 결제가 이루어지지 않습니다. 고객이 재구매를 통해 기간을 연장할 수 있는 상품입니다.	- "/verifyReceipt"를 호출하면 비자동 갱신 구독에 대한 데이터를 포함한 응답 값을 반환합니다. - 갱신되면 transaction_id는 변경되며 상품에 대한 receipt 데이터는 응답 값에 추가됩니다.

각 상품 특징에 대해 확인했습니다. 그렇다면 상품에 대한 receipt-data는 어떻게 얻을까요?
App 개발자와 협업을 통해 테스트 앱 혹은 데이터를 얻을 수 있다면 큰 문제는 되지 않습니다.
하지만 상황이 여의치 않다면 직접 테스트 앱을 만들어서 필요한 데이터를 얻는 수밖에..
저는 여의치 않은 상황이었고, 앱 쪽에서 상품 구매와 완료 처리되는 게 궁금했기 때문에 다른 분의 작성한 글을 참고하여 테스트 앱을 실행 후 데이터를 얻었습니다.
( 참고 ‣ www.raywenderlich.com/5456-in-app-purchase-tutorial-getting-started )

Developer와 App Store Connect 설정과 테스트 앱 실행까지 설명하면 좋겠지만, 인 앱 결제 처리에 대한 서버 프로세스에 집중하도록 하겠습니다.

테스트 앱에서 제가 얻은 각 상품에 대한 receipt-data는 아래와 같습니다.

◼︎ 소모품(Consumable)의 receipt-data

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

◼︎ 비소모품(Non-Consumable)의 receipt-data

MIITswYJKoZIhvcNAQcCoIITpDCCE6ACAQExCzAJBgUrDgMCGgUAMIIDVAYJKoZIhvcNAQcBoIIDRQSCA0ExggM9MAoCAQgCAQEEAhYAMAoCARQCAQEEAgwAMAsCAQECAQEEAwIBADALAgEDAgEBBAMMATEwCwIBCwIBAQQDAgEAMAsCAQ8CAQEEAwIBADALAgEQAgEBBAMCAQAwCwIBGQIBAQQDAgEDMAwCAQoCAQEEBBYCNCswDAIBDgIBAQQEAgIAjTANAgENAgEBBAUCAwIjqDANAgETAgEBBAUMAzEuMDAOAgEJAgEBBAYCBFAyNTYwGAIBBAIBAgQQ0ZO6B8h4atEKtXAgd6zoJjAbAgEAAgEBBBMMEVByb2R1Y3Rpb25TYW5kYm94MBwCAQICAQEEFAwSY29tLndoaXRlcGFlay5hcHBzMBwCAQUCAQEEFNUGc5gD21ugJuNdkAS/PNJCu/9IMB4CAQwCAQEEFhYUMjAyMC0xMS0zMFQwNDoxODozM1owHgIBEgIBAQQWFhQyMDEzLTA4LTAxVDA3OjAwOjAwWjA1AgEHAgEBBC1APliTSPq/+2NfSLMVFTDubQDBeSY9vpXetcRz8gEmujyj9pBkXWKU1D08itkwQgIBBgIBAQQ66veYyXIXgy3MWMBUCQX7sTcA0YIPKWkXJYYXbeU1Qp4W1LPuGhsZwM0XF7bp7lT/tgiidC9yfKDciDCCAVsCARECAQEEggFRMYIBTTALAgIGrAIBAQQCFgAwCwICBq0CAQEEAgwAMAsCAgawAgEBBAIWADALAgIGsgIBAQQCDAAwCwICBrMCAQEEAgwAMAsCAga0AgEBBAIMADALAgIGtQIBAQQCDAAwCwICBrYCAQEEAgwAMAwCAgalAgEBBAMCAQEwDAICBqsCAQEEAwIBADAMAgIGrgIBAQQDAgEAMAwCAgavAgEBBAMCAQAwDAICBrECAQEEAwIBADAbAgIGpwIBAQQSDBAxMDAwMDAwNzQ3ODQ1MjM5MBsCAgapAgEBBBIMEDEwMDAwMDA3NDc4NDUyMzkwHwICBqgCAQEEFhYUMjAyMC0xMS0zMFQwNDoxODozM1owHwICBqoCAQEEFhYUMjAyMC0xMS0zMFQwNDoxODozM1owIQICBqYCAQEEGAwWcHJvZHVjdHMubm9uQ29uc3VtYWJsZaCCDmUwggV8MIIEZKADAgECAggO61eH554JjTANBgkqhkiG9w0BAQUFADCBljELMAkGA1UEBhMCVVMxEzARBgNVBAoMCkFwcGxlIEluYy4xLDAqBgNVBAsMI0FwcGxlIFdvcmxkd2lkZSBEZXZlbG9wZXIgUmVsYXRpb25zMUQwQgYDVQQDDDtBcHBsZSBXb3JsZHdpZGUgRGV2ZWxvcGVyIFJlbGF0aW9ucyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNTExMTMwMjE1MDlaFw0yMzAyMDcyMTQ4NDdaMIGJMTcwNQYDVQQDDC5NYWMgQXBwIFN0b3JlIGFuZCBpVHVuZXMgU3RvcmUgUmVjZWlwdCBTaWduaW5nMSwwKgYDVQQLDCNBcHBsZSBXb3JsZHdpZGUgRGV2ZWxvcGVyIFJlbGF0aW9uczETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQClz4H9JaKBW9aH7SPaMxyO4iPApcQmyz3Gn+xKDVWG/6QC15fKOVRtfX+yVBidxCxScY5ke4LOibpJ1gjltIhxzz9bRi7GxB24A6lYogQ+IXjV27fQjhKNg0xbKmg3k8LyvR7E0qEMSlhSqxLj7d0fmBWQNS3CzBLKjUiB91h4VGvojDE2H0oGDEdU8zeQuLKSiX1fpIVK4cCc4Lqku4KXY/Qrk8H9Pm/KwfU8qY9SGsAlCnYO3v6Z/v/Ca/VbXqxzUUkIVonMQ5DMjoEC0KCXtlyxoWlph5AQaCYmObgdEHOwCl3Fc9DfdjvYLdmIHuPsB8/ijtDT+iZVge/iA0kjAgMBAAGjggHXMIIB0zA/BggrBgEFBQcBAQQzMDEwLwYIKwYBBQUHMAGGI2h0dHA6Ly9vY3NwLmFwcGxlLmNvbS9vY3NwMDMtd3dkcjA0MB0GA1UdDgQWBBSRpJz8xHa3n6CK9E31jzZd7SsEhTAMBgNVHRMBAf8EAjAAMB8GA1UdIwQYMBaAFIgnFwmpthhgi+zruvZHWcVSVKO3MIIBHgYDVR0gBIIBFTCCAREwggENBgoqhkiG92NkBQYBMIH+MIHDBggrBgEFBQcCAjCBtgyBs1JlbGlhbmNlIG9uIHRoaXMgY2VydGlmaWNhdGUgYnkgYW55IHBhcnR5IGFzc3VtZXMgYWNjZXB0YW5jZSBvZiB0aGUgdGhlbiBhcHBsaWNhYmxlIHN0YW5kYXJkIHRlcm1zIGFuZCBjb25kaXRpb25zIG9mIHVzZSwgY2VydGlmaWNhdGUgcG9saWN5IGFuZCBjZXJ0aWZpY2F0aW9uIHByYWN0aWNlIHN0YXRlbWVudHMuMDYGCCsGAQUFBwIBFipodHRwOi8vd3d3LmFwcGxlLmNvbS9jZXJ0aWZpY2F0ZWF1dGhvcml0eS8wDgYDVR0PAQH/BAQDAgeAMBAGCiqGSIb3Y2QGCwEEAgUAMA0GCSqGSIb3DQEBBQUAA4IBAQANphvTLj3jWysHbkKWbNPojEMwgl/gXNGNvr0PvRr8JZLbjIXDgFnf4+LXLgUUrA3btrj+/DUufMutF2uOfx/kd7mxZ5W0E16mGYZ2+FogledjjA9z/Ojtxh+umfhlSFyg4Cg6wBA3LbmgBDkfc7nIBf3y3n8aKipuKwH8oCBc2et9J6Yz+PWY4L5E27FMZ/xuCk/J4gao0pfzp45rUaJahHVl0RYEYuPBX/UIqc9o2ZIAycGMs/iNAGS6WGDAfK+PdcppuVsq1h1obphC9UynNxmbzDscehlD86Ntv0hgBgw2kivs3hi1EdotI9CO/KBpnBcbnoB7OUdFMGEvxxOoMIIEIjCCAwqgAwIBAgIIAd68xDltoBAwDQYJKoZIhvcNAQEFBQAwYjELMAkGA1UEBhMCVVMxEzARBgNVBAoTCkFwcGxlIEluYy4xJjAkBgNVBAsTHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRYwFAYDVQQDEw1BcHBsZSBSb290IENBMB4XDTEzMDIwNzIxNDg0N1oXDTIzMDIwNzIxNDg0N1owgZYxCzAJBgNVBAYTAlVTMRMwEQYDVQQKDApBcHBsZSBJbmMuMSwwKgYDVQQLDCNBcHBsZSBXb3JsZHdpZGUgRGV2ZWxvcGVyIFJlbGF0aW9uczFEMEIGA1UEAww7QXBwbGUgV29ybGR3aWRlIERldmVsb3BlciBSZWxhdGlvbnMgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDKOFSmy1aqyCQ5SOmM7uxfuH8mkbw0U3rOfGOAYXdkXqUHI7Y5/lAtFVZYcC1+xG7BSoU+L/DehBqhV8mvexj/avoVEkkVCBmsqtsqMu2WY2hSFT2Miuy/axiV4AOsAX2XBWfODoWVN2rtCbauZ81RZJ/GXNG8V25nNYB2NqSHgW44j9grFU57Jdhav06DwY3Sk9UacbVgnJ0zTlX5ElgMhrgWDcHld0WNUEi6Ky3klIXh6MSdxmilsKP8Z35wugJZS3dCkTm59c3hTO/AO0iMpuUhXf1qarunFjVg0uat80YpyejDi+l5wGphZxWy8P3laLxiX27Pmd3vG2P+kmWrAgMBAAGjgaYwgaMwHQYDVR0OBBYEFIgnFwmpthhgi+zruvZHWcVSVKO3MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUK9BpR5R2Cf70a40uQKb3R01/CF4wLgYDVR0fBCcwJTAjoCGgH4YdaHR0cDovL2NybC5hcHBsZS5jb20vcm9vdC5jcmwwDgYDVR0PAQH/BAQDAgGGMBAGCiqGSIb3Y2QGAgEEAgUAMA0GCSqGSIb3DQEBBQUAA4IBAQBPz+9Zviz1smwvj+4ThzLoBTWobot9yWkMudkXvHcs1Gfi/ZptOllc34MBvbKuKmFysa/Nw0Uwj6ODDc4dR7Txk4qjdJukw5hyhzs+r0ULklS5MruQGFNrCk4QttkdUGwhgAqJTleMa1s8Pab93vcNIx0LSiaHP7qRkkykGRIZbVf1eliHe2iK5IaMSuviSRSqpd1VAKmuu0swruGgsbwpgOYJd+W+NKIByn/c4grmO7i77LpilfMFY0GCzQ87HUyVpNur+cmV6U/kTecmmYHpvPm0KdIBembhLoz2IYrF+Hjhga6/05Cdqa3zr/04GpZnMBxRpVzscYqCtGwPDBUfMIIEuzCCA6OgAwIBAgIBAjANBgkqhkiG9w0BAQUFADBiMQswCQYDVQQGEwJVUzETMBEGA1UEChMKQXBwbGUgSW5jLjEmMCQGA1UECxMdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxFjAUBgNVBAMTDUFwcGxlIFJvb3QgQ0EwHhcNMDYwNDI1MjE0MDM2WhcNMzUwMjA5MjE0MDM2WjBiMQswCQYDVQQGEwJVUzETMBEGA1UEChMKQXBwbGUgSW5jLjEmMCQGA1UECxMdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxFjAUBgNVBAMTDUFwcGxlIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkkakJH5HbHkdQ6wXtXnmELes2oldMVeyLGYne+Uts9QerIjAC6Bg++FAJ039BqJj50cpmnCRrEdCju+QbKsMflZ56DKRHi1vUFjczy8QPTc4UadHJGXL1XQ7Vf1+b8iUDulWPTV0N8WQ1IxVLFVkds5T39pyez1C6wVhQZ48ItCD3y6wsIG9wtj8BMIy3Q88PnT3zK0koGsj+zrW5DtleHNbLPbU6rfQPDgCSC7EhFi501TwN22IWq6NxkkdTVcGvL0Gz+PvjcM3mo0xFfh9Ma1CWQYnEdGILEINBhzOKgbEwWOxaBDKMaLOPHd5lc/9nXmW8Sdh2nzMUZaF3lMktAgMBAAGjggF6MIIBdjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUK9BpR5R2Cf70a40uQKb3R01/CF4wHwYDVR0jBBgwFoAUK9BpR5R2Cf70a40uQKb3R01/CF4wggERBgNVHSAEggEIMIIBBDCCAQAGCSqGSIb3Y2QFATCB8jAqBggrBgEFBQcCARYeaHR0cHM6Ly93d3cuYXBwbGUuY29tL2FwcGxlY2EvMIHDBggrBgEFBQcCAjCBthqBs1JlbGlhbmNlIG9uIHRoaXMgY2VydGlmaWNhdGUgYnkgYW55IHBhcnR5IGFzc3VtZXMgYWNjZXB0YW5jZSBvZiB0aGUgdGhlbiBhcHBsaWNhYmxlIHN0YW5kYXJkIHRlcm1zIGFuZCBjb25kaXRpb25zIG9mIHVzZSwgY2VydGlmaWNhdGUgcG9saWN5IGFuZCBjZXJ0aWZpY2F0aW9uIHByYWN0aWNlIHN0YXRlbWVudHMuMA0GCSqGSIb3DQEBBQUAA4IBAQBcNplMLXi37Yyb3PN3m/J20ncwT8EfhYOFG5k9RzfyqZtAjizUsZAS2L70c5vu0mQPy3lPNNiiPvl4/2vIB+x9OYOLUyDTOMSxv5pPCmv/K/xZpwUJfBdAVhEedNO3iyM7R6PVbyTi69G3cN8PReEnyvFteO3ntRcXqNx+IjXKJdXZD9Zr1KIkIxH3oayPc4FgxhtbCS+SsvhESPBgOJ4V9T0mZyCKM2r3DYLP3uujL/lTaltkwGMzd/c6ByxW69oPIQ7aunMZT7XZNn/Bh1XZp5m5MkL72NVxnn6hUrcbvZNCJBIqxw8dtk2cXmPIS4AXUKqK1drk/NAJBzewdXUhMYIByzCCAccCAQEwgaMwgZYxCzAJBgNVBAYTAlVTMRMwEQYDVQQKDApBcHBsZSBJbmMuMSwwKgYDVQQLDCNBcHBsZSBXb3JsZHdpZGUgRGV2ZWxvcGVyIFJlbGF0aW9uczFEMEIGA1UEAww7QXBwbGUgV29ybGR3aWRlIERldmVsb3BlciBSZWxhdGlvbnMgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkCCA7rV4fnngmNMAkGBSsOAwIaBQAwDQYJKoZIhvcNAQEBBQAEggEATbRGLKlAK1uwDk+1Suh3tx18qPR6ejP8S7BnOdoizNK4WD8vNcrOy0tudTK6GgfUliJEpf3ZTilu2mNcMRBJnlGbNhzMHVicgYGEYrf8FmANEtyxgWnlhEuv3tLJGaS1y5vL1OsDNaJicMPaZJDJk0XbJxF2gWLz/L1JH45hxIPAMUGAA4GihYYMj9RwJbSAKQwI9l/cZiWDR8HnFsYHg1V6/LCAu8nDkaarFHLZeOJwKKsT9OP/6JHlzpB0NSRYw+5Y6fmmP3FQbglL1vUh1/9CIsdGVf3H0ftxCZrG2b4zGDH/kdAjjec1/RwZxLCMW+Qn4Ot5fX5rbJaL2frRvQ==

◼︎ 자동 갱신 구독(Auto-Renewable Subscription)의 receipt-data

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

◼︎ 비자동 갱신 구독(Non-Renewable Subscription)의 receipt-data

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

서버 프로세스를 간략하게 이해하고, 애플에서 제공하는 상품 4가지에 대해서 알아봤습니다.
receipt-data까지 준비가 완료되었다면 스프링 프로젝트의 로직을 확인하도록 하겠습니다.
(receipt-data 준비가 어렵다면 위에 제가 제공해드린 receipt-data를 사용해도 상관없습니다.)

글에서 설명드리는 코드가 필요하신 분은 아래 GitHub URL을 통해서 다운로드하시면 됩니다.

GitHub URL ‣ github.com/WHITEPAEK/demo-in-app-purchase

[그림 2] application.properties 설정

application.properties는 따로 설정할 필요가 없을 거 같습니다.
"APPLE.PASSWORD"는 자동 갱신 구독 상품에 대한 서비스를 제공하고 있다면
App Store Connect에서 생성한 공유 암호를 넣어주시면 됩니다.

하지만 이 글에서는 소모품 상품에 대해서만 테스트해보도록 하겠습니다.
(소모품 상품에 대해서만 테스트를 진행한 이유는 아래에서 설명드리도록 하겠습니다.)

소모품 외에도 "비소모품, 비자동 갱신 구독" 상품은 따로 password가 필요하지 않기 때문에 문제없이 진행할 수 있습니다.
(자동 갱신 구독 상품에 대한 구매 이력이 포함되어 있는 receipt-data는 password가 필요합니다.)

[Process. 4] 상품 결제 검증 요청 ‣ App에서 "receipt-data" 요청받기

@RestController
public class AppleController {

    private final AppleService appleService;

    public AppleController(AppleService appleService) {
        this.appleService = appleService;
    }

    @PostMapping("/purchase")
    public ResponseEntity purchase(@RequestBody UserReceipt userReceipt) {

        String code = appleService.updatePurchaseHistory(userReceipt);

        return ResponseEntity.ok(code);
    }

}

receipt-data는 문자열이 상당히 길기 때문에 RequestBody로 받아야 합니다. - @RequestBody UserReceipt userReceipt

public class UserReceipt {

    // TODO - User(구매자) 정보에 대한 Fields 필요.

    @JsonAlias("receipt-data")
    private String receiptData;

    public String getReceiptData() {
        return receiptData;
    }

    public void setReceiptData(String receiptData) {
        this.receiptData = receiptData;
    }
}

유저가 구매한 상품을 서버에서 관리하기 위해서는 App에게 receipt-data 외에도 유저(구매자)에 대한 데이터도 받아야 합니다.
실제 서비스를 구현할 때는 UserReceipt.java 파일에서 유저 관리에 필요한 Fields를 적절하게 정의해주도록 하세요.

테스트에서는 receipt-data만 받아서 진행하도록 하겠습니다.

[Process. 4-1] 영수증 검증 요청 ‣ App Store에게 receipt-data 검증 요청 (/verfityReceipt)

// AppleUtils.java - 43 라인

public AppStoreResponse verifyReceipt(UserReceipt userReceipt) throws JsonProcessingException, IllegalStateException {

        Map<String, String> appStoreRequest = new HashMap<>();
        appStoreRequest.put("receipt-data", userReceipt.getReceiptData());
//        appStoreRequest.put("password", PASSWORD);

        String response = HttpClientUtils.doPost(APPLE_PRODUCTION_URL, appStoreRequest);
        AppStoreResponse appStoreResponse = objectMapper.readValue(response, AppStoreResponse.class);

        int statusCode = appStoreResponse.getStatus();
        if (statusCode == 21007) {
            response = HttpClientUtils.doPost(APPLE_SANDBOX_URL, appStoreRequest);
            appStoreResponse = objectMapper.readValue(response, AppStoreResponse.class);
        } else if (statusCode != 0) {
            verifyStatusCode(statusCode);
        }

        return appStoreResponse;
}

receipt-data 데이터와 함께 "[POST] https://buy.itunes.apple.com/verifyReceipt"를 호출합니다.
호출 후 전달받은 JSON 응답 값에서 status 코드 값이 21007인 경우에는
"[POST] https://sandbox.itunes.apple.com/verifyReceipt"를 다시 호출하도록 합니다.
(password는 자동 구독 갱신 상품에 대한 receipt-data 혹은 이력이 포함된 receipt-data를 검증하는 경우에 필요합니다.)

인 앱 결제 테스트를 진행하는 경우에는 Sandbox Test URL을 호출하여야 합니다.
애플 공식 문서에 따르면 Production URL을 먼저 호출하고 21007 코드를 받으면
Sandbox URL을 호출하여 계속 진행하라고 합니다.

Apple Document ‣ developer.apple.com/documentation/appstorereceipts/verifyreceipt

[Process. 4-2 ~ 4-3] 영수증 검증 후 응답받은 데이터를 DB에 저장

// AppleServiceImpl.java - 24 라인

public String updatePurchaseHistory(UserReceipt userReceipt) {

        AppStoreResponse appStoreResponse;
        try {
            appStoreResponse = appleUtils.verifyReceipt(userReceipt);
        } catch (Exception e) {
            logger.error("Verify receipt fail..");
            e.printStackTrace();
            return "Fail";
        }

        UserReceiptInfo userReceiptInfo = null;
        if (appStoreResponse.getReceipt().getInApp().size() == 1) { // 소모품 (Consumable)
            userReceiptInfo = getUserReceiptInfo(appStoreResponse.getReceipt().getInApp().get(0));
        } else {
            // TODO - 비소모품(Non-Consumable), 자동 갱신 구독(Auto-Renewable Subscription), 비자동 갱신 구독(Non-Renewable Subscription)에 대한 로직 필요.
        }

        logger.info("===== DATABASE INSERT IGNORE =====");
        logger.info("product_id ‣ " + userReceiptInfo.getProductId());
        logger.info("transaction_id ‣ " + userReceiptInfo.getTransactionId());
        logger.info("original_transaction_id ‣ " + userReceiptInfo.getOriginalTransactionId());
        logger.info("purchase_data_ms ‣ " + userReceiptInfo.getPurchaseDateMs());
        logger.info("expiration_date ‣ " + userReceiptInfo.getExpirationDate());
        logger.info("====================================");

        return "Success";
}

"/verifyReceipt"을 호출 후 응답받은 JSON 형태의 영수증(receipt) 데이터에서 필요한 값을 파싱 하고
데이터베이스에 저장하여 유저가 구매한 상품 이력을 관리해주어야 합니다.

저는 소모품 상품에 대한 영수증 데이터를 파싱 하여 데이터베이스에 저장하는 대신 logger로 찍었습니다.
실제 서비스에서 상품에 대한 정책과 DB에서 관리할 영수증 데이터가 정해지지 않았기 때문에
각 상품에 대한 상황을 체크하여 프로세스를 확인하는 게 목적이기 때문에 소모품 상품에 대한 영수증을 기반으로 로직을 작성하였습니다.

응답받은 영수증 데이터에서 소모품의 경우에는 in_app에 1건의 데이터만 존재합니다.
("비소모품, 자동 갱신 구독, 비자동 갱신 구독" 상품의 결제를 진행했다면 소모품 상품 외 이력이 in_app에 존재합니다.
또한 트랜잭션이 종료되지 않은 상품의 경우에도 이력이 존재합니다.)

Apple에게 "/verifyReceipt" API 요청 후 응답받은 상품 별 영수증 데이터(JSON)는 아래와 같습니다.
JSON의 Properties 설명은 공식 문서를 참고해주세요.

Apple Document ‣ developer.apple.com/documentation/appstorereceipts/responsebody

◼︎ 소모품(Consumable) 영수증 데이터 (JSON)

{
"receipt":{
"receipt_type":"ProductionSandbox",
"adam_id":0,
"app_item_id":0,
"bundle_id":"com.whitepaek.apps",
"application_version":"1",
"download_id":0,
"version_external_identifier":0,
"receipt_creation_date":"2020-11-30 04:02:18 Etc\/GMT",
"receipt_creation_date_ms":"1606708938000",
"receipt_creation_date_pst":"2020-11-29 20:02:18 America\/Los_Angeles",
"request_date":"2020-11-30 04:03:44 Etc\/GMT",
"request_date_ms":"1606709024832",
"request_date_pst":"2020-11-29 20:03:44 America\/Los_Angeles",
"original_purchase_date":"2013-08-01 07:00:00 Etc\/GMT",
"original_purchase_date_ms":"1375340400000",
"original_purchase_date_pst":"2013-08-01 00:00:00 America\/Los_Angeles",
"original_application_version":"1.0",
"in_app":[
{
"quantity":"1",
"product_id":"products.consumable",
"transaction_id":"1000000747843075",
"original_transaction_id":"1000000747843075",
"purchase_date":"2020-11-30 04:02:18 Etc\/GMT",
"purchase_date_ms":"1606708938000",
"purchase_date_pst":"2020-11-29 20:02:18 America\/Los_Angeles",
"original_purchase_date":"2020-11-30 04:02:18 Etc\/GMT",
"original_purchase_date_ms":"1606708938000",
"original_purchase_date_pst":"2020-11-29 20:02:18 America\/Los_Angeles",
"is_trial_period":"false"
}
]
},
"environment":"Sandbox",
"status":0}

◼︎ 비소모품(Non-Consumable) 영수증 데이터 (JSON)

{
"receipt":{
"receipt_type":"ProductionSandbox",
"adam_id":0,
"app_item_id":0,
"bundle_id":"com.whitepaek.apps",
"application_version":"1",
"download_id":0,
"version_external_identifier":0,
"receipt_creation_date":"2020-11-30 04:18:33 Etc\/GMT",
"receipt_creation_date_ms":"1606709913000",
"receipt_creation_date_pst":"2020-11-29 20:18:33 America\/Los_Angeles",
"request_date":"2020-11-30 04:19:15 Etc\/GMT",
"request_date_ms":"1606709955191",
"request_date_pst":"2020-11-29 20:19:15 America\/Los_Angeles",
"original_purchase_date":"2013-08-01 07:00:00 Etc\/GMT",
"original_purchase_date_ms":"1375340400000",
"original_purchase_date_pst":"2013-08-01 00:00:00 America\/Los_Angeles",
"original_application_version":"1.0",
"in_app":[
{
"quantity":"1",
"product_id":"products.nonConsumable",
"transaction_id":"1000000747845239",
"original_transaction_id":"1000000747845239",
"purchase_date":"2020-11-30 04:18:33 Etc\/GMT",
"purchase_date_ms":"1606709913000",
"purchase_date_pst":"2020-11-29 20:18:33 America\/Los_Angeles",
"original_purchase_date":"2020-11-30 04:18:33 Etc\/GMT",
"original_purchase_date_ms":"1606709913000",
"original_purchase_date_pst":"2020-11-29 20:18:33 America\/Los_Angeles",
"is_trial_period":"false"
}
]
},
"environment":"Sandbox",
"status":0
}

◼︎ 자동 갱신 구독(Auto-Renewable Subscription) 영수증 데이터 (JSON)

{
"environment":"Sandbox",
"receipt":{
"receipt_type":"ProductionSandbox",
"adam_id":0,
"app_item_id":0,
"bundle_id":"com.whitepaek.apps",
"application_version":"1",
"download_id":0,
"version_external_identifier":0,
"receipt_creation_date":"2020-11-30 04:22:32 Etc\/GMT",
"receipt_creation_date_ms":"1606710152000",
"receipt_creation_date_pst":"2020-11-29 20:22:32 America\/Los_Angeles",
"request_date":"2020-11-30 04:23:30 Etc\/GMT",
"request_date_ms":"1606710210501",
"request_date_pst":"2020-11-29 20:23:30 America\/Los_Angeles",
"original_purchase_date":"2013-08-01 07:00:00 Etc\/GMT",
"original_purchase_date_ms":"1375340400000",
"original_purchase_date_pst":"2013-08-01 00:00:00 America\/Los_Angeles",
"original_application_version":"1.0",
"in_app":[
{
"quantity":"1",
"product_id":"products.autoRenewableSubscription",
"transaction_id":"1000000747846047",
"original_transaction_id":"1000000747846047",
"purchase_date":"2020-11-30 04:22:31 Etc\/GMT",
"purchase_date_ms":"1606710151000",
"purchase_date_pst":"2020-11-29 20:22:31 America\/Los_Angeles",
"original_purchase_date":"2020-11-30 04:22:32 Etc\/GMT",
"original_purchase_date_ms":"1606710152000",
"original_purchase_date_pst":"2020-11-29 20:22:32 America\/Los_Angeles",
"expires_date":"2020-11-30 04:25:31 Etc\/GMT",
"expires_date_ms":"1606710331000",
"expires_date_pst":"2020-11-29 20:25:31 America\/Los_Angeles",
"web_order_line_item_id":"1000000057838979",
"is_trial_period":"false",
"is_in_intro_offer_period":"false"
}
]
},
"latest_receipt_info":[
{
"quantity":"1",
"product_id":"products.autoRenewableSubscription",
"transaction_id":"1000000747846047",
"original_transaction_id":"1000000747846047",
"purchase_date":"2020-11-30 04:22:31 Etc\/GMT",
"purchase_date_ms":"1606710151000",
"purchase_date_pst":"2020-11-29 20:22:31 America\/Los_Angeles",
"original_purchase_date":"2020-11-30 04:22:32 Etc\/GMT",
"original_purchase_date_ms":"1606710152000",
"original_purchase_date_pst":"2020-11-29 20:22:32 America\/Los_Angeles",
"expires_date":"2020-11-30 04:25:31 Etc\/GMT",
"expires_date_ms":"1606710331000",
"expires_date_pst":"2020-11-29 20:25:31 America\/Los_Angeles",
"web_order_line_item_id":"1000000057838979",
"is_trial_period":"false",
"is_in_intro_offer_period":"false",
"subscription_group_identifier":"20704611"
}
],
"latest_receipt":"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\/Qrk8H9Pm\/KwfU8qY9SGsAlCnYO3v6Z\/v\/Ca\/VbXqxzUUkIVonMQ5DMjoEC0KCXtlyxoWlph5AQaCYmObgdEHOwCl3Fc9DfdjvYLdmIHuPsB8\/ijtDT+iZVge\/iA0kjAgMBAAGjggHXMIIB0zA\/BggrBgEFBQcBAQQzMDEwLwYIKwYBBQUHMAGGI2h0dHA6Ly9vY3NwLmFwcGxlLmNvbS9vY3NwMDMtd3dkcjA0MB0GA1UdDgQWBBSRpJz8xHa3n6CK9E31jzZd7SsEhTAMBgNVHRMBAf8EAjAAMB8GA1UdIwQYMBaAFIgnFwmpthhgi+zruvZHWcVSVKO3MIIBHgYDVR0gBIIBFTCCAREwggENBgoqhkiG92NkBQYBMIH+MIHDBggrBgEFBQcCAjCBtgyBs1JlbGlhbmNlIG9uIHRoaXMgY2VydGlmaWNhdGUgYnkgYW55IHBhcnR5IGFzc3VtZXMgYWNjZXB0YW5jZSBvZiB0aGUgdGhlbiBhcHBsaWNhYmxlIHN0YW5kYXJkIHRlcm1zIGFuZCBjb25kaXRpb25zIG9mIHVzZSwgY2VydGlmaWNhdGUgcG9saWN5IGFuZCBjZXJ0aWZpY2F0aW9uIHByYWN0aWNlIHN0YXRlbWVudHMuMDYGCCsGAQUFBwIBFipodHRwOi8vd3d3LmFwcGxlLmNvbS9jZXJ0aWZpY2F0ZWF1dGhvcml0eS8wDgYDVR0PAQH\/BAQDAgeAMBAGCiqGSIb3Y2QGCwEEAgUAMA0GCSqGSIb3DQEBBQUAA4IBAQANphvTLj3jWysHbkKWbNPojEMwgl\/gXNGNvr0PvRr8JZLbjIXDgFnf4+LXLgUUrA3btrj+\/DUufMutF2uOfx\/kd7mxZ5W0E16mGYZ2+FogledjjA9z\/Ojtxh+umfhlSFyg4Cg6wBA3LbmgBDkfc7nIBf3y3n8aKipuKwH8oCBc2et9J6Yz+PWY4L5E27FMZ\/xuCk\/J4gao0pfzp45rUaJahHVl0RYEYuPBX\/UIqc9o2ZIAycGMs\/iNAGS6WGDAfK+PdcppuVsq1h1obphC9UynNxmbzDscehlD86Ntv0hgBgw2kivs3hi1EdotI9CO\/KBpnBcbnoB7OUdFMGEvxxOoMIIEIjCCAwqgAwIBAgIIAd68xDltoBAwDQYJKoZIhvcNAQEFBQAwYjELMAkGA1UEBhMCVVMxEzARBgNVBAoTCkFwcGxlIEluYy4xJjAkBgNVBAsTHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRYwFAYDVQQDEw1BcHBsZSBSb290IENBMB4XDTEzMDIwNzIxNDg0N1oXDTIzMDIwNzIxNDg0N1owgZYxCzAJBgNVBAYTAlVTMRMwEQYDVQQKDApBcHBsZSBJbmMuMSwwKgYDVQQLDCNBcHBsZSBXb3JsZHdpZGUgRGV2ZWxvcGVyIFJlbGF0aW9uczFEMEIGA1UEAww7QXBwbGUgV29ybGR3aWRlIERldmVsb3BlciBSZWxhdGlvbnMgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDKOFSmy1aqyCQ5SOmM7uxfuH8mkbw0U3rOfGOAYXdkXqUHI7Y5\/lAtFVZYcC1+xG7BSoU+L\/DehBqhV8mvexj\/avoVEkkVCBmsqtsqMu2WY2hSFT2Miuy\/axiV4AOsAX2XBWfODoWVN2rtCbauZ81RZJ\/GXNG8V25nNYB2NqSHgW44j9grFU57Jdhav06DwY3Sk9UacbVgnJ0zTlX5ElgMhrgWDcHld0WNUEi6Ky3klIXh6MSdxmilsKP8Z35wugJZS3dCkTm59c3hTO\/AO0iMpuUhXf1qarunFjVg0uat80YpyejDi+l5wGphZxWy8P3laLxiX27Pmd3vG2P+kmWrAgMBAAGjgaYwgaMwHQYDVR0OBBYEFIgnFwmpthhgi+zruvZHWcVSVKO3MA8GA1UdEwEB\/wQFMAMBAf8wHwYDVR0jBBgwFoAUK9BpR5R2Cf70a40uQKb3R01\/CF4wLgYDVR0fBCcwJTAjoCGgH4YdaHR0cDovL2NybC5hcHBsZS5jb20vcm9vdC5jcmwwDgYDVR0PAQH\/BAQDAgGGMBAGCiqGSIb3Y2QGAgEEAgUAMA0GCSqGSIb3DQEBBQUAA4IBAQBPz+9Zviz1smwvj+4ThzLoBTWobot9yWkMudkXvHcs1Gfi\/ZptOllc34MBvbKuKmFysa\/Nw0Uwj6ODDc4dR7Txk4qjdJukw5hyhzs+r0ULklS5MruQGFNrCk4QttkdUGwhgAqJTleMa1s8Pab93vcNIx0LSiaHP7qRkkykGRIZbVf1eliHe2iK5IaMSuviSRSqpd1VAKmuu0swruGgsbwpgOYJd+W+NKIByn\/c4grmO7i77LpilfMFY0GCzQ87HUyVpNur+cmV6U\/kTecmmYHpvPm0KdIBembhLoz2IYrF+Hjhga6\/05Cdqa3zr\/04GpZnMBxRpVzscYqCtGwPDBUfMIIEuzCCA6OgAwIBAgIBAjANBgkqhkiG9w0BAQUFADBiMQswCQYDVQQGEwJVUzETMBEGA1UEChMKQXBwbGUgSW5jLjEmMCQGA1UECxMdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxFjAUBgNVBAMTDUFwcGxlIFJvb3QgQ0EwHhcNMDYwNDI1MjE0MDM2WhcNMzUwMjA5MjE0MDM2WjBiMQswCQYDVQQGEwJVUzETMBEGA1UEChMKQXBwbGUgSW5jLjEmMCQGA1UECxMdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxFjAUBgNVBAMTDUFwcGxlIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkkakJH5HbHkdQ6wXtXnmELes2oldMVeyLGYne+Uts9QerIjAC6Bg++FAJ039BqJj50cpmnCRrEdCju+QbKsMflZ56DKRHi1vUFjczy8QPTc4UadHJGXL1XQ7Vf1+b8iUDulWPTV0N8WQ1IxVLFVkds5T39pyez1C6wVhQZ48ItCD3y6wsIG9wtj8BMIy3Q88PnT3zK0koGsj+zrW5DtleHNbLPbU6rfQPDgCSC7EhFi501TwN22IWq6NxkkdTVcGvL0Gz+PvjcM3mo0xFfh9Ma1CWQYnEdGILEINBhzOKgbEwWOxaBDKMaLOPHd5lc\/9nXmW8Sdh2nzMUZaF3lMktAgMBAAGjggF6MIIBdjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH\/BAUwAwEB\/zAdBgNVHQ4EFgQUK9BpR5R2Cf70a40uQKb3R01\/CF4wHwYDVR0jBBgwFoAUK9BpR5R2Cf70a40uQKb3R01\/CF4wggERBgNVHSAEggEIMIIBBDCCAQAGCSqGSIb3Y2QFATCB8jAqBggrBgEFBQcCARYeaHR0cHM6Ly93d3cuYXBwbGUuY29tL2FwcGxlY2EvMIHDBggrBgEFBQcCAjCBthqBs1JlbGlhbmNlIG9uIHRoaXMgY2VydGlmaWNhdGUgYnkgYW55IHBhcnR5IGFzc3VtZXMgYWNjZXB0YW5jZSBvZiB0aGUgdGhlbiBhcHBsaWNhYmxlIHN0YW5kYXJkIHRlcm1zIGFuZCBjb25kaXRpb25zIG9mIHVzZSwgY2VydGlmaWNhdGUgcG9saWN5IGFuZCBjZXJ0aWZpY2F0aW9uIHByYWN0aWNlIHN0YXRlbWVudHMuMA0GCSqGSIb3DQEBBQUAA4IBAQBcNplMLXi37Yyb3PN3m\/J20ncwT8EfhYOFG5k9RzfyqZtAjizUsZAS2L70c5vu0mQPy3lPNNiiPvl4\/2vIB+x9OYOLUyDTOMSxv5pPCmv\/K\/xZpwUJfBdAVhEedNO3iyM7R6PVbyTi69G3cN8PReEnyvFteO3ntRcXqNx+IjXKJdXZD9Zr1KIkIxH3oayPc4FgxhtbCS+SsvhESPBgOJ4V9T0mZyCKM2r3DYLP3uujL\/lTaltkwGMzd\/c6ByxW69oPIQ7aunMZT7XZNn\/Bh1XZp5m5MkL72NVxnn6hUrcbvZNCJBIqxw8dtk2cXmPIS4AXUKqK1drk\/NAJBzewdXUhMYIByzCCAccCAQEwgaMwgZYxCzAJBgNVBAYTAlVTMRMwEQYDVQQKDApBcHBsZSBJbmMuMSwwKgYDVQQLDCNBcHBsZSBXb3JsZHdpZGUgRGV2ZWxvcGVyIFJlbGF0aW9uczFEMEIGA1UEAww7QXBwbGUgV29ybGR3aWRlIERldmVsb3BlciBSZWxhdGlvbnMgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkCCA7rV4fnngmNMAkGBSsOAwIaBQAwDQYJKoZIhvcNAQEBBQAEggEAKW5ec5xp9kgM8xy++jeQ5SNJaNR5PDPEbxLPvpC6tVRKJokBNePdhxdZ1fNP3ghxU2sY6BsjTw3ir4Hxe2YC0lCsap32lncG0sCPnifMKaAN7IlyFTF27Ubl0d8ete7THiSzqz5ZOiVG2sBoYNDe0v107HS7w929twp7uLyDwim3GqMFdpv+IdNUJ6g2e94r\/Zo3nVwzRNge\/CD1Lj6oVTKqNdU2QiyiuZN5804mi9dToXZxHk8ihL4tflSA6Aqfm\/DisJgwc9gmwhwuRVl6DiaZZmitoMn0AberUDh1LheGg9cA0pL7fZfZ7UCC00ELh71X07cKelWb8i1Q\/PECvQ==",
"pending_renewal_info":[
{
"auto_renew_product_id":"products.autoRenewableSubscription",
"original_transaction_id":"1000000747846047",
"product_id":"products.autoRenewableSubscription",
"auto_renew_status":"1"
}
],
"status":0
}

◼︎ 비자동 갱신 구독(Non-Renewable Subscription) 영수증 데이터 (JSON)

{
"receipt":{
"receipt_type":"ProductionSandbox",
"adam_id":0,
"app_item_id":0,
"bundle_id":"com.whitepaek.apps",
"application_version":"1",
"download_id":0,
"version_external_identifier":0,
"receipt_creation_date":"2020-11-30 04:29:57 Etc\/GMT",
"receipt_creation_date_ms":"1606710597000",
"receipt_creation_date_pst":"2020-11-29 20:29:57 America\/Los_Angeles",
"request_date":"2020-11-30 04:30:32 Etc\/GMT",
"request_date_ms":"1606710632165",
"request_date_pst":"2020-11-29 20:30:32 America\/Los_Angeles",
"original_purchase_date":"2013-08-01 07:00:00 Etc\/GMT",
"original_purchase_date_ms":"1375340400000",
"original_purchase_date_pst":"2013-08-01 00:00:00 America\/Los_Angeles",
"original_application_version":"1.0",
"in_app":[
{
"quantity":"1",
"product_id":"products.nonRenewableSubscription",
"transaction_id":"1000000747847882",
"original_transaction_id":"1000000747847882",
"purchase_date":"2020-11-30 04:29:57 Etc\/GMT",
"purchase_date_ms":"1606710597000",
"purchase_date_pst":"2020-11-29 20:29:57 America\/Los_Angeles",
"original_purchase_date":"2020-11-30 04:29:57 Etc\/GMT",
"original_purchase_date_ms":"1606710597000",
"original_purchase_date_pst":"2020-11-29 20:29:57 America\/Los_Angeles",
"is_trial_period":"false"
}
]
},
"environment":"Sandbox",
"status":0
}

해당 로직에서 발생할 수 있는 이슈를 확인해보도록 하겠습니다.

[그림 3] 인 앱 결제 프로세스 이슈(In-App Purchase Process Issue)

구매한 상품의 트랜잭션이 정상적으로 종료되지 않는 문제에 대해 아래와 같은 케이스를 생각해볼 수 있습니다.

1. App에서 발생한 문제
1-1. App에서 receipt-data를 Server에 전달하기 전 비정상적으로 종료된 경우 - [Process. 4] 이슈
1-2. App에서 receipt-data를 Server에 전달한 후 비정상적으로 종료된 경우 - [Process. 4-1 ~ 4-4] 이슈
1-3. App에서 구매 완료(트랜잭션 종료) 후 Server에게 구매 완료 요청 API를 호출하기 전 종료된 경우 - [Process. 5] 이슈

2. Server에서 발생한 문제
2-1. 데이터베이스에 영수증 데이터를 저장 후 Server 문제 발생으로 App에게 응답 값을 전달하지 못한 경우 - [Process. 4-4] 이슈
2-2. 영수증 검증 오류와 같은 이슈로 데이터베이스에 저장하지 못하고 App에게 실패(fail)의 응답 값을 전달한 경우 - [Process. 4-4] 이슈

위 5가지의 문제에 대해 제가 생각해본 해결 포인트는 아래와 같습니다.

1-1. App이 재구동될 때 종료되지 않은 트랜잭션의 receipt-data를 재생성하여 Server에 재요청하기 때문에 Server 쪽에서는 신경 쓸 부분이 없다.
‣ App에서 처리해야하는 이슈

1-2. App이 재구동 되면서 종료되지 않은 트랜잭션의 receipt-data를 재생성하여 Server에 재요청 한다.
이 경우에 Server는 기존 로직을 동일하게 진행하나 데이터베이스에 중복으로 유저의 상품 정보가 존재하는지 확인해야 한다.
‣ App & Server에서 처리해야하는 이슈

1-3. App에서 유저의 구매 이력과 DB에 저장된 유저의 구매 이력을 비교하여 DB를 현행화 해주는 Server 로직이 필요하다.
이 경우에는 어떻게 처리해야 할까.. 댓글로 의견 부탁드리겠습니다.
‣ 고객이 결제를 했으나, 상품 구매가 정상적으로 이루어지지 않았기 때문에 고객센터를 통해 문의를 한다.(?)

2-1. App은 일정시간 동안 응답 값을 받지 못하면 Server에 재요청한다.
일정시간 혹은 재요청 후에도 응답 값을 받지 못하면 App은 결제 실패에 대한 트랜잭션을 처리할 로직을 구현해야 한다.
(서버에 문제가 발생한 경우에는 서비스 전체 장애이기 때문에 절대 발생하는 일이 없기를..)
‣ App & Server에서 처리해야하는 이슈

2-2. App은 실패에 대한 응답 값을 전달받았기 때문에 Server에 재요청 한다.
이 경우에는 Apple 쪽 문제 혹은 Server에서 데이터 처리 과정에서 발생한 문제이기 때문에 관련 로그를 적절하게 남기고 빠른 시간 내에 장애를 처리해야 한다. (마찬가지로 발생해서는 안되는 문제이지만 만약 발생한 경우 App 쪽에서 결제 실패에 대한 트랜잭션을 처리할 로직을 구현해야한다.)
‣ App & Server에서 처리해야하는 이슈

로직에서 고려해야 할 사항은 (1) "비소모품, 자동 갱신 구독, 비자동 갱신 구독" 상품의 구매 이력이 존재하는 영수증 데이터에 대한 처리와
(2) 1-2 이슈 상황에 대한 부분일 거라고 생각합니다. 아래에서 두 가지 상황에 대해서 얘기를 해보겠습니다.

(1) 구매 이력이 존재하는 영수증
in_app 프로퍼티에 상품의 구매 이력이 존재하는 영수증 데이터를 처리하는 로직은 현재 코드에서 구현하지 않았습니다.
이유는 서비스 정책이 정해지지 않은 상황이지만, 앱 내에서 사용하는 "기간제 & 무기한"의 상품을 다룰 예정이고
유저의 구매 상품과 기간을 서버에서 관리할 것이기 때문에 transaction_id가 일관성 있게 유지되는
소모품(Consumable) 옵션이 적절하다고 판단하였기 때문입니다.

"비소모품, 자동 갱신 구독, 비자동 갱신 구독" 상품의 경우에는 App에서 복원(Restore) 기능을 구현해야 합니다.
복원 기능을 구현하지 않는다면 App Store에서 거절(reject) 사유에 해당되기 때문입니다.
또한 복원을 하는 경우 transaction_id가 변경되어 구매 이력이 추가적으로 생성되기 때문에
앱 내에서 사용하는 상품을 관리하기에는 적절하지 않다고 판단하였습니다.

// AppleServiceImpl.java - 35 라인

UserReceiptInfo userReceiptInfo = null;
if (appStoreResponse.getReceipt().getInApp().size() == 1) { // 소모품 (Consumable)
	userReceiptInfo = getUserReceiptInfo(appStoreResponse.getReceipt().getInApp().get(0));
} else {
	// TODO - 비소모품(Non-Consumable), 자동 갱신 구독(Auto-Renewable Subscription), 비자동 갱신 구독(Non-Renewable Subscription)에 대한 로직 필요.
}

해당 부분에서 본인의 서비스 정책에 따른 상품의 영수증(receipt)에서 필요한 데이터를 파싱 하는 로직을 구현하면 됩니다.
(추후에 정책이 정해지면 적절한 프로세스를 구현해보고 좀 더 자세하게 설명을 추가해보도록 하겠습니다.)

(2) App에서 receipt-data를 Server에 전달한 후 비정상적으로 종료된 경우
App에서는 receipt-data를 Server에 전달하였고 Server에서는 영수증 검증까지 완료하고 유저의 구매 상품의 정보를
데이터베이스에 정상적으로 저장까지 완료하고 성공(Success)에 대한 응답 값을 App에게 전달하였으나,
App이 비정상적으로 종료되어서 Server에서 보낸 성공에 대한 응답 값을 못 받았기 때문에 구매 트랜잭션을 종료하지 못한 상황입니다.

이 경우에는 App이 재 구동된 시점에 종료되지 않은 트랜잭션에 대한 receipt-data를 재생성하여 Server에 다시 요청합니다.
하지만 유저가 구매한 상품에 대한 정보가 데이터베이스에 저장된 상황이기 때문에
Server는 transaction_id를 이용하여 데이터베이스에 저장된 데이터가 있는지 확인하고
데이터가 존재한다면 App에게 성공(Success)에 대한 응답 값을 전달해주면 됩니다.

// AppleServiceImpl.java - 42 라인

logger.info("===== DATABASE INSERT IGNORE =====");
logger.info("product_id ‣ " + userReceiptInfo.getProductId());
logger.info("transaction_id ‣ " + userReceiptInfo.getTransactionId());
logger.info("original_transaction_id ‣ " + userReceiptInfo.getOriginalTransactionId());
logger.info("purchase_data_ms ‣ " + userReceiptInfo.getPurchaseDateMs());
logger.info("expiration_date ‣ " + userReceiptInfo.getExpirationDate());
logger.info("====================================");

데이터베이스에 저장하는 로직은 현재 구현하지 않았고 logger로 필요한 데이터를 출력하였습니다.
이미 존재하는 데이터에 대한 중복 저장에 대해서는 INSERT IGNORE를 이용하여 처리하면 어떨까 하는 의견입니다.

마찬가지로 데이터베이스에서 관리할 상품 정보가 정해지지 않아서 몇 가지의 데이터만 뽑아서 확인했습니다.
애플 공식 문서에서는 "transaction_id, original_transaction_id, product_id"를 기준으로
데이터베이스에서 상품을 관리하길 권장합니다.

저는 데이터베이스에서 "기간제 & 무기한" 상품을 관리할 예정이기 때문에
"transaction_id, original_transaction_id, product_id" 외에도
상품을 구매한 유저의 정보와 구매한 상품에 대한 기간으로 계산한 만료 기간 등 추가로 넣어줄 예정입니다.

[Process. 4-4] 상품 결제 검증 응답 ‣ 데이터베이스에 유저가 구매한 상품 정보를 정상적으로 저장하였다면
App에게 성공(Success)에 대한 응답 값 반환

// AppleController.java - 19 라인

@PostMapping("/purchase")
public ResponseEntity purchase(@RequestBody UserReceipt userReceipt) {

	String code = appleService.updatePurchaseHistory(userReceipt);

	return ResponseEntity.ok(code);
}

애플(Apple) 인 앱 결제(In-App Purchase)에 대한 프로세스를 알아봤습니다.

가장 중요한 것은 서비스에 대한 정책을 어떻게 정하느냐에 따라 로직이 달라질 것입니다.
인 앱 결제에서 관리할 데이터와 프로세스가 정해진다면
프로토타입으로 간단하게 작성한 로직을 좀 더 구체화시킬 수 있을 거 같습니다.

해당 글 내용은 개인적인 판단으로 임의의 서비스 정책을 정한 후 작성한 글입니다.
또한 코드를 작성하는 실력이 아직 많이 부족하기 때문에 부족함이 많은 프로토타입의 코드입니다.
애플의 인 앱 결제(In-App Purchase) 프로세스를 이해하는 부분에서 도움이 되었으면 합니다.

인 앱 결제에서 사용되는 4가지 종류의 상품과 다양한 방식의 예외 사항을 테스트해봤습니다.
프로세스 흐름에 따라 글을 작성하다 보니 제가 경험한 전부를 내용에 넣지는 못했습니다.

각자가 생각하는 다양한 프로세스 혹은 궁금한 점
또는 글에서 부족하거나 틀린 점에 대해서 댓글을 통해 남겨주세요.

제가 겪어본 상황과 아는 지식에 한해서 저 또한 의견을 공유드리도록 하겠습니다.

감사합니다 :)

[2] 스프링 프로젝트에 애플 로그인 API 연동하기

WHITEPAEK — Mon, 31 Aug 2020 01:52:41 +0900

[1] 스프링 프로젝트에 애플 로그인 API 연동을 위한 Apple Developer 설정

[2] 스프링 프로젝트에 애플 로그인 API 연동하기 - (현재 글)

이전 포스트에서 "Sign in wtih Apple" 연동을 위한 Apple Developer 3가지 설정을 진행하였습니다.

설정을 통해서 필요한 데이터 준비가 끝났으므로 프로젝트에 설정하여 확인해보도록 하겠습니다.

먼저, 깃허브에 가서 코드를 다운로드하도록 합니다. (깃허브에서 코드를 다운로드하는 자세한 설명을 생략하도록 하겠습니다.)

깃허브 URL ‣ github.com/WHITEPAEK/demo-sign-in-with-apple

macOS Catalina 버전 10.15.6 운영체제에서 IntelliJ IDEA Ultimate 환경에서 Spring Boot 프로젝트로 포스트를 설명하도록 하겠습니다.

JWT 관련 라이브러리는 "nimbus-jose-jwt(v3.10)"를 이용했습니다. 해당 버전의 라이브러리를 이용한 이유는 애플 로그인 API를 적용시킬 프로젝트에서 사용하고 있기 때문에 그대로 유지하여 사용하기로 결정하였기 때문입니다.

[그림 1] application.properties 설정

프로젝트 다운로드하여 실행하였다면 application.properties 파일로 이동해주세요.

이전 포스트에서 설정 후 얻은 값을 아래와 동일한 위치에 입력해주면 됩니다.

# [그림 1.8] Team ID 값 입력
APPLE.TEAM.ID=[Team ID]

# [그림 2.5] Return URLs 값 입력
APPLE.WEBSITE.URL=[Website URLs]

# [그림 2.6] Identifier 값 입력
APPLE.AUD=[Client ID]

# [그림 3.5] Key ID 값 입력
APPLE.KEY.ID=[Key ID]

# [그림 3.5]에서 다운로드 받은 Private Key 파일을 해당 위치로 이동 후, 파일명 입력
APPLE.KEY.PATH=static/AuthKey_[KeyID].p8

[그림 2] "localhost:8080/" 접속

프로젝트를 실행 후 "localhost:8080/"으로 접속하면 Sign in with Apple 로그인 화면이 정상적으로 실행됩니다.

그리고 앞서 application.properties에 설정이 정상적이라면 로그인을 진행하고 값을 반환받을 수 있습니다.

프로젝트 실행은 설정 값만 적용한다면 쉽게 진행할 수 있습니다.

간단하게 애플 로그인 프로세스와 코드에 대해서 설명드리도록 하겠습니다.

[1] 애플 로그인 버튼 페이지

[Apple Document]

‣ developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_js/configuring_your_webpage_for_sign_in_with_apple

// AppleController.java - 30 라인

@GetMapping(value = "/")
public String appleLoginPage(ModelMap model) {

  Map<String, String> metaInfo = appleService.getLoginMetaInfo();

  model.addAttribute("client_id", metaInfo.get("CLIENT_ID"));
  model.addAttribute("redirect_uri", metaInfo.get("REDIRECT_URI"));
  model.addAttribute("nonce", metaInfo.get("NONCE"));

  return "index";
}

["localhost:8080/" - Sign in with Apple] 애플 로그인 버튼이 보이는 화면입니다.

유저가 버튼을 클릭하면 로그인이 진행되는데 이때 메타정보와 유저 아이디, 비밀번호가 애플에게 요청됩니다.

필드	설명
ID	유저 아이디
Password	유저 비밀번호
appleid-signin-client-id	Services ID - Identifier 값
appleid-signin-scope	애플에게 전달받을 유저 정보 - name email
appleid-signin-redirect-uri	Services ID - Return URLs 값
appleid-signin-state	상태 값
appleid-signin-nonce	임시 값

[2] 유저 로그인 후 정보 받기

[Apple Document]

‣ developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_rest_api/authenticating_users_with_sign_in_with_apple

// AppleController.java - 69 라인

@PostMapping(value = "/redirect")
@ResponseBody
public TokenResponse servicesRedirect(ServicesResponse serviceResponse) {

  if (serviceResponse == null) {
  	return null;
  }

  String code = serviceResponse.getCode();
  String client_secret = appleService.getAppleClientSecret(serviceResponse.getId_token());

  logger.debug("================================");
  logger.debug("id_token ‣ " + serviceResponse.getId_token());
  logger.debug("payload ‣ " + appleService.getPayload(serviceResponse.getId_token()));
  logger.debug("client_secret ‣ " + client_secret);
  logger.debug("================================");

  return appleService.requestCodeValidations(client_secret, code, null);
}

정의된 7개의 데이터와 함께 "https://appleid.apple.com/auth/authorize" 호출되고

애플은 Services ID에 정의된 Return URLs로 JSON 데이터를 반환합니다.

{
  "state":"test",
  "code":"c50d317be38c742c0beb19d8743de014c.0.nruy.1NtQvAmp9uhyrsMj1mp7kg",
  "id_token":"eyJraWQiOiI4NkQ4OEtmIiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJodHRwczovL2FwcGxlaWQuYXBwbGUuY29tIiwiYXVkIjoiY29tLndoaXRlcGFlay5zZXJ2aWNlcyIsImV4cCI6MTU5ODgwMDEyOCwiaWF0IjoxNTk4Nzk5NTI4LCJzdWIiOiIwMDAxNDguZjA2ZDgyMmNlMGIyNDgzYWFhOTdkMjczYjA5NzgzMjUuMTcxNyIsIm5vbmNlIjoiMjBCMjBELTBTOC0xSzgiLCJjX2hhc2giOiJ1aFFiV0gzQUFWdEc1OUw4eEpTMldRIiwiZW1haWwiOiJpNzlmaWl0OWIzQHByaXZhdGVyZWxheS5hcHBsZWlkLmNvbSIsImVtYWlsX3ZlcmlmaWVkIjoidHJ1ZSIsImlzX3ByaXZhdGVfZW1haWwiOiJ0cnVlIiwiYXV0aF90aW1lIjoxNTk4Nzk5NTI4LCJub25jZV9zdXBwb3J0ZWQiOnRydWV9.GQBCUHza0yttOfpQ-J5OvyZoGe5Zny8pI06sKVDIJaQY3bdiphllg1_pHMtPUp7FLv3ccthcmqmZn7NWVoIPkc9-_8squ_fp9F68XM-UsERKVzBvVR92TwQuKOPFr4lRn-2FlBzN4NegicMS-IV8Ad3AKTIRMIhvAXG4UgNxgPAuCpHwCwEAJijljfUfnRYO-_ywgTcF26szluBz9w0Y1nn_IIVCUzAwYiEMdLo53NoyJmWYFWu8pxmXRpunbMHl5nvFpf9nK-OGtMJrmZ4DlpTc2Gv64Zs2bwHDEvOyQ1WiRUB6_FWRH5FV10JSsccMlm6iOByOLYd03RRH2uYtFw",
  "user":"{
    \"email\":\"i79fiit9b3@privaterelay.appleid.com\",
    \"name\":{
      \"firstName\":\"SEUNGJOO\",
      \"lastName\":\"PAEK\"
    }
  }"
}

반환받은 JSON 데이터는 "state, code, id_token, user" 4개의 키로 이루어져 있습니다.

여기서 알고 있어야 할 부분은 user 키는 유저가 서비스 최초 가입할 때만 받을 수 있습니다.

또한, 유저는 자신의 email을 공유할 수도 있고, 하지 않을 수도 있습니다.

(JSON 데이터는 유저가 email을 공유하지 않은 데이터이며, "code" 키의 값은 5분 동안 유효합니다.)

[3] id_token 5가지 유효성 검증

[Apple Document]

‣ developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_rest_api/verifying_a_user

‣ developer.apple.com/documentation/sign_in_with_apple/fetch_apple_s_public_key_for_verifying_token_signature

// AppleUtils.java - 69 라인

public boolean verifyIdentityToken(String id_token) {

  try {
    SignedJWT signedJWT = SignedJWT.parse(id_token);
    ReadOnlyJWTClaimsSet payload = signedJWT.getJWTClaimsSet();

  // EXP
    Date currentTime = new Date(System.currentTimeMillis());
    if (!currentTime.before(payload.getExpirationTime())) {
    	return false;
    }

    // NONCE(Test value), ISS, AUD
    if (!"20B20D-0S8-1K8".equals(payload.getClaim("nonce")) || !ISS.equals(payload.getIssuer()) || !AUD.equals(payload.getAudience().get(0))) {
    	return false;
    }

    // RSA
    if (verifyPublicKey(signedJWT)) {
    	return true;
    }
  } catch (ParseException e) {
  	e.printStackTrace();
  }

  return false;
}

애플에게 로그인 유저에 대한 정보를 JSON 데이터로 받은 후

"id_token" 값을 decode 하여 "RSA, exp, nonce, iss, aud" 5가지의 검증 절차를 진행합니다.

[JWT]

‣ jwt.io

[그림 3] id_token을 Decoded

"exp, nonce, iss, aud"의 값은 "id_token" 값을 decode 하면 PAYLOAD 영역에 존재합니다.

[그림 4] id_token을 공개키 서명 확인

RSA 검증은 "[GET] https://appleid.apple.com/auth/keys"를 호출하여 공개키 리스트를 받은 후

"id_token" 값의 HEADER 영역의 kid와 동일한 공개키 데이터로 서명 확인을 진행합니다.

키	값
exp	id_token 만료 시간 (10분)
iss	https://appleid.apple.com
aud	Services ID - Identifier 값
nonce	생성된 임의 값
RSA	Apple에서 제공받은 Public Key

[4] client_secret 생성

[Apple Document]

‣ developer.apple.com/documentation/sign_in_with_apple/generate_and_validate_tokens

// AppleUtils.java - 131 라인

public String createClientSecret() {

        JWSHeader header = new JWSHeader.Builder(JWSAlgorithm.ES256).keyID(KEY_ID).build();
        JWTClaimsSet claimsSet = new JWTClaimsSet();
        Date now = new Date();

        claimsSet.setIssuer(TEAM_ID);
        claimsSet.setIssueTime(now);
        claimsSet.setExpirationTime(new Date(now.getTime() + 3600000));
        claimsSet.setAudience(ISS);
        claimsSet.setSubject(AUD);

        SignedJWT jwt = new SignedJWT(header, claimsSet);

        try {
            ECPrivateKey ecPrivateKey = new ECPrivateKeyImpl(readPrivateKey());
            JWSSigner jwsSigner = new ECDSASigner(ecPrivateKey.getS());

            jwt.sign(jwsSigner);

        } catch (InvalidKeyException e) {
            e.printStackTrace();
        } catch (JOSEException e) {
            e.printStackTrace();
        }

        return jwt.serialize();
}

[3]에서 5가지의 검증 절차가 정상적으로 완료되었다면 client_secret을 생성해주도록 합니다.

client_sercret은 JWT로 생성되며 필요한 값은 아래와 같습니다.

키	값
kid	애플에서 생성한 Private Key에 대한 Key ID
alg	ES256
iss	App ID 생성에 사용된 Team ID
iat	생성 시간
exp	만료 시간
aud	https://appleid.apple.com
sub	Services ID - Identifier 값

위의 데이터로 client_secret의 JWT가 생성되었다면,

마지막으로 애플에서 다운로드한 Key 파일 안에 들어있는 Private Key로 서명을 해주면

client_secret이 정상적으로 생성 완료됩니다.

[5] 토큰 검증 및 발급

[Apple Document]

‣ developer.apple.com/documentation/sign_in_with_apple/generate_and_validate_tokens

‣ developer.apple.com/documentation/sign_in_with_apple/tokenresponse

// AppleUtils.java - 189 라인

public TokenResponse validateAuthorizationGrantCode(String client_secret, String code) {

        Map<String, String> tokenRequest = new HashMap<>();

        tokenRequest.put("client_id", AUD);
        tokenRequest.put("client_secret", client_secret);
        tokenRequest.put("code", code);
        tokenRequest.put("grant_type", "authorization_code");
        tokenRequest.put("redirect_uri", APPLE_WEBSITE_URL);

        return getTokenResponse(tokenRequest);
}

[2]에서 전달받은 code와 [4]에서 생성한 client_secret의 값 그리고 "client_id, grant_type, redirect_uri" 값으로

"[POST] https://appleid.apple.com/auth/token"을 호출하여 권한 부여를 위한 토큰 검증을 진행하도록 합니다.

("code"는 5분간 유효한 값이므로 주의하도록 한다.)

키	값
client_id	Services ID - Identifier 값
client_secret	eyJraWQiOiJWTTJOOFMzN1RSIiwiYWxnIjoiRVMyNTYifQ.eyJzdWIiOiJjb20ud2hpdGVwYWVrLnNlcnZpY2VzIiwiYXVkIjoiaHR0cHM6XC9cL2FwcGxlaWQuYXBwbGUuY29tIiwiaXNzIjoiODNNNlk1QllLVCIsImV4cCI6MTU5ODgwNTU2NSwiaWF0IjoxNTk4ODAxOTY1fQ.2HO_p7883orlgHS4GQ893haS8SLbRBGLhxNSCZl2i1bwc8uTZSEn4gCQcmvwCqs6lN7zRiUGE5iLQvqNlkJNPQ
code	c3944a20072b7446b97633646556204f8.0.rruy.Gjgud84EqqpCvP31MrudDw
grant_type	authorization_code
redirect_uri	Services ID - Return URLs 값

"[POST] https://appleid.apple.com/auth/token" 호출이 정상적으로 완료되면 JSON 데이터를 반환받습니다.

{
  "access_token":"a08c1600e80f84d44842ce3342abac413.0.mruy.IyMPSXmTYtMyUCDWDKKN3g",
  "expires_in":3600,
  "id_token":"eyJraWQiOiJlWGF1bm1MIiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJodHRwczovL2FwcGxlaWQuYXBwbGUuY29tIiwiYXVkIjoiY29tLndoaXRlcGFlay5zZXJ2aWNlcyIsImV4cCI6MTU5ODgwMjU2NiwiaWF0IjoxNTk4ODAxOTY2LCJzdWIiOiIwMDAxNDguZjA2ZDgyMmNlMGIyNDgzYWFhOTdkMjczYjA5NzgzMjUuMTcxNyIsIm5vbmNlIjoiMjBCMjBELTBTOC0xSzgiLCJhdF9oYXNoIjoiaFNMOFBrZWxoNWdFblNGeURISGNIQSIsImVtYWlsIjoiaTc5ZmlpdDliM0Bwcml2YXRlcmVsYXkuYXBwbGVpZC5jb20iLCJlbWFpbF92ZXJpZmllZCI6InRydWUiLCJpc19wcml2YXRlX2VtYWlsIjoidHJ1ZSIsImF1dGhfdGltZSI6MTU5ODgwMTk2Miwibm9uY2Vfc3VwcG9ydGVkIjp0cnVlfQ.WqYWPuTi8apdqQnP9V6-yvVLBt84P48mYVbGa0e3io4sNKL919iIVZfNoE1GZ8F6WNOrXtcOQU_n3hclrfmNyYsidj-IH6R-0JwxwLobKJoFNH7lfKd067OyiYGxHJMFcleRaDoRWsBF4Wh_FUT3Nft_qy2CVd9pNEg-mFOruI6-5oUDdnPQwelywNCsqlkmECcKna4Psvs9eRn58ALfpke5SL-A762--peGzgp00RvrGMK4t26UWG9UN13LIXDvX3ydMCdg8gvmO7BizSoi4zJHgvKuYxLLT_heOkvNWxcT81h7dEdwqAczLTE3FBarTkAekxvtykVwlEBlfyoXcg",
  "refresh_token":"r8e88bc9f62bc496398b71117610c5aeb.0.mruy.UuuL5tpwnWaof86XPErqJg",
  "token_type":"Bearer"
}

반환받은 JSON 데이터에서 "id_token"을 decode 하여 필요한 유저 정보를 얻을 수 있습니다.

[6] refresh_token 검증 및 토근 재발급

[Apple Document]

‣ developer.apple.com/documentation/sign_in_with_apple/generate_and_validate_tokens

‣ developer.apple.com/documentation/sign_in_with_apple/tokenresponse

// AppleUtils.java - 210 라인

public TokenResponse validateAnExistingRefreshToken(String client_secret, String refresh_token) {

        Map<String, String> tokenRequest = new HashMap<>();

        tokenRequest.put("client_id", AUD);
        tokenRequest.put("client_secret", client_secret);
        tokenRequest.put("grant_type", "refresh_token");
        tokenRequest.put("refresh_token", refresh_token);

        return getTokenResponse(tokenRequest);
}

[5]에서 전달받은 "refresh_token"에 대한 유효성 검증을 하고 싶다면

"client_id, client_secret, grant_type, refresh_token"의 값으로

"[POST] https://appleid.apple.com/auth/token" 호출하여 검증을 진행합니다.

키	값
client_id	Services ID - Identifier 값
client_secret	eyJraWQiOiJWTTJOOFMzN1RSIiwiYWxnIjoiRVMyNTYifQ.eyJzdWIiOiJjb20ud2hpdGVwYWVrLnNlcnZpY2VzIiwiYXVkIjoiaHR0cHM6XC9cL2FwcGxlaWQuYXBwbGUuY29tIiwiaXNzIjoiODNNNlk1QllLVCIsImV4cCI6MTU5ODgwNTU2NSwiaWF0IjoxNTk4ODAxOTY1fQ.2HO_p7883orlgHS4GQ893haS8SLbRBGLhxNSCZl2i1bwc8uTZSEn4gCQcmvwCqs6lN7zRiUGE5iLQvqNlkJNPQ
grant_type	refresh_token
refresh_token	r8e88bc9f62bc496398b71117610c5aeb.0.mruy.UuuL5tpwnWaof86XPErqJg

"refresh_token"에 대한 "[POST] https://appleid.apple.com/auth/token" 호출이 정상적으로 완료되면

JSON 데이터를 반환받습니다.

{
  "access_token":"aebbe3a8249d745d486af1573ac74b821.0.mruy.lamBfraOUXnmnhxb4NxjAA",
  "expires_in":3600,
  "id_token":"eyJraWQiOiI4NkQ4OEtmIiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJodHRwczovL2FwcGxlaWQuYXBwbGUuY29tIiwiYXVkIjoiY29tLndoaXRlcGFlay5zZXJ2aWNlcyIsImV4cCI6MTU5ODgwMzYxOSwiaWF0IjoxNTk4ODAzMDE5LCJzdWIiOiIwMDAxNDguZjA2ZDgyMmNlMGIyNDgzYWFhOTdkMjczYjA5NzgzMjUuMTcxNyIsImF0X2hhc2giOiJnN0N3WnhXSTBvOW5wdUhvSjE3azRBIiwiZW1haWwiOiJpNzlmaWl0OWIzQHByaXZhdGVyZWxheS5hcHBsZWlkLmNvbSIsImVtYWlsX3ZlcmlmaWVkIjoidHJ1ZSIsImlzX3ByaXZhdGVfZW1haWwiOiJ0cnVlIn0.R77ost9PyivMguFyXYLyng-RZbH9lPq_GAA-35cr6DtanfInCg4UtlxFmoaGV6_euxK7vCVu_32vEiEkrktJwJF7H1RSOdQ8JBgBZt6Qdnr4hR_vfQTpb6D1JMoiLD_GCmjz_rfwvI0ityON1yjBCuYsJbV6RMasrNw6LvWueqAQ0v_nls68gxAqwGR0XOtl9SwK7CJK7Nj-BqJMcQT_H3sw8QM6zw1XopuEqSk7Ci8Qirh8Z36a9oSfilgXs7vT-H99CGk50HkYkLU9-DawoyaWc_iAMC3ROAo_WvxI_tlPs9CjtwZNXlBvz4ExLl9zVgAM9Rh8oE5R2evXeag3SQ",
  "token_type":"Bearer"
}

반환받은 JSON 데이터에서 "id_token"을 decode 하여 필요한 유저 정보를 얻을 수 있습니다.

대략적인 애플 로그인(Sign in with Apple) 연동에 대해서 설명했습니다.

코드와 같이 풀어서 쉽게 설명하려고 했으나 생각보다 더 복잡하고 헷갈릴 수 있을 거 같습니다..^^;;

Apple Developer Documentation을 참고하며 코드를 보면서 이해하신다면 포스트보다 이해하기가 좀 더 수월하실 거라 생각합니다.

[Sign in with Apple - Step by step !! (정리)]

[Step. 01] "Sign in with Apple" 버튼이 있는 애플 로그인 페이지

[Step. 02] "https://appleid.apple.com/auth/authorize" 호출 - (유저 로그인)

[Step. 03] "https://appleid.apple.com/auth/keys" 공개 키 호출 및 검증 - (rsa, exp, nonce, iss, aud)

[Step. 04] "client_secret" 생성 - (jwt + private key)

[Step. 05] "https://appleid.apple.com/auth/token" 호출 - (authorization_code)

[Step. 06] "https://appleid.apple.com/auth/token" 호출 - (refresh_token)

[추가 내용(1) - 이메일 변경, 서비스 해지, 애플 계정 탈퇴 이벤트가 발생한 경우]

// AppleController.java - 108 라인

@PostMapping(value = "/apps/to/endpoint")
    @ResponseBody
    public void appsToEndpoint(@RequestBody AppsResponse appsResponse) {
        logger.debug("[/path/to/endpoint] RequestBody ‣ " + appsResponse.getPayload());
}

유저의 애플 계정에 대한 이벤트가 발생하면 body안에 payload 키로 jwt 형태의 데이터가 담겨서

"App ID에 등록된 Endpoint URL"로 전송됩니다.

"payload" : "eyJraWQiOiI4NkQ4OEtmIiwiYWxnIjoiUlMyNTYifQ.eyJpc3MiOiJodHwczovL2FwcGxlaWQuYXBwbGUuY29tIiwiYXVkIjoiY29tLnNrdC5tYXNzaXZlYXJzaWduaW4iLCJleHAiOjE1OTg0MzU0MTIsImlhdCI6MTU5ODM0OTAxMiwianRpIjoiZDNvTUVfWE1tcjVqcC1KWlRMUHVIUSIsImV2ZW50cyI6IntcInR5cGVcIjpcImNvbnNlbnQtcmV2b2tlZFwiLFwic3ViXCI6XCIwMDAxNDguYzEyZjdlNmI4Yjk2NDExNGEzYzRiZTdmYzY5M2I0MzYuMDgxNlwiLFwiZXZlbnRfdGltZVwiOjE1OTgzNDg5ODQyMTJ9In0.EDWOfSnbdBDdNVGeSL7KBymsYV8NkcRz9XY1mCPIcWrOABK1tVLyLqdlclRwqD4lBKeJgGS74tE_YMAx1Z9iJcZVjL_56OuCbvKRge_-RXn8PLXbTJWONh8PBrsNSrbwZvykwLbKEcKfhNWcJWzoPNsuKLxVS5aPSQ59OjaegP8WNzYpRfDwO-f7prWSHPnkEO4vv6WQvYmKD3zQMl4DqkZwAIbWCv4TzAKP3h-vzy4RVNghF1WBrAG4MANdVY_Y6gJdvDnAy1tcghqpD5k13r04PaWpT3GU1QI--ps0EaNLekSJxrNUDZrD9bUxb1fLEthoQv4v4lcR_Y2xlp_Pbg"

payload의 값은 jwt이므로 decode 하면 HEADER와 PAYLOAD 데이터 영역으로 나뉩니다.

--HEADER--
{
  "kid": "86D88Kf",
  "alg": "RS256"
}

--PAYLOAD--
{
  "iss":"https:\/\/appleid.apple.com",
  "aud":"com.whitepaek.services",
  "exp":1598929977,
  "iat":1598843577,
  "events":"{
    \"type\":\"consent-revoked\",
    \"sub\":\"000148.f06d822ce0b2483aaa97d273b0978325.1717\",
    \"event_time\":1598843567475
  }",
  "jti":"uZmGepCUZyA_0by3Jh7JCQ"
}

유저가 서비스 해지를 한 경우,

전달된 payload의 값을 decode 한 결과입니다.

[추가 내용(2) - 애플 로그인 페이지]

// AppleController.java - 48 라인

@GetMapping(value = "/apple/login")
    public String appleLogin(ModelMap model) {

        Map<String, String> metaInfo = appleService.getLoginMetaInfo();

        model.addAttribute("client_id", metaInfo.get("CLIENT_ID"));
        model.addAttribute("redirect_uri", metaInfo.get("REDIRECT_URI"));
        model.addAttribute("nonce", metaInfo.get("NONCE"));
        model.addAttribute("response_type", "code id_token");
        model.addAttribute("scope", "name email");
        model.addAttribute("response_mode", "form_post");

        return "redirect:https://appleid.apple.com/auth/authorize";
}

추가적으로 앱(App)에 Sign in with Apple 버튼이 존재하는 페이지가 아닌

애플 로그인 페이지 화면을 제공해야 하는 경우에는

"https://appleid.apple.com/auth/authorize"를 redirect 해주면

ID와 Password를 입력하는 화면으로 바로 이동됩니다.

[그림 5] Apple ID 로그인 화면으로 이동

이상으로 Sign in with Apple API를 Spring 프로젝트에 연동 방법에 대해 알아봤습니다.

잘못된 내용 혹은 궁금하신 점은 댓글 남겨주시면 확인 후 답변드리도록 하겠습니다.

감사합니다 :)

[1] 스프링 프로젝트에 애플 로그인 API 연동을 위한 Apple Developer 설정

WHITEPAEK — Sun, 30 Aug 2020 23:00:56 +0900

[1] 스프링 프로젝트에 애플 로그인 API 연동을 위한 Apple Developer 설정 - (현재 글)

[2] 스프링 프로젝트에 애플 로그인 API 연동하기

Spring API Server에서 Apple Login API를 연동하여 앱(App)에 제공하기 위한 개발을 해봤습니다.

애플에게 사용자 인증 토큰을 발급받는 로직뿐 아니라 Android와 ios 12 이하 버전에서는 로그인 페이지를 앱에게 제공해주어야 합니다.

(ios 13 버전 이상에서는 SDK가 제공되는 걸로 알고 있습니다.)

나이스 한 코드를 작성할 실력은 부족하지만 Apple Developer Documentation을 보면서 프로세스를 이해하고 글을 작성해볼 기회를 가졌다는 것에 의미를 두도록 하겠습니다.

애플 로그인 API(Sign In with Apple) 연동을 하기 위해서는 Apple Developer 사이트에서 필요한 설정을 먼저 해줘야 합니다.

(참고로 Apple Developer에서 필요한 API 서비스를 이용하기 위해서는 매년 결제를 진행해야 이용할 수 있습니다.)

Account - Apple Developer 사이트로 이동하여 3가지 설정을 진행하도록 하겠습니다.

[1] App ID 등록하기

[그림 1.1] Account - Apple Developer

Account - Apple Developer 사이트로 이동 후 "Certificates, Identifiers & Profiles"를 클릭해주세요.

[그림 1.2] Identifiers 메뉴

"Identifiers" 메뉴로 이동 후 "+" 버튼을 클릭해주세요.

[그림 1.3] App IDs 선택

"App IDs"를 선택 후 진행해주세요.

[그림 1.4] App 선택

"App" 타입을 선택 후 진행해주세요.

[그림 1.5] App ID 정보 입력

"Description"에 해당 App ID에 대한 간략한 설명을 적고, "Bundle ID"는 네이밍 예시처럼 입력해주세요.

(ex. Bundle ID : com.domainname.appname)

[그림 1.6] Sign In with Apple 등록

아래로 스크롤하여 "Sign In with Apple"를 선택 후 "Edit"을 클릭해주세요.

[그림 1.7] "Sign In with Apple" 설정

"Enable as a primary App ID"를 선택하고, "Endpoint" URL를 작성해주세요.

Endpoint URL는 도메인 형식이며 기본 443 포트로 SSL 적용이 되어 있어야 합니다.

애플에서 유저가 "이메일 변경, 앱 서비스 해지, 애플 계정 탈퇴"를 했을 경우,

입력한 Endpoint URL로 유저 정보와 이벤트에 대한 PAYLOAD 데이터를 전송합니다.

만약, 상황이 여의치 않아서 URI를 갖추지 못하였다면 형식을 맞춰서 임의로 작성해주도록 합니다.

유저의 "이메일 변경, 앱 서비스 해지, 애플 계정 탈퇴"에 대해서는 테스트하지 못하겠지만

애플 로그인에 연동은 문제없이 진행할 수 있습니다.

[그림 1.8] App ID 등록 완료

App ID가 등록 완료되었습니다.

Team ID는 보안상의 이유로 이미지에서 지웠지만, 자신의 "Team ID"를 알고 있어 주세요.

Team ID는 클라이언트 시크릿(Client sercret)을 생성할 때 필요한 정보입니다.

[2] Services ID 등록하기

[그림 2.1] Services IDs 선택

이번에는 애플 로그인(Sign In with Apple)을 진행한 유저의 정보를 전달받기 위한 Services ID를 등록하겠습니다.

[그림 1.2]와 동일하게 "Identifiers" 메뉴에서 "+" 버튼을 클릭 후 "Services IDs"를 선택하여 진행해주세요.

[그림 2.2] Services ID 정보 입력

"Description"에 Services ID에 대한 간략한 설명을 입력하고

"Identifier"에 Services ID를 식별할 수 있는 도메인을 작성해주세요.

(ex. Identifier : com.domainname.appname)

[그림 2.3] Services ID 선택

Services ID가 등록되었다면 Identifiers 메뉴 리스트에서

등록한 Services ID를 클릭하여 설정 페이지로 이동해주세요.

[그림 2.4] Services ID 설정

Services ID 설정 페이지에서 "Sign In with Apple"를 선택 후 "Configure" 버튼을 클릭해주세요.

[그림 2.5] App ID와 Return URLs 등록

앞서 등록을 진행했던 App ID를 선택 후, "Domain"과 "Return URLs"를 입력해주세요.

도메인이 준비가 안되었다면 임의의 도메인을 입력해주셔도 테스트에는 문제가 없습니다.

하지만, Return URLs는 현재 자신의 IP/Port, URL를 정확하게 입력해줘야 합니다.

등록한 Return URLs로 애플 로그인을 진행한 유저의 정보가 전달되기 때문입니다.

(Domain과 Return URLs은 여러 개 등록할 수 있습니다.)

[그림 2.6] Services ID 등록 완료

Services ID 등록이 완료되었습니다.

자신의 Services ID의 "Identifier"를 기억하고 있어야 합니다.

Services ID의 식별자(Identifier)는 client_id, aud의 값으로 사용됩니다.

[3] Private Key 생성하기

[그림 3.1] Keys 등록

클라이언트 시크릿(client_secret)을 생성할 때 사용할 비밀 키(private key)를 생성하도록 하겠습니다.

"Keys" 메뉴에서 "+" 버튼을 클릭해주세요.

[그림 3.2] Key 설정

Key Name을 입력 후,

"Sign in with Apple"를 선택 후 "Configure" 버튼을 클릭해주세요.

[그림 3.3] App ID 선택

앞서 생성했던 App ID를 선택해주세요.

[그림 3.4] Key 등록 완료

Private Key 생성을 위한 "Key" 등록은 비교적 쉽게 끝냈습니다.

[그림 3.5]

자신의 "Key ID"를 기억해주세요.

그리고 "Download" 버튼을 클릭하여 Private Key 정보가 들어있는 "AuthKey_[KeyID].p8" 파일을 다운로드하여주세요.

주의할 점은 다운로드는 최초 1회만 가능하고 이후에는 다시 다운로드하지 못하니 파일을 잘 보관해주도록 합니다.

(혹시, 파일을 잃어버렸다면 [그림 3.1]부터 다시 진행해주세요.)

Key ID와 파일은 클라이언트 시크릿(client secret)을 생성할 때 필요한 데이터입니다.

이상으로 애플 로그인 API 연동을 위한 Apple Developer의 3가지 설정을 완료했습니다.

설정에 대해서 다시 한번 정리해보도록 하겠습니다.

[1] App ID - 자신의 App 서비스를 생성하고, 서비스에 애플 로그인으로 가입한 유저에 대한 이벤트를 전달받기 위한 설정입니다.

클라이언트 시크릿을 생성할 때 사용될 Team ID를 기억해주세요.

(유저에 대한 이벤트는 "이메일 변경, 서비스 해지, 애플 계정 탈퇴"에 대한 것입니다.

Endpoint URL에 등록한 URL로 PAYLOAD라는 키로 JWT 데이터를 전달받을 수 있습니다.)

[2] Services ID - 애플 로그인을 진행한 유저의 정보를 전달받기 위한 설정입니다.

client_id와 aud로 사용될 Identifier를 기억해주세요.

(Return URLs에 등록된 URL로 유저 정보에 대한 JSON 데이터를 전달받을 수 있습니다.)

[3] Key - 클라이언트 시크릿을 생성할 때 필요한 Private Key를 생성하기 위한 설정입니다.

Key ID와 .p8 파일은 기억해주세요.

모든 설정을 완료했으니,

다음 포스트에서 코드를 참고하여 확인해보도록 하겠습니다.

다음 포스트 읽으러 가기 ‣

[IntelliJ] 스프링 프로젝트 구성 설정

WHITEPAEK — Wed, 3 Jun 2020 18:52:48 +0900

Step by step!
∙Step 01 ‣ 스프링 프로젝트 생성
∙Step 02 ‣ (현재 글) 스프링 프로젝트 구성 설정

스프링 프로젝트 생성 글에서 메이븐(Maven) 빌드 도구와 스프링 MVC(Spring MVC) 프레임워크를 이용해서 스프링 프로젝트를 생성하는 방법에 대해 알아봤습니다. 프로젝트를 만들기만 하였기 때문에 메이븐 관련 파일 pom.xml과 스프링 MVC 프레임워크에 관련된 web.xml, dispatcher-servlet.xml, applicationContext.xml 파일만 생성된 상태에서 추가적인 작업 없이 글을 끝냈습니다. 이번 글에서는 스프링 프로젝트 구성에 대해 파악하고 설정해보도록 하겠습니다.

제가 작성하는 스프링에 관련된 글은 실습을 기반으로 설명하고 있으며, 이론 설명은 실습을 진행할 수 있는 수준에서 설명하고 있습니다.

스프링의 이론은 훌륭한 개발자 분들께서 자세하고 정확하게 설명한 글이 많기 때문에 제 글을 읽다가 부족한 부분은 번거롭더라도 검색 혹은 개념 서적을 통해서 습득하는 걸 권장드립니다.

macOS 운영체제에서 IntelliJ IDEA Ultimate(Version 2020.1.1)를 이용하여 진행하였습니다.

Windows에서도 IntelliJ IDEA의 GUI는 거의 동일하기 때문에 큰 어려움은 없을 거예요.

그리고 해당 글은 대부분 스프링 프레임워크에 대한 설명이기 때문에 IDE가 다르다고 해서 문제가 되지는 않습니다.

하지만, 약간의 몇몇 부분에 대해서는 IDE에 따라 설정 방식이 다른 부분이 있을 수 있습니다.

(IDE에 따른 설정 방식은 검색을 통해 확인 부탁드립니다.)

"스프링 프레임워크 구조 또는 동작 방식"에 대해 검색을 하면 관련 개념을 습득할 수 있습니다. 이 부분에 대한 자세한 이론 설명은 생략하도록 하고 인텔리제이(IntelliJ IDEA)와 이클립스(Eclipse)에서 스프링 프로젝트 생성 후 구성되는 디렉토리와 파일을 비교해서 확인해보겠습니다. 비교해서 설명하는 이유는 인텔리제이와 이클립스 또는 STS에서 생성되는 디렉토리 구성과 파일 명이 다르기 때문입니다. 저는 이해도가 없어서 헷갈리기도 했지만, 관련 내용을 검색해도 서로 다른 정보 때문에 괜한 찝찝함을 갖고 있었기 때문입니다. (특히 스프링 관련 서적을 확인해보면 이클립스(STS) 기반으로 작성되어 있는 경우가 대부분인데 인텔리제이에서 스프링(Spring)이 공식으로 지원하는 STS 구조로 프로젝트를 구성하여 IDE의 초기 구성 차이점에 대해 이해하고, 스프링 프로젝트를 진행하는데 찝찝함을 없애고 실습을 원활히 따라갈 수 있는게 목적입니다.)

아래 [그림 1]과 [그림 2]를 참고해서 설명을 시작하도록 하겠습니다. (1)번 빨간박스 영역들은 디렉토리를 나타낸 것이고, (2)번 파란박스 영역들은 XML 파일을 나타낸 것입니다.


[그림 1] 인텔리제이에서 스프링 프로젝트를 생성했을 때 구성되는 디렉토리와 XML 파일	[그림 2] 이클립스(STS)에서 스프링 프로젝트를 생성했을 때 구성되는 디렉토리와 XML 파일 (인텔리제이를 이용하여 예시를 구현한 화면)

디렉토리(빨간박스 영역)부터 확인해보도록 하겠습니다.

아래 표를 참고하면 두 개의 IDE가 생성하는 디렉토리의 차이를 쉽게 이해할 수 있을 거예요.

디렉토리	인텔리제이	이클립스 또는 STS
소스 루트(Source Root)	src/main/java	src/main/java
리소스 루트(Resources Root)	src/main/resources	src/main/resources
테스트 소스 루트(Test Sources Root)	src/test/java	src/test/java
테스트 리소스 루트(Test Resources Root)	-	src/test/resources
웹 리소스(Web Resources)	web	src/main/webapp
기타	web/WEB-INF/	src/webapp/WEB-INF/classes src/webapp/WEB-INF/spring/appServlet/ src/webapp/WEB-INF/views/

두 개의 IDE를 비교해보면 인텔리제이에서는 생성되지 않은 디렉토리가 있을 뿐 아니라

인텔리제이([그림 1])에서는 "src" 디렉토리와 같은 레벨에 웹 리소스 디렉토리(web)가 생성되고,

이클립스([그림 2])에서는 "src/main/" 디렉토리 하위에 웹 리소스 디렉토리(webapp)가 생성된 걸 확인할 수 있습니다.

인텔리제이에서 [그림 1]과 같이 구성된 디렉토리 구조에서 생성되지 않은 디렉토리를 추가하고 설정을 통해 프로젝트를 진행하는데 문제는 없습니다. 하지만 스프링(Spring)에서 공식으로 제공하는 STS 디렉토리 구조를 따라 웹 리소스 디렉토리(web)를 "src/main/" 디렉토리 하위로 이동시키고 디렉토리 명을 "webapp"으로 변경하여 진행하도록 하겠습니다.

변경하여 진행하는 이유는 많은 개발자들이 STS 디렉토리 구조 기반으로 스프링 프로젝트를 진행하고 있기 때문(물론 전부 그런 것은 아니고 프로젝트에 따라 디렉토리 구조는 다르게 사용할 수 있습니다.)이고, 인텔리제이에서 설정을 한 개라도 직접 해보기 위함입니다.

[그림 3] war 플러그인 설정에 따른 디렉토리 기본 경로

추가적인 이유로는 war 플러그인에서 src/main/webapp 디렉토리를 기본 경로로 지정하고 있습니다. 그렇기 때문에 패키징 할 때 웹 리소스 디렉토리(webapp) 경로에 대한 설정을 따로 신경 쓰지 않고 진행할 수 있습니다. (기본 경로를 이용하지 않고 특정 경로를 설정하여 사용할 수도 있습니다.)

Apache Maven WAR Plugin Document ‣ maven.apache.org/plugins/maven-war-plugin/war-mojo.html

이번에는 XML 파일(파란박스 영역)에 대한 차이를 알아보도록 하겠습니다.

역할	인텔리제이	이클립스 또는 STS
WAS(Web Application Server, Tomcat)가 실행되고 웹 어플리케이션에 필요한 설정을 구성하는 XML 파일	web.xml	web.xml
[애플리케이션 컨텍스트(Application Context) 파일] 웹 애플리케이션 공통으로 사용되는 빈(bean)을 설정하는 XML 파일 ‣ 서로 다른 dispatcher-servlet.xml(servlet-context.xml)에서 공유해야 하는 빈을 설정한다.	applicationContext.xml	root-context.xml
[서블릿 컨텍스트(Servlet Context) 파일] 필요한 상황에 맞춰 사용되는 빈(bean)을 설정하는 XML 파일, 일반적으로 Web 관련된 빈을 설정한다. ‣ applicationContext.xml(root-context.xml)에 동일한 빈이 존재하는 경우에는 dispatcher-servlet.xml(servlet-context.xml) 설정된 빈이 우선적으로 적용된다.	dispatcher-servlet.xml	servlet-context.xml
메이븐 설정 파일이며, 라이브러리 의존성 관리와 패키징 등 관련 설정을 구성하는 XML 파일	pom.xml	pom.xml

위의 표를 참고하여 각 파일이 어떤 역할을 하는지 읽어보세요. 인텔리제이와 이클립스에서 생성되는 파일 명이 다를 수 있고, 개발자에 따라 파일 명을 다르게 설정할 수 있기 때문에 기본으로 생성되는 파일 명을 기준으로 비교하여 표를 작성해봤습니다. ("web.xml"과 "pom.xml"은 동일하게 사용됩니다.)

디렉토리 설명에서 언급한 것처럼 XML 파일 또한 인텔리제이에서 생성된 컨텍스트 파일(applicationContext.xml)과 서블릿 컨텍스트 파일(dispatcher-servlet.xml)을 STS에서 생성한 파일 명을 기준으로 변경하고 디렉토리 위치를 설정하여 프로젝트를 구성하도록 하겠습니다. (참고, "web.xml"에서 각 컨텍스트 파일을 설정하기 때문에 파일 명이 달라도 큰 의미가 없습니다. 특히 컨텍스트 분리 전략에 따라서 추가적인 컨텍스트 파일을 사용할 수도 있습니다.)

두 개의 IDE에 따른 디렉토리와 XML 파일에 대해 간략하게 비교해봤습니다. 위에서 설명드린 것처럼 스프링 프로젝트 생성에 이어서 인텔리제이에서 기본으로 생성된 디렉토리와 XML 파일의 구성을 스프링에서 공식으로 지원하는 STS 구성으로 변경해보도록 하겠습니다.

[그림 4] web 디렉토리 경로 변경 전

web 디렉토리 경로를 src/main 디렉토리 하위로 이동하겠습니다.

web 디렉토리를 클릭 후 F6 단축키를 눌러주세요.

[그림 5] 변경하는 디렉토리 경로 설정

Move 팝업 창이 나타나면 해당 프로젝트의 "/src/main" 디렉토리 경로를 지정해주세요.

[그림 6] web 디렉토리 경로 변경 후

web 디렉토리를 "src/main" 디렉토리 하위로 이동시켰습니다.

이번에는 "web" 디렉토리 이름을 "webapp"으로 변경하기 위해서 web 디렉토리를 클릭 후 Shift+F6 단축키를 눌러주세요.

[그림 7] "web" 디렉토리 이름을 "webapp"으로 변경

Rename 팝업 창이 나타나면 "web"을 "webapp"으로 변경해주세요.

[그림 8] "webapp" 디렉토리 이름으로 변경 후

"webapp"으로 디렉토리 이름이 변경되었습니다.

이번에는 웹 리소스 디렉토리 경로를 설정해야 합니다.

command+;(Ctrl+Alt+Shift+S) 단축키를 눌러주세요.

[그림 9] 웹 리소스 디렉토리 경로 설정 전

Project Structure 창이 나타나면 Project Settings 목록에서 Modules > Web을 선택하면

Web Resource Directory 경로가 빨간색으로 표시되는 걸 확인할 수 있습니다.

빨간색으로 표시되는 경로를 더블클릭해주세요.

[그림 10] 웹 리소스 디렉토리 경로 설정

Web Resource Directory Path 팝업 창이 나타나면 웹 리소스 디렉토리 경로를 해당 프로젝트의

"/src/main/webapp" 디렉토리 경로로 설정해주세요.

[그림 11] 웹 리소스 디렉토리 경로 설정 후

웹 리소스 디렉토리 경로를 "/src/main/webapp" 디렉토리 위치로 설정이 정상적으로 완료되면

빨간색 표시가 사라집니다.

[그림 12] 디렉토리 생성 전

웹 리소스 디렉토리 경로를 "/src/main/webapp"으로 설정을 완료했으면

컨텍스트 파일을 관리할 디렉토리를 생성하도록 하겠습니다.

WEB-INF 디렉토리를 클릭 후 command+N(Alt+Insert) 단축키를 눌러서

팝업 메뉴를 활성화하고 Directory를 클릭해주세요.

[그림 13] 디렉토리 생성

/webapp/WEB-INF 디렉토리 하위에 스프링 컨텍스트 파일(Application Context, Servlet Context)을 관리할 spring 디렉토리을 생성하고, spring 디렉토리 하위에 서블릿 컨텍스트 파일을 관리할 appServlet 디렉토리를 생성해주세요.

"spring/appServlet"으로 디렉토리 이름을 입력하면

spring 디렉토리를 생성하고 하위에 appServlet 디렉토리를 한 번에 생성할 수 있습니다.

[그림 14] 디렉토리 생성 후

"src/main/webapp/WEB-INF/spring/appServlet" 디렉토리가 생성됐습니다.

[그림 12] ~ [그림 14]의 과정처럼

/WEB-INF 디렉토리 하위에 views 디렉토리를 생성하고,

/test 디렉토리 하위에 resources 디렉토리를 생성해주세요.

[그림 15] 스프링 프로젝트 디렉토리 구성 완료

인텔리제이에서 생성한 스프링 프로젝트의 디렉토리 구성을 STS 디렉토리 구성처럼 변경 완료했습니다.

[그림 15]는 디렉토리 구성이 최종적으로 완료된 상태입니다.

(현재 상황에서 불필요한 디렉토리는 추가하지 않았습니다. 앞으로 프로젝트가 진행됨에 따라 필요한 디렉토리는 상황에 맞춰 추가적으로 생성하겠습니다.)

[그림 16] 테스트 리소스 루트 설정

/test 디렉토리 하위에 생성한 resources 디렉토리 모양이 일반 디렉토리 모양인 경우라면 테스트 리소스 루트(Test Resources Root) 설정이 안 된 것입니다. 이런 경우에는 resources 디렉토리를 우클릭 후 Mark Directory as > Test Resources Root를 클릭해서 설정해주세요.

이어서 컨텍스트 파일 이름을 변경하고 파일 경로를 컨텍스트를 관리하기 위해 생성한 디렉토리 위치로 변경하겠습니다.

[그림 17] 컨텍스트 파일 명 변경 전

두 개의 컨텍스트 파일 명을 STS의 컨텍스트 파일 명으로 변경하도록 하겠습니다.

[그림 6] ~ [그림 7]에서 진행했던 것처럼 컨텍스트 파일을 클릭 후 Shift+F6 단축키를 눌러서 각 파일명을 변경해주세요.

applicationContext.xml → root-context.xml

dispatcher-servlet.xml → servlet-context.xml

[그림 18] 컨텍스트 파일 명 변경 후

각 컨텍스트 파일 명을 변경했으면

[그림 4 ] ~ [그림 5]에서 진행했던 것처럼 F6 단축키를 눌러서 디렉토리 경로를 변경해주도록 하겠습니다.

애플리케이션 컨텍스트 파일(root-context.xml)은 /spring 디렉토리 하위로 이동하고,

서블릿 컨텍스트 파일(servlet-context.xml) 파일은 /spring/appServlet 디렉토리 하위로 이동해주세요.

(추가적으로 index.jsp 파일은 /views 디렉토리 하위로 이동해주세요.

index.jsp 파일은 스프링의 컨텍스트 파일이 아닌 JSP 파일입니다.)

[그림 19] 컨텍스트 파일의 디렉토리 경로 변경 후

인텔리제이에서 생성된 컨텍스트 파일의 이름과 디렉토리 경로를 STS에서 생성된 스프링 프로젝트 구성처럼 변경 완료했습니다.

[그림 19]는 모든 구성이 완료된 스프링 프로젝트입니다.

디렉토리와 컨텍스트 파일에 생기는 빨간 줄은 스프링 설정이 아직 안된 상태라서 생기는 것입니다.

다음 포스트는 스프링 설정을 진행해서 빨간 줄은 모두 없애고 프로젝트를 실행해보도록 하겠습니다.

현재까지의 포스트에서는 스프링 프로젝트를 생성하고 구성까지 완료했습니다.

스프링 프로젝트 구성 설정은 인텔리제이에서 생성되는 구성을 스프링(Spring)에서 공식으로 제공하는 STS를 기준으로 변경했습니다.

한마디,
저도 이해한 내용을 바탕으로 직접 실습해보고 관련 글을 작성하였습니다. 공부를 하면서 저의 관점에서 이해하는 데 어려움이 있었던 포인트를 기준으로 글을 작성하기 때문에 제 글이 도움이 안될 수도 있고 혹은 틀린 내용이 있을 수도 있습니다. 이런 부분은 댓글을 이용해서 피드백 부탁드립니다. 동일한 개념이라도 각자의 관점에서 이해하는 부분이 다를 수 있기 때문에 서로 대화를 통해서 올바른 지식을 공유하면 좋겠습니다. 감사합니다.

● spring-project-initialize Repository ‣ github.com/WHITEPAEK/spring-project-initialize

[IntelliJ] 스프링 프로젝트 생성

WHITEPAEK — Sun, 31 May 2020 20:47:08 +0900

Step by step!
∙Step 01 ‣ (현재 글) 스프링 프로젝트 생성
∙Step 02 ‣ 스프링 프로젝트 구성 설정

인텔리제이(IntelliJ IDEA)에서 스프링 프레임워크(Spring Framework) 프로젝트를 생성해보도록 하겠습니다. 스프링 프로젝트를 생성하는 방법을 찾아보면 설정 방식이 여러 개가 검색됩니다. 스프링에 대한 이해도가 높고 익숙하신 개발자에게는 어떤 방식을 검색하던 자신에게 필요한 부분을 쉽게 캐치해서 사용할 수 있습니다. 하지만 초급 개발자는 익숙하지 않기 때문에 필요한 부분을 캐치해서 적용하기란 쉽지 않습니다. 또한, 실무에서 이미 갖춰진 환경에서 개발을 진행하다 보면 직접 스프링을 설정할 기회가 거의 없을 수도 있기 때문에 많은 개발자분들이 필요할 때마다 검색해서 설정합니다. 그렇기 때문에 "나는 왜 잘 못할까?"라고 생각하실 필요 없습니다.

본 포스팅은 개발 공부를 하고 있는 학생과 스프링 프로젝트 생성부터 진행해야 하는 초급 개발자 눈높이에서 자세하게 설명할 수 있도록 노력하겠습니다. 생성하는 방법에서 끝나는 게 아니라 개발할 수 있는 환경을 갖추기까지 설정 방법 포스팅을 이어서 작성하겠습니다.

macOS 운영체제에서 IntelliJ IDEA Ultimate(Version 2020.1.1)를 이용하여 진행하였습니다.

Windows에서도 IntelliJ IDEA의 GUI는 거의 동일하기 때문에 큰 어려움은 없을 거예요.

하지만, IntelliJ IDEA는 Community 버전과는 차이가 있을 수 있기 때문에 Ultimate 버전을 사용하는 걸 권장합니다.

Maven + Spring MVC를 이용하여 메이븐(Maven)과 스프링으로 설정된 프로젝트를 생성해보도록 하겠습니다. 제가 설명하는 방식 외에도 여러 개의 설정 방식이 있습니다. 하지만, 설정 순서가 다를 뿐이지 결과적으로는 똑같다고 생각합니다.

"Spring MVC → Maven" 순서로 설정을 할 수도 있고, "Maven"으로 프로젝트를 생성하고 "Spring MVC" 설정 없이 디렉토리 설정부터 직접 하나씩 구성할 수도 있습니다. 하지만 저는 Maven → Spring MVC 설정을 순서로 설정할 것이며 자동으로 디렉토리 구성까지 될 것입니다. 나중에 경험이 쌓이고 스프링에 대한 이해도가 높아진다면 다양한 방식으로 스프링 프로젝트를 생성할 수 있습니다.

("처음 공부할 때는 전체적인 설정을 직접 해보는 게 도움이 된다."라는 얘기도 있습니다. 이 방식으로는 저는 이해도가 부족한지 더 어렵게 느껴지더라고요. 자신이 사용하는 IDE에 대한 이해도도 어느 정도 받쳐줘야 가능하기 때문에 저는 IDE에서 제공하는 방식을 활용해보도록 하겠습니다.)

추가로 이클립스(Eclipse)에서는 "Dynamic Web Project" 또는 "Maven Project"를 생성하고 설정을 통해 스프링(Spring) 프로젝트를 만들 수 있습니다. 제가 설명하는 디렉토리 구성까지 완성된 스프링 프로젝트가 필요한 경우에는 "Spring Legacy Project"를 생성하면 기본적인 구조가 만들어진 프로젝트를 이용할 수 있습니다.

[그림 1] IntelliJ IDEA 실행 및 "Create New Project" 클릭

인텔리제이를 실행하고 Create New Project를 클릭해서 새 프로젝트를 생성하도록 하겠습니다.

[그림 2] "Maven" 프로젝트 생성

프로젝트 템플릿 목록에서 메이븐(Maven)을 선택하고 프로젝트에서 사용할 Project SDK(JDK)를 선택해주세요.

[그림 3] "GroupId"와 "ArtifactId" 입력

GroupId는 프로젝트의 가장 최상위 패키지(Top level package) 명으로 사용되고, ArtifactId는 프로젝트 명으로 사용됩니다.

(GroupId는 대표적으로 프로젝트가 진행되는 회사 도메인을 역순으로 작성합니다.

속한 회사가 없거나 단독으로 진행하는 사이드 프로젝트인 경우에는 자신이 사용할 도메인을 하나 정한 후 역순으로 작성해주세요.)

Version은 기본으로 "1.0-SNAPSHOT"으로 설정되어 있는데 "SNAPSHOT"은 해당 버전이 개발 버전이라는 걸 의미합니다.

(추가로 배포 버전은 "RELEASE"를 붙여서 사용합니다. 이해가 안 돼도 괜찮습니다.

경험이 쌓이면 자연스레 알게 되는 부분이므로 읽어보고 넘어가도록 합니다.)

[그림 4] "Maven" 프로젝트 생성 완료

메이븐 프로젝트가 생성되었습니다.

좌측에 프로젝트 툴 윈도우(Project tool window)를 보면 src 디렉토리와 pom.xml 파일로 구성되어 있습니다.

[그림 5] "Add Framework Support..." 클릭

앞서, 메이븐(Maven) 프로젝트를 생성했기 때문에 이제부터는 Spring MVC를 설정할 순서입니다.

spring-project-initialize 모듈(Module)을 우클릭하여 Add Framework Support... 를 클릭해주세요.

[그림 6] "Spring MVC" 선택

팝업 창이 나타나면 좌측 프레임워크 목록에서 Spring MVC를 선택해주세요.

(현재 인텔리제이에서는 5.2.3 버전의 스프링 프레임워크를 제공하고 있습니다.)

[그림 7] "Spring MVC" 설정 완료

Spring MVC 설정이 완료되었습니다.

프로젝트 툴 윈도우를 확인해보면 lib와 web 디렉토리가 추가되었습니다.

[그림 8] "lib" 디렉토리 삭제

lib 디렉토리를 삭제해주도록 하겠습니다.

삭제하는 이유는

[그림 6]을 다시 확인해보면 인텔리제이에서는 Spring 5.2.3 버전을 제공하고 있다는 것을 알 수 있고,

인텔리제이에서 제공하는 프레임워크는 lib 디렉토리에 기본 라이브러리를 자동으로 추가시킵니다.

그러나 기본으로 제공되는 라이브러리를 사용하지 않고

메이븐 저장소(Maven Repository)를 이용하여 라이브러리를 관리할 것이기 때문에

인텔리제이가 추가한 라이브러리를 삭제하는 것입니다.

메이븐 저장소를 이용하지 않을 경우, 필요한 라이브러리를 일일이 다운로드 후 프로젝트에 추가해주는 작업을 해야 합니다.

이런 방식은 라이브러리를 관리하기가 까다롭습니다.

(라이브러리 버전이 변경되었을 때 기존 라이브러리를 삭제하고

필요한 버전의 라이브러리를 다운로드 후 다시 프로젝트에 추가해주는 작업을 반복해야 합니다.)

[그림 9] 프로젝트에 추가된 라이브러리 삭제

Command+;(Ctrl+Alt+Shift+S) 단축키를 이용하여 Project Structure 창을 활성화하고,

프로젝트 설정(Project Settings) 목록에서 Libraries에 추가되어 있는

Spring MVC-5.2.3.RELEASE와 Spring-5.2.3.RELEASE를 삭제해야 합니다.

([그림 8]에서 lib 디렉토리와 인텔리제이에서 자동으로 추가한 라이브러리를 전부 삭제했기 때문에

프로젝트에 설정된 라이브러리는 존재하지 않아 무의미하기 때문입니다.)

[그림 10] 프로젝트에 설정된 라이브러리가 없는 상태

[그림 11] 스프링 프로젝트 생성 완료 (Maven + Spring MVC)

인텔리제이에서 스프링 프로젝트 생성을 완료했습니다.

([그림 10]과 [그림 11]은 스프링 프로젝트가 완성된 결과 화면입니다.)

메이븐(Maven) 프로젝트를 생성([그림 2] 참고) 후 스프링 MVC(Spring MVC) 프레임워크를 추가([그림 5] 참고)하고

인텔리제이에서 기본으로 제공되는 라이브러리를 삭제([그림 9] 참고)하여 스프링 레거시 프로젝트(Spring Legacy Project) 초기 생성을 해봤습니다.

(참고, 일반적으로 스프링(Spring) 프로젝트라고 말하는 것은 "Spring MVC" 프레임워크를 뜻하는 걸로 알고 있습니다.)

다음 글 이어서 보기 ‣

● spring-project-initialize Repository ‣ github.com/WHITEPAEK/spring-project-initialize

[IntelliJ] Git에서 멀티 프로젝트 Checkout 구성 방법

WHITEPAEK — Sat, 12 Oct 2019 18:56:13 +0900

프로젝트를 진행하면 단일 프로젝트로 구성되는 경우보다는 기능 별로 프로젝트가 나뉘어 있는 경우가 더 많습니다. 팀원 간 프로젝트를 협업하다 보면 깃(Git)을 이용해서 프로젝트를 내려받아야 합니다. 하지만 프로젝트가 여러 개의 경우 이클립스(Eclipse)와 다르게 인텔리제이(IntelliJ)에서 구성 방식과 설정에 대해 약간의 헷갈림이 있습니다. (물론, 저처럼 개발 초보자는 인텔리제이에 익숙하지 않거나 처음 해보시는 분들은 도큐먼트(Document)를 봐도 이해하기 힘듭니다.)

현업 실습을 경험하면서 깨우친(?) 깃에 있는 여러 개의 프로젝트를 인텔리제이에 구성하고 체크아웃(Checkout) 할 수 있도록 설정하는 방법을 설명드리도록 하겠습니다. (자신의 PC 디렉토리 구조와 터미널에서 기본적인 깃 사용 방법은 알고 있어야 합니다.)

아래 글을 읽기 전 인텔리제이 멀티 프로젝트(모듈)에 대해 잘 모르시는 분은 이 글을 참고하시면 이해하시는데 도움이 될 수 있습니다.

[1] Git에서 프로젝트 Clone 하기

[그림 1.1] 디렉토리 생성

터미널을 실행 후

자신이 원하는 위치에 여러 개의 프로젝트를 클론(Clone) 하기 위한 디렉토리를 mkdir 명령어로 생성해주세요.

(파인더로 해당 위치의 디렉토리로 이동하여 직접 폴더를 생성해도 상관없습니다.)

새로 생성한 폴더(test-web)는 인텔리제이에서 루트 프로젝트로 사용됩니다.

 mkdir /.../[디렉토리 위치]/[새로운 폴더명]

[그림 1.2] 현재 디렉토리 위치 변경

새로 생성한 폴더의 위치로 cd 명령어로 변경해주세요.

cd /.../[디렉토리 위치]/[이동할 폴더명]

[그림 1.3] Clone 할 프로젝트 확인

클론을 수행할 프로젝트가 있는 깃으로 이동해주세요.

저는 Spring Boot + Maven 기반의 프로젝트 3개를 예시로 설명드리겠습니다.

[그림 1.4] web URL 복사

클론 하기 위한 프로젝트로 이동 후 Web URL을 복사해주세요.

저는 3개의 프로젝트 중 test-web-common을 먼저 수행하도록 하겠습니다.

[그림 1.5] 프로젝트 Clone

복사한 Web URL을 터미널에서 git clone 명령어와 함께 입력하여 프로젝트를 클론 해주세요.

(자신이 생성한 디렉토리 위치에서 명령어를 수행하여야 합니다.)

git clone [복사한 Web URL]

[그림 1.6] 모든 프로젝트 Clone

[그림 1.4 ~ 그림 1.5]와 동일한 방법으로 나머지 프로젝트도 클론 해주세요.

ls -l 명령어로 해당 디렉토리 위치에서 프로젝트가 클론 된 걸 확인할 수 있습니다.

[그림 1.7] 디렉토리 확인

해당 디렉토리로 직접 이동하여 확인해봐도 정상적으로 프로젝트가 클론 된 걸 확인할 수 있습니다.

그러면 이제 인텔리제이에 구성할 프로젝트 준비는 끝났습니다.

[2] IntelliJ에 프로젝트 열기

[그림 2.1] 프로젝트 열기

인텔리제이를 실행 후 시작 화면(Welcom Screen)에서 Open을 클릭해주세요.

[그림 2.2] 프로젝트 선택

준비한 루트 프로젝트(test-web)를 선택 후 Open을 클릭해주세요.

[그림 2.3] 인텔리제이 프로젝트 확인

루트 프로젝트(test-web) 하위에 준비한 3개의 프로젝트가 구성된 걸 확인할 수 있습니다.

[3] 프로젝트 Module 설정하기

[그림 3.1] 모듈 설정을 진행할 프로젝트 선택

이제 준비한 프로젝트를 루트 프로젝트(test-web)의 모듈(Module)로 설정해주도록 하겠습니다.

모듈 설정을 진행할 프로젝트를 선택해주세요.

저는 test-web-admin 프로젝트를 먼저 진행하도록 하겠습니다.

[그림 3.2] 선택한 프로젝트 모듈 설정

프로젝트를 선택 후 File > New > Module from Existing Sources... 를 클릭해주세요.

[그림 3.3] 디렉토리 선택

루트 프로젝트(test-web) 티렉토리 위치로 이동 후 선택한 프로젝트와 동일한 디렉토리를 선택 후 Open을 클릭해주세요.

저는 인텔리제이에서 test-web-admin 프로젝트를 선택하였기 때문에 test-web-admin 디렉토리를 선택해주었습니다.

[그림 3.4] 빌드 선택

프로젝트 설정되어 있는 빌드를 선택 후 Next를 클릭해주세요.

(저는 Maven으로 구성된 프로젝트이므로 Maven을 선택하겠습니다.)

[그림 3.5] 프로젝트 옵션 설정

'Import Maven projects automatically'를 체크 후 Next를 클릭해주세요.

[그림 3.6] Import Module

모듈로 설정할 프로젝트를 선택 후 Finish를 클릭해주세요.

(각각의 프로젝트를 따로 설정해주므로 해당 프로젝트에 관련된 것 한개만 목록에 나올 거예요.)

[그림 3.7] 모듈 설정 완료

test-web-admin 프로젝트가 정상적으로 루트 프로젝트(test-web)의 모듈로 설정되었습니다.

[4] Module로 설정된 프로젝트 실행 환경설정

[그림 4.1] Edit Configurations...

프로젝트가 모듈로 설정이 되었으면 실행 환경설정도 해주어야 합니다.

Edit Configurations... 를 클릭해주세요.

[그림 4.2] Working directory 설정

Run/Debug Configurations 창 목록에서 해당 프로젝트의 Application을 선택 후 Environment를 클릭해서 펼쳐주세요.

그리고 Working directory의 목록에서 '$MODULE_WORKING_DIR$'을 선택 후 OK를 클릭해주세요.

test-web-admin 프로젝트의 모듈 실행 환경설정까지 모든 설정이 끝났습니다.

[5] 여러 개 프로젝트를 Multi Module로 설정하기

[그림 5.1] 하위 프로젝트 모듈 설정

test-web-common 프로젝트 경우 하위에 2개의 프로젝트가 추가로 포함되어 있습니다.

이 경우 또한 [그림 3.1 ~ 그림 4.2]와 동일한 방식으로 각 프로젝트에 대해 모듈 설정을 해주면 됩니다.

[그림 5.2] 멀티 프로젝트(모듈) 설정 완료

[그림 3.1 ~ 그림 4.2]와 동일한 방식으로 나머지 프로젝트도 모듈 설정을 전부 해주면 됩니다.

모듈 설정과 실행 환경설정을 정상적으로 하였다면 프로젝트 실행도 정상적으로 작동되는 걸 확인할 수 있습니다.

[그림 5.3] 각 모듈별 git 설정

모듈 설정이 완료된 프로젝트를 확인해보면 모듈 별로 깃(git) 설정이 정상적으로 돼있는 걸 확인할 수 있습니다.

모듈 별로 깃 설정 및 기능을 사용할 수 있습니다.

macOS 카탈리나 클린 설치(2) : MacBook Pro, MacBook Air, iMac Pro, Mac mini

WHITEPAEK — Fri, 11 Oct 2019 10:39:27 +0900

# macOS Catalina clean install(2)

클린 설치를 위한 USB를 만들었습니다. 이제 USB를 이용해서 맥OS(macOS)를 클린 설치해보도록 하겠습니다.

맥OS를 카탈리나로 업데이트하기 전 자신이 사용하는 프로그램(앱)이 32비트인지 확인해보세요. 카탈리나(Catalina)부터는 32비트 앱은 지원을 중단하고 64비트 앱만 지원하기 때문에 기존의 32비트 앱은 카탈리나에서 사용할 수 없으므로 참고하여 업데이트하시기 바랍니다.

카탈리나를 업데이트로 진행할 경우 사용하지 못하는 32비트 프로그램이 남아있기 때문에 이 부분이 찝찝하신 분에게는 클린 설치를 추천드립니다.

다음 설명과 같은 설정은 클린 설치에 문제 되는 부분이 아니므로 본 글에 내용이 포함되어 있지 않더라도 안심하고 진행하셔도 됩니다.

- 2016 및 이후 모델(터치바 모델)부터는 지문 인식, True Tone 설정이 추가적으로 진행됩니다.

- 와이파이(Wi-Fi) 연결 상태에 따라 Apple ID 등 일부 설정을 건너뛸 수도 있습니다.

(건너뛴 설정은 macOS 클린 설치가 완료된 후 추가로 설정할 수 있습니다.)

[1] macOS Catalina 클린 설치 준비

[그림 1.1] 설치 USB 연결

전원을 끈 상태에서 USB 설치 디스크를 포트에 연결해주세요.

[2] 시동 보안 설정

iMac Pro, Mac mini, MacBook Air, MacBook Pro 2018 및 이후 모델은 Apple T2 보안 칩이 장착되어 있습니다.

클린 설치 전 시동 보안 유틸리티를 설정해주어야 하므로 아래 설명과 동일하게 진행해주시면 됩니다.

2018 이전 모델의 경우 [그림 3.1]부터 진행해주시면 됩니다.

(USB 연결 > 전원 ON > option 키 누르기)

[그림 2.1] 전원 버튼 + command + R

전원을 켠 후 command + R 키를 길게 누르고 있어 주세요.

macOS 복구로 시동됩니다.

[그림 2.2] macOS 유틸리티 화면

macOS 유틸리티 창이 나타나면 command + R 키를 그만 누르고

메뉴 막대에서 유틸리티 > 시동 보안 유틸리티를 클릭해주세요.

[그림 2.3] 시동 보안 유틸리티 화면

'macOS 암호 입력...'을 클릭해주세요.

[그림 2.4] macOS 암호 입력

자신의 macOS 암호를 입력하고 확인을 클릭해주세요.

[그림 2.5] 시동 보안 유틸리티 설정

보안 시동에서 '보안 없음'을 선택하고 허용된 시동 미디어에서 '외부 또는 제거 가능한 미디어에서 시동 허용'을 선택 후

시동 보안 유틸리티 창을 닫아주세요.

[그림 2.6] 재시동

좌측 상단 을 클릭 후 '재시동'을 클릭 후 option 키를 길게 누르고 있어 주세요.

[3] macOS Catalina 클린 설치 시작

[그림 3.1] macOS 재시동

재시동 후 macOS 부팅이 시작되면 option 키를 그만 눌러도 됩니다.

[그림 3.2] Install macOS Catalina 선택

'Install macOS Catalina'를 클릭해주세요.

[그림 3.3] macOS 로딩 화면

로딩을 기다려주세요.

[그림 3.4] 언어 선택

macOS에서 사용할 기본 언어(한국어)를 선택 후 계속을 클릭해주세요.

[4] 디스크 지우기(포맷)

[그림 4.1] 디스크 유틸리티 선택

macOS 유틸리티 화면이 나타나면 디스크 유틸리티를 선택 후 계속을 클릭해주세요.

[그림 4.2] Macintosh HD 포맷

Macintosh HD를 선택 후 지우기를 클릭해주세요.

[그림 4.3] Macintosh HD 포맷 설정

이름은 Macintosh HD, 포맷은 APFS 기본 설정을 그대로 지우기를 클릭해주세요.

[그림 4.4] Macintosh HD 포맷 완료

지우기 작업이 완료되면 디스크 유틸리티 창을 닫아주세요.

[5] macOS Catalina 설치

[그림 5.1] macOS 설치 선택

macOS 유틸리티 창으로 돌아온 후 macOS 설치를 선택 후 계속을 클릭해주세요.

[그림 5.2] macOS Catalina 설치 시작

macOS Catalina 설치를 시작합니다.

계속을 클릭해주세요.

[그림 5.3] 소프트웨어 사용권 계약의 이용 약관 화면

동의를 클릭해주세요.

[그림 5.4] 소프트웨어 사용권 계약의 이용 약관 동의

동의를 클릭해주세요.

[그림 5.5] 디스크 선택

macOS Catalina를 설치할 디스크(Macintosh HD)를 선택 후 설치를 클릭해주세요.

[그림 5.6] macOS Catalina 설치 중

디스크에 macOS Catalina가 설치되고 있습니다. 기다려주세요.

[그림 5.7] macOS 부팅 중

디스크 설치가 완료되면 macOS가 부팅됩니다. 기다려주세요.

[그림 5.8] 국가 선택

국가(대한민국)를 선택 후 계속을 클릭해주세요.

[그림 5.9] 언어 기본설정

자신이 사용할 언어에 맞게 설정 후 계속을 클릭해주세요.

기본 설정으로 진행하시면 됩니다.

[그림 5.10] 인터넷 연결 설정

연결 방법을 설정해주세요.

'컴퓨터가 인터넷에 연결되어 있지 않습니다.'를 선택 후 진행하도록 하겠습니다.

(인터넷 연결 상태에 따라 해당 설정은 생략될 수 있습니다.)

[그림 5.11] 인터넷 연결 설정

계속을 클릭해주세요.

[그림 5.12] 데이터 및 개인 정보 보호 화면

계속을 클릭해주세요.

[그림 5.13] 정보 전송 화면

'지금 정보를 전송하지 않음'을 선택 후 계속을 클릭해주세요.

[그림 5.14] 이용 약관

동의를 클릭해주세요.

[그림 5.15] 이용 약관 동의

동의를 클릭해주세요.

[그림 5.16] 계정 생성

전체 이름은 macOS 사용자 이름이며, 계정 이름은 홈 폴더 이름으로 사용됩니다.

정보를 입력 후 계속을 클릭해주세요.

[그림 5.17] 빠른 설정

계속을 클릭해주세요.

[그림 5.18] 시간대 선택

가장 가까운 도시를 선택 후 계속을 클릭해주세요.

[그림 5.19] 분석 설정

계속을 클릭해주세요.

[그림 5.20] 스크린 타임 설정

스크린 타임에 관련된 설정은 나중에 시스템 환경설정에서 변경 가능합니다.

계속을 클릭해서 기본 설정으로 진행해주세요.

[그림 5.21] 보기 모드 선택

자신에게 맞는 화면 모드를 선택 후 계속을 클릭해주세요.

나중에 시스템 환경설정에서 변경 가능합니다.

[그림 5.22] 전체 설정 중

지금까지 진행한 설정이 세팅되는 중입니다. 기다려주세요.

[그림 5.23] macOS Catalina

모든 설정이 완료되면 macOS Catalina가 시작됩니다.

* 시동 보안 설정을 하신 분은 [그림 2.1 ~ 그림 2.6]을 참고해서 기본 설정으로 다시 바꿔주세요.

보안 시동은 '전체 보안'으로 허용된 시동 미디어는 '외부 또는 제거 가능한 미디어에서 시동 허용 안 함'으로 선택 후 재시동해주세요.

macOS 카탈리나 클린 설치(1) : USB 만들기

WHITEPAEK — Thu, 10 Oct 2019 16:10:47 +0900

# macOS Catalina clean install(1)

맥OS(macOS) 카탈리나(Catalina)가 정식 배포되었습니다. 이번 카탈리나 버전에서 가장 기대되는 부분은 사이드카(Sidecar) 기능으로 아이패드(iPad)를 확장 모니터로 사용할 수 있는 부분입니다. 많은 애플 유저분들이 업데이트를 어떤 방식으로 할지 고민할 텐데요. 맥OS를 업데이트하는 방법은 두 가지가 있습니다. 첫 번째는 시스템 환경설정에서 소프트웨어 업데이트를 하는 방법과 두 번째는 윈도우의 포맷과 동일한 개념의 클린 설치가 있습니다. 저는 두 번째 방법인 클린 설치를 이용한 업데이트 방법을 알려드리도록 하겠습니다.

클린 설치는 이전 모하비(Mojave)에서 설명드린 방법과 대부분 동일합니다. 그래도 혹시라도 헷갈리시는 분들을 위해 다시 한번 설명해드리도록 하겠습니다. 클린 설치를 하기 앞서 16GB 이상의 USB를 준비해주세요.

[1] macOS Catalina Install 앱 다운로드

[그림 1.1] 시스템 환경설정 -> 소프트웨어 업데이트

좌측 상단에  아이콘을 클릭 후 시스템 환경설정...을 클릭해주세요.

[그림 1.2] 지금 업그레이드하기

소프트웨어 업데이트 아이콘을 클릭 후 지금 업그레이드하기를 클릭해주세요.

[그림 1.3] 새로운 업데이트 다운로드

다운로드가 전부 완료될 때까지 기다려주세요.

[그림 1.4] App Store에서 다운로드

[그림 1.1 ~ 그림1.3] 방법이 잘 안될 때는 앱 스토어(App Store)에서 macOS Catalina를 다운로드해주세요.

[그림 1.5] macOS Catalina 설치 화면 종료

다운로드가 완료되면 위 사진처럼 macOS Catalina 설치 화면이 나타납니다.

이때 진행하지 마시고 macOS 설치 종료(command + Q)를 클릭해주세요.

[2] USB 포맷

[그림 2.1] 16GB 이상의 USB 연결

16GB 이상의 USB를 포트에 꽂아주세요.

[그림 2.2] Spotlight -> 디스크 유틸리티 입력

command + space bar 단축키를 눌러서 스팟라이트(Spotlight)를 실행하고 디스크 유틸리티를 입력해주세요.

[그림 2.3] USB 선택

디스크 유틸리티를 실행하고 자신의 USB를 선택 후 지우기를 클릭해주세요.

[그림 2.4] USB 포맷

이름을 MyVolume으로 입력하고 포맷은 Mac OS 확장(저널링)을 선택 후

지우기를 클릭해주세요.

[그림 2.5] USB 포맷 완료

정상적으로 포맷이 끝나면 완료를 클릭해주세요.

[3] macOS Catalina 설치 USB 만들기

[그림 3.1] Spotlight -> 터미널 입력

스팟라이트를 실행하고 터미널을 입력해주세요.

[그림 3.2] 터미널에서 'createinstallmedia' 명령어 입력

터미널을 실행하고 아래의 명령어를 입력 후 return(enter) 키를 눌러주세요.

sudo /Applications/Install\ macOS\ catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolume

[그림 3.3] macOS 비밀번호 입력

자신의 맥OS 비밀번호를 입력해주세요. 입력을 해도 아무것도 입력되지 않습니다.

무시하고 자신의 비밀번호를 입력 후 return(enter) 키를 눌러주세요.

[그림 3.4] Y 입력

'If you wish to continue type (Y) then press return:'이라는 문구가 출력되면 Y를 입력 후 return(enter) 키를 눌러주세요.

[그림 3.5] 설치 USB 완성

로딩이 완료될 때까지 기다려주세요.

Install media now available at "/Volumes/Install macOS Catalina"라는 문구가 출력되면

맥OS 카탈리나 설치를 위한 USB가 완성된 거예요.

[4] macOS Catalina 클린 설치

[그림 4.1] macOS Catalina

macOS Catalina 클린 설치하러 가기!

[IntelliJ] 자바 멀티 프로젝트(모듈) 생성하기

WHITEPAEK — Sat, 5 Oct 2019 22:43:10 +0900

인텔리제이(IntelliJ)에서 이클립스(Eclipse)처럼 워크스페이스(Workspace)에 여러 개의 프로젝트를 생성하는 방법을 알아보도록 하겠습니다. 우선 설명에 앞서 인텔리제이와 이클립스에서의 용어와 개념 차이에 대해 먼저 이해해야 하기 때문에 설명드리도록 하겠습니다.

다음 표는 인텔리제이와 이클립스에서의 용어 차이입니다. 인텔리제이에서 프로젝트는 이클립스의 워크스페이스라고 생각하시면 되는데 용어적인 차이점일 뿐 주의하셔야 합니다. 이클립스의 워크스페이스 같은 경우 하나의 디렉토리라고 생각할 수 있지만 인텔리제이의 프로젝트는 하나의 프로젝트 개념으로 생각해야 합니다. 즉, 이클립스의 프로젝트처럼 코드를 작성하고 컴파일할 수 있는 하나의 프로젝트입니다.

IntelliJ IDEA	Eclipse
Project	Workspace
Module	Project

다음 표와 같이 설명하는 게 적절한지는 모르겠지만 이해를 돕기 위해서 다시 한번 위의 표를 수정해서 보여드리겠습니다. 이전 표에서는 용어적인 차이점에서 보여줬다면 다음 표는 개념적인 차이점에서 본 것입니다.

IntelliJ IDEA	Eclipse
-	Workspace
Project	Project
Module	-

그렇다면 워크스페이스 개념이 없는 인텔리제이는 여러 개의 프로젝트를 하나의 윈도우에 어떻게 구성할까요? 위의 표를 보면 이클립스와 다르게 인텔리제이에서는 모듈(Module)이라는 개념이 있습니다. 모듈은 하나의 작은 프로젝트라고 생각하면 됩니다. 인텔리제이에서는 프로젝트 안에 여러 개의 작은 프로젝트(모듈)를 구성할 수 있습니다.

좀 더 이해하기 편하게 말씀드리자면 이클립스의 워크스페이스에서는 서로 관련이 없는 프로젝트를 구성하여 사용하는 경우가 있지만, 인텔리제이의 경우 프로젝트 안에 작은 프로젝트(모듈)를 구성하는 것이기 때문에 서로 연관이 있는 프로젝트를 구성해서 사용하는 것이 바람직합니다. (물론, 서로 관련이 없는 프로젝트를 구성하여 사용할 수 있으나 인텔리제이 규칙(?)에 어긋나는 방법이므로 권장하지 않습니다.)

인텔리제이와 이클립스의 차이점에 대한 설명은 여기까지입니다. 인텔리제이에서 직접 멀티 프로젝트(모듈)를 생성하고 위에서 설명한 인텔리제이의 프로젝트와 모듈에 대해 좀 더 이해할 수 있도록 해보겠습니다.

[1] 빈 프로젝트(Empty Project) 모듈 구성하기

# Java Multi Project

# Java Multi Module

[그림 1.1] 새 프로젝트 생성(Create New Project) 화면

인텔리제이를 실행 후 시작 화면(Welcom Screen)에서 새 프로젝트를 생성해주세요.

[그림 1.2] Empty Project 선택 화면

빈 프로젝트(Empty Project)를 선택 후 Next를 클릭해주세요.

[그림 1.3] Project name 입력 화면

프로젝트 이름(Project name)을 입력하고 Finish를 클릭해주세요.

[그림 1.4] New Module 선택 화면

Project Structure 윈도우가 나타나면 New Module를 클릭해주세요.

[그림 1.5] Module : Java 프로젝트 생성 화면

Java를 선택 후 Next를 클릭해주세요.

모듈은 작은 프로젝트라고 설명했던 부분이 기억나시나요?

모듈도 프로젝트 단위이기 때문에 프로젝트와 동일한 방식으로 생성되는 것입니다.

(예제는 이해를 돕기 위해서 자바 프로젝트를 생성하도록 하겠습니다.

나중에 자신이 진행하는 프로젝트 환경에 맞게 생성하시면 됩니다.)

[그림 1.6] Module name 입력 화면

모듈 이름(Module name)을 입력 후 Finish를 클릭해주세요.

Module file location에서 생성될 모듈 위치를 설정해줄 수 있습니다.

[그림 1.7] Module 생성 결과 화면

새로운 모듈이 생성된 걸 확인할 수 있습니다.

[그림 1.8] 모듈 추가 생성 화면

(그림 1.4 ~ 그림 1.7)과 같은 방식으로 모듈을 2개 더 생성해주세요.

총 3개의 모듈을 생성하였으면 OK를 클릭해주세요.

[그림 1.9] 멀티 프로젝트(모듈) 구성 완료 화면

프로젝트 툴 윈도우(Project tool window)에 3개의 모듈이 구성된 걸 확인할 수 있습니다.

[그림 1.10] 멀티 프로젝트(모듈) 구성 완료 화면

각 모듈 안에 Sources Root인 src 폴더가 있는 것을 확인할 수 있습니다.

이제 각 모듈 안에 필요한 Java 파일을 생성할 수 있습니다.

이상으로 Empty Project안에 자바 멀티 프로젝트(모듈)를 생성이 끝났습니다.

[2] 루트 프로젝트(Root Project) 모듈 구성하기

# Maven Multi Project

# Maven Multi Module

# Gradle Multi Project

# Gradle Multi Module

서비스가 단일 프로젝트로 구성되는 경우가 아니라면

공통 프로젝트와 여러 개의 프로젝트가 멀티로 구성되어 서로 상호작용하는 방식으로 구성될 것입니다.

이러한 방식의 프로젝트를 구성하기 위해서는 루트 프로젝트를 생성하고

여러 개의 프로젝트를 루트 프로젝트의 멀티 모듈로 구성해야 합니다.

메이븐(Maven) 기반의 멀티 프로젝트(모듈)와 그래들(Gradle) 기반의 멀티 프로젝트(모듈)

두 가지에 대해 설명하겠습니다.

[IntelliJ] Spring MVC, Maven 프로젝트 설정 방법

WHITEPAEK — Sun, 11 Aug 2019 11:02:43 +0900

시작하기에 앞서..

해당 포스트에서는 스프링에 대한 이론적인 설명은 작성하지 않았습니다. 이론적인 부분은 훌륭한 참고 서적이 많기 때문에 해당 서적을 구입하여 반복적으로 학습하는 것을 추천해 드립니다. 저와 마찬가지로 많은 초보자가 스프링 설정에서 많은 어려움을 겪는다고 생각하여 제가 공부하고 설정한 방식을 최대한 자세하게 작성하는 데 집중하였습니다. 개인적으로 이론은 한 번에 익히지 못할뿐더러 직접 코드를 작성해가면서 이해하는 것이 가장 효과적이라고 생각합니다. 하지만, 소스 코드를 작성하기도 전에 설정 부분에서 막혀버리면 생각보다 큰 좌절감이 다가옵니다. 코드 한 줄이라도 작성해볼 수 있도록 프로젝트 생성과 설정 방법에 관해 설명하였습니다.

[포스트에서 사용된 환경]
- 운영체제: macOS Mojave
- 도구: IntelliJ IDEA ULTIMATE
- 프레임워크: Spring MVC + Maven
- 데이터베이스: Oracle
- 서버: Tomcat

인텔리J에서 스프링 프로젝트를 설정하는 방법은 다양합니다. 하지만 설정 순서의 차이와 인텔리J에서 자동으로 설정해주는 부분을 수동으로 직접 설정하는 차이일 뿐입니다.

데이터베이스의 경우 Oracle을 사용하였지만 다른 데이터베이스 또한 설정 방식이 비슷하고 해당 포스트에서는 설명하지 않은 MyBatis와 같은 데이터베이스를 위한 프레임워크 등 다양한 프레임워크와 라이브러리가 존재합니다. 본격적인 프로젝트 개발을 시작하게 된다면 효율적인 다양한 설정 방법과 방식이 존재합니다. 설정 방법을 차근차근 이해하면서 따라 한다면 설명하지 않은 부분도 추가로 설정하여 이용하실 수 있습니다.

[1] Maven 프로젝트 생성하기

[그림 1.1] IntelliJ 실행

IntelliJ를 실행 후 Create New Project를 클릭해주세요.

[그림 1.2] Maven 프로젝트 생성

New Project 목록에서 Maven을 클릭하고 Project SDK에서 자신이 사용할 JDK 버전에 맞게 선택해주세요.

Next를 클릭해주세요.

[그림 1.3] GroupId, ArtifactId 설정

GroupId는 자신의 프로젝트를 식별해주는 고유 아이디입니다.

프로젝트에서 컨트롤하는 도메인 이름과 동일하게 입력해주세요.

ArtifactId는 버전 정보를 생략한 이름(jar)입니다.

프로젝트 이름과 동일하게 입력해주세요.

Next를 클릭해주세요.

[그림 1.4] Project name 설정

앞에서 설정한 ArtifactId와 동일하게 프로젝트 이름을 입력해주세요.

Finish를 클릭해주세요.

[그림 1.5] Maven 프로젝트

Enable Auto-Import를 클릭하면 메이븐 프로젝트 생성이 완료된거예요.

[2] Spring Framework 설정하기

[그림 2.1] 스프링 프레임워크 설정하기

루트 디렉토리 SpringMavenProject에서 우측 마우스를 클릭 후 Add Framework Support....를 클릭해주세요.

[그림 2.2] Spring MVC 선택

Add Frameworks Support 목록에서 Spring MVC (4.3.18.RELEASE)를 선택하고 OK를 클릭해주세요.

IntelliJ에서는 기본값으로 Spring 4.3 버전을 제공하고 있습니다,

[그림 2.3] web 디렉토리 자동 추가

web 디렉토리와 파일들이 자동으로 생성된 걸 확인할 수 있습니다.

관련 설정	IntelliJ	Eclipse
빈(bean) 설정	applicationContext.xml	root-context.xml
내부 웹 관련 처리 작업 설정	dispatcher-servlet.xml	servlet-context.xml
톰캣(tomcat) 구동 관련 설정	web.xml	web.xml

[3] Tomcat 설정하기

[그림 3.1] Add Configuration... 클릭

우측 상단 툴바에서 Add Configuration...을 클릭해주세요.

[그림 3.2] 톰캣 설정 화면

Run/Debug Configurations 창에서 좌측 상단 +를 클릭하여 Tomcat Server->Local를 클릭해주세요.

[그림 3.3] 톰캣 Fix 설정

Fix 버튼을 클릭해주세요.

[그림 3.4] 톰캣 루트 설정

Deployment 화면으로 이동되면 Application context를 /로 입력해주세요.

[그림 3.5] 톰캣 설정 완료

톰캣(tomcat) 설정이 완료되었습니다.

[4] Lombok Plugin 설치하기

Lombok 라이브러리는 getter/setter, toString(), 생성자 등을 자동으로

생성하여 반복적인 코드를 제거하므로 코드 라인 수를 줄여 가독성을 높여주고

생산성 향상에 큰 도움이 됩니다.

[그림 4.1] Plugins 화면

command + , (Ctrl+Alt+S) 단축키를 이용하여

Preferences(Settings) 창으로 이동 후 Plugins를 클릭해주세요.

[그림 4.2] Lombok 검색

검색 창에 Lombok을 입력 후 해당 플러그인을 설치해주세요.

[그림 4.2]는 이미 설치되어서 활성화된 상태입니다.

[5] Database 설정하기

다양한 데이터베이스를 설정할 수 있습니다.

저는 Oracle Database를 이용하여 설정하는 방법을 알려드리도록 하겠습니다.

☛ 오라클 데이터베이스 설치 방법

☛ MySQL 데이터베이스 설치 방법

[그림 5.1] 오라클 홈페이지

JDBC 설치를 위해 오라클 홈페이지로 접속 후 자신의 오라클 데이터베이스 버전에 맞는 드라이버를 클릭해주세요.

저는 Oracle Databases 11g Release 2 (11.2.0.4) drivers를 클릭하도록 하겠습니다.

[그림 5.2] ojdbc6.jar 다운로드

Accept License Agreement를 클릭 후 ojdbc6.jar를 클릭하여 다운로드해주세요.

다운로드가 완료되었으면 IntelliJ 화면으로 이동해주세요.

[그림 5.3] ojdbc 라이브러리 설정

command + ; (Ctrl+Alt+Shift+S) 단축키를 이용하여 Project Structure 창으로 이동해주세요.

좌측 상단에 + 버튼을 클릭 후 Java를 클릭해주세요.

[그림 5.4] ojdbc6.jar 추가

다운로드한 ojdbc6.jar 파일을 선택 후 Open을 클릭해주세요.

[그림 5.5] 모듈 선택 화면

OK를 클릭해주세요.

[그림 5.6] ojdbc6 라이브러리 추가 완료

라이브러리에 정상적으로 ojdbc6가 추가되었습니다.

[6] pom.xml 파일 설정

[그림 6.1] pom.xml 설정

pom.xml 파일에서 프로젝트 설정, 라이브러리 의존성 설정, 빌드 설정을 할 수 있습니다.

기본적인 부분에 대해서만 설정할 것이며 프로젝트를 진행하면서 필요한 라이브러리는 상황에 맞게 추가해주세요.

[그림 6.2] pom.xml 라이브러리 의존성 설정

아래의 코드를 <project> ... </project> 태그 사이에 입력해주세요.

    <properties>
        <java-version>1.8</java-version>
        <org.springframework-version>4.3.18.RELEASE</org.springframework-version>
        <org.aspectj-version>1.6.10</org.aspectj-version>
        <org.slf4j-version>1.6.6</org.slf4j-version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>${org.springframework-version}</version>
            <exclusions>
                <exclusion>
                    <groupId>commons-logging</groupId>
                    <artifactId>commons-logging</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${org.springframework-version}</version>
        </dependency>

        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjrt</artifactId>
            <version>${org.aspectj-version}</version>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${org.slf4j-version}</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>jcl-over-slf4j</artifactId>
            <version>${org.slf4j-version}</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>${org.slf4j-version}</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
            <exclusions>
                <exclusion>
                    <groupId>javax.mail</groupId>
                    <artifactId>mail</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>javax.jms</groupId>
                    <artifactId>jms</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>com.sun.jdmk</groupId>
                    <artifactId>jmxtools</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>com.sun.jmx</groupId>
                    <artifactId>jmxri</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.1</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${org.springframework-version}</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.5.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <compilerArgument>-Xlint:all</compilerArgument>
                    <showWarnings>true</showWarnings>
                    <showDeprecation>true</showDeprecation>
                </configuration>
            </plugin>
        </plugins>
    </build>

[그림 6.3] pom.xml에 추가한 라이브러리

command + ; (Ctrl+Alt+Shift+S) 단축키를 이용하여 Project Structure 창으로 이동해주세요.

목록에서 Artifacts를 클릭 후 Output Layout->Available Elements의 라이브러리를 전부 더블클릭해주세요.

[그림 6.4] Artifacts lib 추가

더블클릭한 라이브러리들이 프로젝트 lib 디렉토리에 정상적으로 추가되었습니다.

[7] log4j.xml 파일 설정하기

[그림 7.1] 로그 파일 설정하기

로그를 남기기 위해 자반 기반 로깅 유틸리티인 Log4j를 사용하겠습니다.

Log4j를 사용하기 위해서는 log4j.xml 파일을 생성해서 설정을 해주어야 합니다.

src/main/resources 디렉토리에 log4j.xml 파일을 생성하고 아래 코드를 입력해주세요.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration PUBLIC "-//APACHE//DTD LOG4J 1.2//EN" "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

	<appender name="console" class="org.apache.log4j.ConsoleAppender">
		<param name="Target" value="System.out" />
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="%-5p: %c - %m%n" />
		</layout>
	</appender>

	<logger name="org.springframework.core">
		<level value="info" />
	</logger>	
	
	<logger name="org.springframework.beans">
		<level value="info" />
	</logger>
	
	<logger name="org.springframework.context">
		<level value="info" />
	</logger>

	<logger name="org.springframework.web">
		<level value="info" />
	</logger>

	<!-- Root Logger -->
	<root>
		<priority value="info" />
		<appender-ref ref="console" />
	</root>
	
</log4j:configuration>

[8] Database 연동 테스트

[그림 8.1] JDBC 테스트 코드 작성

오라클 데이터베이스가 정상적으로 연결이 되었는지 확인하는 테스트 코드를 작성해보도록 하겠습니다.

데이터베이스 서버가 실행되어 있어야 하고, jdbc 라이브러리가 프로젝트에 추가되어있어야 합니다.

src/test/java 디렉토리에 JDBCTest.class 파일을 생성 후 아래 코드를 입력해주세요.

import lombok.extern.log4j.Log4j;
import org.junit.Test;

import java.sql.Connection;
import java.sql.DriverManager;

import static org.junit.Assert.fail;

@Log4j
public class JDBCTest {
    static {
        try {
            Class.forName("oracle.jdbc.driver.OracleDriver");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    @Test
    public void connection() {
        try(Connection conn = DriverManager.getConnection(
                "jdbc:oracle:thin:@localhost:1521:XE", "system", "oracle")) {
            log.info(conn);
        } catch (Exception e) {
            fail(e.getMessage());
        }
    }
}

[그림 8.2] JDBC 테스트 코드 실행

control+shift+R (Ctrl+Shift+F10) 단축키를 이용하여 테스트 코드를 실행해주세요.

그림처럼 결과창에 log가 출력되었다면 정상적으로 데이터베이스가 연결된 거예요.

[9] Spring MVC - Controller 테스트

[그림 9.1] web.xml 파일 설정

MVC2 방식의 Controller가 정상적으로 실행되는지 확인하기 위해서 관련 파일을 설정하도록 하겠습니다.

먼저 web.xml 파일에서 <url-pattern> ... </url-pattern> 태그 사이를 /로 수정해주세요.

[그림 9.2] HelloController.class 생성

src/main/java 디렉토리에 com.whitepaek.controller 패키지를 생성해주세요.

그리고 해당 패키지에 HomeController.class 파일을 생성하고 아래 코드를 입력해주세요.

package com.whitepaek.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/home/*")
public class HomeController {

    @GetMapping("test")
    public @ResponseBody String homeTest() {
        return "Spring + Maven";
    }
}

[그림 9.3] dispatcher-servlet.xml

dispatcher-servlet.xml 파일에 아래 코드를 추가해주세요.

<context:component-scan base-package="com.whitepaek.controller" />

[그림 9.4] 프로젝트 실행

모든 설정이 끝났습니다.

위에서 테스트 코드를 실행하였기 때문에 프로젝트 실행 전 톰캣으로 설정을 확인하고

control + R (Shift+F10) 단축키를 이용하여 프로젝트를 실행해주세요.

[그림 9.5] 브라우저 확인

브라우저에 URL을 localhost:8080/home/test로 입력하여 정상적으로 결과가 나오는 걸 확인할 수 있습니다.

이것으로 Spring MVC + Maven + Tomcat + OracleDB 프로젝트 생성 및 설정에 대한 설명이 끝났습니다.

[10] Tomcat, OracleDB 포트번호 충돌 해결

[그림 10.1] 포트 충돌로 인한 브라우저 접속 화면

Tomcat과 OracleDB는 기본값으로 8080 포트를 사용합니다.

그렇기 때문에 충돌이 되면 결과창에 에러 메시지와 함께 브라우저에 Sign in 모달 창이 나오는 것을 확인할 수 있습니다.

[그림 10.2] 톰캣 포트번호 수정

[그림 3.3]에서 설명했던 톰캣 설정 창으로 이동 후 HTTP port 번호를 8080을 제외한 다른 포트번호로 수정해주세요.

설명에서는 8081 포트로 수정하겠습니다.

포트번호를 수정하였으면 다시 톰캣을 실행 후 브라우저 URL에 localhost:8081/home/test와 같이

수정한 포트로 다시 접속하면 정상적으로 결과가 출력되는 것을 확인할 수 있습니다.

다른 방법으로는 Oracle 데이터베이스 포트 번호를 바꿔줘도 됩니다.

Reference

● IntelliJ IDEA ULTIMATE 학생 인증으로 무료로 사용하기

● InteliiJ Java 설정 방법

● Tomcat 설정 방법

● MySQL 설정 방법

● Oracle DB 설정 방법