日日是Oracle APEX: CKEditor5による画像アップロードを実装する(2)

2022年8月3日水曜日

CKEditor5にて画像の貼り付けを行なったときに発行される、画像のアップロード要求を受け付けて表RTE_IMAGESに保存する処理と、画像のダウンロード要求を受け付けるREST APIを作成します。

作成するREST APIは、以下の記事で紹介しているREST APIとほとんど同じです。APEXセッションによる保護の設定についても同じです。

以下より、今回作成しているアプリケーションのためのREST APIを作成します。

記述する作業は、画像のアップロードとダウンロードに関するものに限定します。それ以外の作業は、上記の記事が参考になります。

SQLワークショップのRESTfulサービスを開きます。

左ペインにてモジュールを選択し、モジュールの作成を実行します。

モジュール名としてrteditor、ベース・パスとして/rteditor/を設定し、モジュールの作成を実行します。本番環境で使用するといったものではないため、公開はONにしておきます。

モジュールrteditorが作成されます。続けて、テンプレートの作成を実行します。

URIテンプレートとしてimageを入力します。テンプレートの作成を実行します。

テンプレートimageが作成されます。ハンドラの作成を実行します。

メソッドにPOSTを選択し、ソースに以下を記述します。

	declare
	l_id rte_images.id%type;
	begin
	/*
	* アップロードされた画像は:bodyにバイナリ・データとして保持されている。
	* :content_typeはORDSが設定してくれている。
	* :current_userはAPEXセッションによる保護をかけた場合、APP_USERになる。
	*/
	insert into rte_images(content_type, image, created_by, created)
	values(:content_type, :body, :current_user, sysdate)
	returning id into l_id;
	:status_code := 201;
	/*
	* アップロードに成功した場合は、urlとしてダウンロードするリンクをJSON形式で返す。
	* ex:
	* {
	* "url": "https://hostname/ords/apexdev/rteditor/image/322343253253"
	* }
	*/
	apex_json.open_object;
	apex_json.write(
	p_name => 'url',
	p_value => owa_util.get_cgi_env('REQUEST_PROTOCOL') \|\|
	'://' \|\|
	owa_util.get_cgi_env('SERVER_NAME') \|\|
	owa_util.get_cgi_env('SCRIPT_NAME') \|\|
	owa_util.get_cgi_env('PATH_INFO') \|\|
	'/' \|\| l_id
	);
	apex_json.close_object;
	exception
	when others then
	/* エラーを返す。
	* {
	* "error": {
	* "message": "Something wrong!"
	* }
	* }
	*/
	apex_json.open_object;
	apex_json.open_object('error');
	apex_json.write('message', 'Something wrong!');
	apex_json.close_object;
	apex_json.close_object;
	end;