例 3.1. ブートローダとファクトリ関数

//
//  HelloWorld.cpp
//

#include "HelloWorld.hpp"

// ブートローダ
SFCApplet::FactorySPP SFCApplet::Boot(AEECLSID id, SFXAnsiStringPtr license)
{
    *license = "heap://"
               "TIXDRQXNU5WHU8Y3Z9WOHWQR6Z3VPSDHDV5CR1S4XASPWLUHWAS7Z5Z2TGS3XMSAT3UPUQTLTARCYPSF"
               "UEJZ6ROSJWGUQSEYKR6V2U4VESMTQLHKZ6X7Y2VKXHWIX3XBU0Z7VHWHXIZBSGT5SPU3XLX0Z1Y4R3TC"
               "U6WGT9WHWIVNYHYCUCR9T3SMTEWPRNVAX1Y4VPW2YCY9YQV5R7Z9UIVHT6SDUPU2SIW6VCRCWBR2S4WQ"
               "UPYFWCYGT4VIT1WHXGYPTQSFYPWNV3ULRNWFW7RBRFVKUKS2YQSQYHW1TPUPXBZ6UEY2WOYKR7S3TAU4"
               "TQS6UHVFVEVLU3R5SDSKW7RPTNTPVQU2T4R8Z4VLUGEW3U98TLDR8/";

    return (id == AEECLSID_HELLOWORLD) ? (&HelloWorld::Factory) : (null);
}

// ファクトリ関数
SFCInvokerPtr HelloWorld::Factory(Void)
{
    return ::new HelloWorld;
}

例 3.2. HelloWorld の定義

////  HelloWorld.hpp//

#define __HELLOWORLD_HPP

#include <SophiaFramework.hpp>
#include "HelloWorld.bid"

//
//  HelloWorld アプリケーションクラス
//
//  便利な型を生成するマクロ
SFMTYPEDEFCLASS(HelloWorld) 
class HelloWorld : public SFYApplication //  HelloWorld は SFYApplication を継承する
{
    //  インスタンスのコピーを禁止するマクロ
    SFMSEALCOPY(HelloWorld) 
public:
    static SFCInvokerPtr Factory(Void);
private:
    explicit HelloWorld(Void) static_throws;
    virtual ~HelloWorld(Void);
    XANDLER_DECLARE_VOIDRENDER(OnRenderRequest)  // 描画ハンドラの宣言
    XANDLER_DECLARE_BOOLEVENT(OnKey)             // キーハンドラの宣言
};

#endif // __HELLOWORLD_HPP //

	大文字アルファベットを含むアプリケーション名(BREW 4.0のみ)
	通常、HelloWorld などのアプリケーションクラスの名前はアプレット本体と同じ名前にします。 ただし、BREW 4.0 からアプレットの名前に大文字アルファベットが使えなくなりましたので、 HelloWorld や USRApplication などアプリケーションクラスの名前に大文字アルファベットを使う場合、 大文字アルファベットを小文字アルファベットに変換するなどして、 ビルド後のファイル名に大文字アルファベットが含まれないようにする必要があります。

	アプリケーションクラス内でのハンドラ
	アプリケーションクラス内で利用するハンドラは、 アプリケーションクラスがデフォルトで保持するルート(SFZRoot)のハンドラとみなされます。 HelloWorld アプレットの例では、簡略化のため直接アプリケーションクラス内でハンドラを定義して使っていますが、 一般にハンドラはルート以外のレスポンダ内で利用することが推奨されます。

	SFMTYPEDEFCLASS マクロ
	SFMTYPEDEFCLASS は引数に指定したクラス関する便利なユーザー定義型を自動生成するマクロです。 関連情報 : SFMTYPEDEFCLASS マクロ

	SFMSEALCOPY マクロ
	SFMSEALCOPY はインスタンスのコピーを禁止するマクロです。 SFYApplication を継承するクラスのインスタンスはコピーしてはいけません。 関連情報 : SFMSEALCOPY マクロ

	XANDLER_DECLARE_VOIDRENDER マクロ
	XANDLER_DECLARE_VOIDRENDER は描画ハンドラを宣言するためのマクロです。 描画イベント [SFEVT_RESPONDER_RENDER] が発生すると、 ここで宣言したハンドラが呼び出されて実行されます。 関連情報 : 描画イベント専用ハンドラ [XANDLER_DECLARE_VOIDRENDER] | 描画イベント [SFEVT_RESPONDER_RENDER]

	XANDLER_DECLARE_BOOLEVENT マクロ
	XANDLER_DECLARE_BOOLEVENT は Bool 型を返すハンドラを宣言するための汎用マクロです。 ここでは、BREW 環境から送信されるキーイベントのハンドラを宣言しています。 キーイベントが発生すると、ここで宣言したハンドラが呼び出されて実行されます。 関連情報 : 引数のある汎用ハンドラ [XANDLER_DECLARE_VOIDEVENT または XANDLER_DECLARE_BOOLEVENT] | キーイベント | Bool 型

例 3.3. コンストラクタの実装(ハンドラの登録)

// コンストラクタ
HelloWorld::HelloWorld(Void) static_throws
{
    if (static_try()) {
        // 描画ハンドラを登録する
        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER,
            SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST),
            XANDLER_INTERNAL(OnRenderRequest)
        ));
    }
    if (static_try()) {
        // キーハンドラを登録する
        static_throw(RegisterHandler(
            SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
            XANDLER_INTERNAL(OnKey)
        ));
    }
}

イベント

イベント(SFXEvent)は、 イベント タイプと 2 つのパラメータ( P16 パラメータと P32 パラメータ)から構成されます。 イベントを処理するハンドラは、 SFYApplication::RegisterHandler または SFYResponder::RegisterHandler 関数を使ってレスポンダに登録します。 イベントには BREW SDK で定義される BREW 定義イベントと、 SophiaFramework 独自のレスポンダ定義イベントの 2 種類があります。 BREW 定義イベントのイベント タイプ名は、BREW SDK で定義されるイベント タイプ名の先頭に SF 接頭語が付加された名前になります。 BREW 定義イベントは トレーサに登録された配信規則によりレスポンダに配信され、 レスポンダに登録されたハンドラが呼び出されて実行される配信型イベントです。 たとえば、SFEVT_KEY イベント(キーイベント)は BREW 定義イベントです。 一方、レスポンダ定義イベントのイベント タイプ名は、SFEVT_RESPONDER_ 接頭語が付加された名前になります。 レスポンダ定義イベントは SFYResponder::InvokeForward または SFYResponder::InvokeBackward 関数を使って送信され、 レスポンダに登録されたハンドラが呼び出されて実行されるコールバック型イベントです。 たとえば、SFEVT_RESPONDER_RENDER イベント(描画イベント [SFEVT_RESPONDER_RENDER])はレスポンダ定義イベントです。 関連情報 : イベント一覧 | BREW 定義イベント | レスポンダ定義イベント | レスポンダシステムのイベント処理 | SFXEvent | SFXEventRange | SFCEventEnum

	イベントの表現
	このリファレンスマニュアルでは状況に応じてイベントを �@イベントタイプ名、�A（イベントタイプ名, P16 パラメータ）、�B（イベントタイプ名, P16 パラメータ, P32 パラメータ）の３つの方法で表現しています。

SFXEventRange クラス

ハンドラは、 SFYApplication::RegisterHandler または SFYResponder::RegisterHandler 関数の引数で SFXEventRange クラスを使ってイベントの範囲を指定してレスポンダに登録します。 SFXEventRange(sEventType, eEventType, sP16, eP16) は (sEventType, sP16, *) から (eEventType, eP16, *) までの範囲のイベントを表します。 たとえば、上の例にある SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END) は (SFEVT_KEY, SFP16_BEGIN) から(SFEVT_KEY, SFP16_END)までのイベント、つまりすべてのキーイベントを表します。 ハンドラが処理するイベントがひとつだけで (EventType, P16) であるときは、 SFXEventRange(sEventType, eEventType, sP16, eP16) で sEventType と eEventType は EventType、 sP16 と eP16 は P16 という風にそれぞれ同じ値を設定します。 上の例にある SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST) は (SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, *) という描画イベントだけを表します。 関連情報 : SFXEventRange | SFXEvent | SFCEventEnum | SFCEventEnum SFYApplication::RegisterHandler | SFYApplication::UnregisterHandler | SFYApplication::ClearHandler | SFYResponder::RegisterHandler | SFYResponder::UnregisterHandler | SFYResponder::ClearHandler

	XANDLER_INTERNAL マクロ
	内部のインスタンスを参照するハンドラを取得するマクロです。 ハンドラ登録時、ハンドラ関数名の指定では XANDLER_INTERNAL マクロを使います。

例 3.4. デストラクタの実装

// デストラクタ
HelloWorld::~HelloWorld(Void)
{
}

例 3.7. グローバルな変数の定義とアクセス

//
//  ExampleAppli アプリケーションクラス（AppWizard で自動生成）
//
SFMTYPEDEFCLASS(ExampleAppli)
class ExampleAppli : public SFYApplication
{
    SFMSEALCOPY(ExampleAppli)
public:
    static SFCInvokerPtr Factory(Void);
private:
    explicit ExampleAppli(Void) static_throws;
    virtual ~ExampleAppli(Void);

    // グローバル変数 global_something_val を定義する
    SInt32 global_something_val;
public:
    // グローバル変数 global_something_val にアクセスするための GetGlobalSomethingVal() 関数を宣言する
    SInt32 GetGlobalSomethingVal();
};

// グローバル変数 global_something_val にアクセスするための GetGlobalSomethingVal() 関数を定義する
ExampleAppli::GetGlobalSomethingVal(Void)
{
    return global_something_val;
}

// GetGlobalSomethingVal() 関数経由でグローバル変数 global_something_val の値を取得する
static_cast<ExampleAppli>(SFYApplication::GetInstance())->GetGlobalSomethingVal();

例 3.8. エラー値をキャッチしエラー処理するコード

helloworld = ::new HelloWorld();
switch( helloworld->static_catch() ){

        // エラー値に応じてエラー処理をする

};