さらに進んだ学習

引き続き、thin クライアント用とインターネット用のスマートコードのさらに高度な機能を試してみることもできます。Sun WorkShop Visual のパッケージには、ユーザー用の学習を実行する「Sun WorkShop Visual 再現」スクリプト実行用の命令を含んだ HTML ファイルが付属しています。HTML ブラウザで以下のファイルを開いて学習が実行される様子を観察し、その結果を確認してください。

1. $VISUROOT/lib/locale/<YourLocale>/sc/timex.html
このファイルでは、自動リモート更新によるアプリケーションの作成方法を示す「サーバーにプッシュ」学 習について説明します。

2. $VISUROOT/lib/locale/<YourLocale>/sc/parsex.html
このファイルでは、Web ページを取り出して解析するアプリケーションの作成方法について説明します。

注 - VISUROOT は Sun WorkShop Visual のインストールディレクトリであり、<YourLocale> は使用しているロケールの名前です。

パーサーの使用

「カスタマイズ」ダイアログで「SGML/HTML パーサ」トグルをオンにして、SGML/HTML を処理したいことを Sun WorkShop Visual に通知した後は、以下の 4 つの手順が必要となります。各手順は、受信ハンドラの内部で行われます。

1. ルーチン scRegisterSGMLMimeType (または HTML scRegisterHTML のショートカット) を呼び出すことによって、MIME 型を登録します。

2. ルーチン scRegisterSGMLMimeErrorHandler を呼び出すことによって、エラーハンドラを登録します。この手順は省略可能です。

3. ルーチン scAddTagCallback と scAddAttrCallback を呼び出すことによって、入力ストリームの 1 つ以上の項目にインタレストを登録します。あるいは、この時点で従来の構文解析ツリーを要求することも できます。

4. ルーチン scProcessSGML を使用してパーサーを呼び出します。

これらの手順を行う際は、次のことに注意してください。

パーサーへのインタフェースをプログラムする前に、次のヘッダーファイルをイン クルードしていることを確認してください。

#include <SGML.h>

このヘッダーファイルは Sun WorkShop Visual に付属しています。このヘッダーファイルのディレクトリは、自動的に Makefile に組み込まれます。

さらに、DTDDIR 環境変数には次の値を設定する必要があります。

$VISUROOT/src/sgml/dtds

SGML パーサーの位置と使用するファイルの詳細については、「パーサーを使用するための実用情報」参照してください。

MIME 型の登録

パーサーを構成するには、最初に SGML オブジェクトを作成する必要があります。その後、このオブジェクトは、呼び出す必要のある他のルーチン に渡されます。SGML オブジェクトは、次に示す、データの MIME 型を登録するために呼び出すルーチンから返されます。

SGML_t *

scRegisterSGMLMimeType( mimetype, dtd)

        char * mimetype;

        char * dtd;

これを使用して、MIME 型と SGML DTD を関連付けます。最も一般的な方法を次に示します。

SGML_t * sgm = scRegisterSGMLMimeType("text/html", "HTML32.soc");

これは最もよく使用されるため、次のショートカットを使用することもできます。

SGML_t *

scRegisterHTML( mimetype)

        char * mimetype;

この動作は上とまったく同じであり、「text/html」と HTML32 DTD を関連付けます。独自の DTD を追加するには、それを DTDDIR 環境変数によって参照されるディレクトリに置いてください。

次に、「SGML/HTML パーサ」トグルをオンにした状態で、「受信 (URL の内容)」フィールドに「processMyData」を指定した場合に生成されるものを示します。MIME 型を登録するために 1 つの行が追加されています。

int

processMyData ( data, idata)

        sc_stdcs_t* data;

        sc_idata* idata;

{

	extern InputData * newInputData();

	group0_t * group = (group0_t*)data->group;

	InputStream * i   = (*idata->getInputStream)( idata);

#if 0 /* example usage */

	char      * type  = (*idata->getMimeType)(idata);

	int         len   = (*idata->getContentLength)( idata);

	InputData * id    = newInputData( i);

	char *   d        = (*id->getData)( id);

#endif

	sgm = scRegisterHTML( type); /* この行が追加されました */

	...

	return 0;

}

エラーハンドラの登録

デフォルトのエラーハンドラは、標準出力にエラーメッセージを出力します。これ を無効にするには、次のルーチンを使用して、独自のエラーハンドラを登録してください。

int

scRegisterSGMLErrorHandler( errorhandler)

        void_f errorhandler;

ユーザーのエラーハンドラは、次の形式にしてください。

void

errorhandler( s)

        char * s;

入力ストリーム項目にインタレストを登録

解析されたデータを利用するため、入力の 1 つ以上の項目 (たとえば、HTML 内の特定のタグや属性) にインタレストを登録します。

入力項目へのインタレストの登録は、ウィジェットのコールバック方式によく似て います。ウィジェットのコールバックの場合、ウィジェットは特定のアクションにインタレストを登録しま す。そして、そのアクションが起こると、指定したルーチン
(コールバック) が呼び出されます。ここでは、言語の項目にインタレストを登録します。パーサーは、これらの項目のどち らかを検出すると、ユーザーのコールバックルーチンを呼び出します。

HTML には、タグと属性という 2 つの主要項目があります。以降の節で説明する 2 つのルーチンのどちらかを使用して、これらの項目にインタレストを登録できます。最初に、タグと属性を 簡単に説明しておきます。

<menu>

	<li>The first item in the list

	<li>The second item in the list

</menu>

<a href="#bottom"><b>Go to bottom of page</b></a>

...

<a name="bottom"></a>

タグにインタレストを登録

SGML パーサーは、HTML 入力のどの部分にユーザーが関心を持っているかを知る必要があります。また、選択した HTML ブロック内のどこでコールバックルーチンを呼び出すかも知る必要があります。

タグ要素にインタレストを登録するためのルーチンは次のとおりです。

int

scAddTagCallback( sgm, tagname, type, callback, data)

	SGML_t * sgm;

	char * tagname;

	int type;

	void (*callback)();

	void * data;

このルーチンへの引数には、さらに説明が必要です。これについては以下の項を参 照してください。

int type

この引数は、選択されたタグ内でユーザーのコールバックルーチンをいつ呼び出す かをパーサーに通知します。さらに、HTML の選択したブロックの内部からコールバックルーチンにデータが渡されるかどうかは、選択した「型」によ って決まります。ユーザーのコールバックルーチンは、任意の数の異なるタグと型に同じルーチンを使用で きるよう、常にタグ名とタイプを受け取ります。しかし、「ON_ATTR」と「ON_DATA」の場合には、より多く の情報が返されます。

図 18-7 に示すように、タグブロック内のどこでコールバックルーチンを呼び出すかに応じて、4 つの定義済みの型を選択できます。4 つの型は次のとおりです。

• ON_ENTRY
  ブロックの先頭を表します (たとえば <a> や <menu>)。データ (「ユーザーのコールバックルーチン」では call_data と呼ぶ) はユーザーのルーチンに渡されません。
• ON_EXIT
  ブロックの最後を表します (たとえば </a> や </menu>)。データ (「ユーザーのコールバックルーチン」では call_data と呼ぶ) はユーザーのルーチンに渡されません。
• ON_ATTR
  タグ定義の内部に現われる属性を表します (たとえば、href="mylink")。ユーザーのコールバックルーチンは、call_data 引数として引用符内部のテキストを受け取ります (「ユーザーのコールバックルーチン」で説明します)。
• ON_DATA
  タグの後にあるテキスト (またはデータ) を表します。ユーザーのコールバックルーチンは、タグの先頭と最後の間にあるテキストを call_data 引数として受け取ります (「ユーザーのコールバックルーチン」で説明します)。

 

図 18-7 型

属性にインタレストを登録

属性にインタレストを登録するルーチンは次のとおりです。

int

scAddAttrCallback( sgm, tagname, attrname, callback, data)

	SGML_t * sgm;

	char * tagname;

	char * attrname;

	void (*callback)();

	void * data;

以下の引数だけは、上記のタグ登録ルーチン用に記述されたものとは異なります。< /P>

• char * attrname
  これは関心のある属性の名前です。

任意の数の属性にインタレストを登録できます。

ユーザーのコールバックルーチン

ユーザーのコールバックルーチンにはスタブファイルがありません。すべて自分で 記述する必要があります。ルーチンの名前は、 scAddAttrCallback または scAddTagCallback への 4 番目の引数 (つまり「callback」という引数) として指定された名前です。

パーサーは、インタレストの登録されたタグや属性を検出すると、ユーザーのコー ルバックルーチンを呼び出します。次の例では、ユーザーのコールバックの内容と渡される引数の一覧を示 します。

int

mycallback( tag, attribute, type, call_data, client_data)

        char * tag;

        char * attribute;

        int    type;

        void * call_data;

        void * client_data;

ユーザーのルーチンに渡される引数は次のとおりです。

1. char * tag
パーサーが検出したタグです。

2. char * attribute
パーサーが検出した属性です。タグだけに関心があった場合には、これはヌルです。

3. int type
ルーチンの呼び出し型が「ON_ENTRY」、「ON_EXIT」、「ON_DATA」、「ON_ATTR」のいずれであるかを示し ます。これらについては、「int type」を参照してください。属性に関心がある場合には、この引数は関係ありません。

4. void * call_data
属性に関心がある場合には、これは等号記号の後に記述される属性部分です。たとえば、「href」属性にイ ンタレストを登録し、パーサーが次の行を検出した場合、この引数は「 #regmime 」となります。

	<a href="#regmime">

インタレストのタグとして「ON_DATA」を指定した場合には、この引数はタグの後のデータです。実例については、図 18-7 を参照してください。

5. void * client_data
これは登録ルーチンに渡される「データ」引数であり、ユーザー独自のデータをコールバックに渡すことが できます。これは、「コールバック」ダイアログでの Xt コールバック用のクライアントデータに似ています。

任意の数のタグや属性にインタレストを登録できるため、任意の数のコールバック ルーチンを持つことができます。しかし、タグと属性にそれぞれ 1 つのコールバックルーチンを持つことが、おそらく最も便利な組み合わせとなります。

入力ストリームの解析

MIME 型を指定し、エラーハンドラを登録し、特定の入力ストリーム項目にインタレストを登録して SGML オブジェクトを設定すると、パーサーを呼び出す準備ができたことになります。そのためのルーチンを次に 示します。

int

scProcessSGML( sgm, istream)

	SGML_t * sgm;	/* the parser handle scRegisterSGMLMimeType */

	InputStream * istream;	/* the input stream from the server */

最初の引数は、前の節で説明されています。2 番目の引数である入力ストリームは、受信ハンドラに渡されます。

パーサーの使用例

この節では、SGML パーサーの使い方を説明します。「カスタマイズ」ダイアログで 「SGML/HTML パーサ」トグルをオンにした場合には、受信ハンドラの名前も与える必要があります。Sun WorkShop Visual によって生成されたハンドラのスタブを次に示します。

int

processMyData ( data, idata)

        sc_stdcs_t* data;

        sc_idata* idata;

{

        extern InputData * newInputData();

        group0_t * group = (group0_t*)data->group;

        InputStream * i   = (*idata->getInputStream)( idata);

#if 0 /* example usage */

        char      * type  = (*idata->getMimeType)(idata);

        int         len   = (*idata->getContentLength)( idata);

        InputData * id    = newInputData( i);

        char *   d        = (*id->getData)( id);

#endif

        return 0;

}

SGML パーサーを使用するには、SGML オブジェクトを作成するためにこのルーチンにいくつかのコードを追加し、SGML オブジェクトを設定してから、着信データをパーサーに送信する必要があります。着信 HTML を解析するためのコードを追加した受信ハンドラを次に示します。

int

processMyData ( data, idata)

        sc_stdcs_t* data;

        sc_idata* idata;

{

	extern InputData * newInputData();

	group0_t * group = (group0_t*)data->group;

	InputStream * i   = (*idata->getInputStream)( idata);

/* 「#if 0 /* example usage */」という行は削除されました */

	char      * type  = (*idata->getMimeType)(idata);

	int         len   = (*idata->getContentLength)( idata);

	InputData * id    = newInputData( i);

	char *   d        = (*id->getData)( id);

/* 「#endif」という行は削除されました */

/* ここからは追加された行です */

	SGML_t * sgm;

	if ( strcmp( type, "text/html") != 0)

		return -1;

	sgm = scRegisterHTML( type); /* the parser object */

	(void) scAddTagCallback(sgm, "A", ON_ENTRY, getanchor, 

			"a-call");

	(void) scAddAttrCallback(sgm,  "A", "HREF", 

			getlinkinfo, "href");

	(void) scProcessSGML( sgm, i);

/* ここまでが追加された行です */

	return 0;

}

このルーチンでは、パーサーがアンカータグ (<a>) を検出するたびに getanchor を呼び出し、「href」属性が検出されるたびに getlinkinfo を呼び出すことを指定しています。以下のルーチンは、ユーザーが記述してください。

int

getanchor( tag, attr, type, call_data, client_data)

	char * tag;

	char * attr;

	int    type;

	void * call_data;

	void * client_data;

{

	printf("anchor-start(%s)\n", client_data);

}

int

getlinkinfo( tag, attr, type, call_data, client_data)

	char * tag;

	char * attr;

	int    type;

	void * call_data;

	void * client_data;

{

	printf( "%s=%s\n", client_data, call_data);

}

注 - このパーサーを使用する、Sun WorkShop Visual 再現機能によるオンラインスクリプトを実行する方法については、「さらに進んだ学習」を参照してください。

パーサーを使用するための実用情報

SGML パーサーを使用するには、コンパイル済みのコードとリンクする必要があります。ソースの場所を次に示し ます。

$VISUROOT/src/sgml

ライセンス条項により、ユーザーはこれらのソースを自由に使用できます。

最初は Sun WorkShop Visual に付属のコンパイル済みバージョンを使用する方が簡単です。

SGML パーサーは、以下のファイルとディレクトリを使用します。

1. $VISUROOT/lib
ここには、アーカイブと SGML ライブラリの共有バージョンが含まれています。Sun WorkShop Visual が Makefile に生成した構築ルールでは、 libsgml.so を使用します。しかし、好みに応じて libsgml.a とリンクすることもできます。

2. $VISUROOT/src/sgml/hdrs/SGML.h
これは、パーサーエンジンを使用するために必要なインクルードファイルです。スマートコードの「カスタ マイズ」ダイアログで「SGML/HTML パーサ」トグルをオンにした場合には、 Makefile では API が参照されます。

3. $VISUROOT/src/sgml/dtds
これは、HTML 3.2 DTD および他の関連するデータファイルを含んでいるディレクトリです。パーサーはこれを見つける必要がある ため、DTDDIR 環境変数に次の値を設定する必要があります。

	$VISUROOT/src/sgml/dtds

コンパイルする前に、以下のことを確認してください。

1. $VISUROOT/bin が PATH に含まれていること

2. $VISUROOT/lib がライブラリのパス環境変数 (たとえば、32 ビットアプリケーション用の LD_LIBRARY_PATH、64 ビットアプリケーション用の LD_LIBRARY_PATH64) に追加されていること