碧 - セットアップ

プロジェクトのセットアップ

新規プロジェクトまたは既存のプロジェクトにmidoriフレームワークをセットアップする手順を説明します。
プロジェクトはTomcatプロジェクトかWTPプロジェクトを想定しています。


1.必要な資材の配置


・WEB-INF/libの下にmidoriTutorial.zipを解凍したWEB-INF/lib配下をコピーします。
・src/にmidori.xmlをコピーします。


2.設定


・WEB-INF/web.xmlに以下の設定を追加します。

<!--
	//==========================================================
	//フィルターの定義
	//==========================================================
 -->

	<!-- 碧(midori)用のフィルター -->
	<filter>
		<filter-name>midoriFilter</filter-name>
		<filter-class>jp.fores.midori.server.MidoriFilter</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>expireCache</param-name>
			<param-value>true</param-value>
		</init-param>
		<init-param>
			<param-name>requestGZip</param-name>
			<param-value>true</param-value>
		</init-param>
		<init-param>
			<param-name>responseGZip</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>


<!--
	//==========================================================
	//フィルターマッピングの定義
	//==========================================================
 -->

	<!-- 碧(midori)用のフィルター -->
	<filter-mapping>
		<filter-name>midoriFilter</filter-name>
		<url-pattern>/rpc/*</url-pattern>
	</filter-mapping>


<!--
	//==========================================================
	//サーブレットの定義
	//==========================================================
 -->

	<!-- RPC用のサーブレット -->
	<servlet>
		<servlet-name>RPCServlet</servlet-name>
		<servlet-class>jp.fores.midori.server.RPCServlet</servlet-class>
		<!-- 設定ファイル -->
		<init-param>
			<param-name>configFile</param-name>
			<param-value>midori.xml</param-value>
		</init-param>
		<!-- リスティング機能を有効にするかどうかのフラグ -->
		<init-param>
			<param-name>listing</param-name>
			<param-value>true</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>


<!--
	//==========================================================
	//サーブレットマッピングの定義
	//==========================================================
 -->

	<!-- RPC用のサーブレット -->
	<servlet-mapping>
		<servlet-name>RPCServlet</servlet-name>
		<url-pattern>/rpc/*</url-pattern>
	</servlet-mapping>
									


・src/midori.xmlで、ルートパッケージ、コンテナクラス、利用する通信方式に応じたプラグインの設定を行ないます。

<?xml version="1.0" encoding="UTF-8"?>
<config>
	<rootPackage>foo.bar</rootPackage>
	<container>jp.fores.midori.server.container.impl.BasicSingletonContainer</container>
	<plugins>
		<plugin type="amf" class="jp.fores.midori.server.plugin.impl.AmfPlugin" />
		<plugin type="java" class="jp.fores.midori.server.plugin.impl.JavaSerializePlugin" />
		<plugin type="json" class="jp.fores.midori.server.plugin.impl.JsonRPCPlugin" />
		<plugin type="xmlrpc" class="jp.fores.midori.server.plugin.impl.XmlRPCPlugin" />
		<plugin type="axmlrpc" class="jp.fores.midori.server.plugin.impl.ApacheXmlRPCPlugin" />
		<plugin type="hessian" class="jp.fores.midori.server.plugin.impl.HessianPlugin" />
		<plugin type="thrift" class="jp.fores.midori.server.plugin.impl.ThriftPlugin" />
	</plugins>
</config>


3.動作確認


アプリケーションをサーバにデプロイして動作確認を行ないます。
ブラウザから以下のようなURLにアクセスして下さい。
エラーが発生せずに、レスポンスが返ってきたら成功です。
(例)http://localhost:8080/midoriTutorial/rpc/
(URLのホスト名やポートの部分は、環境によって異なることがあります。)


※詳細は設定、機能リファレンスを参照して下さい。