付録 D: Java 言語束縛

D.1 Java 言語束縛

SVG DOM 定義に対する Java 言語束縛は次の URL から入手できる： The Java language binding for the SVG Document Object Model definitions is available at:

http://www.w3.org/TR/2011/REC-SVG11-20110816/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.2 Java 言語による SVG の利用

ECMAScript などの言語による SVG に対するスクリプトにおいては、 script 要素とイベント属性（例えば onload や onclick など）を利用して SVG 内容にスクリプトコードを直接記述できる。一方、 Java 言語などの実行形式がバイナリのプログラミング言語では，コードを script 要素やイベント属性に埋め込むことはできない。したがって、そのような言語をどのように SVG 文書に結びつけ, イベント処理させるかを指定する必要がある。 Java 言語の場合にこれをどのようにして行うべきか， Java 言語を通して動的な SVG 内容をサポートする UA には何が求められるのかは、次の様になる： 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 ファイルを参照しているべきである。例えば： 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 ファイルのマニフェストには、 SVG 文書のイベントリスナの初期化の責を担うクラスを定義する， SVG-Handler-Class エントリが含まれる。エントリは完全修飾名にすべきである。例えば： 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 インタフェースを実装する： The class referenced by SVG-Handler-Class implements the EventListenerInitializer interface defined as:
```
public interface EventListenerInitializer {
  void initializeEventListeners(SVGDocument doc);
}
```
initializeEventListeners() メソッドは、 onload イベントが誘発される前に UA から呼び出される。 The method initializeEventListeners() will be called by the User Agent before the onload event is triggered.

他のバイナリ・プログラミング言語に対するイベント束縛（ binding ）は、定められていない。 The event binding of other binary programming languages is not specified.

付録 D: Java 言語束縛

目次

D.1 Java 言語束縛

D.2 Java 言語による SVG の利用