com.j_phone.io
インタフェース BrowserConnection

すべてのスーパーインタフェース:
javax.microedition.io.Connection

public interface BrowserConnection
extends javax.microedition.io.Connection

ブラウザによるURLアクセスを実現するための Connection インタフェースです。このインタフェースを実装したオブジェクトは、スキームに "url:" または "urls:" を指定してConnector.open()メソッドを呼び出すことで取得できます。

ブラウザによるURLアクセスの基本処理シーケンスは以下のようにします。

  1. Connector.open()メソッドにて、スキームに "url:" または "urls:" を指定して呼び出すことにより、BrowserConnection インタフェースを実装したオブジェクトを取得します。
  2. BrowserConnection インタフェースのconnect() メソッドを呼び出して、ネイティブシステムのブラウザを起動して、Connector.open()メソッドで指定したURLにアクセスします。
  3. closeメソッドを呼び出すことで、ブラウザによるURLアクセス機能を終了します。

導入されたバージョン:
JSCL 1.2

メソッドの概要
 void connect()
          ネイティブシステムのブラウザを起動して、 Connector.open() メソッドに指定したURLにアクセスします。
 
インタフェース javax.microedition.io.Connection から継承したメソッド
close
 

メソッドの詳細

connect

public void connect()
             throws java.io.IOException
ネイティブシステムのブラウザを起動して、 Connector.open() メソッドに指定したURLにアクセスします。

このメソッドでは、 Connector.open()メソッドに指定された URL が "url:" で始まる文字列の場合は、スキーム部の "url:" を "http:" に変換してブラウザに渡します。URL が "urls:" で始まる文字列の場合は、スキーム部の "urls:" を "https:" に変換してブラウザに渡します。

このメソッド内では、URL 文字列の URL エンコード処理は行いません。 そのため、URLエンコードが必要な場合はURLエンコード済みの URL 文字列を Connector.open()メソッドに指定する必要があります。 URLエンコード変換後の URL 文字列は 256 バイト以内としてください。

ネイティブシステムのブラウザが起動している間、すべてのJavaスレッドはブロックされます。

例外:
java.io.IOException - 指定したURLにアクセスできなかった場合に発生する