Business Consulting Services © Copyright Hosei University Ja-Sakai Café 2009 年 3 月 17 日 法政大学 常盤 祐司

© Copyright Hosei University 1 1 目次 Sakai CLE Ja Sakai における展開 課題 方針 対象 プログラミングガイド

© Copyright Hosei University 2 2 Java 1.5 Oracle 9i/10g MySQL 4.1 HSQL (demo) Spring Hibernate Tomcat 5.5 Java Server Faces Sakai 2.x Apache SSL mod_jk WEBISO Virtual hosting Velocity Sakai CLE / Architecture Sakai CLE はオープンソースにより構成されている

© Copyright Hosei University 3 3 Ja Sakai における展開 Sakai Tool Sakai 標準 User, Course Question & Testing Adapter Syllabus Sakai Tool B 大学 開発 Sakai Tool Sakai 標準 Sakai Tool A 大学 開発 Academic information System Commercial System Integration Adapter Sakai Tool C 大学 開発 Sakai Application Framework (SAF) 再利用可能な Tool および Adapter Administrative System Integration SAML based Web SSO SaaS Integration 再利用可能な Knowhow 利用技術 各大学で開発されたツールおよび利用技術が他大学で再利用できる

© Copyright Hosei University 4 4 課題

© Copyright Hosei University 5 5 方針 Sakai の導入からアプリケーション組み込みまでの一連の操 作を習得する。  環境設定  Sakai 導入  Sakai 修正  Contrib モジュール追加  アプリケーション開発  デバッグ Step by Step でその通り操作すれば確実に完了する。 大学における一般的な ICT 環境を標準とする。  PCWindows  ServerLinux Sakai プログラミング 101

© Copyright Hosei University 6 6 対象 プログラム開発体験のある学生、大学院生および社会人。 IDE およびコマンドベースによる開発体験があれば望まし い。

© Copyright Hosei University 7 7 Sakai プログラミングガイド １．前提 ２．開発環境概要 ３．バージョン管理のセットアップ ４．開発用 PC のセットアップ ５． Sakai のアプリケーション構造 ６． Eclipse を使った Sakai アプリケーション開発 ７． Sakai アプリケーションのデバッグ ８．標準 Tool のカスタマイズ ９． Contrib Tool 組み込み方法 １０． CSV ファイルから user 、 course 、 member 登録のサンプルプログラ ム作成 １１．プログラムを本番環境へリリース 付録－ CSV ファイルによる user 、 course 、 member 登録のプログラム一式 プログラム一覧 入力用 CSV ファイルレイアウト 参考文献 A4 にて 98 ページの分量

© Copyright Hosei University 前提 以下の知識がある方を対象  Sakai CLE のインストール  eclipse を使った java の Web アプリケーション開発

© Copyright Hosei University 環境 本番環境 Linux Sakai CLE MySQL バージョン管理 Linux Subversion commit checkout 開発用 PC Windows Sakai CLE MySQL OS ： Windows XP SP2 IDE ： Eclipse IDE for Java EE Developers (eclipse 3.4.1) DB ： MySQL b JVM ： Java 1.5.0_16* Subversion ： CollabNet Subversion Command-Line Client v1.5.4 (for Windows) Maven ： Maven Tomcat ： apache-tomcat DB Tool ： DbVisualizer ＊： Java 1.6 では Java API の違いにより Sakai のコンパイルでエラーとなる。

© Copyright Hosei University バージョン管理のセットアップ １） Subversion のインストール a. バージョン管理サーバ環境 ・ Redhat Linux ES4 ・ root で作業を行います。 ・ /root/src 配下にソースをダウンロードして、展開します。 ・ apache はインストールされているものとします。 b. Subversion の必要ソースをダウンロードします。 src]# wget src]# wget src]# wget c. インストールします。 先ずは、 neon をインストールします。 src]# tar zxvf neon tar.gz src]# cd neon neon ]#./configure neon ]# make neon ]# make install.

© Copyright Hosei University 開発用 PC のセットアップ １） Java のインストール ２） MySQL のセットアップ ３） Maven のセットアップ ４） Subversion のセットアップ ５） Tomcat のセットアップ ６） MySQL JDBC ドライバのセットアップ ７） Sakai Source のダウンロード ８） Sakai.properties のセットアップ ９） Sakai の build １０） Tomcat と Sakai の起動 １１） DB Tool のセットアップ １２） Eclipse のセットアップ

© Copyright Hosei University Sakai のアプリケーション構造 app-name Tool 名 + api – interfaces などの定義。 Tomcat の shared\lib に配備。 + src - interfaces のソースなど + impl – api(interfaces) の実装。 Tomcat の components に配備。 + src – 実装のソース + test – ユニットテストコード + pack – Spring 定義ファイルなど。 impl と一緒に、 Tomcat の components に配備。 + tool - ユーザインターフェース。 Tomcat の webapps に配備。 + src - ユーザインターフェースのソースなど + java – java のソースコード + webapp + app-name – JSF 、 JSP ファイルなど + css + images + templates - RSF html templates + tools + WEB-INF - web.xml, applicationContext.xml など

© Copyright Hosei University Sakai のアプリケーション構造 フォルダ名説明 {ap-name}-tool ツール本体。 MVC モデルのコントローラ (controller) に相当する Java クラス、 View に相当する Velocity ファイル、ツールで使用する言語ファイルなどを配置 {ap-name}-api MVC モデルのモデル (model) に相当する Java クラス（インターフェース部分） を配置 {ap-name}-impl MVC モデルのビュー（ view ）に相当する Java クラス（インターフェースを実装 した Java クラス）を配置

© Copyright Hosei University eclipse を使った Sakai アプリケーション開発 1. Sakai App Builder のインストール Eclipse プラグイン Sakai App Builder を使いアプリケーション開 発 Eclipse 上で、 Help -> Software Updates -> Available Software -> Add Site Location ： ： [Sakai AppBuilder Feature] を選択して [Install] 2. Sakai アプリケーションの作成 a. Sakai AppBuilder を使って、サンプルコード を生成 File -> New -> Project

© Copyright Hosei University Sakai アプリケーションのデバッグ 1. ロギングによるトレース DEBUG レベルのログ出力設定 %CATALINA_HOME%\sakai\sakai.properties に以下の ５行を追加。 log.config.count=4 log.config.1 = ALL.org.sakaiproject.log.impl log.config.2 = OFF.org.sakaiproject log.config.3 = INFO.org.sakaiproject.db.impl log.config.4 = DEBUG.org.sakaiproject.mytool.logic.MytoolLogicImp Tomcat を再起動して、ログを確認します。 2. eclipse でデバッグ Tomcat の Java Platform Debugger Architecture (JPDA) を 有効にすることで、 eclipse から遠隔デバッグができるよ うになります。

© Copyright Hosei University 標準ツールのカスタマイズ １）標準 Tool 修正ガイドについて ２） Profile Tool 画面への項目追加概要 ３） Profile Tool 画面 JSP ファイルへの項目追加 ４）画面表示用メッセージファイルの項目追加 ５） Profile を定義するクラスの項目追加 ６） Hibernate の O/R マッピング設定ファイルの項目追加 ７）コンパイルとデプロイ ８）アプリケーションの動作確認 ９）参考情報 タスク： Profile Tools に項目をひとつ追加する。

© Copyright Hosei University Contrib Tool 組み込み方法 タスク： Sakai Contrib Tools の 1 つである「 JForum 」を Sakai に組み込 む １） JForum の入手 ２） JForum のセットアップ

© Copyright Hosei University CSV ファイルによる環境 (user, course, member) 設定 １） CSV インポートプロジェクトの作成 ２）プログラム構造 ３）ユーザ登録・更新の実装 ４）ユーザ削除の実装 ５）コースサイト登録・更新の実装 ６）コースサイト削除の実装 ７）サイトメンバー登録の実装 ８）サイトメンバー削除の実装 タスク： 用意した CSV ファイルから各種登録を行う。

© Copyright Hosei University 本番環境へのリリース １）開発用 PC のソースをバージョン管理サーバへ転送 ２）バージョン管理サーバから本番環境へソースを転送 ３）本番環境でコンパイル 本番環境 Linux Sakai CLE MySQL バージョン管理 Linux Subversion commit checkout 開発用 PC Windows Sakai CLE MySQL タスク： 開発環境から本番環境へのリリース

© Copyright Hosei University 20 参考文献 [1] Sakai 2.5 Source Install Guide ： Sakai2.5 の Source から動作環境を作成する手順書 [2] Development Environment Setup Walkthrough ： Sakai の開発環境作成手順 [3] Java SE Downloads - Previous Release - J2SE 5.0 ： J2SE のダウンロードサイト [4] MySQL Downloads ： MySQL ダウンロードサイト [5] Apache Maven Project ： Sakai の Source をコンパイルする際に利用するプロジェクト管理 ツール [6] Subversion （バージョン管理ツール）のダウンロードサイト [7] Apache Tomcat ： Apache Tomcat5.5 のダウンロードサイト [8] MySQL Connector/J ： MySQL の JDBC ドライバ [9] Download DbVisualizer ：データベースの GUI ツールダウンロードサイト [10] Eclipse Downloads ： eclipse （統合開発ツール）のダウンロードサイト [11] Sakai application (tool) structure ： Sakai のアプリケーション構造 …..