Alinous CMS update

Alinous-CMS技術資料

Alinous-CMS及びAlinous-Coreの動作環境

Alinous-CMSは、Alinous-Core上に構築されたテンプレートですので、動作環境はAlinous-Coreに準じます。Alinous-Coreの動作環境は

OS Windows, Linux(Javaに準拠)
JDK version 1.5以降
アプリケーションサーバ Tomcat, Websphere, Weblogic (J2EE対応のWebコンテナ)

が必要です。

Alinous-CMSに関する技術資料

Alinous-CMSには、Alinous-Coreのプロフェッショナル版の上位版の「Alinous-Core CMS Enterprise Edition」が利用されています。この、エディションには

CMS用のツリー表示エンジン
SEO用の静的HTML出力エンジン
Luceneによる全文検索機能

が付加されています。

Alinous-CMSの技術資料

Alinous-Coreに関する技術資料

Alinous-Coreに関する資料として、『Alinous-CORE徹底入門』という資料を用意しています。こちらのドキュメントでは、順を追って読んでいくことで、サンプルのプロジェクトを動かしながらAlinous-COREを学習できるようになっています。

Alinous-CORE徹底入門

Alinous上での設定

alinous-config.xml上での設定

alinous-config.xmlに設定する際には、次のようなコードを記述します。

treenodes" />
	node" />
		id" />contents/id" />
		datastore" />pgapps/datastore" />
		doc-type" />
			id" />normalDoc/id" />
			display-name" />通常の文書/display-name" />
			editpage" />/edit/edit.html/editpage" />
			showpage" />/show/show.html/showpage" />
			deletepage" />/edit/deleteDoc.html/deletepage" />
			spanclass" />/spanclass" />
			folderimg" />
			/alinous-common/treenode/img/toc_open.gif/folderimg" />
		/doc-type" />
	/node" />
/treenodes" />

このとき、nodeタグひとつにつき、ひとつのツリーオブジェクトが作成されます。各タグの意味については次の表のようになります。

id	ツリーオブジェクトのIDです
datasotre	ツリーオブジェクトの値を保持するデータベースのインスタンス名です
display-name	ドキュメントの表示名を記述します
editpage	ツリー上からAjaxでドキュメントの「Update」コマンドが選択されたときに、ドキュメントを編集するためのページを選択します
showpage	ツリー上からAjaxでドキュメントの「Update」コマンドが選択されたときに、ドキュメントを表示するためのページを選択します
deletepage	ツリー上からAjaxでドキュメントの「Delete」コマンドが選択されたときに、ドキュメントを削除するために実行するページを選択します
spanclass	（オプション）ツリーに表示されるノードのスタイルシートのクラスを指定します
folderimg	（オプション）ツリーに表示されるノードの画像を指定します

この中で重要なのは、editpage, showpage, deletepageです。これらは、ツリーオブジェクトがHTML上で表示されたときに、ノードをクリックした際に表示されるコマンドを実行する際に実行されるページを指定し、ツリーオブジェクトに関連付けられたドキュメントを操作するために利用します。
コマンドは、下図のように、ツリーオブジェクトをHTML上に埋め込んだ際に、鉛筆のアイコンをクリックするとコンテキストメニューとして表示されるものです。

Alinous-Coreの仕組み（上級者向け）

この章について

この節では、Alinous-Coreの技術的なしくみについて説明します。この節に関しては、かなり、技術的にシステムの開発に詳しい人向けに書かれてありますので、あまり、システムに詳しくない方や、とにかく早く何かを作りたいという方は読み飛ばしていただいてかまいません。

Java上につくられた仮想マシン

Alinous-CoreはJavaで実装されていますが、それには多くの理由があります。それは、今までに作られたさまざまなJava部品の再利用が考えられているからです。

Alinous-Coreの本体はalinous.warというwarファイルで提供されています。このwarファイルは、Servletコンテナ上にデプロイできるようになっており、 Alinous-Coreの仮想マシンはTomcatなどのServletコンテナ上で動作します。

また、独自のクラスローダーも持っており、ライブラリ用のフォルダにあるjarファイルをリアルタイムで読み込んで実行する仕組みも持っています。

HTMLとスクリプトの実行方法

Alinous-Coreは、「ALINOUS_HOME」という環境変数で指定されたフォルダの中のファイルをHTTP経由でリクエストされたアドレスにマッピングしてHTTPクライアントに返すHTTPサーバです。

ただし、Alinous-Coreは拡張子が「*.alns」「*.html」「*.rss」のファイルに関しては一度中間オブジェクトにコンパイルした後、Alinous-Coreの仮想マシン上で実行されます。この中間オブジェクトは、一度コンパイルされると元のファイルが更新されるまで仮想マシン内でキャッシュされ、効率よくコンパイルを行うようになっています。

HTMLのサーバサイドレンダリング

Alinous-Coreは、データベースのインスタンスを２つ使います。ひとつのDBインスタンスは、アプリケーションで利用するもので、もうひとつの DBインスタンスはAlinous-Coreのシステムが利用するものです。

システム用のインスタンスは

画面の遷移情報のキャッシュ
Alinousスクリプトで利用された変数のキャッシュ
セッション情報
フォーム入力の値の過去データ

を管理しており、通常のフレームワークで書く際に面倒な画面の遷移とそれに伴う状態（FormパラメータやAlinousスクリプトの実行結果）を自動化しています。

また、Alinous-Coreでは、HTMLで記述されたフォームを部品化するためのポートレット機能を利用することにより、ひとつのHTMLファイルを他のHTMLファイルのdivタグやtdタグの中に埋め込むことが可能です。このとき、埋め込まれたHTMLの部分は、まるでframeタグのように独立して画面遷移します。これは、サーバー側で各HTMLがオブジェクト化されて独立した状態をもち、それが最終的にサーバー側で直列のHTML文字列にレンダリングされることで実現しています。

フォーム認証

Alinous-Coreおける認証機能は、「alinous-config.xml」に設定することで動作させることができます。実際には以下のような記述をします。

?xml version="1.0" encoding="utf-8"?" />
alinous-config" />
    system" />
           system-datastore id="pgsrc" /" />
           default-datastore id="pgapps" /" />
    /system" />

    datasources id="pgsrc"
		class="org.alinous.plugin.derby.DerbyDataSource"" />
           connect" />jdbc:derby://localhost/MyDB;create=true;/connect" />
           user" />/user" />
           pass" />/pass" />
    /datasources" />

    datasources id="pgapps"
			class="org.alinous.plugin.derby.DerbyDataSource"" />
           connect" />jdbc:derby://localhost/MyDB;create=true;/connect" />
           user" />/user" />
           pass" />/pass" />
    /datasources" />
        
    basic-auth" />
           relm" />
                   datastore" />pgsrc/datastore" />
                   table" />AUTH_TABLE/table" />
                   users" />USERS/users" />
                   passwords" />PASSWORDS/passwords" />
                   roles" />ROLES/roles" />
           /relm" />
                
           zones" />
                   zone" />
                          area" />/admin//area" />
                          roles" />admin/roles" />
                !-- error-page" />/admin/error.html/error-page" /> --" />
                                
                           form-auth" />
                                   login" />/admin/login.html/login" />
                                   confirm" />/admin/confirm.html/confirm" />
                            /form-auth" />
                    /zone" />
                        
            /zones" />

    /basic-auth" />   
/alinous-config" />

basic-auth" />タグの部分がフォーム認証およびBASIC認証に関する記述をしている部分です。 BASIC認証は、ブラウザからユーザIDとパスワードを送り、レルムの内容と見比べて認証する単純なメカニズムとなっており、フォーム認証はログインフォームやログインのロジックを自分で書くという違いがあります。

relm" />タグは、BASIC認証を行う上で使います。レルムとは、「ユーザーのID」「パスワード」「ロール」を管理するためのデータベースのことです。Alinous-Coreでは、どのテーブルのどのカラムをどのように割り当てるかを設定ファイルで決めることができ、 relm" />タグの中に設定します。

datastore	どのデータベースを使うか
table	どのテーブルを使うか
users	ユーザーIDを格納するためのカラム
passwords	パスワードを格納するためのカラム
roles	ロールを格納するためのカラム

カスタムバリデータ

カスタムバリデータを利用することで、バリデーションのロジックを自分で書くことが出来ます。カスタムバリデータが利用されている例は、「/ALINOUS_HOME/boxtest/index.html」にあります。前回、標準バリデータを利用する際には、alns:validate属性をinput" />タグにつけましたが、そこまではカスタムバリデータの場合も同じです。カスタムバリデータを付ける場合には、この属性の値をcustomという値にします。

form name="testForm" action="show.html" method="POST"" />
(中略)
input type="text" name="txt" value="Hello world" 
		alns:validate="custom"" />br" />
(中略)
/form" />

標準バリデータの場合は、これでバリデータの設置は終わりだったのですが、カスタムバリデータの場合はバリデーションのロジックを自力で書く必要があります。ロジックを書く場所は今回の場合はshow.htmlにたいしてフォームをPOSTするので、そのロジックを記述するshow.alnsに記述します。show.alnsのソースコードを示すと次のようになります。

// please put breakpoint at the next line
return 0;


function validate($formName, $inputName, $value, $IN, $SESSION)
{
        if($value == ""){
                return "custom";
        }
        return 0;
}

function validateArray($formName, $inputName, @value, $IN, $SESSION)
{
        // Write validation logic for array parameters here
        return 0;
}

ここで、２つの関数があることに注目してください。validate関数とvalidateArray関数です。validate関数は、フォーム入力の値が通常の文字列のものに対するバリデーションロジックを記述するもので、validateArray関数は、フォーム入力の値が配列の場合に呼び出されるものです。今回は、通常のテキストのinput" />にたいしてカスタムのバリデーションをかけているので、とりあえず、 validateArray関数は忘れていただいてかまいません。フォームの値が配列の場合に関しては、Alinous-Core徹底活用の節で説明いたします。ところで、このvalidate関数関数ですが、５つの引数をもちます。それぞれの引数の説明をすると、次のようになります。

$formName	入力されたフォームの値が入っています。
$inputName	inputのname属性の値が入っています。これから評価する値がどのinputタグの値かを識別するためのものです。
$value or @value	$inputNameで指定されたinputタグの値が入っています。
$IN	入力パラメーターが入っています。
$SESSION	セッションの値が入っています。このDOM変数にプロパティを足した場合は、セッションとして記憶されます。

ここで注目してもらいたいのが、$inputNameパラメータの存在です。このパラメータが存在するということは、このvalidate関数は、フォームの中に存在するカスタムバリデータを設置したフォーム入力の数だけ呼ばれるということです。このへんの動きは、validate関数にブレークポイントを設置してデバッガで動きを追ってみるとわかりやすいかと思います。

このvalidate関数でバリデーションの結果を返すには、return文を使います。バリデーションが正しく行われた場合には、0を返します。一方、バリデーションに失敗した場合には、文字列を返すようにします。この文字列がバリデーションのエラーコードになります。このエラーコードは、標準バリデータで説明したエラーメッセージの表示を行う際に利用します。この例では、失敗したときにはcustomというエラーコードが帰りますのでもし、このバリデータにエラー表示を付けると次のようになります。

span alns:msg="txt" alns:form="testForm" alns:validate="custom"" />
   font color="#FF0000"" />input your comment/font" />br" />
/span" />

フォームとバリデータ

Alinous-Coreでは、バリデータは大きく分類してつぎの２種類を持っています。

標準バリデータ
カスタムバリデータ

標準バリデータは、nullチェックや正規表現のチェックを行うためのものです。実際の開発では、単純に一つの値のフォーマットでバリデーションをかけるだけではなく、データベースの中の値を見てバリデーションをかけるケースなどが多々あります。例えば、会員制のサイトで新しい IDを登録するときに、もうすでに使われているIDはバリデーションではじきたい場合などがそのようなケースにあたります。

そのような場合のために用意されたのがカスタムバリデータです。カスタムバリデータでは、Alinousスクリプトでバリデーションのロジックを組むことが出来ます。

では、それぞれのバリデータに関してみていきましょう。

標準バリデータ

標準バリデータの例はサンプルの「/ALINOUS_HOME/insert/index.html」にあります。次に、バリデータの記述がされたフォームのソースを示します。

form name="searchForm" action="confirm.html" 
		method="POST" enctype="multipart/form-data"" />
    table" />
        tr" />
            td" />NAME : /td" />
            td" />
                input type="text" name="name" value=""
                                        alns:validate="notnull"" />
                span alns:msg="name" 
			alns:form="searchForm" alns:validate="notnull"" />
                    font color="#FF0000"" />input your NAME/font" />br" />
                /span" />
            /td" />
        /tr" />

このソースでは各input" />タグにalns:validateという拡張属性が記述されています。そして、今回はnullチェックのバリデータですので、その属性の値にnotnullが指定されています。バリデータの機能を付けること自体はこれで終わりです。

さらに、バリデーションが失敗したときのエラーメッセージを表示させたいときにはspan" />タグを利用します。span" />タグのなかの拡張属性で次のように設定することで、バリデーションが失敗した際にはspan" />タグ内のメッセージが表示されます。

alns:msg	どのインプットの失敗時に表示するか？インプットのname属性で指定
alns:form	インプットのがあるフォーム名を指定
alns:validate	エラーコードを指定。標準バリデータの場合は、バリデータ名

SQLとHTMLの連携

SQLとHTMLの連携機能はAlinous-Coreのもっとも特徴的な部分になります。この機能を体験するのにもっとも良いのは、サンプルプロジェクトの「/ALINOUS_HOME/select/」の部分です。このフォルダにアクセスするには

http://localhost:8080/select/

にアクセスしてください。

このフォルダにある、「show.alns」はSELECT文を利用した例です。ソースは次のようになっています。

show.alns

// EXECUTE SELECT STATEMENT
if($IN.comment != null){
        $LIKE_STMT = '%' + $IN.comment + '%';
}


SELECT * INTO RECORDS FROM SAMPLE_TABLE 
                WHERE
                        NAME = $IN.name AND
                        EMAIL = $IN.mail AND
                        COMMENT like $LIKE_STMT
                ORDER BY NAME DESC
                limit 10;

// Making colors for the back ground of TD tag for each record.
for($i = 0; $i < Array.size(@RECORDS); $i++){
        if($i % 2 == 0){
                $RECORDS[$i].BGCOL = "#EFEFEF";
        }
        else{
                $RECORDS[$i].BGCOL = "#FFFFFF";
        }
}

return 0;

このプログラムでは、まず最初にlike文で利用するための変数$LIKE_STMTをフォームから入力されたインプットの値に応じて作っています。$ IN.commentというのがフォームの「commnet」という名前の入力の値になります。ここで、このshow.alnsに入力しているフォームのソースを見てみます。

index.html

form name="searchForm" action="show.html" method="POST"" />
        
 table" />
       tr" />
               td" />NAME : /dt" />
               td" />input type="text"
			name="name" alns:ignoreBlank="true"" />/td" />
       /tr" />
       tr" />
               td" />E-MAIL : /td" />
               td" />input type="text" 
			name="mail" alns:ignoreBlank="true"" />/td" />
       /tr" />
       tr" />
               td" />COMMENT : /td" />
               td" />input type="text" 
			name="comment" alns:ignoreBlank="true"" />/td" />
       /tr" />
  /table" />
       
  input  name="submit" type="submit" value="Search"/" />
/form" />

このフォームには「name」、「mail」、「comment」３つの入力インプットがあります。これらの値がこのフォームがPOSTされた際にそれぞれ、$IN.name、$IN.mail、$IN.commnetという変数として自動的にわたります。

ここで、見てほしいのが「alns:ignoreBlank」という拡張属性です。

input type="text" name="comment" alns:ignoreBlank="true"" />

通常、フォームのインプットに何も入力しない場合、そのインプットの値は空文字（""）になりますが、この属性がついているとそのインプットの値が nullになります。最初の＄LIKE_STMTを作る部分では、commentの値があるかどうかで判別してlike文に対する式を作っています。

次にSQLを実行する部分になります。その部分を抜き出すと次のようになります。

SELECT * INTO RECORDS FROM SAMPLE_TABLE 
                WHERE
                        NAME = $IN.name AND
                        EMAIL = $IN.mail AND
                        COMMENT like $LIKE_STMT
                ORDER BY NAME DESC
                limit 10;

このSQL文には、Alinousスクリプトの変数を埋め込むことが出来ます。ここで、ふと、みなさんは疑問に思うと思います。もし、$IN.nameなどの入力している変数がnullもしくは存在しなかったらどうなるのでしょうか？

実は、Alinous-Coreは、WHERE句の条件式の自動調整機能を持っています。Alinous-Coreは、Alinousスクリプトに書かれたSQLをコンパイルしてツリー構造の中間コードを持っています。そして、次の図のように、ツリーの末端のほうから、不完全な条件式を取り除く作業を自動的におこなってくれます。この自動調整機能は、SQL文の最後に「ADJUST_WHERE = FALSE」と記述することにより無効化することもできます。

そして、SELECT文が実行されるとINTO句で指定した＠RECORDSという配列にレコードが返されます。この@RECORDという配列は、 Alinousスクリプトでもいじることが出来、最後の部分でそのレコードをテーブルに表示する際のバックグラウンドの色をそのレコードに付け足しています。

// Making colors for the back ground of TD tag for each record.
for($i = 0; $i < Array.size(@RECORDS); $i++){
        if($i % 2 == 0){
                $RECORDS[$i].BGCOL = "#EFEFEF";
        }
        else{
                $RECORDS[$i].BGCOL = "#FFFFFF";
        }
}

HTMLの記述方法

では、次にどのようにTDタグの中に別のページを組み込むかを具体的にHTMLのコードを見ながら説明していきます。まずは、ALINOUS_HOME/index.htmlの中のTDタグの部分を実際に見てみましょう。

TD alns:tagid="contents" alns:inner="/default.html"" /> /TD" />

TDタグに、alns:tagidとalns:innerというAlinous-Core用の属性がついています。この２つの属性を利用することによって、初期状態のindex.htmlのTDタグの部分に/default.htmlを埋め込むことが出来ます。属性の説明をしますと、alns: tagidはそのTDタグの領域に名前を付けるために利用します。そして、alns:innerは初期状態で埋め込まれるファイルを指定します。

では、初期画面の左側の「Select DB Form」というリンクをクリックしたときの動作はどのように実現されているのでしょうか？それでは、実際にそのリンクの部分のHTMLのコードを見てみます。

A href="/select/" alns:target="contents"" />Select DB Form/A" />

Aタグにalns:targetという属性がついています。この属性を付けることによって、ページ全体を遷移させるのではなく、名前を付けたTDタグの領域のみ遷移させることが出来ます。また、このalns:targetに入れる特殊な値としてthisという値があります。この値は、自分がどこかの HTMLに埋め込まれている場合には埋め込まれているTDタグの中をhrefのURLに遷移させ、自分がトップの場合にはHTML全体が遷移します。

この様子を示すサンプルは、実は、「Select DB Form」のリンクをクリックした後に表示されるALINOUS_HOME/select/index.htmlにあります。フォームの下に「TEST」というリンクがあると思います。ソースは次のようになっています。

A href="/" alns:target="this"" />TEST/A" />

このAタグは今の自分の領域にトップページをそのまま、まるごと入れ込むことを意味しています。実際に、このリンクをクリックすると入れ子のような状態になりますが、これを複数回繰り返すと下図のような状態になります。このような状態でもそれぞれの領域が独立した状態を持って画面遷移します。このことは、入れ子になったページのリンクをクリックしてみると、そのクリックされた部分のページが入れ子になっていないときと同じ動きをすることで確認することが出来ます。

今回は、tdタグのなかに他のページを埋め込みましたが、他にはdiv" />タグの中に埋め込むことも可能です。

Alinous-Coreの基本

Alinous-Coreの基本概念は、HTMLとSQLベースで開発ができることです。

HTMLは、通常のHTMLにテキスト出力のマクロとAlinous-Core用の拡張属性（アトリビュート）を加えたもので記述します。

また、Alinousスクリプトは、SQLをそのままスクリプト内に入力できるほか、DOM形式の変数を利用したスクリプトを記述することが出来ます。スクリプト部分では、DOM形式の変数が使えるほかに、if文、while文、for文や標準関数、カスタムの関数を利用することが出来ます。

少しだけ例を示すと次のようになります。

AlinousーCoreでは、ひとつのページを表示するのに"*.html"ファイルと、"*.alns"ファイルを記述します。

sample.alns

// EXECUTE SELECT STATEMENT

// $IN.[フォーム変数名]でHTMLのフォームからの変数の値を取得
if($IN.comment != null){
  $LIKE_STMT = '%' + $IN.comment + '%';
}

SELECT * INTO RECORDS FROM SAMPLE_TABLE
  WHERE
    NAME = $IN.name AND
    EMAIL = $IN.mail AND
    COMMENT like $LIKE_STMT
  limit 10;

return 0;

スクリプトを実行することによって下の図のような変数を作ることが出来ます。

sample.alnsを実行後、Alinous-Coreは、デザイン（HTML）とその実行結果を結合します。

sample.html

HTML" />
HEAD" />
  meta http-equiv="Content-Type" content="text/html; charset=utf-8"" />
  TITLE" />Input data into database/TITLE" />
/HEAD" />

BODY" />

  H3" />Select DB Form(/select/index.html)/H3" />BR" />

  TABLE" />
    TR" />
      TD width="200" bgcolor="#AAAAAA"" />NAME/TD" />
      TD width="200" bgcolor="#AAAAAA"" />E-MAIL/TD" />
      TD width="300" bgcolor="#AAAAAA"" />COMMENT/TD" />
    /TR" />

    TR alns:iterate="@RECORDS" alns:variable="oneRecord"" />
      TD width="200"" />{$oneRecord.NAME}/TD" />
      TD width="200"" />{$oneRecord.EMAIL}/TD" />
      TD width="300"" />{$oneRecord.COMMENT}/TD" />
    /TR" />

  /TABLE" />

  BUTTON alns:back="true"" />Back/BUTTON" />

  H4" />Comment/h4" />

/BODY" />

/HTML" />

HTMLは、属性が拡張されていますが、Alinous-Core用のタグはありません。その他の拡張要素としては、本文中にマクロでスクリプトで作成した変数の値を埋め込むことが出来ます。

これで、なんとなく、Alinous-Coreのイメージが分かりましたでしょうか？一番、Alinous-Coreを理解するのによい方法は実際に動かしてみることだと思いますので、これから、実際にAlinous-Coreのデバッグ環境で動かしてみましょう。

HTMLファイルの記述

HTMLファイルの役目は、Alinousスクリプトで作成した変数をHTMLで表現されたデザインの中に埋め込むことです。

Alinous-CoreのHTMLは、通常のHTMLを次の２つの点で拡張しています。

変数を出力するテキストマクロが記述できる
Alinous-Core専用の属性が存在する

拡張部分はこれだけで、他に、Alinous-Core独自のタグなどは存在しません。そのため、DreamWeaverなどのオーサリングツールで作成したHTMLのデザインとの互換性に優れています。

Alinous-Core専用の属性について

Alinous-Core専用属性は、HTMLのタグの中に記述することによって様々な動作をさせることができるものです。出来ることの例を挙げると

配列を使った繰り返し表示
フォームのバリデーション
他HTMLの組込み（ポートレット機能）
「戻る」ボタンの自動生成
条件式が正しいときに中身を表示（if文の役目）

があります。

書き方を「配列を使った繰り返し表示」を例にするとつぎのtest.htmlのようになります。

test.alns

$record[0].name = "Yamada";
$record[1].name = "Tanaka";

return 0;

test.html

html" />
body" />

div alns:iterate="@record" alns:variable="oneRecord"" />
{$oneRecord.name}さんこんにちはbr" />
/div" />

/body" />
/html" />

このとき、test.htmlは下のように展開されます。

html" />
body" />

div" />
Yamadaさんこんにちはbr" />
/div" />
div" />
Tanakaさんこんにちはbr" />
/div" />

/body" />
/html" />

Alinous-Core専用属性は、付けられるタグが決まっています。例えば、先ほど紹介したalns:iterate属性はdiv" />、span" />、tr" />、td" />タグに付けることが可能です。これらの属性の詳細についてはリファレンスを参考にしてください。

urlのパスについて

HTML内で使われるパスは、次の３種類があります。

「http://」から始まる完全なURL
「/」から始まる絶対パス
相対パス

この３種類のパスのうち、絶対パスに関してはAlinous-Coreの場合は、「/ALINOUS_HOME」を起点にした絶対パスになります。デバッグ用サーバでは「/ALINOUS_HOME」フォルダが

http://localhost:8080/

にあたります。

もし、「/ALINOUS_HOME/folder1/test.html」へのリンクを張りたい場合は次のように記述します。

a href="/folder1/test.html"" />リンク/a" />

関数について

Alinousスクリプト上で使える関数のタイプは次の３通りあります。

Alinousスクリプト上で定義した関数
標準関数
JavaConnectorで作成したカスタム関数

Alinousスクリプト上で定義した関数は、Alinousスクリプトのメイン部分（return 0まで）の後に記述した関数です。

// 戻り値を省略
testFunc();
// 戻り値を変数に代入
$retValue = testFunc();

// 引数もとることが出来る
$ar[0] = "0000";
$ar[1] = "1111";

testFunc2("test", @ar);

return 0;

function testFunc()
{
        return "test";
}

function testFunc2($domValue, @arrayValue)
{

}

関数は、戻り値を持つことが出来、関数内でreturnをした値が戻されます。今回の例では通常の値を返していますが、配列を返すことも出来ます。

また、引数には、通常のDOM変数と配列の両方をとることが出来ます。関数内で引数の値を変更した場合には、呼び出した元に処理が戻ったときに引数に指定した値も変更されます。

標準関数は、Alinous-Coreがデフォルトで持っている関数でこれらは何の定義も必要なく利用することが出来ます。

$ar[0] = "0000";
$ar[1] = "1111";

// 配列の大きさを取得（2が返される）
$num = Array.size(@ar);

return 0;

JavaConnectorで作成したカスタム関数は、Javaで書かれたメソッドをAlinous-Coreにインポートした関数です。標準関数のほとんどは、JavaConnectorで書かれていて、標準関数と同じ使い方で利用することが出来ます。JavaConnectorでの関数の作り方は後述します。

制御構文について

Alinousスクリプトでは、他のスクリプト言語のように次のような制御文が使えます。

if文
else文
else if文
for文
while文

それらの例を次に示します。

$test = 10;

// if文の例
if($test == 10){
        $test = 1;
}
else if($test == 1){
        $test = 2;
}
else{
        $test = 3;
}

// while文の例
$cnt = 0;
while($cnt < 10){
        $cnt = $cnt + 1;
}

// for文の例
for($i = 0; $i < 10; $i++){
        $ar[$i] = $i;
}

return 0;

Alinousスクリプトの変数

Alinousスクリプトで利用する変数はDOM形式の変数で「.」で区切って変数名を書くことが出来ます。

$message.hello = "Hello world!!";
$message.gooby = "good by";

return 0;

このときに、変数のアロケーションに関しては意識する必要はありません。自動的に存在しない変数に値を代入したときに変数のアロケーションは行われます。

また、変数が存在するかどうかは、値がnullかどうかをチェックすることによって調べることが出来ます。つまり、存在しない変数の値を参照するとnullが返されます。次にその例を示します。

$message.hello = "Hello world!!";

if($message.hello == null){
        //　$message.helloは存在するのでここにはきません
        $exist = "存在しません";
}

if($message.goodby == null){
        //　$message.goodbyは存在しないのでここにきます
        $exist = "存在しません";
}

return 0;

if文は最初の()の中の式が正しければ中の{}の部分を実行し、正しくなければ実行しません。また、==演算子は演算子の左と右の変数（もしくは式）の値が等しいことを意味します。

Alinousスクリプトの変数の型

Alinousスクリプトの変数には、次の３つの型があります。

文字列型
整数型
浮動小数点型

これらの値は、直前に入力した値によって決まってきます。例を示すと次のようになります。

// 文字列型
$valStr = "文字列型";

// 整数型
$valInt = 100;

// 浮動小数点型
$valDouble = 10.0;

return 0;

これをデバッガで実行し、変数の様子を見ると次のようになっています。

値の右側になにもついていないものが文字列型、[INT]とついているものが整数型、[DOUBLE]とついているものが浮動小数点型になります。

配列について

Alinous-Coreでは、配列を扱うことも出来ます。配列は、[]を変数の後につけることにより実現が可能です。次に、配列を使ったサンプルを示します。

// シンプルな配列
$valArray[0] = "test";
$valArray[1] = "test1";
$valArray[2] = "test2";
$valArray[3] = "test3";

// 配列の中にDOM変数を定義
$valDom[0].name = "iizuka";
$valDom[0].value = "tomohiro";
$valDom[1].name = "yamada";
$valDom[1].value = "tarou";

return 0;

これをデバッガで表示すると次のようになります。

配列の中には通常の変数を代入することが出来ます。Alinousスクリプトの場合、すべての変数はDOM形式なので、ソースの中の２番目の例のようにさらに入れ子構造をとることもでき、SELECT文を使ってデータベースからレコードを取ってきたときにはこの形式で配列が返されます。

特殊変数について

Alinous-Coreにはいくつかの特殊変数があります。その変数は最初から役割が決まっているもので、それぞれ次のような役割があります。

変数名	役割
$IN	HTTPでGETおよびPostされた変数
$SESSION	セッションに保存されている変数
$HTTP	HTTPプロトコルのヘッダーなどの値が保存されている変数

Alinousスクリプトの構文

前節でも述べたとおり、Alinousスクリプトは、HTMLに埋め込むための変数を作成するプログラムを記述する部分です。次に、簡単なAlinousスクリプトのプログラムを示します。

$test = "Hello world!!";

return 0;

このスクリプトでは最初に$testという変数を作り、その後で0を返しています。この0を返す処理は決まりごとだと思って、毎回書くようにしてください。 0以外の値を返すときの役割は後述します。

基本構文

Alinous-Coreの言語使用について語る前に、もう一度、Alinous-Coreの概念についておさらいをしておきます。Alinous-Coreは、Webデータベースアプリケーションむけのドメイン特化型言語です。ですので、通常は、フレームワークがカバーする機能の表現を言語レベルでサポートしている部分が多々あります。そのため、Alinous-Coreでプログラムを作る際には、自分が今作っているところの役割をきちんと理解することが大切です。

ここで、ひとつのAlinous-Coreの最も簡単なプログラム例を示します。ファイルは２つで「test.alns」と「test.html」です。その内容を次に示します。

test.alns

$test = "Hello world!!";

return 0;

test.html

html" />
head" />
        title" />最も簡単なサンプル/title" />
/head" />
body" />
h" />サンプルプログラムです/h" />

{$test}

/body" />
/html" />

Alinous-Coreのひとつのページは次の順番で実行され、表示されます。

Alinousスクリプト（test.alns）を実行し、変数を作る
HTMLファイルにAlinousスクリプトで作成した変数を埋め込む

つまり、Alinousスクリプトは動的な変数を作成する役割を持ち、HTMLはデザイン部分の表現をするやくわりを持ちます。これを考慮して、読み進めてみてください。

alinous-config.xml

alinousーconfig.xmlは、Alinous-Coreサーバの動作時の設定に関する項目を設定するためのファイルです。次の設定をこのファイルで行うことが出来ます。

システム全体の設定
データベース設定
認証の設定
メールの設定

初期設定では、alinousーconfig.xmlは次のようになっています。

alinous-config.xml

?xml version="1.0" encoding="utf-8"?" />
alinous-config" />
        system" />
                system-datastore id="pgsrc" /" />
                default-datastore id="pgapps" /" />
        /system" />

        datasources id="pgsrc"
			class="org.alinous.plugin.derby.DerbyDataSource"" />
                connect" />jdbc:derby://localhost/MyDB;create=true;/connect" />
                user" />/user" />
                pass" />/pass" />
        /datasources" />

        datasources id="pgapps"
			class="org.alinous.plugin.derby.DerbyDataSource"" />
                connect" />jdbc:derby://localhost/MyDB;create=true;/connect" />
                user" />/user" />
                pass" />/pass" />
        /datasources" />
        
        basic-auth" />
                relm" />
                        datastore" />pgsrc/datastore" />
                        table" />AUTH_TABLE/table" />
                        users" />USERS/users" />
                        passwords" />PASSWORDS/passwords" />
                        roles" />ROLES/roles" />
                /relm" />
                
                zones" />
                    zone" />
                            area" />/admin//area" />
                            roles" />admin/roles" />