flash.net パッケージには、新しいブラウザウィンドウを開く、URL 要求をサーバーに送信する、クラスエイリアスを扱うなどの操作を行うためのパッケージレベルの関数が含まれます。
パブリック 関数
 関数定義元
  
registerClassAlias() メソッドの呼び出しを介して以前にエイリアスを登録したクラスを検索します。
flash.net
  
navigateToURL(request:URLRequest, window:String = null):void
Flash Player のコンテナを含むアプリケーション (通常はブラウザ) でウィンドウを開くか、置き換えます。
flash.net
  
registerClassAlias(aliasName:String, classObject:Class):void
AMF (Action Message Format) でオブジェクトがエンコードされる場合、オブジェクトのクラス (タイプ) は維持されます。
flash.net
  
URL リクエストをサーバーに送信しますが、応答は無視します。
flash.net
関数の詳細
getClassByAlias()関数
public function getClassByAlias(aliasName:String):Class

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

既に registerClassAlias() メソッドの呼び出しによってエイリアスが登録されているクラスを検索します。

このメソッドは flash.utils.getDefinitionByName() メソッドと相互に作用しません。

パラメータ

aliasName:String — 検索するエイリアスです。

戻り値
Class — 指定されたエイリアスに関連付けられたクラスです。見つからない場合は、例外がスローされます。

例外
ReferenceError — エイリアスが登録されていません。

関連項目

navigateToURL()関数 
public function navigateToURL(request:URLRequest, window:String = null):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

Flash Player のコンテナを含むアプリケーション (通常はブラウザ) でウィンドウを開くか、置き換えます。

メモ : ブラウザ内で実行されるローカルコンテンツの場合、navigateToURL() 関数を呼び出すときに "javascript:" 擬似プロトコルを指定できるのは (たとえば navigateToURL("javascript:someFunction()"))、SWF ファイルとそれが含まれる Web ページが (存在する場合)、信頼できるローカルのセキュリティサンドボックスにある場合のみです。詳細については、以下を参照してください。

パラメータ

request:URLRequest — 移動先の URL を指定する URLRequest オブジェクトです。
 
window:String (default = null)request パラメータで指定されたドキュメントを表示するブラウザウィンドウまたは HTML フレームです。特定のウィンドウの名前を入力するか、次の値のいずれかを使用します。
  • "_self" は、現在のウィンドウ内の現在のフレームを指定します。
  • "_blank" は、新規ウィンドウを指定します。
  • "_parent" は、現在のフレームの親を指定します。
  • "_top" は、現在のウィンドウ内の最上位のフレームを指定します。

このパラメータに値を指定しない場合は、新しい空のウィンドウが作成されます。スタンドアローン Flash Player では、新しい ("_blank") ウィンドウまたは名前付きのウィンドウのいずれかを指定できます。その他の値は適用されません。

メモ : ローカルファイルシステムのサンドボックスで実行される SWF ファイル内のコードが navigateToURL() 関数を呼び出して window パラメータにカスタムウィンドウ名を指定すると、そのウィンドウ名はランダム名に受け継がれます。"_flashXXXXXXXX" の形式の名前になります。X はそれぞれがランダム 16 進数字を表します。同じセッション内で (含まれるブラウザウィンドウを閉じるまでに) 再度この関数を呼び出して window パラメータに同じ名前を指定した場合は、同じランダムストリングが使用されます。


例外
SecurityError — このエラーは次の状況でスローされます。
  • 信頼されていないローカル SWF はインターネットへの接続を許可されません。この問題は、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類することで回避できます。
  • スクリプティング疑似 URL を評価するために試行された移動操作です。ただし、含まれるドキュメント (一般にブラウザ内の HTML ドキュメント) はアクセス権限が与えられていないサンドボックスからのものです。含まれるドキュメントに allowScriptAccess="always" を指定することで、この問題を回避できます。
  • HTML ファイルと SWF ファイルのドメインが一致しないとき、特別なウィンドウ "_self""_top"、または "_parent" の移動は、allowScriptAccess"none" または "sameDomain" に設定されている HTML ページに SWF ファイルがある場合はできません。
  • デフォルト以外の名前を持つウィンドウを、ローカルファイルシステムのサンドボックスにある SWF ファイル内から移動することはできません。

関連項目




次の例では、新しいブラウザウィンドウで URL http://www.adobe.com を開き、URLVariables オブジェクトで捕捉したユーザーセッションに関するデータを Web サーバーに渡します。
package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class NavigateToURLExample extends Sprite {

        public function NavigateToURLExample() {
            var url:String = "http://www.adobe.com";
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "Your Name";
            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            try {            
                navigateToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}
registerClassAlias()関数 
public function registerClassAlias(aliasName:String, classObject:Class):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

AMF (Action Message Format) でオブジェクトがエンコードされる場合、オブジェクトのクラス (タイプ) は維持されます。オブジェクトを AMF にエンコードする場合、この関数は、そのクラスのエイリアスを保存し、オブジェクトのデコード時にクラスを復元できるようにします。エンコードコンテキストで、オブジェクトのクラスのエイリアスが登録されていない場合、オブジェクトは匿名オブジェクトとしてエンコードされます。同様に、デコードコンテキストで、同じエイリアスが登録されていない場合、デコードするデータに対して、匿名オブジェクトが作成されます。

LocalConnection、ByteArray、SharedObject、NetConnection、および NetStream はすべて AMF でオブジェクトをエンコードするクラスの例です。

エンコードおよびデコードコンテキストでは、エイリアスに同じクラスを使用する必要はありません。エンコード先およびデコード先のクラスに、ソースクラスによって直列化されたすべてのメンバーが含まれている限り、クラスを意図的に変更できます。

パラメータ

aliasName:String — 使用するエイリアスです。
 
classObject:Class — 指定されたエイリアスに関連付けられたクラスです。


例外
TypeError — いずれかのパラメータが null の場合。

関連項目




この例では、registerClassAlias() 関数を使用して、クラス ExampleClass のエイリアス (com.example.eg) を登録します。クラスのエイリアスが登録されると、オブジェクトを ExampleClass のインスタンスとして非直列化できるようになり、コードは true を出力します。registerClassAlias() 呼び出しが削除されると、コードは false を出力します。
package {
    import flash.display.Sprite;
    import flash.net.registerClassAlias;
    import flash.utils.ByteArray;

    public class RegisterClassAliasExample extends Sprite {
        public function RegisterClassAliasExample() {
            registerClassAlias("com.example.eg", ExampleClass);
            var eg1:ExampleClass = new ExampleClass();
            var ba:ByteArray = new ByteArray();
            ba.writeObject(eg1);
            ba.position = 0;
            var eg2:* = ba.readObject();
            trace(eg2 is ExampleClass); // true
        }
    }
}

class ExampleClass {}
sendToURL()関数 
public function sendToURL(request:URLRequest):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

URL リクエストをサーバーに送信しますが、応答は無視します。

サーバーの応答を調べるには、代わりに URLLoader.load() メソッドを使用します。

Flash Player 9 以降では、SWF ファイルがこのメソッドを使用しないようにすることができます。そのためには、SWF コンテンツを含んでいる HTML ページに allowNetworking パラメータ (object タグおよび embed タグ) を設定します。

詳細については、http://www.adobe.com/go/fp9_0_security_jp の Flash Player 9 セキュリティに関するホワイトペーパーを参照してください。

パラメータ

request:URLRequest — データの送信先の URL を指定する URLRequest オブジェクトです。


例外
SecurityError — 信頼されていないローカル SWF ファイルはインターネットへの接続を許可されません。この問題は、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類することで回避できます。

関連項目




次の例では、URLVariables オブジェクトで捕捉したユーザーセッションに関するデータを、http://www.yourDomain.com/application.jsp にあるアプリケーションに渡します。
 package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.net.URLVariables;
    import flash.net.sendToURL;

    public class SendToURLExample extends Sprite {

        public function SendToURLExample() {
            var url:String = "http://www.yourDomain.com/application.jsp";
            var variables:URLVariables = new URLVariables();
            variables.sessionId = new Date().getTime();
            variables.userLabel = "Your Name";

            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            trace("sendToURL: " + request.url + "?" + request.data);
            try {
                sendToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/flash/net/package.html