Documentation

Wiki APIの基本

LiferayのHeadless Deliveryアプリケーションは、WikiアプリケーションにRESTサービスを提供します。 これらのサービスを使用すると、Wikiノードとページを追加したり、それらの情報を一覧表示したり、コンテンツを変更したり、完全に削除したりできます。 ここでは、cURLコマンドとJavaクラスを使用してこれらのサービスを呼び出します。

チュートリアルリソースの準備

チュートリアルに進む前に、まずクリーンなLiferay Dockerコンテナをセットアップし、提供されたチュートリアルコードを使用できるように準備します。

Liferay Dockerコンテナ

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

docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.29-ga29。

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

開始したら、Site IDを取得します。 サイトIDを見つけるには、 サイトメニュー(サイトメニュー)を開き、 [Configuration] → [Site Settings] → [Site Configuration] に移動します。

[Site Configuration]設定でサイトIDを探します。

チュートリアルコード

本チュートリアルでは、サンプルコードを提供し、Headless APIのデモを行います。 このコードには、チュートリアル全体で使用するためのサンプルのcURLファイルとJavaファイルの両方が含まれています。

次のコマンドを実行して、 サンプルコード をダウンロードし、解凍します。

curl https://learn.liferay.com/dxp/latest/ja/collaboration-and-social/wiki/developer-guide/liferay-q8u2.zip -O
unzip liferay-q8u2.zip

cURLスクリプトを使用する準備ができたら、実行する前にJavaソースファイルを手動でコンパイルする必要があります。 これを行うには、プロジェクトのjavaフォルダに移動し、javacコマンドを実行します。

cd liferay-q8u2/java
javac -classpath .:* *.java

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

WikiNodeおよびWikiPage Headless APIの使用

サンプルコードには、次のAPIを呼び出すcURLスクリプトとJavaクラスが含まれています。

サービス

HTTPメソッド

HTTPエンドポイント

Javaメソッド

説明

WikiNode

POST

/v1.0/sites/{siteId}/wiki-nodes

postSiteWikiNode

API呼び出しで提供された詳細を使用して、指定されたサイトに新しいWikiノードを作成します

WikiNode

GET

/v1.0/sites/{siteId}/wiki-nodes

getSiteWikiNodesPage

指定されたサイト内のすべてのWikiノードの完全なリストを返します。結果に対して、ページ分割、絞り込み、検索、およびソートをすることができます

WikiNode

GET

/v1.0/wiki-nodes/{wikiNodeId}

getWikiNode

指定されたノードエンティティの詳細を返します

WikiNode

PUT

/v1.0/wiki-nodes/{wikiNodeId}

putWikiNode

指定されたノードの詳細をAPI呼び出しで提供されたものに置き換えます

WikiNode

DELETE

​/v1.0​/wiki-nodes​/{wikiNodeId}

deleteWikiNode

指定されたノードを削除し、操作が成功した場合は204を返します

WikiPage

POST

/v1.0/wiki-nodes/{wikiNodeId}/wiki-pages

postWikiNodeWikiPage

API呼び出しで提供された詳細を使用して、指定されたノードに新しいWikiページを作成します

WikiPage

POST

/v1.0/wiki-pages/{parentWikiPageId}/wiki-pages

postWikiPageWikiPage

API呼び出しで提供された詳細を使用して、指定されたWikiページの新しいWiki子ページを作成します。

WikiPage

GET

/v1.0/wiki-nodes/{wikiNodeId}/wiki-pages

getWikiNodeWikiPagesPage

指定されたWikiノードに追加されたすべてのWikiページの完全なリストを返します。結果に対して、ページ分割、絞り込み、検索、およびソートをすることができます

WikiPage

GET

/v1.0/wiki-pages/{parentWikiPageId}/wiki-pages

getWikiPageWikiPagesPage

指定されたWikiページに追加されたすべてのWiki子ページの完全なリストを返します。結果に対して、ページ分割、絞り込み、検索、およびソートすることができます

WikiPage

GET

/v1.0/wiki-pages/{wikiPageId}

getWikiPage

指定されたWikiページエンティティの詳細を返します

WikiPage

PUT

/v1.0/wiki-pages/{wikiPageId}

putWikiPage

指定されたページの詳細をAPI呼び出しで提供されたものに置き換えます

WikiPage

DELETE

/v1.0/wiki-pages/{wikiPageId}

deleteWikiPage

指定されたページを削除し、操作が成功した場合は204を返します

重要

WikiページにPOSTメソッドとPUTメソッドを使用する場合は、 headlineフィールドと encodingFormatフィールドの両方を定義する必要があります。 headlineフィールドはページのメインタイトルを設定し、 encodingFormatフィールドはページのメディアフォーマット(HTML、BBCodeなど)を決定します。

WikiNode APIの呼び出し

この演習では、cURLコマンドまたはJavaクラスのいずれかを使用してWikiNode APIを呼び出すことができます。 次の出力例はcURLコマンドに対応しており、提供されているJavaクラスの出力とは少し異なります。

  1. liferay-q8u2プロジェクトのcurlまたはjavaフォルダに移動します。

    cURLの場合:

    cd liferay-q8u2/curl
    

    Javaの場合:

    cd liferay-q8u2/java
    
  2. サイトIDをパラメーターとして使用して、WikiNode_POST_ToSiteシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したサイトに新しいWikiノードが作成されます。

    cURLの場合:

    ./WikiNode_POST_ToSite.sh {site-id}
    

    Javaの場合:

    java -classpath .:* -DsiteId={site-id} WikiNode_POST_ToSite
    

    ターミナルには、新しく作成されたWikiノードの完全なスキーマが表示されます。 提供されているAPI呼び出しでは、新規ノードのdescriptionおよびnameフィールドのみを定義していますが、以下のGET、PUT、DELETEメソッドで使用するためにノードのIDをコピーする必要があります。

    {
      ...
      "description" : "Foo",
      ...
      "id" : 38405,
      "name" : "Able Node",
      ...
    }
    
  3. サイトIDをパラメーターとして使用して、WikiNodes_GET_FromSiteシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したサイト内のすべてのWikiノードのリストが返されます。

    cURLの場合:

    ./WikiNodes_GET_FromSite.sh {site-id}
    

    Javaの場合:

    java -classpath .:* -DsiteId={site-id} WikiNodes_GET_FromSite
    

    注釈

    すべてのDXP/ポータルインスタンスには、 Mainと呼ばれるデフォルトのWikiノードが付属しています。 このノードは、作成したノードとともに上記の出力に表示されます。

  4. WikiのノードIDをパラメーターとして使用して、WikiNode_PUT_ByIdシェルスクリプトまたはJavaクラスを実行します。 これにより、指定されたWikiノードの詳細がAPI呼び出しで提供された詳細に置き換えられます。

    cURLの場合:

    ./WikiNode_PUT_ById.sh {wiki-node-id}
    

    Javaの場合:

    java -classpath .:* -DwikiNodeId={wiki-node-id} WikiNode_PUT_ById
    
    {
      ...
      "description" : "Bar",
      ...
      "id" : 38405,
      "name" : "Baker Node",
      ...
    }
    
  5. WikiのノードIDをパラメーターとして使用して、WikiNode_DELETE_ByIdシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したノードが削除されます。

    cURLの場合:

    ./WikiNode_DELETE_ById.sh {wiki-node-id}
    

    Javaの場合:

    java -classpath .:* -DwikiNodeId={wiki-node-id} WikiNode_DELETE_ById
    
  6. 以前のWikiのノードIDをパラメーターとして使用して、WikiNode_GET_ByIdシェルスクリプトまたはJavaクラスを実行します。 これにより、指定されたノードが存在する場合はその詳細が返されます。

    cURLの場合:

    ./WikiNode_GET_ById.sh {wiki-node-id}
    

    Javaの場合:

    java -classpath .:* -DwikiNodeId={wiki-node-id} WikiNode_GET_ById
    

    前の手順でノードを削除したため、次のメッセージが返されます。

    {
      "status" : "NOT_FOUND",
      "title" : "No WikiNode exists with the primary key 38405"
    }
    

WikiPage APIの呼び出し

cURLコマンドまたはJavaクラスのいずれかを使用して、WikiPage APIを呼び出すことができます。 以下の出力例は、cURLコマンドに対応したもので、Javaクラスの出力とは異なります。

  1. liferay-q8u2プロジェクトのcurlまたはjavaフォルダに移動します。

    cURLの場合:

    cd liferay-q8u2/curl
    

    Javaの場合:

    cd liferay-q8u2/java
    
  2. WikiNode_POST_ToSiteシェルスクリプトまたはJavaクラスを実行して、Wikiページのノードを作成します。

    cURLの場合:

    ./WikiNode_POST_ToSite.sh {site-id}
    

    Javaの場合:

    java -classpath .:* -DsiteId={site-id} WikiNode_POST_ToSite
    

    注釈

    WikiページはWikiノードに保存されるため、Wikiページを作成する前に少なくとも1つのノードが存在する必要があります。

  3. WikiPage_POST_ToNode 呼び出しで使用するために、出力からノードのIDをコピーします。

    {
      ...
      "description" : "Foo",
      ...
      "id" : 38504,
      "name" : "Able Node",
      ...
    }
    
  4. 上記のノードIDをパラメーターとして使用して、WikiPage_POST_ToNodeシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したノードの新しいWikiページが作成されます。

    cURLの場合:

    ./WikiPage_POST_ToNode.sh {wiki-node-id}
    

    Javaの場合:

    java -classpath .:* -DwikiNodeId={wiki-node-id} WikiPage_POST_ToNode
    
  5. WikiPage_POST_ToParent呼び出しで使用するためにページのIDをコピーします。

    {
      ...
      "content" : "Foo",
      ...
      "description" : "Able Page",
      "encodingFormat" : "text/x-wiki",
      ...
      "headline" : "Able Page",
      "id" : 38506,
      ...
    }
    
  6. 上記のWikiページIDをパラメーターとして使用して、WikiPage_POST_ToParentシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したWikiページの子ページが作成されます。

    cURLの場合:

    ./WikiPage_POST_ToNode.sh {wiki-page-id}
    

    Javaの場合:

    java -classpath .:* -DparentWikiPageId={wiki-page-id} WikiPage_POST_ToParent
    
    {
       ...
       "content" : "Foo",
       ...
       "description" : "Charlie Page",
       "encodingFormat" : "text/x-wiki",
       ...
       "headline" : "Charlie Page",
       "id" : 38510,
       ...
    }
    
  7. WikiのノードIDをパラメーターとして使用して、WikiPages_GET_FromNodeシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したノードに追加されたすべてのWikiページのリストが返されます。これには、新しく作成された両方のWikiページが含まれます。

    cURLの場合:

    ./WikiPages_GET_FromNode.sh {wiki-node-id}
    

    Javaの場合:

    java -classpath .:* -DwikiNodeId={wiki-node-id} WikiPages_GET_FromNode
    
  8. Wikiの親ページIDをパラメーターとして使用して、WikiPages_GET_FromParentシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したWikiページの既存の子ページが返されます。

    cURLの場合:

    ./WikiPages_GET_FromParent.sh {wiki-page-id}
    

    Javaの場合:

    java -classpath .:* -DparentWikiPageId={wiki-page-id} WikiPages_GET_FromParent
    
  9. 上記のWikiページIDのいずれかをパラメーターとして使用して、WikiPage_PUT_ByIdシェルスクリプトまたはJavaクラスを実行します。 これにより、元のページのコンテンツがAPI呼び出しで定義されたコンテンツに置き換えられます。

    cURLの場合:

    ./WikiPage_PUT_ById.sh {wiki-page-id}
    

    Javaの場合:

    java -classpath .:* -DwikiPageId={wiki-page-id} WikiPage_PUT_ById
    
    {
      "content" : "Bar",
      ...
      "encodingFormat" : "text/x-wiki",
      ...
      "headline": "Baker Page",
      "id" : 38515,
      ...
    }
    
  10. 目的のWikiページIDをパラメーターとして使用して、WikiPage_DELETE_ByIdシェルスクリプトまたはJavaクラスを実行します。 これにより、指定したWikiページが削除されます。

    cURLの場合:

    ./WikiPage_DELETE_ById.sh {wiki-page-id}
    

    Javaの場合:

    java -classpath .:* -DwikiPageId={wiki-page-id} WikiPage_DELETE_ById
    
  11. 削除されたWikiページのIDをパラメーターとして使用して、WikiPage_GET_ByIdシェルスクリプトまたはJavaクラスを実行します。 これにより、指定されたページが存在する場合はその詳細が返されます。

    cURLの場合:

    ./WikiPage_GET_ById.sh {wiki-page-id}
    

    Javaの場合:

    java -classpath .:* -DwikiPageId={wiki-page-id} WikiPage_GET_ById
    

    前の手順でページが削除されたため、次のメッセージが表示されます。

    {
      "status" : "NOT_FOUND",
      "title" : "No WikiNode exists with the primary key 38515"
    }
    

サンプルのcURLスクリプトの検証

以下は、チュートリアルのcURLコマンドの代表的な例です。

WikiNode_POST_ToSite.sh

curl \
	-H 'Content-Type: application/json' \
	-X 'POST' "http://localhost:8080/o/headless-delivery/v1.0/sites/${1}/wiki-nodes" \
	-d "{\"description\": \"Foo\", \"name\": \"Able Node\"}" \
	-u "[email protected]:learn"

WikiPage_POST_ToNode.sh

curl \
	-H 'Content-Type: application/json' \
	-X 'POST' "http://localhost:8080/o/headless-delivery/v1.0/wiki-nodes/${1}/wiki-pages" \
	-d "{\"content\": \"Foo\", \"encodingFormat\": \"text/x-wiki\", \"headline\": \"Able Page\"}" \
	-u "[email protected]:learn"

WikiPages_GET_FromNode.sh

curl \
	"http://localhost:8080/o/headless-delivery/v1.0/wiki-nodes/${1}/wiki-pages" \
	-u "[email protected]:learn"

サンプルのJavaクラスの検証

以下は、チュートリアルのJavaコマンドの代表的な例です。

WikiNode_POST_ToSite.java

ublic class WikiNode_POST_ToSite {

/**
 * java -classpath .:* -DsiteId=1234 WikiNode_POST_ToSite
 */
public static void main(String[] args) throws Exception {
	WikiNodeResource.Builder builder = WikiNodeResource.builder();

	WikiNodeResource wikiNodeResource = builder.authentication(
		"[email protected]", "learn"
	).build();

	WikiNode wikiNode = wikiNodeResource.postSiteWikiNode(
		Long.valueOf(System.getProperty("siteId")),
		new WikiNode() {
			{
				description = "Foo";
				name = "Dog Node";
			}
		});

	System.out.println(wikiNode);
}

WikiPage_POST_ToNode.java

ublic class WikiPage_POST_ToNode {

/**
 * java -classpath .:* -DwikiNodeId=1234 WikiPage_POST_ToNode
 */
public static void main(String[] args) throws Exception {
	WikiPageResource.Builder builder = WikiPageResource.builder();

	WikiPageResource wikiPageResource = builder.authentication(
		"[email protected]", "learn"
	).build();

	WikiPage wikiPage = wikiPageResource.postWikiNodeWikiPage(
		Long.valueOf(System.getProperty("wikiNodeId")),
		new WikiPage() {
			{
				content = "Foo";
				encodingFormat = "text/x-wiki";
				headline = "Dog Page";
			}
		});

	System.out.println(wikiPage);
}

WikiPages_GET_FromNode.java

ublic class WikiPages_GET_FromNode {

/**
 * java -classpath .:* -DwikiNodeId=1234 WikiPages_GET_FromNode
 */
public static void main(String[] args) throws Exception {
	WikiPageResource.Builder builder = WikiPageResource.builder();

	WikiPageResource wikiPageResource = builder.authentication(
		"[email protected]", "learn"
	).build();

	Page<WikiPage> page = wikiPageResource.getWikiNodeWikiPagesPage(
		Long.valueOf(System.getProperty("wikiNodeId")), null, null, null,
		Pagination.of(1, 2), null);

	System.out.println(page);
}