住所APIの基本

liferay DXP/Portal 7.4+.

Liferay の REST API を使用して郵便住所を管理します。

アカウントに住所を追加する

新しいLiferay DXPインスタンスを起動し、以下を実行します。

docker run -it -m 8g -p 8080:8080 。

メールアドレス test@liferay.com とパスワード test を使用して、http://localhost:8080でLiferayにサインインしてください。 プロンプトが表示されたら、パスワードを learn に変更します。

次に、以下の手順に従います。

1. Postal Address API Basics をダウンロードして解凍する。

   curl https://resources.learn.liferay.com/dxp/latest/en/users-and-permissions/developer-guide/liferay-n8y7.zip -O
   

   unzip liferay-n8y7.zip
   

2. アカウントのリストを取得するには、 Accounts_GET_FromInstance を使用します。 住所を追加するアカウントのIDをメモしてください。 また、 Global Menu → Control Panel → Accounts に移動してアカウントのリストを見ることもできます。

3. cURLスクリプトを使用して、選択したアカウントに新しい住所を追加します。 コマンドラインで curl フォルダに移動します。 PostalAddress_POST_ToAccount.shスクリプトを実行する。 1234をアカウントIDに置き換える。

   ./PostalAddress_POST_ToAccount.sh 1234
   

   JSONレスポンスは、新しい住所が追加されたことを示しています：

    {
      "addressCountry" : "United States",
      "addressLocality" : "Diamond Bar",
      "addressRegion" : "California",
      "addressType" : "shipping",
      "id" : 35706,
      "name" : "Able Address",
      "postalCode" : "12345",
      "primary" : false,
      "streetAddressLine1" : "123 Foo St",
      "streetAddressLine2" : "",
      "streetAddressLine3" : ""
    }
   

4. Global Menu → Control Panel → Accounts に移動します。 ステップ2で選択したアカウントを選択し、 Addresses に移動します。 アカウントに新しい住所が追加されていることを確認してください。

   

5. RESTサービスは、Javaクライアントを使って呼び出すこともできます。 curlフォルダからjava フォルダに移動します。 ソースファイルをコンパイルします。

   javac -classpath .:* *.java
   

6. PostalAddress_POST_ToAccount.javaクラスを実行する。 1234をアカウントIDに置き換える。

   java -classpath .:* -DaccountId=1234 PostalAddress_POST_ToAccount
   

cURLコマンドの検証

PostalAddress_POST_ToAccount.shスクリプトはcURLコマンドでRESTサービスを呼び出す。

curl \
	"http://localhost:8080/o/headless-admin-user/v1.0/accounts/${1}/postal-addresses" \
	--data-raw '
		{
			"addressCountry": "United States",
			"addressLocality": "Diamond Bar",
			"addressRegion": "California",
			"addressType": "shipping",
			"name": "Able Address",
			"postalCode": "12345",
			"primary": false,
			"streetAddressLine1": "123 Foo St",
			"streetAddressLine2": "",
			"streetAddressLine3": ""
		}' \
	--header "Content-Type: application/json" \
	--request "POST" \
	--user "test@liferay.com:learn"

ここでは、コマンドの引数を紹介します。

他のcURLコマンドも同様のJSON引数を使用しています。

Javaクラスを調べる

PostalAddress_POST_ToAccount.javaクラスは、郵便住所関連サービスを呼び出して郵便住所を追加する。

このクラスは、わずか3行のコードでRESTサービスを呼び出します。

このプロジェクトには依存関係として com.liferay.headless.admin.user.client.jar ファイルが含まれていることに注意してください。 すべての REST アプリケーションのクライアント JAR 依存情報は、インストー ルの API エクスプローラーの /o/api にある。

他のJavaクラスの例もこれと似ているが、異なる PostalAddressResource メソッドを呼び出している。

以下は、cURLとJavaを使って他のPostalAddress RESTサービスを呼び出す例である。

アカウントから住所を取得する

以下のcURLまたはJavaコマンドを使用して、アカウントから郵便住所のリストを取得する。 1234`をアカウントIDに置き換える。

PostalAddresses_GET_FromAccount.sh

コマンド：

./PostalAddresses_GET_FromAccount.sh 1234

コード：

curl \
	"http://localhost:8080/o/headless-admin-user/v1.0/accounts/${1}/postal-addresses" \
	--user "test@liferay.com:learn"

PostalAddresses_GET_FromAccount.java

コマンド：

java -classpath .:* -DaccountId=1234 PostalAddresses_GET_FromAccount

コード：

public static void main(String[] args) throws Exception {
	PostalAddressResource.Builder builder = PostalAddressResource.builder();

	PostalAddressResource postalAddressResource = builder.authentication(
		"test@liferay.com", "learn"
	).build();

	System.out.println(
		postalAddressResource.getAccountPostalAddressesPage(
			Long.valueOf(System.getProperty("accountId"))));
}

アカウントの郵便住所はJSONレスポンスで返される。

組織から住所を取得する

以下のcURLまたはJavaコマンドを使って、ある組織から郵便住所のリストを取得する。 1234を組織のIDに置き換えてください。

PostalAddresses_GET_FromOrganization.sh

コマンド：

./PostalAddresses_GET_FromOrganization.sh 1234

コード：

curl \
	"http://localhost:8080/o/headless-admin-user/v1.0/organizations/${1}/postal-addresses" \
	--user "test@liferay.com:learn"

PostalAddresses_GET_FromOrganization.java

コマンド：

java -classpath .:* -DorganizationId=1234 PostalAddresses_GET_FromOrganization

コード：

public static void main(String[] args) throws Exception {
	PostalAddressResource.Builder builder = PostalAddressResource.builder();

	PostalAddressResource postalAddressResource = builder.authentication(
		"test@liferay.com", "learn"
	).build();

	System.out.println(
		postalAddressResource.getOrganizationPostalAddressesPage(
			String.valueOf(System.getProperty("organizationId"))));
}

組織の郵便住所がJSONレスポンスで返される。

ユーザーから住所を取得する

以下のcURLまたはJavaコマンドで、ユーザーから郵便住所のリストを取得する。 1234をユーザーIDに置き換える。

PostalAddresses_GET_FromUser.sh

コマンド：

./PostalAddresses_GET_FromUser.sh 1234

コード：

curl \
	"http://localhost:8080/o/headless-admin-user/v1.0/user-accounts/${1}/postal-addresses" \
	--user "test@liferay.com:learn"

PostalAddresses_GET_FromUser.java

コマンド：

java -classpath .:* -DuserAccountId=1234 PostalAddresses_GET_FromUser

コード：

public static void main(String[] args) throws Exception {
	PostalAddressResource.Builder builder = PostalAddressResource.builder();

	PostalAddressResource postalAddressResource = builder.authentication(
		"test@liferay.com", "learn"
	).build();

	System.out.println(
		postalAddressResource.getUserAccountPostalAddressesPage(
			Long.valueOf(System.getProperty("userAccountId"))));
}

ユーザーの住所はJSONレスポンスで返される。

住所の取得

以下のcURLまたはJavaコマンドで特定の郵便住所を取得する。 1234`を郵便住所のIDに置き換える。

PostalAddress_GET_ById.sh

コマンド：

./PostalAddress_GET_ById.sh 1234

コード：

curl \
	"http://localhost:8080/o/headless-admin-user/v1.0/postal-addresses/${1}" \
	--user "test@liferay.com:learn"

PostalAddress_GET_ById.java

コマンド：

java -classpath .:* -DpostalAddressId=1234 PostalAddress_GET_ById

コード：

public static void main(String[] args) throws Exception {
	PostalAddressResource.Builder builder = PostalAddressResource.builder();

	PostalAddressResource postalAddressResource = builder.authentication(
		"test@liferay.com", "learn"
	).build();

	System.out.println(
		postalAddressResource.getPostalAddress(
			Long.valueOf(System.getProperty("postalAddressId"))));
}

郵便番号はJSONレスポンスで返される。

住所をパッチする

以下のcURLまたはJavaコマンドを使って、既存の郵便住所を部分的に編集する。 1234を郵便住所のIDに置き換える。

PostalAddress_PATCH_ById.sh

コマンド：

./PostalAddress_PATCH_ById.sh 1234

コード：

PostalAddress_PATCH_ById.java

コマンド：

java -classpath .:* -DpostalAddressId=1234 PostalAddress_PATCH_ById

コード：

住所を記入する

以下のcURLまたはJavaコマンドで、既存の郵便住所を完全に上書きする。 1234を郵便住所のIDに置き換える。

PostalAddress_PUT_ById.sh

コマンド：

./PostalAddress_PUT_ById.sh 1234

コード：

PostalAddress_PUT_ById.java

コマンド：

java -classpath .:* -DpostalAddressId=1234 PostalAddress_PUT_ById

コード：

住所を削除する

以下のcURLまたはJavaコマンドを使用して、既存の郵便住所を削除する。 1234を郵便住所のIDに置き換える。

PostalAddress_DELETE_ById.sh

コマンド：

./PostalAddress_DELETE_ById.sh 1234

コード：

PostalAddress_DELETE_ById.java

コマンド：

java -classpath .:* -DpostalAddressId=1234 PostalAddress_DELETE_ById

コード：

API Explorer はすべての PostalAddress サービスとスキーマを表示し、各サービスを試すためのインターフェイスを持っています。