付録 D ： Java 言語バインディング

SVG 文書オブジェクトモデル定義に対する Java 言語バインディングは次の URL から入手できる：

The Java language binding for the SVG Document Object Model definitions is available at:

  http://www.w3.org/TR/SVG11/java-binding.zip

この言語バインディングが正式なものでないことに注意。 IDL 定義が SVG DOM を構成する正式なものである。

Note that this language binding is not normative. The IDL Definitions are the normative parts of the SVG DOM.

D.1 Java 言語での SVG の利用

ECMAScript などの言語による SVG に対するスクリプトでは、'script' 要素とイベント属性（例えば 'onload' や 'onclick' など）を利用して SVG 内容にスクリプトコードを直接書き込める。一方、 Java 言語などの実行形式がバイナリのプログラミング言語のコードを 'script' 要素やイベント属性に埋め込むことはできない。したがって、そのような言語をどのように SVG 文書にバインドし、イベント処理させるかを指定する必要がある。次の技法では Java 言語の場合にこれをどのようにして行うべきか、 Java 言語を通して動的な SVG 内容をサポートするＵＡには何が求められるのかを述べる。

When scripting SVG with a language such as ECMAScript, it is possible to embed script code directly in the SVG content using the 'script' element and the event attributes (e.g., 'onload' or 'onclick'). For programming languages with a binary delivery format, such as the Java language, it is not possible to embed the code into the 'script' element or within the event attributes. Therefore there is a need to specify how such languages can bind to and handle events in the SVG document. The following technique describes how this should be done when using the Java language and what is expected of the User Agent that supports dynamic SVG content through the Java language .

• 'script' 要素は、文書で発火されたイベントを処理するためのコンパイルされたコードを含む jar ファイルを参照すべきである。例えば：
  

   <script type="application/java-archive" 
              xlink:href="myJavaHandlers.jar" />
  

• The 'script' element should reference a jar file containing the compiled code to handle the events fired by the document. For example:
  

   <script type="application/java-archive" 
              xlink:href="myJavaHandlers.jar" />
  

• 参照された jar ファイルのマニフェスト（ manifest ）は SVG 文書のイベントリスナを初期化する責を負うクラスを定義する SVG-Handler-Class エントリを含んでいる。エントリの指定は完全修飾クラス名（ fully qualified class name ）になっているべきである。例えば：
  

  
  *****************************************************
  Manifest-Version: 1.1
  SVG-Handler-Class: org.example.svg.SVGHandler
  *****************************************************
       
  

• The manifest in the referenced jar file contains an entry, SVG-Handler-Class, defining the class responsible for initializing the event listeners on the SVG document. The entry should be a fully qualified class name. For example:
  

  
  *****************************************************
  Manifest-Version: 1.1
  SVG-Handler-Class: org.example.svg.SVGHandler
  *****************************************************
       
  

• SVG-Handler-Class により参照されるクラスは次の EventListenerInitializer インターフェースを実装する：
  

  public interface EventListenerInitializer {
    /**
     * 必要なリスナの登録
     */
         
    void initializeEventListeners(SVGDocument doc) {
      /* DOM を利用するイベントハンドラの初期化を
         ここに記述 */
    }
  }
  

   
• The class referenced by SVG-Handler-Class implements the EventListenerInitializer interface defined as:
  

        
  public interface EventListenerInitializer {
    /**
     * Registers the listeners needed
     */
         
    void initializeEventListeners(SVGDocument doc) {
      /* Initialization of event handlers using the
         DOM goes here */
    }
  }
  

   
• initializeEventListeners() メソッドは、イベントが発火される前にＵＡから呼び出される。
  
• The method initializeEventListeners() will be called by the User Agent before the onload event is triggered.
  

他のバイナリ・プログラミング言語に対するイベント・バインディングは定められていない。

The event binding of other binary programming languages is not specified.